Mettre à jour un abonnement pour une notification
S’applique à : Windows Azure Pack
Mises à jour l’état de l’abonnement pour une notification.
Requête
Remplacez <NotificationEndpoint> par l’adresse de point de terminaison de l’API REST notification du fournisseur de ressources personnalisé Azure Pack Windows. Remplacez <l’ID> par l’identificateur de l’abonnement à mettre à jour.
Méthode |
URI de demande |
Version HTTP |
|---|---|---|
PUT |
<http:// NotificationEndpoint>/subscriptions/<ID> |
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 live 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 à mettre à jour. Pour plus d’informations, consultez Abonnement (objet 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
Une opération réussie envoie le code d'état 200 (OK).
Pour plus d’informations sur les codes d’état, consultez Status and Error Codes (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 |
Abonnement mis à jour. Pour plus d’informations, consultez Abonnement (objet point de terminaison de notification). |
Exemple
L’exemple suivant montre une mise à jour d’un abonnement pour une demande de notification .
PUT https://<NotificationEndpoint>:30010/subscriptions/ec66ec96-8edd-4916-be45-607959155c2a HTTP/1.1
Referer: https://<Computer>:30004/subscriptions/ec66ec96-8edd-4916-be45-607959155c2a
Accept-Language: en-US
x-ms-client-request-id: ef2c5d93-a957-439b-9210-de52107322c1-2014-07-09 23:45:22Z
x-ms-client-session-id: a519f0aa-53e9-4522-94fd-3c55607a6b65
x-ms-principal-id: <Computer>%5cAdministrator
x-ms-request-id: 684b6822d29e4aac96fe45110881e525.2014-07-09T23:45:24.2267567Z
Authorization: Basic <encoded username and password>
Content-Type: application/json; charset=utf-8
Host: <Computer>:30010
Content-Length: 219
Expect: 100-continue
L’exemple de code suivant montre la réponse JSON pour mettre à jour un abonnement pour une notification.
{
"SubscriptionId": "ec66ec96-8edd-4916-be45-607959155c2a",
"SubscriptionName": "My very cool plan",
"State": 1,
"LifecycleState": 0,
"LastErrorMessage": null,
"QuotaSettings": null,
"AdminId": "notauser@contoso.com",
"CoAdminIds": [
]
}
Remarques
Cette API ne peut être utilisée que pour mettre à jour les éléments d’état d’un abonnement.
Lors de l’appel de TOD, l’API Gestion des services attend une minute pour une réponse. Si aucune réponse n’est reçue, l’abonnement est marqué comme étant hors synchronisation.