获取所有 Azure 使用情况分析信息
适用于:合作伙伴中心 | 由世纪互联运营的合作伙伴中心 | Microsoft Cloud for US Government 合作伙伴中心
如何获取客户的所有 Azure 使用情况分析信息。
必备条件
- 合作伙伴中心身份验证中所述的凭据。 此方案仅支持使用用户凭据进行身份验证。
REST 请求
请求语法
方法 | 请求 URI |
---|---|
GET | {baseURL}/partner/v1/analytics/usage/azure HTTP/1.1 |
URI 参数
参数 | 类型 | 说明 |
---|---|---|
top | string | 要在请求中返回的数据行数。 如果未指定,最大值和默认值为 10000。 当查询中存在多行数据时,响应正文中包含的下一个链接可用于请求下一页数据。 |
skip | int | 要在查询中跳过的行数。 使用此参数可以浏览较大的数据集。 例如, top=10000 and skip=0 检索前 10000 行数据, top=10000 and skip=10000 检索接下来的 10000 行数据,等等。 |
filter | string | 请求中的 filter 参数包含一条或多条语句,用于在响应中筛选行。 每个语句都包含与 或 运算符关联的eq 字段和值,可以使用 或 or 组合and 语句。ne 可以指定以下字符串:customerTenantId customerName subscriptionId subscriptionName usageDate resourceLocation meterCategory meterSubcategory meterUnit 示例: .../usage/azure?filter=meterCategory eq 'Data Management' 示例: .../usage/azure?filter=meterCategory eq 'Data Management' or (usageDate le cast('2018-01-01', Edm.DateTimeOffset) and usageDate le cast('2018-04-01', Edm.DateTimeOffset)) |
aggregationLevel | string | 指定用于检索聚合数据的时间范围。 可以是以下字符串之一: day 、 week 或 month 。 如果未指定,则默认值为 day 。如果没有 groupby ,则aggregationLevel 不支持 参数。 参数 aggregationLevel 适用于 中 groupby 存在的所有日期字段。 |
orderby | string | 对每个安装的结果数据值进行排序的语句。 语法为 ...&orderby=field [order],field [order],... 。 参数 field 可以是以下字符串之一:customerTenantId customerName subscriptionId subscriptionName usageDate resourceLocation meterCategory meterSubcategory meterUnit order 参数是可选的,可以 asc desc 或 分别指定每个字段的升序或降序。 默认为 asc 。示例: ...&orderby=meterCategory,meterUnit |
groupby | string | 仅将数据聚合应用于指定字段的语句。 可以指定的字段如下所示:customerTenantId customerName subscriptionId subscriptionName usageDate resourceLocation meterCategory meterSubcategory meterUnit 返回的数据行将包含 参数和 Quantity 中指定的 groupby 字段。参数 groupby 可与 参数一 aggregationLevel 起使用。示例: ...&groupby=meterCategory,meterUnit |
请求标头
有关详细信息,请参阅合作伙伴中心 REST 标头。
请求正文
无。
请求示例
GET https://api.partnercenter.microsoft.com/partner/v1/analytics/usage/azure HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
Content-Type: application/json
Content-Length: 0
REST 响应
如果成功,响应正文将包含 Azure 使用情况 资源的集合。
响应的成功和错误代码
每个响应都带有一个 HTTP 状态代码,用于指示成功或失败以及其他调试信息。 请使用网络跟踪工具来读取此代码、错误类型和其他参数。 有关完整列表,请参阅错误代码。
响应示例
{
"customerTenantId": "39A1DFAC-4969-4F31-AF94-D76588189CFE",
"customerName": "A",
"subscriptionId": "EC649980-D623-49F5-B7C1-80CC772B83A8",
"subscriptionName": "AZURE PURCHSE SAMPLE APP",
"usageDate": "2018-05-27T00:00:00",
"resourceLocation": "useast",
"meterCategory": "Data Management",
"meterSubcategory": "None",
"meterUnit": "10,000s",
"quantity": 20
}