Créer un abonnement pour une notification
S’applique à : Windows Azure Pack
Utilisé par l’API Gestion des services pour avertir le fournisseur de ressources qu’un abonnement à un plan est en cours de création. L’objet Subscription fourni fournit des informations qui peuvent être utilisées par le fournisseur de ressources pour traiter en interne le nouvel abonnement.
Requête
Remplacez <NotificationEndpoint> par l’adresse de point de terminaison de l’API REST de notification du fournisseur de ressources personnalisée Azure Pack Windows.
Méthode |
URI de demande |
Version HTTP |
|---|---|---|
POST |
<http:// NotificationEndpoint>/abonnements |
HTTP/1.1 |
Paramètres URI
Aucun.
En-têtes de requête
Le tableau suivant décrit les en-têtes de demande obligatoires ou facultatifs.
En-tête de requête |
Description |
|---|---|
Autorisation : De base |
Obligatoire. Jeton d’autorisation de base. |
x-ms-principal-id |
Obligatoire. Identificateur du principal. |
x-ms-client-request-id |
facultatif. Identificateur de demande client. |
x-ms-client-session-id |
facultatif. Identificateur de session client. |
x-ms-principal-liveid |
facultatif. Identificateur en direct du principal. |
Corps de la demande
Le tableau suivant décrit les éléments du corps de la demande.
Nom de l'élément |
Description |
|---|---|
Abonnement |
Abonnement à créer. Pour plus d’informations, consultez Abonnement (objet de point de terminaison de notification). |
response
La réponse inclut un code d'état HTTP, un ensemble d'en-têtes de réponse et un corps de réponse.
Code d’état
Retournez le code d’état 201 (Créé) si la création d’un abonnement interne du fournisseur de ressources réussit. Le code d’état 202 (accepté) peut être retourné si l’opération s’exécute de façon asynchrone.
Pour plus d’informations sur les codes d’état, consultez Codes d’état et d’erreur (Windows Azure Pack Service Management).
En-têtes de réponse
La réponse de cette opération inclut des en-têtes HTTP standard. Tous les en-têtes standard sont conformes à la spécification du protocole HTTP/1.1.
Corps de la réponse
Le tableau suivant décrit les éléments clés du corps de la réponse :
Nom de l'élément |
Description |
|---|---|
Abonnement |
Nouvel abonnement. Pour plus d’informations, consultez Abonnement (objet de point de terminaison de notification). |
Exemple
L’exemple de code suivant montre une requête Créer un abonnement .
POST https://<NotificationEndpoint>/subscriptions HTTP/1.1
Referer: https://<Computer>:30004/subscriptions
Accept-Language: en-US
x-ms-client-request-id: 4abcdb02-cf03-4b07-a1e1-d43c4fe06a8b-2013-07-25 06:09:39Z
x-ms-client-session-id: be02e255-38de-4e86-9690-b3a3e3037e4c
x-ms-principal-id: <COMPUTER>\Administrator
x-ms-principal-liveid: <COMPUTER>\Administrator
x-ms-request-id: 60668356a6204f269a455cc3f3901a84.2013-07-25T06:09:42.8465532Z
Authorization: Basic <encoded username and password>
Content-Type: application/json; charset=utf-8
Host: <Computer>:30010
Content-Length: 438
Expect: 100-continue
{
"SubscriptionId": "685a05ed-3a6f-4c3a-b70c-924a1307834f",
"SubscriptionName": "Hosting Plan One",
"State": 0,
"LifecycleState": 0,
"LastErrorMessage": null,
"QuotaSettings": [
{
"Key": "Editions",
"Value": "[{\"displayName\":\"Default\",\"groupName\":\"Default\",\"resourceCount\":\"10\",\"resourceSize\":\"1024\",\"resourceSizeLimit\":\"1024\",\"offerEditionId\":\"070913050037\",\"groupType\":null}]"
}
],
"AdminId": "egghead@contoso.com",
"CoAdminIds": [
]
}
L’exemple de code suivant montre une réponse JSON Créer un abonnement .
{
"SubscriptionId": "685a05ed-3a6f-4c3a-b70c-924a1307834f",
"SubscriptionName": "Hosting Plan One",
"State": 0,
"LifecycleState": 0,
"LastErrorMessage": null,
"QuotaSettings": [
{
"Key": "Editions",
"Value": "[{\"displayName\":\"Default\",\"groupName\":\"Default\",\"resourceCount\":\"10\",\"resourceSize\":\"1024\",\"resourceSizeLimit\":\"1024\",\"offerEditionId\":\"070913050037\",\"groupType\":null}]"
}
],
"AdminId": "egghead@contoso.com",
"CoAdminIds": [
]
}
Remarques
Lors de l’appel de toD, l’API Gestion des services attend une minute pour obtenir une réponse. Si aucune réponse n’est reçue, l’abonnement est marqué comme étant hors synchronisation.
Les opérations asynchrones sont prises en charge. Si l’opération de création prend plus d’une minute, le fournisseur de ressources peut retourner 202 (accepté) et définir sa représentation interne de l’abonnement (objet de point de terminaison de notification). LifecycleState à l’approvisionnement. Une fois que le fournisseur de ressources a terminé l’opération de création, il doit définir sa représentation de l’abonnement (objet de point de terminaison de notification). LifecycleState à provisionné . L’API Gestion des services vérifie l’abonnement (objet de point de terminaison de notification). LifecycleState pour la fin de l’opération toutes les 10 secondes à l’aide de ToD.