Udostępnij za pośrednictwem

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

  • Odwołanie
Service:
Partner Center Rest
API Version:
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
With optional parameters: 
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 użycia 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 jest tylko następne.
show_details
 query

boolean

Jeśli ustawiono wartość true, rekordy wykorzystania zostaną podzielone według poziomów wystąpień 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 w przypadku, gdy dostępnych jest więcej rekordów użycia.
start_time
 query

string

date-time

Godzina rozpoczęcia pomiaru użycia 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 idempotencji żą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 lub nieprawidłowe dane wejściowe. 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 mogła zrealizować żą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