通过

Manage billing - Get a customer's utilization records for Azure

  • 参考
服务:
Partner Center Rest
API 版本:
v1

获取属于合作伙伴客户拥有的 Azure 订阅的资源的利用率。

GET https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/subscriptions/{subscription_id}/utilizations/azure
具有可选参数: 
GET https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/subscriptions/{subscription_id}/utilizations/azure?start_time={start_time}&end_time={end_time}&size={size}&granularity={granularity}&show_details={show_details}&seek_operation={seek_operation}

URI 参数

名称 在 必需 类型 说明
customer_id
 path True

string

拥有订阅的客户 ID。
subscription_id
 path True

string

要检索其利用率的 Azure 订阅的 ID。
end_time
 query

string

date-time

在计费系统中计量利用率的结束时间。
granularity
 query

string

资源使用时间粒度。 可以是每日或每小时。 诽谤是每天的。
seek_operation
 query

string

要执行的搜寻操作。 仅支持 Next。
show_details
 query

boolean

如果设置为 true，则利用率记录将由资源实例级别拆分。 如果设置为 false，则会在资源级别聚合利用率记录。 默认值为 true。
size
 query

integer

int32

要返回的最大记录数可选。 默认值为 1000。 返回的资源集合将指定下一个链接，以防有更多的可用利用率记录。
start_time
 query

string

date-time

在计费系统中计量利用率的开始时间。

请求头

名称 必需 类型 说明
Authorization True

string

授权持有者令牌
ms-correlationid

string

用于在内部跟踪请求。 如果未提供 ms-correlationid，则服务器将为每个请求生成一个新请求
ms-cv

string

用于在内部跟踪请求。 如果未提供 ms-cv，服务器将为每个请求生成一个新请求
ms-requestid

string

用于请求的幂等性。 如果未提供 ms-requestid，服务器将为每个请求生成一个新请求

响应

名称 类型 说明
200 OK

Collections.ResourceCollection[Utilizations.AzureUtilizationRecord]

请求成功。 响应正文包含 Azure 利用率记录资源集合。

Media Types: "application/json", "text/json", "application/xml", "text/xml"
204 No Content

Collections.ResourceCollection[Utilizations.AzureUtilizationRecord]

数据不适用于给定的开始和结束时间。 在标头重试后不会返回任何内容。

Media Types: "application/json", "text/json", "application/xml", "text/xml"
400 Bad Request

输入缺失或无效。 响应正文将提供错误详细信息。

Media Types: "application/json", "text/json", "application/xml", "text/xml"
401 Unauthorized

请求未通过身份验证。 客户端需要首先通过合作伙伴 API 服务进行身份验证。

Media Types: "application/json", "text/json", "application/xml", "text/xml"
403 Forbidden

请求已经过身份验证，但被拒绝，因为调用方无权调用该请求。

Media Types: "application/json", "text/json", "application/xml", "text/xml"
404 Not Found

找不到资源或未与给定输入参数一起使用。

Media Types: "application/json", "text/json", "application/xml", "text/xml"
500 Internal Server Error

合作伙伴 API 服务或其某个依赖项未能满足请求。 调用方可能会重试此操作。

Media Types: "application/json", "text/json", "application/xml", "text/xml"

定义

名称 说明
Collections.ResourceCollection[Utilizations.AzureUtilizationRecord]
Link
ResourceAttributes
ResourceLinks
System.Collections.Generic.KeyValuePair[System.String,System.String]
Utilizations.AzureInstanceData
Utilizations.AzureResource
Utilizations.AzureUtilizationRecord

Collections.ResourceCollection[Utilizations.AzureUtilizationRecord]

名称 类型 说明
attributes

ResourceAttributes

items

Utilizations.AzureUtilizationRecord[]

links

ResourceLinks

totalCount

integer

名称 类型 说明
headers

System.Collections.Generic.KeyValuePair[System.String,System.String][]

method

string

uri

string

ResourceAttributes

名称 类型 说明
etag

string

objectType

string

名称 类型 说明
next

Link

previous

Link

self

Link

System.Collections.Generic.KeyValuePair[System.String,System.String]

名称 类型 说明
key

string

value

string

Utilizations.AzureInstanceData

名称 类型 说明
additionalInfo

object

location

string

orderNumber

string

partNumber

string

resourceUri

string

tags

object

Utilizations.AzureResource

名称 类型 说明
category

string

id

string

name

string

region

string

subcategory

string

Utilizations.AzureUtilizationRecord

名称 类型 说明
attributes

ResourceAttributes

infoFields

object

instanceData

Utilizations.AzureInstanceData

quantity

number

resource

Utilizations.AzureResource

unit

string

usageEndTime

string

usageStartTime

string