获取所有客户的使用情况记录
适用于:合作伙伴中心 | Microsoft Cloud for US Government 合作伙伴中心
合作伙伴可以使用 CustomerMonthlyUsageRecord 资源集合来获取其所有客户的使用情况记录。 此资源表示所有客户的使用情况记录。 这包括具有 Microsoft Azure (MS-AZR-0145P) 订阅或 Azure 计划的客户。
必备条件
合作伙伴中心身份验证中所述的凭据。 此方案只支持使用应用凭据和用户凭据进行身份验证。
客户 ID (
customer-tenant-id
)。 如果不知道客户的 ID,可以通过选择“客户”工作区、客户列表中的客户和“帐户”,在合作伙伴中心中查找该 ID。 在客户的“帐户”页上的“客户帐户信息” 部分查找 Microsoft ID。 Microsoft ID 与客户 ID (customer-tenant-id
) 相同。
C#
获取在当前计费周期内购买了特定 Azure 服务或资源的所有客户的所有使用情况记录:
使用 IAggregatePartner.Customers 集合调用 ById () 方法。
调用 UsageRecords 属性,然后调用 Get () 或 GetAsync () 方法。
// IAggregatePartner partnerOperations; var usageRecords = partnerOperations.Customers.UsageRecords.Get();
有关示例,请参阅以下示例:
- 示例: 控制台测试应用
- 项目: PartnerSDK.FeatureSamples
- 类: GetCustomerUsageRecords.cs
REST 请求
请求语法
方法 | 请求 URI |
---|---|
GET | {baseURL}/v1/customers/usagerecords HTTP/1.1 |
请求标头
有关详细信息,请参阅合作伙伴中心 REST 标头。
请求正文
无。
请求示例
GET https://api.partnercenter.microsoft.com/v1/customers/usagerecords HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: e128c8e2-4c33-4940-a3e2-2e59b0abdc67
MS-CorrelationId: 47c36033-af5d-4457-80a4-512c1626fac4
REST 响应
如果成功,此方法在响应正文中返回 CustomerMonthlyUsageRecord 资源。
响应的成功和错误代码
每个响应都带有一个 HTTP 状态代码,用于指示成功或失败以及其他调试信息。 请使用网络跟踪工具来读取此代码、错误类型和其他参数。 有关完整列表,请参阅 错误代码。
响应示例
可以使用 isUpgraded 属性来标识具有 Azure 计划的客户。 如果 isUpgraded 的值为 true,则表示客户具有 Azure 计划。
HTTP/1.1 200 OK
Content-Length: 1120
Content-Type: application/json
MS-CorrelationId: 47c36033-af5d-4457-80a4-512c1626fac4
MS-RequestId: e128c8e2-4c33-4940-a3e2-2e59b0abdc67
Date: Tue, 17 Sep 2019 20:31:45 GMT
{
"totalCount": 25,
"items": [
{
"budget": {
"attributes": {
"objectType": "SpendingBudget"
}
},
"customerSpendingBudget": {
"attributes": {
"objectType": "SpendingBudget"
}
},
"percentUsed": 0,
"isUpgraded": false,
"resourceId": "11111111-1843-4b3b-872f-206e08a08e51",
"id": "11111111-1843-4b3b-872f-206e08a08e51",
"resourceName": "LEGACY AZURE CUSTOMER SE",
"name": "LEGACY AZURE CUSTOMER SE",
"totalCost": 0,
"currencyLocale": "fr-FR",
"usdTotalCost": 0,
"lastModifiedDate": "2019-08-01T23:00:16.57+00:00",
"attributes": {
"objectType": "CustomerMonthlyUsageRecord"
}
},
{
"budget": {
"amount": 20,
"attributes": {
"objectType": "SpendingBudget"
}
},
"percentUsed": 602.84,
"isUpgraded": true,
"resourceId": "11111111-6fb9-4b05-8f15-b3d72e0596e6",
"id": "11111111-6fb9-4b05-8f15-b3d72e0596e6",
"resourceName": "Modern Azure Customer SE",
"name": "Modern Azure Customer SE",
"totalCost": 120.5682999999995904716,
"currencyCode": "SEK",
"usdTotalCost": 12.39999999999999985235,
"lastModifiedDate": "2019-09-17T17:08:11.1433333+00:00",
"attributes": {
"objectType": "CustomerMonthlyUsageRecord"
}
},
{
"budget": {
"attributes": {
"objectType": "SpendingBudget"
}
},
"percentUsed": 0,
"isUpgraded": true,
"resourceId": "11111111-5892-4326-8541-9da1fdb233fb",
"id": "11111111-5892-4326-8541-9da1fdb233fb",
"resourceName": "Test_Test_MA20190829_14",
"name": "Test_Test_MA20190829_14",
"totalCost": 0,
"currencyCode": "GBP",
"usdTotalCost": 0,
"lastModifiedDate": "2019-09-17T17:08:11.1433333+00:00",
"attributes": {
"objectType": "CustomerMonthlyUsageRecord"
}
},
{
"budget": {
"amount": 97,
"attributes": {
"objectType": "SpendingBudget"
}
},
"percentUsed": 28.08,
"isUpgraded": true,
"resourceId": "11111111-641b-4c53-b7fc-0f2bfca8a581",
"id": "11111111-641b-4c53-b7fc-0f2bfca8a581",
"resourceName": "Modern Azure Customer UK",
"name": "Modern Azure Customer UK",
"totalCost": 27.23292827625710931604,
"currencyCode": "GBP",
"usdTotalCost": 33.280000000000001044,
"lastModifiedDate": "2019-09-17T17:08:11.1433333+00:00",
"attributes": {
"objectType": "CustomerMonthlyUsageRecord"
}
}
],
"links": {
"self": {
"uri": "/customers/usagerecords",
"method": "GET",
"headers": []
}
},
"attributes": {
"objectType": "Collection"
}
}