你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Generate Cost Details Report - Get Operation Results

参考

Service:: Cost Management

API Version:: 2023-11-01

获取指定操作的结果。 CostDetails 创建请求响应 Location 标头中提供了此链接。

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

URI 参数

名称	在	必需	类型	说明
operationId	path	True	string	目标操作 ID。
scope	path	True	string	订阅、计费帐户或其他计费范围的 ARM 资源 ID。目前不支持资源组和管理组。有关详细信息，请参阅 https://aka.ms/costmgmt/scopes。
api-version	query	True	string	要用于此操作的 API 版本。

响应

名称	类型	说明
200 OK	CostDetailsOperationResults	没问题。请求已成功。
202 Accepted		已接受。操作正在进行中。
Other Status Codes	ErrorResponse	描述操作失败原因的错误响应。

安全性

azure_auth

Azure Active Directory OAuth2 流。

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

名称	说明
user_impersonation	模拟用户帐户

示例

Get details of the operation result

Sample Request

HTTP

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

Sample Response

Status code:: 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": "2023-11-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"
}

Status code:: 202

Location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.CostManagement/costDetailsOperationResults/00000000-0000-0000-0000-000000000000?api-version=2023-11-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

此操作生成的 Blob 信息。

名称	类型	说明
blobLink	string	链接到要下载文件的 Blob。
byteCount	integer	Blob 中的字节数。

CostDetailsDataFormat

报表的数据格式

名称	类型	说明
Csv	string	Csv 数据格式。

CostDetailsMetricType

详细报表的类型。默认提供 ActualCost

名称	类型	说明
ActualCost	string	实际成本数据。
AmortizedCost	string	摊销成本数据。

CostDetailsOperationResults

成本详细信息 Api 的长时间运行操作的结果。

名称	类型	说明
error	ErrorDetails	错误的详细信息。
id	string	长时间运行的操作的 ID。
manifest.blobCount	integer	Blob 的总数。
manifest.blobs	BlobInfo[]	此操作生成的 Blob 信息的列表。
manifest.byteCount	integer	所有 Blob 中的字节总数。
manifest.compressData	boolean	压缩格式的数据。
manifest.dataFormat	CostDetailsDataFormat	报表的数据格式
manifest.manifestVersion	string	清单版本。
manifest.requestContext.requestBody	GenerateCostDetailsReportRequestDefinition	成本详细信息调用中提供的请求有效负载正文
manifest.requestContext.requestScope	string	请求的请求范围。
name	string	长时间运行的操作的名称。
status	CostDetailsStatusType	成本详细信息操作的状态
type	string	长时间运行的操作的类型。
validTill	string	报告 URL 变为无效/过期的时间（UTC 格式），例如 2020-12-08T05：55：59.4394737Z。

CostDetailsStatusType

成本详细信息操作的状态

名称	类型	说明
Completed	string	操作已完成。
Failed	string	操作失败。
NoDataFound	string	操作已完成，未找到成本数据。

CostDetailsTimePeriod

拉取成本详细报表数据的开始和结束日期。 API 仅允许拉取 1 个月或更短且不超过 13 个月的数据。

名称	类型	说明
end	string	要将数据拉取到的结束日期。示例格式 2020-03-15
start	string	要从中拉取数据的开始日期。示例格式 2020-03-15

ErrorDetails

错误的详细信息。

名称	类型	说明
code	string	错误代码。
message	string	指示操作失败原因的错误消息。

ErrorResponse

错误响应指示服务无法处理传入请求。错误消息中提供了原因。

某些错误响应：

429 TooManyRequests - 请求受到限制。等待“x-ms-ratelimit-microsoft.consumption-retry-after”标头中指定的时间后重试。
503 ServiceUnavailable - 服务暂时不可用。等待“Retry-After”标头中指定的时间后重试。

名称	类型	说明
error	ErrorDetails	错误的详细信息。

GenerateCostDetailsReportRequestDefinition

成本详细报表的定义。

名称	类型	说明
billingPeriod	string	此参数只能由企业协议客户使用。使用 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 默认为开放月份时间段