Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Remarque
Cette API est disponible pour les partenaires fournisseurs de solutions Cloud (CSP) uniquement pour accéder à leurs données de rapprochement facturées et non facturées pour un client. Pour en savoir plus sur le programme CSP, consultez Fournisseur de solutions Microsoft Cloud.
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 l’exportation de leurs données d’utilisation facturée et non facturée, d’utilisation agrégée facturée et de rapprochement de facture vers Stockage Blob Azure de manière asynchrone. Ainsi, il n’est pas nécessaire de maintenir une connexion ouverte pendant des heures et de parcourir des millions de transactions de façon itérative. L’API asynchrone permet d’accéder rapidement aux données d’utilisation, d’utilisation agrégée et de réconciliation dans des tronçons gérables.
L’API de facturation des partenaires est définie dans le sous-espace microsoft.graph.partners.billingde noms OData.
Remarque
L’utilisation quotidienne prend normalement 24 heures pour apparaître dans l’Espace partenaires Microsoft ou pour ê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 des partenaires prend en charge les autorisations de partenaire suivantes.
| Type d’autorisation | Autorisation de moindre privilège | Autorisations à privilèges plus élevés |
|---|---|---|
| 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é aide les organisations à aligner leurs clients sur les trois principes directeurs d’une architecture de confiance nulle :
- Vérifiez explicitement.
- Utiliser le moindre privilège
- Supposez une violation.
Pour en savoir plus sur la Confiance nulle et d’autres moyens d’aligner votre organisation sur les principes directeurs, consultez le Centre d’orientation sur la Confiance nulle.
Cas d’utilisation courants
L’API de facturation des partenaires fournit des méthodes et des actions qui permettent aux partenaires directs de Microsoft d’exporter leurs données d’utilisation de Azure de volumes élevés facturés et non facturés, d’utilisation agrégée facturée et de rapprochement de factures.
Données d’utilisation agrégées facturées
| Cas d’utilisation | API |
|---|---|
| Créer une opération d’exportation pour exporter les données d’utilisation agrégées facturées | billedAggregatedUsage : exporter |
| Sondage pour la mise à jour du status d’une opération | Obtenir l’opération |
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 : export |
| Sondage pour la mise à jour du status d’une opération | Obtenir l’opération |
Données d’utilisation non facturées
| Cas d’utilisation | API |
|---|---|
| Créer une opération d’exportation pour exporter les données d’utilisation non facturées | unbilledUsage : exporter |
| Sondage pour la mise à jour du status d’une opération | Obtenir l’opération |
Données de rapprochement de 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 : exporter |
| Sondage pour la mise à jour du status d’une opération | Obtenir l’opération |
Données de rapprochement de factures non facturées
| Cas d’utilisation | API |
|---|---|
| Créer une opération d’exportation pour exporter les données de rapprochement des factures non facturées | unbilledReconciliation : exporter |
| Sondage pour la mise à jour du status d’une opération | Obtenir l’opération |
Récupération de données asynchrones
Le téléchargement des données d’utilisation ou de réconciliation 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 billedUsage : export ou unbilledUsage : export pour accéder aux postes de consommation facturés ou non facturés. L’API renvoie un 202 Accepted code de réponse et un Location en-tête contenant l’URL de l’opération de longue durée. Vous pouvez case activée le 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 de réussite avec une URL de manifeste.
Point de terminaison d’utilisation agrégée
Utilisez l’API d’exportation billedAggregatedUsage : export pour exporter les données d’utilisation agrégées facturées pour une facture spécifique. L’API renvoie un 202 Accepted code de réponse et un Location en-tête contenant l’URL de l’opération de longue durée. Vous pouvez case activée le 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 de réussite avec une URL de manifeste.
Point de terminaison d’élément de ligne de facturation
Utilisez l’API d’exportation : export ou UnbilledReconciliation pour accéder aux postes de rapprochement des factures facturées ou non facturées. L’API renvoie un 202 Accepted code de réponse et un Location en-tête contenant l’URL de l’opération de longue durée. Vous pouvez case activée le 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 de réussite avec une URL de manifeste.
Point de terminaison du status de l’opération
Jusqu’à ce que vous receviez le status de réussite, continuez à interroger l’API d’opération Get à 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 demande. Lorsque l’opération est terminée avec succès, la réponse fournit également un manifeste avec des détails sur les 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 divise ou partitionne les fichiers pour optimiser le débit et le parallélisme d’E/S.