Crear una suscripción

Una vez que haya instalado y configurado su recopilador de datos, cree una suscripción para transmitirle sus datos de Colocation.

nota

Sólo puede utilizar un tipo de canal de comunicación en su organización. Por ejemplo, si crea una suscripción con el canal del núcleo de AWS IoT, no podrá crear otra suscripción utilizando un tipo de canal diferente.

Sólo se permite un canal para una única suscripción.

Requisitos previos

• Antes de llamar a las API de gestión de suscripciones, consulte Integración con un recopilador para establecer y configurar el destino de sus datos.

• Envíe sus credenciales de usuario, ID de cliente y secreto de cliente para la autenticación OAuth2. Consulte Autenticación de la API para obtener más información sobre cómo autenticar sus solicitudes a la API de Equinix.

Núcleo de IoT de AWS

Para crear una suscripción para enviar datos a Amazon IoT Core, envíe una solicitud POST al punto final /smartview/v2/streaming/subscriptions. En el cuerpo de la solicitud, especifique el channelType como AWS_IOT_CORE y su URL en awsIotCoreChannelConfiguration. Especifique los datos que debe recibir en el objeto messageType.

Ejemplo de solicitud 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 obtener una lista completa de las opciones disponibles para messageType, consulte la Referencia API.

Centro de eventos Azure

Para crear una suscripción de canal Azure, póngase en contacto con el servicio de asistencia técnica (/docs/customer-support/index.md).

Webhook

Para crear una suscripción para enviar datos a un webhook, envíe una solicitud POST al punto final /smartview/v2/streaming/subscriptions. En el cuerpo de la solicitud, especifique el channelType como WEBHOOK y su configuración en webhookChannelConfiguration. Especifique los datos que debe recibir en el objeto messageType.

Ejemplo de solicitud 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 obtener una lista de las opciones de configuración del webhook y las opciones disponibles para messageType, consulte la Referencia API.

API Rest de Equinix

Para crear una suscripción para que sus datos estén disponibles desde la API de Equinix, envíe una solicitud POST al punto final /smartview/v2/streaming/subscriptions. En el cuerpo de la solicitud, especifique el channelType como REST. Especifique los datos que debe recibir en el objeto messageType.

Ejemplo de solicitud 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 obtener una lista completa de las opciones disponibles para messageType, consulte la Referencia API.

Respuesta de muestra:

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

La cabecera Location de la respuesta contiene el ID de suscripción necesario para consumir el feed en tiempo real.