共用方式為

從 EA 價位表 API 移轉

  • 發行項

先前使用 Enterprise 報表 consumption.azure.com API 取得價位表的 EA 客戶，需要移轉到取代的 Azure Resource Manager API。 下列指示可協助您移轉，它們也會描述舊 API 與新 API 之間的任何合約差異。

注意

所有 Azure 企業報告 API 都會淘汰。 您應該儘快移轉至 Microsoft 成本管理 API。

將許可權指派給服務主體以呼叫 API

在呼叫 API 之前，您必須使用正確的許可權來設定服務主體 （SPN）。 您可以使用服務主體呼叫 API。 如需詳細資訊，請參閱 將許可權指派給成本管理 API。

呼叫價位表 API

價位表 API 會以異步方式產生價位表，並產生您下載的檔案。

呼叫新的價位表 API 時，請使用下列要求 URI：

支援的要求

您可以使用下列範圍來呼叫 API：

註冊：providers/Microsoft.Billing/billingAccounts/{billingAccountId}

依指定計費週期的計費帳戶下載

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingPeriods/{billingPeriodName}/providers/Microsoft.CostManagement/pricesheets/default/download?api-version=2023-11-01

POST 要求會傳回位置來輪詢報表產生狀態，如下列回應中所述：

範例回覆

狀態碼：202

Location: https://management.azure.com/providers/Microsoft.Billing/billingAccounts/0000000/providers/Microsoft.CostManagement/operationResults/00000000-0000-0000-0000-000000000000?api-version=2023-09-01
Retry-After: 60

狀態碼：200

{
  "status": "Completed",
  "properties": {
    "downloadUrl": "https://myaccount.blob.core.windows.net/?restype=service&comp=properties&sv=2015-04-05&ss=bf&srt=s&st=2015-04-29T22%3A18%3A26Z&se=2015-04-30T02%3A23%3A26Z&sr=b&sp=rw&spr=https&sig=G%2TEST%4B",
    "validTill": "2023-09-30T17:32:28Z"
  }
}

輪詢報告產生狀態的範例要求

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/0000000/providers/Microsoft.CostManagement/operationResults/00000000-0000-0000-0000-000000000000?api-version=2023-09-01

回應主題變更

[
        {
              "id": "enrollments/57354989/billingperiods/201601/products/343/pricesheets",
              "billingPeriodId": "201704",
            "meterId": "dc210ecb-97e8-4522-8134-2385494233c0",
              "meterName": "A1 VM",
              "unitOfMeasure": "100 Hours",
              "includedQuantity": 0,
              "partNumber": "N7H-00015",
              "unitPrice": 0.00,
              "currencyCode": "USD"
        },
        {
              "id": "enrollments/57354989/billingperiods/201601/products/2884/pricesheets",
              "billingPeriodId": "201404",
            "meterId": "dc210ecb-97e8-4522-8134-5385494233c0",
              "meterName": "Locally Redundant Storage Premium Storage - Snapshots - AU East",
              "unitOfMeasure": "100 GB",
              "includedQuantity": 0,
              "partNumber": "N9H-00402",
              "unitPrice": 0.00,
              "currencyCode": "USD"
        },
        ...
]

新的回應變更

價位表屬性如下所示：

名稱 類型 說明
basePrice 字串 客戶登入時或服務計量 GA 啟動時的單價，如果是登入之後，則為單價。

它適用於 Enterprise 合約 使用者
currencyCode 字串 簽署 Enterprise 合約的貨幣
effectiveEndDate 字串 價位表計費週期的有效結束日期
effectiveStartDate 字串 價位表計費週期的有效開始日期
enrollmentNumber 字串 EA 計費帳戶的唯一標識符。
includedQuantity 字串 EA 客戶有權取用的特定服務數量，而不需要累加費用。
marketPrice 字串 指定產品或服務的目前定價。 此價格沒有任何交涉，且以您的 Microsoft 合約類型為基礎。

針對 PriceType 使用量，市場價格會反映為隨用隨付價格。

對於 PriceType 儲蓄方案，市場價格會反映相應承諾期限的隨用隨付價格之上的儲蓄方案權益。

對於 PriceType ReservedInstance，市場價格會反映一或三年承諾用量的總價格。

注意：對於沒有交涉的EA客戶，市場價格可能會四捨五入到與單價不同的小數位數。
meterCategory 字串 計量的分類類別名稱。 例如，雲端服務、網路等。
meterId 字串 計量的唯一標識碼
meterName 字串 計量的名稱。 計量代表 Azure 服務的可部署資源。
meterRegion 字串 服務計量可供使用之 Azure 區域的名稱。
meterSubCategory 字串 計量的子分類類別名稱。
meterType 字串 計量類型的名稱
partNumber 字串 與計量相關聯的元件編號
priceType 字串 產品的價格類型。 例如，具有隨用隨付率的 Azure 資源，其 priceType 為使用量。 其他價格類型包括 ReservedInstance 和 Savings 方案。
product 字串 產生費用的產品名稱。
productId 字串 已耗用計量之產品的唯一識別碼。
serviceFamily 數值 Azure 服務的類型。 例如，計算、分析和安全性。
skuId 字串 SKU 的唯一標識碼
術語 字串 Azure 儲蓄方案或保留期限的期限長度 – 一年或三年（P1Y 或 P3Y）
unitOfMeasure 字串 如何測量服務的使用量
unitPrice 字串 指定產品或服務計費時的每一單價，包括以市場價格為基礎的任何談判折扣。

對於 PriceType ReservedInstance，單價會反映一或三年承諾用量的總成本，包括折扣。

注意：若服務在各層之間的價格有所差異，單價與使用量詳細資料下載中的有效價格就會不同。

如果服務是多層式定價，則有效價格是各層的混合費率，而且不會顯示階層特定的單價。 混合價格或有效價格是跨越多層的已取用數量的凈價格（其中每一層都有特定的單價）。

相關內容