Utiliser microsoft API Graph pour exporter les données de facturation des partenaires

  • Article

Importante

Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .

Remarque

Cette API est disponible pour les partenaires fournisseur de solutions Cloud (CSP) uniquement pour accéder à leurs données de rapprochement facturées et non facturées pour un locataire. Pour en savoir plus sur le programme CSP, consultez Fournisseur de solutions Cloud Microsoft.

Dans le cadre de l’écosystème de l’Espace partenaires Microsoft, les partenaires directs Microsoft dans les programmes Fournisseur de solutions cloud peuvent demander à exporter leurs données facturées et non facturées vers Stockage Blob Azure de manière asynchrone. Cela élimine la nécessité de maintenir une connexion ouverte pendant des heures et de parcourir des millions de transactions de manière itérative. L’API asynchrone permet d’accéder rapidement aux données de facturation et de rapprochement dans des blocs gérables.

L’API de facturation partenaire est définie dans le sous-espace de nom microsoft.graph.partners.billingOData .

Remarque

L’utilisation évaluée quotidiennement prend normalement 24 heures pour apparaître dans l’Espace partenaires Microsoft ou être disponible via l’API.

Autorisation

Pour exporter des données de rapprochement, le principal appelant doit se trouver dans le locataire partenaire et disposer des autorisations de privilège de facturation de partenaire appropriées. L’API de facturation partenaire prend en charge les autorisations de partenaire suivantes.

Type d’autorisation Autorisation avec privilèges minimum Autorisations privilégiées plus élevées
Déléguée (compte professionnel ou scolaire) PartnerBilling.Read.All Non prise en charge.
Déléguée (compte Microsoft personnel) Non prise en charge. Non prise en charge.
Application PartnerBilling.Read.All Non prise en charge.

Confiance Zéro

Cette fonctionnalité permet aux organisations d’aligner leurs identités sur les trois principes directeurs d’une architecture Confiance nulle :

  • Vérifiez explicitement.
  • Utiliser le privilège minimum
  • Supposez une violation.

Pour en savoir plus sur Confiance nulle et d’autres façons d’aligner vos organization sur les principes directeurs, consultez le Centre d’aide Confiance nulle.

Cas d’utilisation courants

L’API de facturation des partenaires fournit des méthodes et des actions qui permettent aux partenaires directs Microsoft d’exporter leurs données de rapprochement facturées à volume élevé et leurs données d’utilisation Azure facturées et non facturées.

Données d’utilisation facturées

Cas d’utilisation API
Créer une opération d’exportation pour exporter les données d’utilisation facturées billedUsage : exportation
Interroger la mise à jour status de l’opération Opération d’obtention

Données d’utilisation non facturées

Cas d’utilisation API
Créer une opération d’exportation pour exporter des données d’utilisation non facturées unbilledUsage : export
Interroger la mise à jour status de l’opération Opération d’obtention

Données de rapprochement des factures facturées

Cas d’utilisation API
Créer une opération d’exportation pour exporter les données de rapprochement des factures facturées billedReconciliation : export
Interroger la mise à jour status de l’opération Opération d’obtention

Récupération asynchrone des données

Le téléchargement des données d’utilisation ou de rapprochement est une opération de longue durée qui se compose des opérations suivantes.

Point de terminaison d’élément de ligne d’utilisation

Utilisez l’API d’exportation billedUsage : export ou unbilledUsage : export pour accéder aux éléments de ligne de consommation facturés ou non facturés. L’API retourne un 202 Accepted code de réponse et un Location en-tête qui contient l’URL de l’opération de longue durée. Vous pouvez case activée la status de l’opération de longue durée en effectuant une requête GET à intervalles réguliers jusqu’à ce que vous receviez une status réussie avec une URL de manifeste.

Point de terminaison d’élément de ligne de non-utilisation

Utilisez l’API billedReconciliation : export pour accéder aux éléments de ligne de rapprochement des factures facturées. L’API retourne un 202 Accepted code de réponse et un Location en-tête qui contient l’URL de l’opération de longue durée. Vous pouvez case activée la status de l’opération de longue durée en effectuant une requête GET à intervalles réguliers jusqu’à ce que vous receviez une status réussie avec une URL de manifeste.

Point de terminaison status de l’opération

Jusqu’à ce que vous receviez le status de réussite, continuez à interroger l’API Get operation à intervalles réguliers. Si les données demandées ne sont pas disponibles, la réponse de l’API inclut un Retry-After en-tête qui indique le temps d’attente avant d’envoyer une autre requête. Une fois l’opération terminée, la réponse fournit également un manifeste avec les détails des fichiers générés. Le manifeste fournit un dossier de stockage à partir duquel les données de facturation réelles peuvent être téléchargées. La réponse fractionne ou partitionne les fichiers pour optimiser le débit et le parallélisme d’E/S.