Criar uma assinatura

Depois de você seu coletor de dados, crie uma assinatura para transmitir seus dados de colocation para ele.

observação

Você pode usar apenas um tipo de canal de comunicação em sua organização. Por exemplo, se você criar uma assinatura com o canal AWS IoT Core, não poderá criar outra assinatura usando um tipo de canal diferente.

Apenas um canal é permitido para uma única assinatura.

Pré-requisitos

• Antes de chamar as APIs de gerenciamento de assinatura, consulte Integração com um coletor para definir e configurar o destino de seus dados.

• Envie suas credenciais de usuário, ID do cliente e Segredo do cliente para autenticação OAuth2. Consulte Autenticação do API para obter mais informações sobre como autenticar suas solicitações no Equinix API.

AWS IoT Core

Para criar uma assinatura para enviar dados para o Amazon IoT Core, envie uma POST solicitação para o /smartview/v2/streaming/subscriptions endpoint. No corpo da solicitação, especifique o channelType AS AWS_IOT_CORE e sua URL no awsIotCoreChannelConfiguration. Especifique quais dados ele deve receber no messageTypeobjeto.

Exemplo de solicitação cURL:

curl -X   
POST 'https://api.equinix.com/smartview/v2/streaming/subscriptions'  
-H 'content-type: application/json'  
-H 'authorization: Bearer <token>'  
-d '{  
    "messageType": {  
        "asset": [],  
        "environmental": [  
            {  
                "accountNumber": "116710",  
                "ibx": [  
                    "LD9"  
                ],  
                "level": [  
                    "CAGE"  
                ]  
            }  
        ],  
        "power": [],  
        "meteredPower": [],  
        "systemAlert": [],  
        "customAlert": []  
    },  
    "channel": {  
        "channelType": "AWS_IOT_CORE",  
        "awsIotCoreChannelConfiguration": {  
            "url": "https://<awsIotCoreuri>.amazonaws.com"  
        }  
    }  
}' 

Para obter uma lista completa das opções disponíveis para o messageType, consulte a Referência do API .

Hub de Eventos do Azure

Para criar uma assinatura de canal do Azure, entre em contato com o suporte.

Webhook

Para criar uma assinatura para enviar dados para um webhook, envie uma POST solicitação para o /smartview/v2/streaming/subscriptions endpoint. No corpo da solicitação, especifique o channelType AS WEBHOOK e sua configuração no webhookChannelConfiguration. Especifique quais dados ele deve receber no messageTypeobjeto.

Exemplo de solicitação cURL:

curl -X   
POST 'https://api.equinix.com/smartview/v2/streaming/subscriptions'  
-H 'content-type: application/json'  
-H 'authorization: Bearer <token>'  
-d '{  
    "messageType": {  
        "asset": [],  
        "environmental": [  
            {  
                "accountNumber": "116710",  
                "ibx": [  
                    "LD9"  
                ],  
                "level": [  
                    "CAGE"  
                ]  
            }  
        ],  
        "power": [],  
        "meteredPower": [],  
        "systemAlert": [],  
        "customAlert": []  
    },  
    "channel": {  
        "channelType": "WEBHOOK",  
        "webhookChannelConfiguration": {
            "sslCertificate": "ZkFzZLY1IGRpY31kZXI=...",
            "url": "https://<webhook-uri>.com",
            "numberOfRetries": 1,
            "numberOfConcurrentCalls": 20,
            "batchSize": 5
        },
    }  
}' 

Para obter uma lista de opções de configuração de webhook e opções disponíveis para o messageType, consulte a Referência do API .

API REST da Equinix

Para criar uma assinatura para disponibilizar seus dados no Equinix API, envie uma POST solicitação para o /smartview/v2/streaming/subscriptions endpoint. No corpo da solicitação, especifique o channelType como REST. Especifique quais dados ele deve receber no messageTypeobjeto.

Exemplo de solicitação cURL:

curl -X   
POST 'https://api.equinix.com/smartview/v2/streaming/subscriptions'  
-H 'content-type: application/json'  
-H 'authorization: Bearer <token>'  
-d '{  
    "messageType": {  
        "asset": [],  
        "environmental": [  
            {  
                "accountNumber": "116710",  
                "ibx": [  
                    "LD9"  
                ],  
                "level": [  
                    "CAGE"  
                ]  
            }  
        ],  
        "power": [],  
        "meteredPower": [],  
        "systemAlert": [],  
        "customAlert": []  
    },  
    channel": {  
        "channelType": "REST",  
        "restChannelConfiguration": {  
        }  
    }  
}' 

Para obter uma lista completa das opções disponíveis para o messageType, consulte a Referência do API .

Exemplo de resposta:

HTTP/1.1 201 Created  
Location: /smartview/v2/streaming/subscriptions/0f6bdb36-e130-4924-b038-ee1785fad999

O Location cabeçalho na resposta contém o ID de assinatura necessário para consumir o feed em tempo real.