取得訂用帳戶的所有每月使用記錄

  • 發行項

適用于：合作夥伴中心 |適用于 Microsoft Cloud for US Government 的合作夥伴中心

您可以使用 AzureResourceMonthlyUsageRecord 資源集合來取得客戶訂用帳戶內的服務清單及其相關聯的評分使用量資訊。

必要條件

  • 認證，如合作夥伴中心驗證所述。 此案例支援使用獨立應用程式和 App+使用者認證進行驗證。

  • 客戶識別碼 (customer-tenant-id)。 如果您不知道客戶的識別碼，您可以選取 [客戶] 工作區，然後從客戶清單中選取客戶，然後從客戶清單中查詢該識別碼，然後查閱合作夥伴中心。 在客戶的 [帳戶] 頁面上，尋找 [客戶帳戶資訊] 區段中的 [Microsoft 識別碼] 。 Microsoft 識別碼與客戶識別碼 () customer-tenant-id 相同。

  • 訂閱識別碼。

此 API 僅支援 Microsoft Azure (MS-AZR-0145P) 訂用帳戶。 如果您使用 Azure 方案，請參閱 改為依計量取得訂用帳戶的使用量資料 。

C#

若要取得訂用帳戶的資源使用量資訊：

  1. 使用 IAggregatePartner.Customers 集合來呼叫 ById () 方法。

  2. 呼叫 Subscriptions 屬性和 UsageRecords，然後呼叫 Resources 屬性。

  3. 呼叫 Get () 或 GetAsync () 方法。

// IAggregatePartner partnerOperations;
// var selectedCustomerId as string;
// var selectedSubscriptionID as string;

var usageRecords = partnerOperations.Customers.ById(selectedCustomerId).Subscriptions.ById(selectedSubscriptionId).UsageRecords.Resources.Get();

如需範例，請參閱下列內容：

REST 要求

要求的語法

方法 要求 URI
GET {baseURL}/v1/customers/{customer-tenant-id}/subscriptions/{id-for-subscription}/usagerecords/resources HTTP/1.1

URI 參數

下表列出取得評等使用量資訊所需的查詢參數。

名稱 類型 必要 描述
customer-tenant-id guid Y 與客戶對應的 GUID。
subscription-id guid Y 對應至訂用帳戶的 GUID。

要求標頭

如需詳細資訊，請參閱合作夥伴中心 REST 標頭。

要求本文

無。

要求範例

GET https://api.partnercenter.microsoft.com/v1/customers/{customer-tenant-id}/subscriptions/{id-for-subscription}/usagerecords/resources HTTP/1.1
Authorization: Bearer <token>
Accept: application/json
MS-RequestId: 65b26053-37d0-4303-9fd1-46ad8012bcb6
MS-CorrelationId: 47c36033-af5d-4457-80a4-512c1626fac4

REST 回應

如果要求成功，此方法會在回應本文中傳回 AzureResourceMonthlyUsageRecord 資源的集合。

回應成功和錯誤碼

每個回應都隨附 HTTP 狀態碼，會指出成功與否以及其他的偵錯資訊。 請使用網路追蹤工具來讀取此錯誤碼、錯誤類型和其他參數。 如需完整清單，請參閱錯誤碼。

回應範例

HTTP/1.1 200 OK
Content-Length: 12014
Content-Type: application/json
MS-CorrelationId: 648a26a4-a63e-459f-844b-4f29d7913353
MS-RequestId: be82a8ba-4a53-49f7-8313-b033c058687e
Date: Tue, 10 Nov 2015 19:09:59 GMT

{
    "totalCount":20,
    "items":[{
        "category":"Storage",
        "subcategory":"LOCALLY REDUNDANT",
        "quantityUsed":0.151287527825352,
        "unit":"GB",
        "id":"2a2419c0-cefe-46b2-8004-8eb002ad606c",
        "name":"Azure Resource 1",
        "totalCost":0.195779159290613,
        "currencyLocale":"en-US",
        "attributes":{
            "objectType":"AzureResourceMonthlyUsageRecord"
        }
    },
    {
        "category":"Remote App",
        "subcategory":"Remote App",
        "quantityUsed":0.932546524299563,
        "unit":"GB",
        "id":"7e4099c8-2b3d-41a6-a1bd-d5cf315989b2",
        "name":"Azure Resource 2",
        "totalCost":0.920983775016379,
        "currencyLocale":"en-US",
        "attributes":{
            "objectType":"AzureResourceMonthlyUsageRecord"
        }
    }],
    "links":{
        "self":{
            "uri":"/v1/customers/<customer-tenant-id>/subscriptions/<id-for-subscription>%20/usagerecords",
            "method":"GET",
            "headers":[]
        }
    },
    "attributes":{
        "objectType":"Collection"
    }
}