取得所有 Azure 使用情形的分析資訊

文章
07/17/2024

適用于：合作夥伴中心 |由 21Vianet 營運的合作夥伴中心 |適用于 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` 。 `aggregationLevel`若沒有 `groupby` ，則不支援參數。參數 `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": "39A1DFAC-4969-4F31-AF94-D76588189CFE",
  "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
}

另請參閱

合作夥伴中心分析 - 資源

分享方式：