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 AWS IoT Core, vous ne pourrez pas créer un autre abonnement en utilisant un type de canal différent.

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 la destination de vos données.

• Soumettez vos informations d'identification utilisateur, ID client et secret client pour l'authentification OAuth2. Reportez-vous à authentification API pour plus d'informations sur la manière d'authentifier vos requêtes auprès de Equinix API.

AWS IoT Core

Pour créer un abonnement pour envoyer des données à Amazon IoT Core, envoyez POSTune demande au /smartview/v2/streaming/subscriptionspoint de terminaison. Dans le corps de la requête, 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 une liste complète des options disponibles pour messageType, reportez-vous à la référence API .

Azure Event Hub

Pour créer un abonnement au canal Azure, veuillez contacter le support.

Webhook

Pour créer un abonnement pour 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 à partir de Equinix API, envoyez POSTune demande au /smartview/v2/streaming/subscriptionsnoeud final. Dans le corps de la demande, spécifiez channelTypecomme 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 une 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'ID d'abonnement requis pour consommer le flux en temps réel.