Obtenir toutes les informations analytiques sur l’utilisation d’Azure

  • Article

S’applique à : Espace partenaires | Espace partenaires géré par 21Vianet | Espace partenaires de Microsoft Cloud for US Government

Comment obtenir toutes les informations d’analyse de l’utilisation d’Azure pour vos clients.

Prérequis

Demande REST

Syntaxe de la requête

Méthode URI de requête
GET {baseURL}/partner/v1/analytics/usage/azure HTTP/1.1

Paramètres URI

Paramètre Type Description
top chaîne Le nombre de lignes de données à renvoyer dans la requête. La valeur maximale et la valeur par défaut en l’absence de définition est 10000. Si la requête comporte davantage de lignes, le corps de la réponse inclut un lien sur lequel vous cliquez pour solliciter la page suivante de données.
skip int Le nombre de lignes à ignorer dans la requête. Utilisez ce paramètre pour parcourir de grands ensembles de données. Par exemple, top=10000 and skip=0 récupère les 10 000 premières lignes de données, top=10000 and skip=10000 récupère les 10 000 lignes de données suivantes, et ainsi de suite.
filter chaîne Le paramètre filter de la requête contient une ou plusieurs instructions qui filtrent les lignes de la réponse. Chaque instruction contient un champ et une valeur associés aux opérateurs ou , et les instructions peuvent être combinées à l’aide eqand de ou or.ne Vous pouvez spécifier les chaînes suivantes :

customerTenantId
customerName
subscriptionId
subscriptionName
usageDate
resourceLocation
meterCategory
meterSubcategory
meterUnit


Exemple :
.../usage/azure?filter=meterCategory eq 'Data Management'

Exemple :
.../usage/azure?filter=meterCategory eq 'Data Management' or (usageDate le cast('2018-01-01', Edm.DateTimeOffset) and usageDate le cast('2018-04-01', Edm.DateTimeOffset))
aggregationLevel chaîne Indique la plage de temps pendant laquelle récupérer les données agrégées. Il peut s’agir de l’une des chaînes suivantes : day, weekou month. Si aucune valeur n’est spécifiée, la valeur par défaut est day.

Le aggregationLevel paramètre n’est pas pris en charge sans .groupby Le aggregationLevel paramètre s’applique à tous les champs de date présents dans le groupby.
orderby string Instruction qui commande les valeurs de données de résultat pour chaque installation. La syntaxe est ...&orderby=field [order],field [order],.... Le field paramètre peut être l’une des chaînes suivantes :

customerTenantId
customerName
subscriptionId
subscriptionName
usageDate
resourceLocation
meterCategory
meterSubcategory
meterUnit


Le paramètre order est facultatif et peut être asc ou desc pour spécifier l’ordre croissant ou décroissant pour chaque champ, respectivement. Par défaut, il s’agit de asc.

Exemple :
...&orderby=meterCategory,meterUnit
groupby chaîne Une instruction qui applique l’agrégation des données uniquement sur les champs spécifiés. Vous pouvez spécifier les champs suivants :

customerTenantId
customerName
subscriptionId
subscriptionName
usageDate
resourceLocation
meterCategory
meterSubcategory
meterUnit


Les lignes de données retournées contiennent les champs spécifiés dans le groupby paramètre et la quantité.

Le groupby paramètre peut être utilisé avec le aggregationLevel paramètre .

Exemple :
...&groupby=meterCategory,meterUnit

En-têtes de requête

Pour plus d’informations, consultez En-têtes REST de l’Espace Partenaires.

Corps de demande

Aucun.

Exemple de requête

GET https://api.partnercenter.microsoft.com/partner/v1/analytics/usage/azure HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
Content-Type: application/json
Content-Length: 0

Réponse REST

En cas de réussite, le corps de la réponse contient une collection de ressources d’utilisation Azure .

Codes d’erreur et de réussite de la réponse

Chaque réponse est accompagnée d’un code d’état HTTP qui indique la réussite ou l’échec ainsi que des informations de débogage supplémentaires. Utilisez un outil de trace réseau pour lire ce code, le type d’erreur et des paramètres supplémentaires. Pour obtenir la liste complète, consultez Codes d’erreur.

Exemple de réponse

{
  "customerTenantId": "39A1DFAC-4969-4F31-AF94-D76588189CFE",
  "customerName": "A",
  "subscriptionId": "EC649980-D623-49F5-B7C1-80CC772B83A8",
  "subscriptionName": "AZURE PURCHSE SAMPLE APP",
  "usageDate": "2018-05-27T00:00:00",
  "resourceLocation": "useast",
  "meterCategory": "Data Management",
  "meterSubcategory": "None",
  "meterUnit": "10,000s",
  "quantity": 20
}

Voir aussi