Utiliser microsoft API Graph pour exporter les données de facturation des partenaires
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.