Generate Cost Details Report - Get Operation Results

リファレンス

サービス:: Cost Management

API バージョン:: 2024-08-01

指定した操作の結果を取得します。このリンクは、CostDetails 作成要求応答の場所ヘッダーで提供されます。

GET https://management.azure.com/{scope}/providers/Microsoft.CostManagement/costDetailsOperationResults/{operationId}?api-version=2024-08-01

URI パラメーター

名前	/	必須	型	説明
operationId	path	True	string	ターゲット操作 ID。
scope	path	True	string	サブスクリプション、課金アカウント、またはその他の課金スコープの ARM リソース ID。現在、リソースグループと管理グループはサポートされていません。詳細については、https://aka.ms/costmgmt/scopesを参照してください。
api-version	query	True	string minLength: 1	この操作に使用する API バージョン。

応答

名前	型	説明
200 OK	CostDetailsOperationResults	わかりました。要求は成功しました。
202 Accepted		受け入れられる。操作は進行中です。
Other Status Codes	ErrorResponse	操作が失敗した理由を説明するエラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー。

型: oauth2
フロー: implicit
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/authorize

スコープ

名前	説明
user_impersonation	ユーザーアカウントを偽装する

例

Get details of the operation result

要求のサンプル

HTTP

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.CostManagement/costDetailsOperationResults/00000000-0000-0000-0000-000000000000?api-version=2024-08-01

応答のサンプル

状態コード:: 200

{
  "id": "subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.CostManagement/costDetailsOperationResults/00000000-0000-0000-0000-000000000000",
  "name": "00000000-0000-0000-0000-000000000000",
  "status": "Completed",
  "manifest": {
    "manifestVersion": "2024-08-01",
    "dataFormat": "Csv",
    "blobCount": 1,
    "byteCount": 32741,
    "compressData": false,
    "requestContext": {
      "requestScope": "subscriptions/00000000-0000-0000-0000-000000000000",
      "requestBody": {
        "metric": "ActualCost",
        "timePeriod": {
          "start": "2020-03-01",
          "end": "2020-03-15"
        }
      }
    },
    "blobs": [
      {
        "blobLink": "https://ccmreportstorageeastus.blob.core.windows.net/armreports/00000/00000000-0000-0000-0000-000000000000?sv=2020-05-31&sr=b&sig=abcd",
        "byteCount": 32741
      }
    ]
  },
  "validTill": "2022-05-10T08:08:46.1973252Z"
}

状態コード:: 202

Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.CostManagement/costDetailsOperationResults/00000000-0000-0000-0000-000000000000?api-version=2024-08-01
Retry-After: 60

定義

名前	説明
BlobInfo	この操作によって生成される BLOB 情報。
CostDetailsDataFormat	レポートのデータ形式
CostDetailsMetricType	詳細レポートの種類。既定では ActualCost が提供されます
CostDetailsOperationResults	コストの詳細 API の実行時間の長い操作の結果。
CostDetailsStatusType	コスト詳細操作の状態
CostDetailsTimePeriod	コスト詳細レポートのデータをプルするための開始日と終了日。 API では、1 か月以下で 13 か月未満のデータのみをプルできます。
ErrorDetails	エラーの詳細。
ErrorResponse	エラー応答は、サービスが受信要求を処理できないことを示します。エラーメッセージに理由が示されます。いくつかのエラー応答: 429 TooManyRequests - 要求が調整されました。 "x-ms-ratelimit-microsoft.consumption-retry-after" ヘッダーで指定された時刻を待機した後に再試行します。 503 ServiceUnavailable - サービスは一時的に使用できません。 "Retry-After" ヘッダーで指定された時刻を待機した後に再試行します。
GenerateCostDetailsReportRequestDefinition	コスト詳細レポートの定義。

BlobInfo

Object

この操作によって生成される BLOB 情報。

名前	型	説明
blobLink	string	BLOB にリンクしてファイルをダウンロードします。
byteCount	integer (int64)	BLOB 内のバイト数。

CostDetailsDataFormat

列挙

レポートのデータ形式

値	説明
Csv	Csv データ形式。

CostDetailsMetricType

列挙

詳細レポートの種類。既定では ActualCost が提供されます

値	説明
ActualCost	実績コストデータ。
AmortizedCost	償却コストデータ。

CostDetailsOperationResults

Object

コストの詳細 API の実行時間の長い操作の結果。

