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 d'autre abonnement avec 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, consultez Intégration avec un collecteur pour configurer la destination de vos données.

• Veuillez fournir vos identifiants utilisateur, votre identifiant client et votre clé secrète client pour l'authentification OAuth2. Consultez la section Authentification API pour plus d'informations sur l'authentification de vos requêtes auprès de l'API Equinix.

AWS IoT Core

Pour créer un abonnement permettant d'envoyer des données à Amazon IoT Core, envoyez une requête POST au point de terminaison /smartview/v2/streaming/subscriptions (accessible via l'API /api-catalog/smartviewv2/#operation/createSubscription). Dans le corps de la requête, spécifiez AWS_IOT_CORE comme type de canal et son URL dans awsIotCoreChannelConfiguration. Indiquez le type de données à recevoir dans l'objet messageType.

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, consultez la référence API.

Azure Event Hub

Pour créer un abonnement à un canal Azure, veuillez contacter le soutien.

Webhook

Pour créer un abonnement permettant d'envoyer des données à un webhook, envoyez une requête POST au point de terminaison /smartview/v2/streaming/subscriptions. Dans le corps de la requête, spécifiez channelType comme WEBHOOK et sa configuration dans webhookChannelConfiguration. Indiquez le type de données à recevoir dans l'objet messageType.

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 une liste des options de configuration des webhooks et des options disponibles pour messageType, consultez la référence API.

API REST Equinix

Pour créer un abonnement permettant de rendre vos données disponibles via l'API Equinix, envoyez une requête POST au point de terminaison /smartview/v2/streaming/subscriptions (accessible via l'API). Dans le corps de la requête, spécifiez REST pour le paramètre channelType. Indiquez le type de données à recevoir dans l'objet messageType.

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, consultez 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'en-tête Location de la réponse contient l'identifiant d'abonnement requis pour consommer le flux en temps réel.