Créer un abonnement

Une fois que vous avez installé et configuré votre collecteur de données, créez un abonnement pour y diffuser vos données de colocation.

remarque

Vous ne pouvez utiliser qu'un seul type de canal de communication dans votre organisation. Par exemple, si vous créez un abonnement avec le canal principal IoT AWS, vous ne pourrez pas créer un autre abonnement en utilisant un autre type de canal.

Une seule chaîne est permise pour un seul abonnement.

Conditions préalables

• Avant d'appeler les API de gestion des abonnements, reportez-vous à la section intégration avec un collecteur pour configurer et configurer la destination de vos données.

• Envoyez vos informations d’identification utilisateur, votre identifiant client et votre secret client pour l’authentification OAuth2. Pour plus d'informations sur la manière d'authentifier vos demandes auprès du Equinix API, reportez-vous à la section authentification API.

AWS IoT Core

Pour créer un abonnement afin d'envoyer des données à Amazon IoT Core, envoyez POSTune demande au /smartview/v2/streaming/subscriptionspoint de terminaison. Dans le corps de la demande, spécifiez channelTypel'AS AWS_IOT_CORE et son URL dans awsIotCoreChannelConfiguration. Spécifiez les données qu'il doit recevoir dans l'messageTypeobjet.

Exemple de requête 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"  
        }  
    }  
}' 

Pour obtenir la liste complète des options disponibles pour messageType, reportez-vous à la référence API .

Webhook

Pour créer un abonnement afin d’envoyer des données à un webhook, envoyez POSTune demande au /smartview/v2/streaming/subscriptionspoint de terminaison. Dans le corps de la demande, spécifiez l' channelType AS WEBHOOK et sa configuration dans webhookChannelConfiguration. Spécifiez les données qu'il doit recevoir dans l'messageTypeobjet.

Exemple de requête 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
        },
    }  
}' 

Pour obtenir une liste des options de configuration webhook et des options disponibles pour messageType, reportez-vous à la référence API .

API REST Equinix

Pour créer un abonnement afin de rendre vos données disponibles sur Equinix API, envoyez une POST demande au /smartview/v2/streaming/subscriptionsterminal. Dans le corps de la demande, spécifiez le channelType comme REST. Spécifiez les données qu'il doit recevoir dans l'messageTypeobjet.

Exemple de requête 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": {  
        }  
    }  
}' 

Pour obtenir la liste complète des options disponibles pour messageType, reportez-vous à la référence API .

Exemple de réponse:

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

L’Locationen-tête de la réponse contient l’identifiant d’abonnement requis pour utiliser le flux en temps réel.