Udostępnij za pośrednictwem

Manage billing - Get a customer's utilization records for Azure

  • Odwołanie
Usługa:
Partner Center Rest
Wersja interfejsu API:
v1

Pobiera wykorzystanie zasobów należących do subskrypcji platformy Azure należącej do klienta partnera.

GET https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/subscriptions/{subscription_id}/utilizations/azure
Z parametrami opcjonalnymi: 
GET https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/subscriptions/{subscription_id}/utilizations/azure?start_time={start_time}&end_time={end_time}&size={size}&granularity={granularity}&show_details={show_details}&seek_operation={seek_operation}

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
customer_id
 path True

string

Identyfikator klienta, który jest właścicielem subskrypcji.
subscription_id
 path True

string

Identyfikator subskrypcji platformy Azure do pobrania użycia.
end_time
 query

string

date-time

Godzina zakończenia pomiaru wykorzystania w systemie rozliczeniowym.
granularity
 query

string

Stopień szczegółowości czasu użycia zasobów. Może być codziennie lub co godzinę. Defalt jest codziennie.
seek_operation
 query

string

Operacja wyszukiwania do wykonania. Obsługiwane są tylko następne.
show_details
 query

boolean

W przypadku ustawienia wartości true rekordy wykorzystania zostaną podzielone według poziomów wystąpienia zasobów. W przypadku ustawienia wartości false rekordy wykorzystania zostaną zagregowane na poziomie zasobu. Wartość domyślna to true.
size
 query

integer

int32

Opcjonalna maksymalna liczba rekordów do zwrócenia. Wartość domyślna to 1000. Zwrócona kolekcja zasobów określi następny link na wypadek, gdyby było dostępnych więcej rekordów użycia.
start_time
 query

string

date-time

Godzina rozpoczęcia pomiaru wykorzystania w systemie rozliczeniowym.

Nagłówek żądania

Nazwa Wymagane Typ Opis
Authorization True

string

Token elementu nośnego autoryzacji
ms-correlationid

string

Służy do śledzenia żądań wewnętrznie. Jeśli nie podano identyfikatora ms-correlationid, serwer wygeneruje nowy dla każdego żądania
ms-cv

string

Służy do śledzenia żądań wewnętrznie. Jeśli nie podano ms-cv, serwer wygeneruje nowy dla każdego żądania
ms-requestid

string

Służy do idempotentności żądań. Jeśli nie podano identyfikatora ms-requestid, serwer wygeneruje nowy dla każdego żądania

Odpowiedzi

Nazwa Typ Opis
200 OK

Collections.ResourceCollection[Utilizations.AzureUtilizationRecord]

Żądanie zakończyło się pomyślnie. Treść odpowiedzi zawiera kolekcję zasobów rekordów użycia platformy Azure.

Media Types: "application/json", "text/json", "application/xml", "text/xml"
204 No Content

Collections.ResourceCollection[Utilizations.AzureUtilizationRecord]

Dane nie są dostępne dla danego czasu rozpoczęcia i zakończenia. Żadna zawartość nie jest zwracana z nagłówkiem ponawiania próby.

Media Types: "application/json", "text/json", "application/xml", "text/xml"
400 Bad Request

Brak danych wejściowych lub nieprawidłowy. Treść odpowiedzi udostępni szczegóły błędu.

Media Types: "application/json", "text/json", "application/xml", "text/xml"
401 Unauthorized

Żądanie nie zostało uwierzytelnione. Klient musi najpierw uwierzytelnić się za pomocą usługi interfejsu API partnera.

Media Types: "application/json", "text/json", "application/xml", "text/xml"
403 Forbidden

Żądanie zostało uwierzytelnione, ale zostało odrzucone, ponieważ obiekt wywołujący nie ma praw do jego wywołania.

Media Types: "application/json", "text/json", "application/xml", "text/xml"
404 Not Found

Zasób nie został znaleziony lub niedostępny z podanymi parametrami wejściowymi.

Media Types: "application/json", "text/json", "application/xml", "text/xml"
500 Internal Server Error

Usługa interfejsu API partnera lub jedna z jego zależności nie spełniła żądania. Osoby wywołujące mogą ponowić próbę.

Media Types: "application/json", "text/json", "application/xml", "text/xml"

Definicje

Nazwa Opis
Collections.ResourceCollection[Utilizations.AzureUtilizationRecord]
Link
ResourceAttributes
ResourceLinks
System.Collections.Generic.KeyValuePair[System.String,System.String]
Utilizations.AzureInstanceData
Utilizations.AzureResource
Utilizations.AzureUtilizationRecord

Collections.ResourceCollection[Utilizations.AzureUtilizationRecord]

Nazwa Typ Opis
attributes

ResourceAttributes

items

Utilizations.AzureUtilizationRecord[]

links

ResourceLinks

totalCount

integer

Nazwa Typ Opis
headers

System.Collections.Generic.KeyValuePair[System.String,System.String][]

method

string

uri

string

ResourceAttributes

Nazwa Typ Opis
etag

string

objectType

string

Nazwa Typ Opis
next

Link

previous

Link

self

Link

System.Collections.Generic.KeyValuePair[System.String,System.String]

Nazwa Typ Opis
key

string

value

string

Utilizations.AzureInstanceData

Nazwa Typ Opis
additionalInfo

object

location

string

orderNumber

string

partNumber

string

resourceUri

string

tags

object

Utilizations.AzureResource

Nazwa Typ Opis
category

string

id

string

name

string

region

string

subcategory

string

Utilizations.AzureUtilizationRecord

Nazwa Typ Opis
attributes

ResourceAttributes

infoFields

object

instanceData

Utilizations.AzureInstanceData

quantity

number

resource

Utilizations.AzureResource

unit

string

usageEndTime

string

usageStartTime

string