Hämta användningssammanfattningen för en prenumeration

Artikel
08/24/2015

Gäller för: Windows Azure Pack

Anropas av Service Management-API:et för att hämta en sammanfattning av prenumerationsanvändningsdata som genereras av en resursprovider. Den här informationen kan användas av ett faktureringskort för att beräkna faktureringskostnader. Mer information finns i Windows Användningstjänst för Azure Pack.

Förfrågan

Ersätt <NotificationEndpoint> med slutpunktsadressen för rest-API:et Windows Azure Pack Custom Resource Provider Notification. Ersätt <ID> med identifieraren för användningssammanfattningen som ska hämtas.

Metod	URI för förfrågan	HTTP-version
GET	<http:// NotificationEndpoint>/subscriptions/<Id>/usagesummary	HTTP/1.1

URI-parametrar

Inga.

Rubriker för begäran

I följande tabell beskrivs obligatoriska och valfria begärandehuvuden.

Begärandehuvud	Beskrivning
Auktorisering: Grundläggande	Krävs. Den grundläggande auktoriseringstoken.
x-ms-principal-id	Krävs. Huvudidentifieraren.
x-ms-client-request-id	Valfritt. Identifierare för klientbegäran.
x-ms-client-session-id	Valfritt. Klientsessionsidentifieraren.
x-ms-principal-liveid	Valfritt. Live-huvudidentifieraren.

Begärandetext

Inga.

Svarsåtgärder

Svaret innehåller en HTTP-statuskod, en uppsättning svarshuvuden och en svarstext.

Statuskod

En lyckad åtgärd returnerar statuskod 200 (OK).

Information om statuskoder finns i Status- och felkoder (Windows Azure Pack Service Management).

Svarsrubriker

Svaret för den här åtgärden innehåller HTTP-standardhuvuden. Alla standardhuvuden överensstämmer med http/1.1-protokollspecifikationen.

Svarstext

I följande tabell beskrivs de viktigaste elementen i svarstexten:

Elementnamn	Beskrivning
ServiceUsageSummary	Den hämtade användningssammanfattningen. Mer information finns i ServiceUsageSummary (Notification Endpoint Object).

Exempel

I följande kodexempel visas en begäran om att hämta prenumerationsanvändningssammanfattning .

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

I följande kodexempel visas JSON-svaret Hämta prenumerationsanvändningssammanfattning .

{
  "ServiceName": "SqlServer",
  "ServiceDisplayName": "Sql Server",
  "RetrievedSuccessfully": false,
  "ErrorMessage": null,
  "Usages": [

  ]
}

Kommentarer

När du anropar TBD väntar Service Management-API:et en minut på ett svar. Om inget svar tas emot markeras prenumerationen som osynkroniserad.

Se även

Windows REST API-referens för meddelanden för anpassad resursprovider i Azure Pack

Dela via