Get 操作

名前空間: microsoft.graph.partners.billing

注:

この API は、クラウド ソリューション プロバイダー (CSP) パートナーがテナントの請求済みおよび未請求の調整データにのみアクセスするために使用できます。 CSP プログラムの詳細については、「 Microsoft Cloud Solution Provider」を参照してください。

操作オブジェクトのプロパティとリレーションシップを読み取ります。

この API は、次の国内クラウド展開で使用できます。

グローバル サービス 米国政府機関 L4 米国政府機関 L5 (DOD) 21Vianet が運営する中国

アクセス許可

この API を呼び出すには、次のいずれかのアクセス許可が必要です。 アクセス許可の選択方法などの詳細については、「アクセス許可」を参照してください。

アクセス許可の種類 最小特権アクセス許可 より高い特権のアクセス許可
委任 (職場または学校のアカウント) PartnerBilling.Read.All 注意事項なし。
委任 (個人用 Microsoft アカウント) サポートされていません。 サポートされていません。
アプリケーション PartnerBilling.Read.All 注意事項なし。

HTTP 要求

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

オプションのクエリ パラメーター

このメソッドは、応答のカスタマイズに役立つ OData クエリ パラメーターをサポートしていません。 一般的な情報については、「OData クエリ パラメーター」を参照してください。

要求ヘッダー

名前 説明
Authorization ベアラー {token}。 必須です。 認証と認可についての詳細をご覧ください。

要求本文

このメソッドには、要求本文を指定しません。

応答

操作が正常に完了した場合、このメソッドは応答本文に 200 OK 応答コードと microsoft.graph.partners.billing.exportSuccessOperation オブジェクトを返します。 応答本文の resourceLocation ナビゲーション プロパティは、操作の microsoft.graph.partners.billing.manifest リソースを表します。

操作が失敗した場合、このメソッドは応答コード 200 OK と、応答本文に microsoft.graph.partners.billing.failedOperation オブジェクトを返します。

操作がまだ実行されている場合、このメソッドは 200 OK 応答コードと、応答本文に microsoft.graph.partners.billing.runningOperation オブジェクトを返します。

例 1: Get 操作が成功しました

要求

次の例は、 microsoft.graph.partners.billing.exportSuccessOperation オブジェクトを返す要求を示しています。

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

応答

次の例は、正常に完了した操作の応答を示しています。

注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。

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

例 2: Get 操作が失敗しました

要求

次の例は、 microsoft.graph.partners.billing.failedOperation オブジェクトを返す要求を示しています。

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

応答

次の例は、失敗した操作の応答を示しています。

注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。

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

例 3: Get 操作がまだ実行されている

要求

次の例は、 microsoft.graph.partners.billing.runningOperation オブジェクトを返す要求を示しています。

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

応答

次の例は、まだ実行されている操作の応答を示しています。

注: ここに示す応答オブジェクトは、読みやすさのために短縮されている場合があります。

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