Partager via


Automatisation pour les partenaires

Microsoft Cost Management est disponible en mode natif pour les partenaires directs qui ont intégré leurs clients à un Contrat client Microsoft et acheté un plan Azure. Les partenaires et leurs clients peuvent utiliser les API Cost Management pour les tâches courantes. Pour plus d’informations sur les scénarios de non-automation, consultez Cost Management for Partners.

Remarque

Bien que des versions d’API spécifiques soient affichées dans les exemples de cet article, nous vous recommandons d’utiliser la dernière version disponible de l’API. Les plus récentes versions de l’API peuvent avoir des fonctionnalités améliorées. Les versions ultérieures de l’API prennent en charge les versions précédentes.

API Microsoft Cost Management - Fournisseurs directs et indirects

Les partenaires ayant accès aux étendues de facturation d’un locataire partenaire peuvent utiliser les API suivantes pour afficher les coûts facturés.

Les partenaires peuvent appeler des API au niveau de l’étendue de l’abonnement, quelle que soit la stratégie de coût, tant qu’ils ont accès à l’abonnement. Les autres utilisateurs ayant accès à l’abonnement, comme le client ou le revendeur, peuvent appeler les API uniquement après l’activation de la stratégie de coût par le partenaire pour le locataire client.

Pour obtenir une liste des comptes de facturation

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts?api-version=2019-10-01-preview 

Pour obtenir une liste des clients

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/customers?api-version=2019-10-01-preview 

Pour obtenir une liste des abonnements

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingSubscriptions?api-version=2019-10-01-preview 

Pour obtenir la liste des factures pour une période spécifique

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/invoices?api-version=2019-10-01-preview&periodStartDate={periodStartDate}&periodEndDate={periodEndDate} 

L’appel d’API retourne un tableau de factures qui contient des éléments similaires au code JSON suivant.

   {      "id": "/providers/Microsoft.Billing/billingAccounts/{billingAccountID}/billingProfiles/{BillingProfileID}/invoices/{InvoiceID}",      "name": "{InvoiceID}",      "properties": {        "amountDue": {          "currency": "USD",          "value": x.xx        },        ...    } 

Pour rechercher des détails d’utilisation, utilisez la valeur de champ ID retournée précédente et remplacez-la dans l’exemple suivant comme étendue.

GET https://management.azure.com/{id}/providers/Microsoft.Consumption/UsageDetails?api-version=2019-10-01 

L’exemple retourne les enregistrements d’utilisation associés à la facture spécifique.

Pour obtenir la stratégie permettant aux clients de voir les coûts

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/customers/{customerID}/policies/default?api-version=2019-10-01-preview 

Pour définir la stratégie permettant aux clients de voir les coûts

PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/customers/{customerID}/policies/default?api-version=2019-10-01-preview 

Pour obtenir l’utilisation des services Azure pour un compte de facturation

Nous vous recommandons de configurer un export pour ces scénarios. Pour plus d’informations, consultez Récupérer des jeux de données d’utilisation volumineux avec des exportations.

Pour télécharger l’utilisation des services Azure d’un client

Nous vous recommandons de configurer un export pour ce scénario également. Si vous devez télécharger les données à la demande, vous pouvez toutefois utiliser l’API Détails des coûts. Pour plus d’informations, consultez Obtenir des jeux de données à faible coût à la demande.

Pour obtenir ou télécharger la grille tarifaire des services Azure consommés

Tout d’abord, utilisez la publication suivante.

POST https://management.azure.com/providers/Microsoft.Billing/BillingAccounts/{billingAccountName}/billingProfiles/{billingProfileID}/pricesheet/default/download?api-version=2019-10-01-preview&format=csv" -verbose 

Ensuite, appelez la valeur de la propriété de l’opération asynchrone. Par exemple :

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/billingProfiles/{billingProfileID}/pricesheetDownloadOperations/{operation}?sessiontoken=0:11186&api-version=2019-10-01-preview 

L’appel GET précédent retourne le lien de téléchargement contenant la table de tarification.

Pour recevoir des coûts agrégés

POST https://management.azure.com/providers/microsoft.billing/billingAccounts/{billingAccountName}/providers/microsoft.costmanagement/query?api-version=2019-10-01 

Créer un budget pour un partenaire

PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/providers/Microsoft.CostManagement/budgets/partnerworkshopbudget?api-version=2019-10-01 

Créer un budget pour un client

PUT https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountName}/customers/{customerID}/providers/Microsoft.Consumption/budgets/{budgetName}?api-version=2019-10-01 

Supprimer un budget

DELETE https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.CostManagement/budgets/{budgetName}?api-version=2019-10-01