获取所有 Azure 使用情况分析信息

项目
05/28/2024

适用于：合作伙伴中心 | 由世纪互联运营的合作伙伴中心 | 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 参数是可选的，可以`ascdesc`或分别指定每个字段的升序或降序。默认为 `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": "aaaabbbb-0000-cccc-1111-dddd2222eeee",
  "customerName": "A",
  "subscriptionId": "aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e",
  "subscriptionName": "AZURE PURCHSE SAMPLE APP",
  "usageDate": "2018-05-27T00:00:00",
  "resourceLocation": "useast",
  "meterCategory": "Data Management",
  "meterSubcategory": "None",
  "meterUnit": "10,000s",
  "quantity": 20
}

另请参阅

合作伙伴中心分析 - 资源

通过