Opération d’obtention

Espace de noms : microsoft.graph.partners.billing

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.

Lire les propriétés et les relations d’un objet d’opération .

Cette API est disponible dans les déploiements de cloud national suivants.

Service global Gouvernement des États-Unis L4 Us Government L5 (DOD) Chine gérée par 21Vianet

Autorisations

L’une des autorisations suivantes est nécessaire pour appeler cette API. Pour plus d’informations, notamment sur la façon de choisir les autorisations, voir Autorisations.

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

Requête HTTP

GET /reports/partners/billing/operations/{id}

Paramètres facultatifs de la requête

Cette méthode ne prend pas en charge les paramètres de requête OData pour vous aider à personnaliser la réponse. Pour des informations générales, consultez paramètres de la requête OData.

En-têtes de demande

Nom Description
Autorisation Porteur {token}. Obligatoire. En savoir plus sur l’authentification et l’autorisation.

Corps de la demande

N’indiquez pas le corps de la demande pour cette méthode.

Réponse

Si une opération se termine correctement, cette méthode renvoie un 200 OK code de réponse et un objet microsoft.graph.partners.billing.exportSuccessOperation dans le corps de la réponse. La propriété de navigation resourceLocation dans le corps de la réponse représente la ressource microsoft.graph.partners.billing.manifest pour l’opération.

Si une opération échoue, cette méthode renvoie un 200 OK code de réponse et un objet microsoft.graph.partners.billing.failedOperation dans le corps de la réponse.

Si une opération est toujours en cours d’exécution, cette méthode renvoie un 200 OK code de réponse et un objet microsoft.graph.partners.billing.runningOperation dans le corps de la réponse.

Exemples

Exemple 1 : Obtenir l’opération réussie

Demande

L’exemple suivant montre une requête qui renvoie un objet microsoft.graph.partners.billing.exportSuccessOperation .

GET https://graph.microsoft.com/v1.0/reports/partners/billing/operations/6fe687d7-1e0f-4bd6-9091-4672691f64bc

Réponse

L’exemple suivant montre la réponse d’une opération qui s’est terminée avec succès.

Remarque : l’objet de réponse affiché ci-après peut être raccourci pour plus de lisibilité.

HTTP/1.1 200 OK
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.partners.billing.exportSuccessOperation",
  "id": "6fe687d7-1e0f-4bd6-9091-4672691f64bc",
  "status": "succeeded",
  "createdDateTime": "2023-03-09T08:12:53",
  "lastActionDateTime": "2023-03-09T08:37:48.5046691Z",
  "resourceLocation@odata.navigationLink": "https://graph.microsoft.com/v1.0/reports/partners/billing/manifests/8fe347d7-1e0f-4bd6-9091-4672691f32db"
}

Exemple 2 : Échec de l’opération d’obtention

Demande

L’exemple suivant montre une requête qui renvoie un objet microsoft.graph.partners.billing.failedOperation .

GET https://graph.microsoft.com/v1.0/reports/partners/billing/operations/6fe687d7-1e0f-4bd6-9091-4672691f64bc

Réponse

L’exemple suivant montre la réponse d’une opération qui a échoué.

Remarque : l’objet de réponse affiché ci-après peut être raccourci pour plus de lisibilité.

HTTP/1.1 200 OK
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.partners.billing.failedOperation",
  "id": "6fe687d7-1e0f-4bd6-9091-4672691f64bc",
  "status": "failed",
  "createdDateTime": "2023-03-09T08:12:53",
  "lastActionDateTime": "2023-03-09T08:37:48.5046691Z",
  "error": {
    "message": "No data available",
    "code": "5000"
  }
}

Exemple 3 : L’opération d’obtention est toujours en cours d’exécution

Demande

L’exemple suivant montre une requête qui renvoie un objet microsoft.graph.partners.billing.runningOperation .

GET https://graph.microsoft.com/v1.0/reports/partners/billing/operations/6fe687d7-1e0f-4bd6-9091-4672691f64bc

Réponse

L’exemple suivant montre la réponse d’une opération qui est toujours en cours d’exécution.

Remarque : l’objet de réponse affiché ci-après peut être raccourci pour plus de lisibilité.

HTTP/1.1 200 OK
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.partners.billing.runningOperation",
  "id": "6fe687d7-1e0f-4bd6-9091-4672691f64bc",
  "status": "running",
  "createdDateTime": "2023-03-09T08:12:53",
  "lastActionDateTime": "2023-03-09T08:37:48.5046691Z"
}