Freigeben über

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

  • Referenz
Dienst:
Partner Center Rest
API-Version:
v1

Ruft die Nutzung für Ressourcen ab, die zu einem Azure-Abonnement gehören, das einem Kunden des Partners gehört.

GET https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/subscriptions/{subscription_id}/utilizations/azure
Mit optionalen Parametern: 
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}

URI-Parameter

Name In Erforderlich Typ Beschreibung
customer_id
 path True

string

Die ID des Kunden, der das Abonnement besitzt.
subscription_id
 path True

string

Die ID des Azure-Abonnements, für das die Nutzung abgerufen werden soll.
end_time
 query

string

date-time

Die Endzeit, zu der die Auslastung im Abrechnungssystem getaktet wurde.
granularity
 query

string

Die Granularität der Ressourcennutzungszeit. Kann entweder täglich oder stündlich sein. Defalt ist täglich.
seek_operation
 query

string

Der auszuführende Suchvorgang. Nur Weiter wird unterstützt.
show_details
 query

boolean

Wenn dieser Wert auf "true" festgelegt ist, werden die Auslastungsdatensätze durch die Ressourceninstanzebenen aufgeteilt. Wenn dieser Wert auf "false" festgelegt ist, werden die Auslastungsdatensätze auf Ressourcenebene aggregiert. Der Standardwert ist true.
size
 query

integer

int32

Eine optionale maximale Anzahl von Zurückzugebenden Datensätzen. Der Standardwert ist 1000. Die zurückgegebene Ressourcenauflistung gibt einen nächsten Link an, falls mehr Auslastungsdatensätze verfügbar waren.
start_time
 query

string

date-time

Die Startzeit, zu der die Auslastung im Abrechnungssystem getaktet wurde.

Anforderungsheader

Name Erforderlich Typ Beschreibung
Authorization True

string

Autorisierungs-Bearertoken
ms-correlationid

string

Wird intern zum Nachverfolgen von Anforderungen verwendet. Wenn keine ms-correlationid angegeben wird, generiert der Server für jede Anforderung eine neue.
ms-cv

string

Wird intern zum Nachverfolgen von Anforderungen verwendet. Wenn kein ms-cv bereitgestellt wird, generiert der Server für jede Anforderung eine neue.
ms-requestid

string

Wird für die Idempotenz von Anforderungen verwendet. Wenn keine ms-requestid angegeben wird, generiert der Server für jede Anforderung eine neue anforderung.

Antworten

Name Typ Beschreibung
200 OK

Collections.ResourceCollection[Utilizations.AzureUtilizationRecord]

Die Anforderung war erfolgreich. Der Antworttext enthält die Ressourcenauflistung von Azure-Auslastungsdatensätzen.

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

Collections.ResourceCollection[Utilizations.AzureUtilizationRecord]

Daten sind für die angegebene Start- und Endzeit nicht verfügbar. Es wird kein Inhalt mit einer Wiederholungskopfzeile zurückgegeben.

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

Es fehlte eine oder eine ungültige Eingabe. Der Antworttext enthält die Fehlerdetails.

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

Die Anforderung wurde nicht authentifiziert. Der Client muss sich zuerst beim Partner-API-Dienst authentifizieren.

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

Die Anforderung wurde authentifiziert, wurde aber abgelehnt, da der Aufrufer nicht über die Rechte zum Aufrufen verfügt.

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

Die Ressource wurde mit den angegebenen Eingabeparametern nicht gefunden oder nicht verfügbar.

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

Der Partner-API-Dienst oder eine seiner Abhängigkeiten konnte die Anforderung nicht erfüllen. Anrufer versuchen dies möglicherweise erneut.

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

Definitionen

Name Beschreibung
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]

Name Typ Beschreibung
attributes

ResourceAttributes

items

Utilizations.AzureUtilizationRecord[]

links

ResourceLinks

totalCount

integer

Name Typ Beschreibung
headers

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

method

string

uri

string

ResourceAttributes

Name Typ Beschreibung
etag

string

objectType

string

Name Typ Beschreibung
next

Link

previous

Link

self

Link

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

Name Typ Beschreibung
key

string

value

string

Utilizations.AzureInstanceData

Name Typ Beschreibung
additionalInfo

object

location

string

orderNumber

string

partNumber

string

resourceUri

string

tags

object

Utilizations.AzureResource

Name Typ Beschreibung
category

string

id

string

name

string

region

string

subcategory

string

Utilizations.AzureUtilizationRecord

Name Typ Beschreibung
attributes

ResourceAttributes

infoFields

object

instanceData

Utilizations.AzureInstanceData

quantity

number

resource

Utilizations.AzureResource

unit

string

usageEndTime

string

usageStartTime

string