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

Article
05/28/2024

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

Informations d’identification, comme décrit dans Authentification auprès de l’Espace partenaires. Ce scénario prend en charge l’authentification avec les informations d’identification de l’utilisateur uniquement.

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`, `week`ou `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": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
  "customerName": "A",
  "subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
  "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

Analytique de l’Espace partenaires - Ressources

Partager via