Créer un abonnement

Une fois que vous avez mis en place et configuré votre collecteur de données, créez un abonnement pour lui transmettre vos données de colocation.

note

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.

Un seul canal est autorisé par 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 .

Equinix Rest API

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.