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

Solo puede usar un tipo de canal de comunicación en su organización. Por ejemplo, si crea una suscripción con el canal principal de AWS, no podrá crear otra suscripción con 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 administración de suscripciones, consulte Integración con un recopilador para configurar 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 API para obtener más información sobre cómo autenticar sus solicitudes en Equinix API.

Núcleo IoT de AWS

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

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

Centro de eventos Azure

Para crear una suscripción de canal de Azure, póngase en contacto con el soporte técnico.

Webhook

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

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 de webhook y las opciones disponibles para messageType, consulte la Referencia de API .

API Rest de Equinix

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

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

Respuesta de muestra:

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

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