Hämta användningsdata från en resursprovider

 

Gäller för: Windows Azure Pack

Hämtar användningsdata från en resursprovider.

Förfrågan

Ersätt <UsageEndpoint> med slutpunktsadressen för rest-API:et Windows anpassad resursprovider för Azure Pack.

Metod	URI för förfrågan	HTTP-version
GET	<https:// UsageEndpoint>/usage	HTTP/1.1

URI-parametrar

I följande tabell beskrivs URI-parametrarna.

URI-parameter	Beskrivning
lastID	ID:t för den senaste posten som togs emot av användningsinsamlaren. Parametern lastID är tom för den första begäran. Detta är en bekräftelse på att användningsinsamlaren känner igen tidigare poster och därför kan ta bort dem.
BatchSize	Antalet nya poster som ska skickas till användningsinsamlaren. De nya posterna är de som följer posten som identifieras av parametern lastID . Resursprovidern kan skicka en mindre batch än vad som begärts, men inte en större.

Rubriker för begäran

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

Begärandehuvud	Beskrivning
Auktorisering: Ägarna	Krävs. Ägartoken för auktorisering.
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
EventId	Krävs. En unik identifierare som representerar varje användningspost. Det här värdet matchar värdet för URI-parametern lastID .
ResourceId	Valfritt. Om resursprovidern har flera resurser för en enskild prenumeration och användningen aggregeras en resurs kan det här fältet användas för att ange resursnamnet. Om användningen aggregeras efter prenumerations-ID används inte det här elementet.
StartTime	Krävs. Anger när insamlingen av användningsdata startades.
EndTime	Krävs. Anger när insamlingen av användningsdata avslutades.
ServiceType	Krävs. Tjänstnivån som förbrukas.
SubscriptionId	Krävs. Prenumerationsidentifieraren som användningsdata samlades in för. (GUID).
Egenskaper	Valfritt. En ordlista med namn/värde-par som används för att skicka ytterligare information om användningen.
Resurser	Krävs. En ordlista med namn/värde-par som representerar de resurser som allokerats eller förbrukats. En SQL resursprovider kan till exempel ha totalt utrymme och antal databaser som mått.

Kommentarer

Hämta användningsdata från en resursprovider anropas regelbundet av användningsinsamlaren för att samla in resursproviderns användningsinformation. Den här informationen kan användas för att generera faktureringskostnader för resursprovideranvändning. Mer information finns i Slutpunkter för anpassad resursprovider. Mer information om Windows Användningstjänst för Azure-paket finns i Windows Användningstjänst för Azure-paket.

Se även

Windows REST API-referens för användning av anpassad resursprovider i Azure Pack