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

Service:

Partner Center Rest

API-versie:

v1

Hiermee haalt u het gebruik op voor resources die eigendom zijn van een Azure-abonnement dat eigendom is van een klant van de partner.

GET https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/subscriptions/{subscription_id}/utilizations/azure

Met optionele 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}

URI-parameters

Name	In	Vereist	Type	Description
customer_id	path	True	string	De id van de klant die eigenaar is van het abonnement.
subscription_id	path	True	string	De id van het Azure-abonnement waarvoor het gebruik moet worden opgehaald.
end_time	query		string date-time	De eindtijd van het gebruik is gemeten in het factureringssysteem.
granularity	query		string	De tijdgranulariteit van het resourcegebruik. Kan dagelijks of elk uur zijn. Defalt is dagelijks.
seek_operation	query		string	De zoekbewerking die moet worden uitgevoerd. Alleen Next wordt ondersteund.
show_details	query		boolean	Als deze optie is ingesteld op true, worden de gebruiksrecords gesplitst op de niveaus van het resource-exemplaar. Als deze optie is ingesteld op onwaar, worden de gebruiksrecords samengevoegd op resourceniveau. De standaardwaarde is waar.
size	query		integer int32	Een optioneel maximum aantal records dat moet worden geretourneerd. De standaardwaarde is 1000. De geretourneerde resourceverzameling geeft een volgende koppeling op voor het geval er meer gebruiksrecords beschikbaar waren.
start_time	query		string date-time	De begintijd van het gebruik is gemeten in het factureringssysteem.

Aanvraagkoptekst

Name	Vereist	Type	Description
Authorization	True	string	Bearer-token voor autorisatie
ms-correlationid		string	Wordt intern gebruikt voor het bijhouden van aanvragen. Als er geen ms-correlationid is opgegeven, genereert de server een nieuwe voor elke aanvraag
ms-cv		string	Wordt intern gebruikt voor het bijhouden van aanvragen. Als er geen ms-cv is opgegeven, genereert de server een nieuwe voor elke aanvraag
ms-requestid		string	Wordt gebruikt voor idempotentie van aanvragen. Als er geen ms-requestid is opgegeven, genereert de server een nieuwe voor elke aanvraag

Antwoorden

Name	Type	Description
200 OK	Collections.ResourceCollection[Utilizations.AzureUtilizationRecord]	De aanvraag is geslaagd. De hoofdtekst van het antwoord bevat de resourceverzameling van azure-gebruiksrecords. Media Types: "application/json", "text/json", "application/xml", "text/xml"
204 No Content	Collections.ResourceCollection[Utilizations.AzureUtilizationRecord]	Gegevens zijn niet beschikbaar voor de opgegeven begin- en eindtijd. Er wordt geen inhoud geretourneerd met een koptekst voor opnieuw proberen. Media Types: "application/json", "text/json", "application/xml", "text/xml"
400 Bad Request		Er is een ontbrekende of ongeldige invoer. De hoofdtekst van het antwoord bevat de foutdetails. Media Types: "application/json", "text/json", "application/xml", "text/xml"
401 Unauthorized		De aanvraag is niet geverifieerd. De client moet eerst worden geverifieerd met de partner-API-service. Media Types: "application/json", "text/json", "application/xml", "text/xml"
403 Forbidden		De aanvraag is geverifieerd, maar is geweigerd omdat de beller niet over de rechten beschikt om deze aan te roepen. Media Types: "application/json", "text/json", "application/xml", "text/xml"
404 Not Found		De resource is niet gevonden of niet beschikbaar met de opgegeven invoerparameters. Media Types: "application/json", "text/json", "application/xml", "text/xml"
500 Internal Server Error		De partner-API-service of een van de bijbehorende afhankelijkheden kan niet voldoen aan de aanvraag. Bellers kunnen dit opnieuw proberen. Media Types: "application/json", "text/json", "application/xml", "text/xml"

Definities

Name	Description
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	Type	Description
attributes	ResourceAttributes
items	Utilizations.AzureUtilizationRecord[]
links	ResourceLinks
totalCount	integer

Link

Name	Type	Description
headers	System.Collections.Generic.KeyValuePair[System.String,System.String][]
method	string
uri	string

ResourceAttributes

Name	Type	Description
etag	string
objectType	string

ResourceLinks

Name	Type	Description
next	Link
previous	Link
self	Link

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

Name	Type	Description
key	string
value	string

Utilizations.AzureInstanceData

Name	Type	Description
additionalInfo	object
location	string
orderNumber	string
partNumber	string
resourceUri	string
tags	object

Utilizations.AzureResource

Name	Type	Description
category	string
id	string
name	string
region	string
subcategory	string

Utilizations.AzureUtilizationRecord

Name	Type	Description
attributes	ResourceAttributes
infoFields	object
instanceData	Utilizations.AzureInstanceData
quantity	number
resource	Utilizations.AzureResource
unit	string
usageEndTime	string
usageStartTime	string