Opération d’obtention

Article
02/08/2024

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.

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


// Code snippets are only available for the latest version. Current version is 5.x

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Reports.Partners.Billing.Operations["{operation-id}"].GetAsync();


// THE CLI IS IN PREVIEW. NON-PRODUCTION USE ONLY
mgc reports partners billing operations get --operation-id {operation-id}



import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
	  //other-imports
)

graphClient := msgraphsdk.NewGraphServiceClientWithCredentials(cred, scopes)



operations, err := graphClient.Reports().Partners().Billing().Operations().ByOperationId("operation-id").Get(context.Background(), nil)


// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

com.microsoft.graph.models.partners.billing.Operation result = graphClient.reports().partners().billing().operations().byOperationId("{operation-id}").get();


const options = {
	authProvider,
};

const client = Client.init(options);

let operation = await client.api('/reports/partners/billing/operations/6fe687d7-1e0f-4bd6-9091-4672691f64bc')
	.get();


<?php
use Microsoft\Graph\GraphServiceClient;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);


$result = $graphServiceClient->reports()->partners()->billing()->operations()->byOperationId('operation-id')->get()->wait();


Import-Module Microsoft.Graph.Reports

Get-MgReportPartnerBillingOperation -OperationId $operationId


from msgraph import GraphServiceClient

graph_client = GraphServiceClient(credentials, scopes)


result = await graph_client.reports.partners.billing.operations.by_operation_id('operation-id').get()

Réponse

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

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


// Code snippets are only available for the latest version. Current version is 5.x

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Reports.Partners.Billing.Operations["{operation-id}"].GetAsync();


// THE CLI IS IN PREVIEW. NON-PRODUCTION USE ONLY
mgc reports partners billing operations get --operation-id {operation-id}



import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
	  //other-imports
)

graphClient := msgraphsdk.NewGraphServiceClientWithCredentials(cred, scopes)



operations, err := graphClient.Reports().Partners().Billing().Operations().ByOperationId("operation-id").Get(context.Background(), nil)


// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

com.microsoft.graph.models.partners.billing.Operation result = graphClient.reports().partners().billing().operations().byOperationId("{operation-id}").get();


const options = {
	authProvider,
};

const client = Client.init(options);

let operation = await client.api('/reports/partners/billing/operations/6fe687d7-1e0f-4bd6-9091-4672691f64bc')
	.get();


<?php
use Microsoft\Graph\GraphServiceClient;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);


$result = $graphServiceClient->reports()->partners()->billing()->operations()->byOperationId('operation-id')->get()->wait();


Import-Module Microsoft.Graph.Reports

Get-MgReportPartnerBillingOperation -OperationId $operationId


from msgraph import GraphServiceClient

graph_client = GraphServiceClient(credentials, scopes)


result = await graph_client.reports.partners.billing.operations.by_operation_id('operation-id').get()

Réponse

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

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


// Code snippets are only available for the latest version. Current version is 5.x

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.Reports.Partners.Billing.Operations["{operation-id}"].GetAsync();


// THE CLI IS IN PREVIEW. NON-PRODUCTION USE ONLY
mgc reports partners billing operations get --operation-id {operation-id}



import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
	  //other-imports
)

graphClient := msgraphsdk.NewGraphServiceClientWithCredentials(cred, scopes)



operations, err := graphClient.Reports().Partners().Billing().Operations().ByOperationId("operation-id").Get(context.Background(), nil)


// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

com.microsoft.graph.models.partners.billing.Operation result = graphClient.reports().partners().billing().operations().byOperationId("{operation-id}").get();


const options = {
	authProvider,
};

const client = Client.init(options);

let operation = await client.api('/reports/partners/billing/operations/6fe687d7-1e0f-4bd6-9091-4672691f64bc')
	.get();


<?php
use Microsoft\Graph\GraphServiceClient;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);


$result = $graphServiceClient->reports()->partners()->billing()->operations()->byOperationId('operation-id')->get()->wait();


Import-Module Microsoft.Graph.Reports

Get-MgReportPartnerBillingOperation -OperationId $operationId


from msgraph import GraphServiceClient

graph_client = GraphServiceClient(credentials, scopes)


result = await graph_client.reports.partners.billing.operations.by_operation_id('operation-id').get()

Réponse

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

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"
}

Opération d’obtention

Autorisations

Requête HTTP

Paramètres facultatifs de la requête

En-têtes de demande

Corps de la demande

Réponse

Exemples

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

Demande

Réponse

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

Demande

Réponse

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

Demande

Réponse

Commentaires

Commentaires

Ressources supplémentaires