Récupérer un abonnement pour une notification
S’applique à : Windows Azure Pack
Utilisé par l’API Gestion des services pour récupérer les informations d’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. Remplacez <l’ID> par l’identificateur de l’abonnement à récupérer.
Méthode |
URI de demande |
Version HTTP |
|---|---|---|
GET |
<http:// NotificationEndpoint>/abonnements/<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 en direct du principal. |
Corps de la demande
Aucun.
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 200 (OK) si l’opération réussit.
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 |
Abonnement récupéré. Pour plus d’informations, consultez Abonnement (objet de point de terminaison de notification). |
Exemple
L’exemple suivant montre un abonnement récupérer un abonnement pour une demande de notification .
GET 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: 0
Expect: 100-continue
L’exemple de code suivant montre la réponse JSON pour récupérer un abonnement pour une notification.
{
"SubscriptionId": "ec66ec96-8edd-4916-be45-607959155c2a",
"SubscriptionName": null,
"State": 1,
"LifecycleState": 0,
"LastErrorMessage": null,
"QuotaSettings": [
{
"Key": "Editions",
"Value": "[{\"displayName\":\"Default\",\"groupName\":\"Default\",\"resourceCount\":\"10\",\"resourceSize\":\"1024\",\"resourceSizeLimit\":\"0\",\"offerEditionId\":\"32814080310\",\"groupType\":\"Shared\"}]"
}
],
"AdminId": "notauser@contoso.com",
"CoAdminIds": [
]
}
Remarques
La propriété QuotaSettings doit être remplie dans la réponse.
Si un fournisseur de ressources utilise une opération d’abonnement asynchrone, le fournisseur de ressources retourne 202 à partir de l’opération asynchrone, toD est alors appelé toutes les 10 secondes par l’API Gestion des services pour déterminer si l’opération est terminée.
ToD est utilisé lors d’une mise à niveau système depuis Windows Azure Pack version 1.