Récupérer le résumé de l’utilisation d’un abonnement
S’applique à : Windows Azure Pack
Appelé par l’API Gestion des services pour récupérer un résumé des données d’utilisation d’abonnement générées par un fournisseur de ressources. Ces informations peuvent être utilisées par un adaptateur de facturation pour calculer les coûts de facturation. Pour plus d’informations, consultez Windows Service d’utilisation d’Azure Pack.
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 du résumé de l’utilisation à récupérer.
Méthode |
URI de demande |
Version HTTP |
|---|---|---|
GET |
<http:// NotificationEndpoint>/abonnements/<Id>/utilisationummary |
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
Une opération réussie envoie le code d'état 200 (OK).
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 |
|---|---|
ServiceUsageSummary |
Résumé de l’utilisation récupérée. Pour plus d’informations, consultez ServiceUsageSummary (Objet de point de terminaison de notification). |
Exemple
L’exemple de code suivant montre une demande De résumé de l’utilisation de l’abonnement .
GET https://<NotificationEndpoint>/subscriptions/685a05ed-3a6f-4c3a-b70c-924a1307834f/usagesummary HTTP/1.1
Referer: https://<Computer>:30004/subscriptions/685a05ed-3a6f-4c3a-b70c-924a1307834f/usagesummaries
Accept: application/json
Accept-Language: en-US
x-ms-client-request-id: 82610bdb-14d6-4e2a-99a0-9930d879b300-2013-07-25 06:14:56Z
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: 37739ad5c7ab4654b6bb5d5e211f974e.2013-07-25T06:14:57.7649169Z
Authorization: Basic <encoded username and password>
Host: <Computer>:30010
L’exemple de code suivant montre une réponse JSON De résumé de l’utilisation de l’abonnement .
{
"ServiceName": "SqlServer",
"ServiceDisplayName": "Sql Server",
"RetrievedSuccessfully": false,
"ErrorMessage": null,
"Usages": [
]
}
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.