Partager via

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

  • Référence
Service:
Partner Center Rest
Version d'API:
v1

Obtient l’utilisation des ressources appartenant à un abonnement Azure appartenant à un client du partenaire.

GET https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/subscriptions/{subscription_id}/utilizations/azure
Avec des paramètres facultatifs: 
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}

Paramètres URI

Nom Dans Obligatoire Type Description
customer_id
 path True

string

ID du client propriétaire de l’abonnement.
subscription_id
 path True

string

ID de l’abonnement Azure pour lequel récupérer l’utilisation.
end_time
 query

string

date-time

Heure de fin du contrôle de l’utilisation dans le système de facturation.
granularity
 query

string

Granularité du temps d’utilisation des ressources. Peut être tous les jours ou toutes les heures. Defalt est quotidien.
seek_operation
 query

string

Opération de recherche à effectuer. Only Next est pris en charge.
show_details
 query

boolean

Si la valeur est true, les enregistrements d’utilisation sont divisés par les niveaux d’instance de ressource. Si la valeur est false, les enregistrements d’utilisation sont agrégés au niveau de la ressource. La valeur par défaut est true.
size
 query

integer

int32

Nombre maximal facultatif d’enregistrements à retourner. La valeur par défaut est 1 000. La collection de ressources retournée spécifie un lien suivant dans le cas où des enregistrements d’utilisation supplémentaires étaient disponibles.
start_time
 query

string

date-time

Heure de début du contrôle de l’utilisation dans le système de facturation.

En-tête de la demande

Nom Obligatoire Type Description
Authorization True

string

Jeton du porteur d’autorisation
ms-correlationid

string

Utilisé pour le suivi des demandes en interne. Si un ms-correlationid n’est pas fourni, le serveur en génère un nouveau pour chaque requête
ms-cv

string

Utilisé pour le suivi des demandes en interne. Si un ms-cv n’est pas fourni, le serveur en génère un nouveau pour chaque requête
ms-requestid

string

Utilisé pour l’idempotency des requêtes. Si un ms-requestid n’est pas fourni, le serveur en génère un nouveau pour chaque requête

Réponses

Nom Type Description
200 OK

Collections.ResourceCollection[Utilizations.AzureUtilizationRecord]

La demande a réussi. Le corps de la réponse contient la collection de ressources des enregistrements d’utilisation Azure.

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

Collections.ResourceCollection[Utilizations.AzureUtilizationRecord]

Les données ne sont pas disponibles pour l’heure de début et de fin donnée. Aucun contenu n’est retourné avec un en-tête de nouvelle tentative.

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

Une entrée est manquante ou non valide. Le corps de la réponse fournit les détails de l’erreur.

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

La demande n’a pas été authentifiée. Le client doit d’abord s’authentifier auprès du service d’API partenaire.

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

La demande a été authentifiée, mais a été refusée, car l’appelant n’a pas les droits de l’appeler.

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

La ressource est introuvable ou non disponible avec les paramètres d’entrée donnés.

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

Le service d’API partenaire ou l’une de ses dépendances n’a pas pu répondre à la demande. Les appelants peuvent réessayer.

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

Définitions

Nom 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]

Nom Type Description
attributes

ResourceAttributes

items

Utilizations.AzureUtilizationRecord[]

links

ResourceLinks

totalCount

integer

Nom Type Description
headers

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

method

string

uri

string

ResourceAttributes

Nom Type Description
etag

string

objectType

string

Nom Type Description
next

Link

previous

Link

self

Link

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

Nom Type Description
key

string

value

string

Utilizations.AzureInstanceData

Nom Type Description
additionalInfo

object

location

string

orderNumber

string

partNumber

string

resourceUri

string

tags

object

Utilizations.AzureResource

Nom Type Description
category

string

id

string

name

string

region

string

subcategory

string

Utilizations.AzureUtilizationRecord

Nom Type Description
attributes

ResourceAttributes

infoFields

object

instanceData

Utilizations.AzureInstanceData

quantity

number

resource

Utilizations.AzureResource

unit

string

usageEndTime

string

usageStartTime

string