名前	型	説明
error	ErrorDetails	エラーの詳細。
id	string	実行時間の長い操作の ID。
manifest.blobCount	integer (int32)	BLOB の合計数。
manifest.blobs	BlobInfo[]	この操作によって生成される BLOB 情報の一覧。
manifest.byteCount	integer (int64)	すべての BLOB の合計バイト数。
manifest.compressData	boolean	圧縮形式のデータです。
manifest.dataFormat	CostDetailsDataFormat	レポートのデータ形式
manifest.manifestVersion	string	マニフェストのバージョン。
manifest.requestContext.requestBody	GenerateCostDetailsReportRequestDefinition	Cost Details 呼び出しで提供される要求ペイロード本文
manifest.requestContext.requestScope	string	要求の要求スコープ。
name	string	実行時間の長い操作の名前。
status	CostDetailsStatusType	コスト詳細操作の状態
type	string	実行時間の長い操作の種類。
validTill	string (date-time)	レポート URL が無効になるか、UTC で期限切れになる時刻 (例: 2020-12-08T05:55:59.4394737Z)。

CostDetailsStatusType

列挙

コスト詳細操作の状態

値	説明
Completed	操作は完了です。
Failed	操作に失敗しました。
NoDataFound	操作が完了し、コストデータが見つかりません。

CostDetailsTimePeriod

Object

コスト詳細レポートのデータをプルするための開始日と終了日。 API では、1 か月以下で 13 か月未満のデータのみをプルできます。

名前	型	説明
end	string	データをプルする終了日。形式 2020-03-15 の例
start	string	データをプルする開始日。形式 2020-03-15 の例

ErrorDetails

Object

エラーの詳細。

名前	型	説明
code	string	エラーコード。
message	string	操作が失敗した理由を示すエラーメッセージ。

ErrorResponse

Object

エラー応答は、サービスが受信要求を処理できないことを示します。エラーメッセージに理由が示されます。

いくつかのエラー応答:

429 TooManyRequests - 要求が調整されました。 "x-ms-ratelimit-microsoft.consumption-retry-after" ヘッダーで指定された時刻を待機した後に再試行します。
503 ServiceUnavailable - サービスは一時的に使用できません。 "Retry-After" ヘッダーで指定された時刻を待機した後に再試行します。

名前	型	説明
error	ErrorDetails	エラーの詳細。

GenerateCostDetailsReportRequestDefinition

Object

コスト詳細レポートの定義。

名前	型	説明
billingPeriod	string	このパラメーターは、Enterprise Agreement のお客様のみが使用できます。 YearMonth (例: 202008) 形式を使用します。このパラメーターは、invoiceId パラメーターまたは timePeriod パラメーターと共に使用することはできません。要求本文に timePeriod、invoiceId、または billingPeriod パラメーターが指定されていない場合、API は現在の月のコストを返します。
invoiceId	string	このパラメーターは、Microsoft 顧客契約のお客様のみが使用できます。さらに、課金プロファイルまたは顧客スコープでのみ使用できます。このパラメーターは、billingPeriod パラメーターまたは timePeriod パラメーターと共に使用することはできません。要求本文に timePeriod、invoiceId、または billingPeriod パラメーターが指定されていない場合、API は現在の月のコストを返します。
metric	CostDetailsMetricType	詳細レポートの種類。既定では ActualCost が提供されます
timePeriod	CostDetailsTimePeriod	レポートに対して要求されたコスト詳細の特定の日付範囲。このパラメーターは、invoiceId パラメーターまたは billingPeriod パラメーターと共に使用することはできません。要求本文に timePeriod、invoiceId、または billingPeriod パラメーターが指定されていない場合、API は現在の月のコストを返します。 API では、1 か月以下で 13 か月未満のデータのみをプルできます。 timePeriod または billingPeriod または invoiceId が指定されていない場合、API は既定でオープン月の期間に設定されます

次の方法で共有

Generate Cost Details Report - Get Operation Results

URI パラメーター

応答

セキュリティ

azure_auth

スコープ

例

Get details of the operation result

要求のサンプル

応答のサンプル

定義

BlobInfo

CostDetailsDataFormat

CostDetailsMetricType

CostDetailsOperationResults

CostDetailsStatusType

CostDetailsTimePeriod

ErrorDetails

ErrorResponse

GenerateCostDetailsReportRequestDefinition

その他のリソース