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 na sua organização. Por exemplo, se você criar uma assinatura com o canal do AWS IoT Core, você 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 Assinaturas, consulte Integrando com um Coletor para configurar o destino dos seus dados.

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

Núcleo de IoT da AWS

Para criar uma assinatura para enviar dados ao Amazon IoT Core, envie uma solicitação POST para o endpoint /smartview/v2/streaming/subscriptions. No corpo da solicitação, especifique o channelType como AWS_IOT_CORE e sua URL em awsIotCoreChannelConfiguration. Especifique quais dados devem ser recebidos no objeto messageType.

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 messageType, consulte a Referência da 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 a um webhook, envie uma solicitação POST para o endpoint /smartview/v2/streaming/subscriptions. No corpo da solicitação, especifique o channelType como WEBHOOK e sua configuração em webhookChannelConfiguration. Especifique quais dados devem ser recebidos no objeto messageType.

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 das opções de configuração do webhook e das opções disponíveis para messageType, consulte a Referência da API.

API REST da Equinix

Para criar uma assinatura e disponibilizar seus dados na API da Equinix, envie uma solicitação POST para o endpoint /smartview/v2/streaming/subscriptions. No corpo da solicitação, especifique o channelType como REST. Especifique quais dados devem ser recebidos no objeto messageType.

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 messageType, consulte a Referência da API.

Exemplo de resposta:

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

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