本文可協助您了解 Enterprise 合約 (EA) 與 Microsoft 客戶合約 (MCA) 帳戶之間的資料結構、API 和其他系統整合差異。 成本管理同時支援這兩種帳戶類型的 API。 請先檢閱設定 Microsoft 客戶合約的計費帳戶一文,再繼續進行。
具有現有 EA 帳戶的組織在設定 MCA 帳戶時,應該檢閱本文。 以前在更新 EA 帳戶時,只需要進行最少量的一些工作就能從舊註冊移至新註冊。 不過,移轉至 MCA 帳戶則需要額外的工作。 需要進行額外的工作是因為基礎計費子系統有所變更,因此會影響所有成本相關的 API 和服務供應項目。
MCA API 和整合
MCA API 和新的整合可讓您:
- 透過原生 Azure API 獲得完整的 API 可用性。
- 在單一計費帳戶中設定多個發票。
- 存取包含 Azure 服務使用量、第三方 Marketplace 使用量及 Marketplace 購買的綜合 API。
- 使用 Cost Management 檢視跨計費設定檔的成本 (與註冊相同)。
- 存取新的 API 以顯示成本、在成本超過預先定義的閾值時收到通知,並自動匯出原始資料。
移轉檢查清單
下列項目可協助您轉換至 MCA API。
- 熟悉新的 Microsoft 客戶合約計費帳戶。
- 確定您使用的 API,並在下一節查看哪些 API 已遭到取代。
- 熟悉 Azure Resource Manager REST API。
- 如果您尚未使用 Azure Resource Manager API,請使用 Microsoft Entra ID 註冊您的用戶端應用程式。
- 將 Microsoft Entra 應用程式註冊期間建立的應用程式,授與計費帳戶的讀取權限,方法是使用存取控制 (IAM)。
- 更新所有程式碼,以使用 Microsoft Entra 驗證。
- 更新任何程式設計程式碼,以使用 MCA API 呼叫來取代 EA API 呼叫。
- 將錯誤處理機制更新為使用新的錯誤碼。
- 檢閱其他整合方案,例如 Power BI,以執行其他所需的動作。
EA API 被 MCA API 取代
EA API 使用 API 金鑰來進行驗證和授權。 MCA API 使用 Microsoft Entra 驗證。
注意
所有 Azure 企業版報告 API 都已淘汰。 您應該儘快移轉至 Microsoft 成本管理 API。
| 目的 | EA API | MCA API |
|---|---|---|
| 餘額與信用額度 | /balancesummary | Microsoft.Billing/billingAccounts/billingProfiles/availableBalanceussae |
| 使用量 (JSON) | /usagedetails /usagedetailsbycustomdate |
選擇成本詳細資料解決方案 |
| 使用量 (CSV) | /usagedetails/download /usagedetails/submit |
選擇成本詳細資料解決方案 |
| 「Marketplace」使用量 (CSV) | /marketplacecharges /marketplacechargesbycustomdate |
選擇成本詳細資料解決方案 |
| 計費期間 | /billingperiods | Microsoft.Billing/billingAccounts/billingProfiles/invoices |
| 價位表 | /價格表 | Microsoft.Billing/billingAccounts/billingProfiles/pricesheet/default/download format=json or csv Microsoft.Billing/billingAccounts/…/billingProfiles/…/invoices/… /pricesheet/default/download format=json or csv Microsoft.Billing/billingAccounts/../billingProfiles/../providers/Microsoft.Consumption/pricesheets/download |
| 預約購買 | /reservationcharges | Microsoft.Billing/billingAccounts/billingProfiles/transactions |
| 預訂建議 | /SharedReservationRecommendations /單一預訂建議 |
Microsoft.Consumption/reservationRecommendations |
| 預留資源使用 | /預訂詳情 /reservationsummaries |
Microsoft.Consumption/reservationDetails Microsoft.Consumption/reservationSummaries |
¹ Azure 服務和第三方 Marketplace 的使用量可透過使用量詳細資料 API 來獲得。
以下是 MCA 計費帳戶可用的 API:
| 目的 | Microsoft 客戶合約 (MCA) API |
|---|---|
| 計費帳戶² | Microsoft.Billing/billingAccounts |
| 計費設定檔² | Microsoft.Billing/billingAccounts/billingProfiles |
| 發票區段² | Microsoft.Billing/billingAccounts/invoiceSections |
| 發票 | Microsoft.Billing/billingAccounts/billingProfiles/invoices |
| 計費訂閱方案 | {scope}/billingSubscriptions |
² API 會傳回物件 (亦即範圍) 清單,Azure 入口網站中的成本管理體驗以及 API 會在這些範圍中運作。 如需成本管理範圍的詳細資訊,請參閱了解並使用範圍。
如果您使用任何現有的 EA API,則必須將其更新為支援 MCA 計費帳戶。 下表顯示其他整合變更:
| 目的 | 舊供應項目 | 新產品或服務 |
|---|---|---|
| Power BI | Microsoft Consumption Insights 內容套件與連接器 | Azure Consumption Insights 連接器 |
用來取得餘額和信用額度的 API
Get Balance Summary 用來提供下列項目的每月摘要:
- 餘額
- 新增購買商品
- Azure Marketplace 服務費用
- 調整
- 服務額外費用
所有 Consumption API 已被取代為使用 Microsoft Entra ID 進行驗證和授權的原生 Azure API。 如需如何呼叫 Azure REST API 的詳細資訊,請參閱開始使用 REST。
取得餘額摘要 API 會由 Microsoft.Billing/billingAccounts/billingProfiles/availableBalance API 加以取代。
若要使用可用餘額 API 來取得可用餘額:
| 方法 | 要求 URI |
|---|---|
| GET | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/availableBalances?api-version=2018-11-01-preview |
用來取得成本和使用量的 API
使用下列 API 來取得 Azure 服務使用量、第三方 Marketplace 使用量和其他 Marketplace 購買成本的每日明細。 下列適用於 Azure 服務和第三方 Marketplace 使用量的個別 API 已合併。 舊的 API 會取代為匯出或成本詳細資料 API。 若要選擇適合您的解決方案,請參閱選擇成本詳細資料解決方案。 這兩種解決方案都提供相同的 Cost Details 檔案,並且在資料中包含 Marketplace 購買項目;而這些項目先前截至目前為止,只會顯示在餘額摘要中。
與所有成本管理 API 一樣,匯出和成本詳細資料 API 也可以在多個範圍中使用。 對於開立發票的成本,例如您過去通常會在註冊層級收到的成本,請使用計費設定檔範圍。 如需成本管理範圍的詳細資訊,請參閱了解並使用範圍。
| 類型 | 識別碼格式 |
|---|---|
| 計費帳戶 | /Microsoft.Billing/billingAccounts/{billingAccountId} |
| 帳單設定檔 | /Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId} |
| 訂用帳戶 | /subscriptions/{subscriptionId} |
| 資源群組 | /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName} |
新的成本詳細資料資料集可透過匯出和成本詳細資料 API 取得,而且其中有一些屬性名稱已變更。 下表會顯示對應的屬性。
| 舊屬性 | 新屬性 | 備註 |
|---|---|---|
| AccountId | N/A | 不會追蹤訂用帳戶建立者。 使用 invoiceSectionId (與 departmentId 相同)。 |
| AccountNameAccountOwnerId 和 AccountOwnerEmail | N/A | 不會追蹤訂用帳戶建立者。 使用 invoiceSectionName (與 departmentName 相同)。 |
| 附加資訊 | 附加資訊 | |
| 分開計費 | isAzureCreditEligible | 屬性相反。 如果 "isAzureCreditEnabled" 為 true,則 "ChargesBilledSeparately" 會是 false。 |
| 消耗量 | 數量 | |
| ConsumedService | 已消耗的服務 | 確切的字串值可能會不同。 |
| ConsumedServiceId | 無 | |
| CostCenter | 成本中心 | |
| 日期和使用開始日期 | 日期 | |
| 日 | 無 | 從日期剖析日。 |
| 部門編號 | 發票區段識別碼 (invoiceSectionId) | 確切的值會不同。 |
| 部門名稱 | 發票部分名稱 | 確切的字串值可能會不同。 如有需要,請將發票區段設定為符合部門。 |
| ExtendedCost 和 Cost | costInBillingCurrency | |
| InstanceId | 資源ID | |
| 是定期費用 | 無 | |
| 地點 | 位置 | |
| 計量類別 | 計量類別 | 確切的字串值可能會不同。 |
| MeterId | meterId | 確切的字串值會不同。 |
| 儀表名稱 | 儀表名稱 | 確切的字串值可能會不同。 |
| MeterRegion | meterRegion | 確切的字串值可能會不同。 |
| MeterSubCategory | meterSubCategory | 確切的字串值可能會不同。 |
| 月 | 無 | 從日期解析月份。 |
| 優惠名稱 | 無 | 使用 publisherName 和 productOrderName。 |
| OfferID | 無 | |
| 訂單編號 | 無 | |
| 零件編號 | 無 | 使用 meterId 和 productOrderName 來唯一識別價格。 |
| 方案名稱 | productOrderName | |
| 產品 | 產品 | |
| ProductId | productId | 確切的字串值會不同。 |
| 發行者名稱 | 出版者名稱 | |
| ResourceGroup | 資源群組名稱 | |
| ResourceGuid | meterId | 確切的字串值會不同。 |
| 資源位置 | 資源位置 | |
| ResourceLocationId | 無 | |
| ResourceName | 無 | |
| 資源費率 | 有效價格 | |
| 服務管理員ID | N/A | |
| ServiceInfo1 | serviceInfo1 | |
| ServiceInfo2 | serviceInfo2 | |
| ServiceName | 計量類別 | 確切的字串值可能會不同。 |
| 服務層級 | meterSubCategory | 確切的字串值可能會不同。 |
| StoreServiceIdentifier | N/A | |
| SubscriptionGuid | 訂閱ID (subscriptionId) | |
| 訂閱識別碼 (SubscriptionId) | 訂閱ID (subscriptionId) | |
| 訂閱名稱 | 訂閱名稱 | |
| 標籤 | 標記 | tags 屬性會套用至根物件,而非套用至 properties 巢狀屬性。 |
| 度量單位 | 計量單位 | 確切的字串值會不同。 |
| 使用結束日期 | 日期 | |
| 年 | 無 | 從日期解析年份。 |
| (新增) | billingCurrency | 費用的計價貨幣。 |
| (新增) | billingProfileId | 帳單設定檔的唯一識別碼 (與註冊時相同)。 |
| (新增) | billingProfileName | 帳單設定檔的名稱 (與註冊相同)。 |
| (新增) | 收費類型 | 用來區分 Azure 服務使用量、Marketplace 使用量和購買。 |
| (新增) | invoiceId | 發票的唯一識別碼。 目前開啟月份為空白。 |
| (新增) | 出版商類型 | 購買的發行者類型。 空白供使用。 |
| (新增) | serviceFamily | 購買的類型。 空白以供使用。 |
| (新增) | 服務期結束日期 | 已購買服務的結束日期。 |
| (新增) | 服務期間開始日期 | 已購買服務的開始日期。 |
計費週期 API 已由發票 API 加以取代
MCA 計費帳戶不會使用計費週期。 相反地,他們使用發票來釐定特定計費週期的成本。 計費週期 API 已由發票 API 加以取代。 所有 Consumption API 已被取代為使用 Microsoft Entra ID 進行驗證和授權的原生 Azure API。 如需如何呼叫 Azure REST API 的詳細資訊,請參閱開始使用 REST。
若要使用發票 API 來取得發票:
| 方法 | 要求 URI |
|---|---|
| GET | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/invoices?api-version=2018-11-01-preview |
Price Sheet API
本節將討論現有的價位表 API,並針對 Microsoft 客戶合約提供移至價位表 API 的建議。 文中也會討論適用於 Microsoft 客戶合約的價位表 API,並說明價位表中的欄位。 Enterprise 取得價位表和 Enterprise 取得計費週期 API 已由適用於 Microsoft 客戶合約的價位表 API (Microsoft.Billing/billingAccounts/billingProfiles/pricesheet) 加以取代。 新 API 會以非同步 REST 格式同時支援 JSON 和 CSV 格式。 所有 Consumption API 都已被使用 Microsoft Entra ID 進行驗證和授權的原生 Azure API 取代。 如需如何呼叫 Azure REST API 的詳細資訊,請參閱開始使用 REST。
企業級計費 API
您使用企業版計費 API 搭配企業註冊來取得價格和計費週期資訊。 使用 Microsoft Entra Web 權杖進行驗證和授權。
若要使用 Price Sheet 和 Billing Period API,取得指定 Enterprise Enrollment 的適用價格:
| 方法 | 要求 URI |
|---|---|
| GET | https://consumption.azure.com/v2/enrollments/{enrollmentNumber}/pricesheet |
| GET | https://consumption.azure.com/v2/enrollments/{enrollmentNumber}/billingPeriods/{billingPeriod}/pricesheet |
適用於 Microsoft 客戶合約的價位表 API
使用適用於 Microsoft 客戶合約的價位表 API 來檢視所有 Azure 使用量和 Marketplace 使用量服務的價格。 針對帳單設定檔所顯示的價格適用於屬於該帳單設定檔的所有訂用帳戶。
使用價位表 API 來以 CSV 格式檢視所有 Azure 使用量服務價位表資料:
| 方法 | 要求 URI |
|---|---|
| POST | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/providers/Microsoft.CostManagement/pricesheet/default/download?api-version=2018-11-01-preview&startDate=2019-01-01&endDate=2019-01-31&format=csv |
使用價位表 API 來以 JSON 格式檢視所有 Azure 使用量服務價位表資料:
| 方法 | 要求 URI |
|---|---|
| POST | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/providers/Microsoft.CostManagement/pricesheet/default/download?api-version=2018-11-01-preview&startDate=2019-01-01&endDate=2019-01-31&format=json |
使用此 API 會傳回整個帳戶的價位表。 不過,您也可以取得 PDF 格式的精簡版價位表。 摘要內會包含 Azure 消耗量和 Marketplace 消耗服務,這些服務會在特定發票中進行計費。 發票可透過 {invoiceId} 來加以識別,這與發票摘要 PDF 檔案中顯示的發票號碼相同。 以下是範例。
若要使用價位表 API 以 CSV 格式檢視發票資訊:
| 方法 | 要求 URI |
|---|---|
| POST | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/invoices/{invoiceId}/pricesheet/default/download?api-version=2018-11-01-preview&format=csv |
若要使用價位表 API 以 JSON 格式檢視發票資訊:
| 方法 | 要求 URI |
|---|---|
| POST | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/invoices/{invoiceId}/pricesheet/default/download?api-version=2018-11-01-preview&format=json |
您也可以查看目前開啟的計費週期或服務期間內,任何 Azure Consumption 或 Marketplace 耗用服務的估計價格。
若要使用價位表 API 以 CSV 格式檢視使用量服務的預估價格:
| 方法 | 要求 URI |
|---|---|
| POST | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billing AccountId}/billingProfiles/{billingProfileId}/pricesheet/default/download?api-version=2018-11-01-preview&format=csv |
若要使用價位表 API 以 JSON 格式檢視使用量服務的預估價格:
| 方法 | 要求 URI |
|---|---|
| POST | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billing AccountId}/billingProfiles/{billingProfileId}/pricesheet/default/download?api-version=2018-11-01-preview&format=json |
Microsoft 客戶合約價位表 API 是「非同步的 REST API」。 API 的回應已與較舊的同步 API 有所變化。 API 回應的主體也已變更。
舊的回應主體
以下是同步 REST API 回應的範例:
[
{
"id": "enrollments/573549891/billingperiods/2016011/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"
},
{
]
新的回應主體
API 支援 Azure REST 非同步格式。 使用 GET 呼叫 API,然後便會收到下列回應:
No Response Body
HTTP Status 202 Accepted
下列標頭會隨著輸出的位置一起傳送:
Location:https://management.azure.com/providers/Microsoft.Consumption/operationresults/{operationId}?sessiontoken=XZDFSnvdkbkdsb==
Azure-AsyncOperation:https://management.azure.com/providers/Microsoft.Consumption/operationStatus/{operationId}?sessiontoken=XZDFSnvdkbkdsb==
Retry-After: 10
OData-EntityId: {operationId}
對該位置發出另一個 GET 呼叫。 GET 呼叫的回應會相同,直到作業達到完成或失敗狀態為止。 完成時,GET 呼叫位置的回應會傳回下載 URL,就像同時執行作業一樣。 以下是範例:
HTTP Status 200
{
"id": "providers/Microsoft.Consumption/operationresults/{operationId}",
"name": {operationId},
"type": “Microsoft.Consumption/operationResults",
"properties" : {
"downloadUrl": {urltoblob},
"validTill": "Date"
}
}
用戶端也可以針對 Azure-AsyncOperation 發出 GET 呼叫。 端點會傳回作業的狀態。
下表顯示較舊 Enterprise 取得價位表 API 中的欄位。 其包含適用於 Microsoft 客戶合約的新價位表中所對應的欄位:
| 舊屬性 | 新屬性 | 備註 |
|---|---|---|
| 計費期間ID | 不適用 | 不適用。 若為 Microsoft 客戶合約,發票和相關聯的價位表已取代 billingPeriodId 的概念。 |
| meterId | meterId | |
| 計量單位 | 計量單位 | 確切的字串值可能會不同。 |
| includedQuantity | includedQuantity | 不適用於 Microsoft 客戶合約中的服務。 |
| 零件編號 | 不適用 | 相反地,請使用 productOrderName (與 offerID 相同) 和 meterID 的組合。 |
| 單價 | 單價 | 單價適用於 Microsoft 客戶合約所使用的服務。 |
| 貨幣代碼 (currencyCode) | pricingCurrency | Microsoft 客戶合約具有以定價貨幣和計費貨幣表示的價格。 currencyCode 對應到 Microsoft 客戶合約中的 pricingCurrency。 |
| offerID | productOrderName | 除了 OfferID,您也可以使用 productOrderName,但這與 OfferID 不同。 不過,在 Microsoft 客戶合約中,productOrderName 和 meter 會決定與舊版註冊中 meterId 和 OfferID 相關的定價。 |
Consumption Price Sheet API 作業
對於 Enterprise 合約,您可以針對 subscriptionId 範圍或計費期間,使用 Consumption Price Sheet API 的 Get 和 Get By Billing Period 作業。 該 API 會使用 Azure 資源管理驗證。
若要使用價位表 API 來取得某個範圍的價位表資訊:
| 方法 | 要求 URI |
|---|---|
| GET | https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Consumption/pricesheets/default?api-version=2018-10-01 |
若要使用價位表 API 來取得依計費週期顯示的價位表資訊:
| 方法 | 要求 URI |
|---|---|
| GET | https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Billing/billingPeriods/{billingPeriodName}/providers/Microsoft.Consumption/pricesheets/default?api-version=2018-10-01 |
請使用下列 Microsoft 客戶合約的端點,而不要使用上述 API 端點:
適用於 Microsoft 客戶合約的價位表 API (非同步 REST API)
此 API 適用於 Microsoft 客戶合約,而且提供額外屬性。
計費帳戶中,計費設定檔範圍的 Price Sheet
這是現有的 API。 系統已更新,可提供計費帳戶中計費設定檔的 Price Sheet。
依計費帳戶取得範圍的 Price Sheet
當您在計費帳戶中,於註冊範圍取得 Price Sheet 時,會使用 Azure Resource Manager 驗證。
若要在計費帳戶中的註冊帳戶取得 Price Sheet:
| 方法 | 要求 URI |
|---|---|
| GET | /providers/Microsoft.Billing/billingAccounts/65085863/providers/Microsoft.Consumption/pricesheets/download?api-version=2019-01-01 |
若為 Microsoft 客戶合約,請使用下一節中的資訊。 提供用於 Microsoft 客戶合約的欄位屬性。
計費帳戶中,計費設定檔範圍的 Price Sheet
已更新的「計費帳戶價位表 API」會以 CSV 格式提取價位表。 若要在 MCA 的計費設定檔範圍取得 Price Sheet:
| 方法 | 要求 URI |
|---|---|
| GET | /providers/Microsoft.Billing/billingAccounts/{billing AccountId}/billingProfiles/{billingProfileId}/providers/Microsoft.Consumption/pricesheets/download?api-version=2019-01-01 |
在 EA 的註冊範圍中,API 回應和屬性完全相同。 屬性會對應至相同的 MCA 屬性。
Azure Resource Manager 價位表 API 的舊版屬性和相同的新屬性如下表所示。
| 舊的 Azure Resource Manager 價位表 API 屬性 | 新的 Microsoft 客戶合約價位表 API 屬性 | 描述 |
|---|---|---|
| 計量識別碼 | meterId | 計量的唯一識別碼。 與 meterID 相同。 |
| 計量名稱 | 儀表名稱 | 計量的名稱。 Meter 代表可部署的 Azure 服務資源。 |
| 計量類別 | 服務 | 計量的分類類別名稱。 與 Microsoft 客戶合約價位表中的服務相同。 確切的字串值會不同。 |
| 計量子類別 | meterSubCategory | 計量的子分類類別名稱。 根據服務中高層級功能集差異化的分類。 例如,基本 SQL DB 與標準 SQL DB。 |
| 計量區域 | meterRegion | |
| 單位 | 不適用 | 可以從 unitOfMeasure 進行剖析。 |
| 測量單位 | 計量單位 | |
| 組件編號 | 不適用 | 請使用 productOrderName 和 MeterID,而不要使用零件編號,來唯一識別計費設定檔的價格。 在 MCA 發票中,這些欄位會列出,而不是使用零件編號。 |
| 單價 | 單價 | Microsoft 客戶合約單價。 |
| 貨幣代碼 | pricingCurrency | Microsoft 客戶合約會以定價貨幣和計費貨幣來表示價格。 貨幣代碼與 Microsoft 客戶合約中的 pricingCurrency 相同。 |
| 內含數量 | includedQuantity | 不適用於 Microsoft 客戶合約中的服務。 以零值顯示。 |
| 優惠識別碼 | productOrderName | 請改用 productOrderName,而不是 OfferID。 這與 OfferID 不同,不過在 Microsoft 客戶合約中,productOrderName 和 meter 會決定定價。 與舊版註冊中的 meterId 和 OfferID 有關。 |
Microsoft 客戶合約價格的定義方式與 Enterprise 合約不同。 Enterprise 註冊中服務的價格,會依產品、零件編號、meter 和供應項目而唯一決定。 組件編號不會用於 Microsoft 客戶合約。
屬於 Microsoft 客戶合約的 Azure 使用量服務價格,對於 productOrderName 和 meterID 而言是唯一的。 這兩項代表服務計量表和產品計畫。
若要讓使用量詳細資料 API 中的價位表和使用量協調一致,您可以使用 productOrderName 和 meterID。
具有帳單設定檔擁有者、參與者、讀者和發票管理者權限的使用者可以下載價位表。
價目表包括那些價格基於使用量的服務的收費。 這些服務包括 Azure 使用量和 Marketplace 使用量。 每個服務期間結束時的最新價格會鎖定,並套用至單一服務期間內的使用量。 針對 Azure 使用量服務,服務期間通常是行事曆月份。
已淘汰的價位表 API 欄位
以下欄位在 Microsoft 客戶合約價目表 API 中無法使用,或者其中已有相同的欄位。
| 已淘汰欄位 | 描述 |
|---|---|
| 計費期間ID | 不適用。 對應至 MCA 的 InvoiceId。 |
| offerID | 不適用。 對應至 MCA 的 productOrderName。 |
| 計量類別 | 不適用。 對應至 MCA 的服務。 |
| 單位 | 不適用。 可以從 unitOfMeasure 進行剖析。 |
| 貨幣代碼 (currencyCode) | 與 MCA 中的 pricingCurrency 相同。 |
| meterLocation | 與 MCA 的 meterRegion 相同。 |
| 零件編號 | 不適用,因為 MCA 發票中未列出組件編號。 請使用 meterId 和 productOrderName 組合來唯一識別價格,而不要使用組件編號。 |
| 總包含數量 | 不適用。 |
| 稅前標準費率 | 不適用。 |
Reservation Instance Charge API 已替換
您可以使用 Reserved Instance Charge API,取得保留執行個體購買項目的計費交易。 新的 API 包含所有購買項目,包括第三方市集提供的項目。 所有 Consumption API 已被取代為使用 Microsoft Entra ID 進行驗證和授權的原生 Azure API。 如需如何呼叫 Azure REST API 的詳細資訊,請參閱開始使用 REST。 Reserved Instance Charge API 已由 Transactions API 取代。
若要透過交易 API 取得預約購買交易:
| 方法 | 要求 URI |
|---|---|
| GET | https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/transactions?api-version=2018-11-01-preview |
建議的多個 API 已被替代
Reserved Instance Purchase Recommendations API 會提供過去 7、30 或 60 天的虛擬機器使用量。 API 也提供保留購買建議。 其中包含:
- 共用 Reserved Instance Recommendation API
- 單一 Reserved Instance Recommendations API
所有 Consumption API 已被取代為使用 Microsoft Entra ID 進行驗證和授權的原生 Azure API。 如需如何呼叫 Azure REST API 的詳細資訊,請參閱開始使用 REST。 以前列出的保留建議 API 已由 Microsoft.Consumption/reservationRecommendations API 加以取代。
若要使用保留建議 API 來取得保留建議:
| 方法 | 要求 URI |
|---|---|
| GET | https://management.azure.com/providers/Microsoft.Consumption/reservationRecommendations?api-version=2019-01-01 |
Reservation Usage API 已替換
您可以使用 Reserved Instance Usage API,取得註冊中的保留使用量。 如果註冊中有多個保留執行個體,您也可以使用此 API,取得所有保留執行個體購買項目的使用量。
其中包含:
- 保留執行個體使用量詳細資料
- 保留執行個體使用量摘要
所有 Consumption API 已被取代為使用 Microsoft Entra ID 進行驗證和授權的原生 Azure API。 如需如何呼叫 Azure REST API 的詳細資訊,請參閱開始使用 REST。 以前列出的保留建議 API 已由 Microsoft.Consumption/reservationDetails 和 Microsoft.Consumption/reservationSummaries API 加以取代。
若要使用保留詳細資料 API 來取得保留詳細資料:
| 方法 | 要求 URI |
|---|---|
| GET | https://management.azure.com/providers/Microsoft.Consumption/reservationDetails?api-version=2019-01-01 |
若要使用保留摘要 API 來取得保留摘要:
| 方法 | 要求 URI |
|---|---|
| GET | https://management.azure.com/providers/Microsoft.Consumption/reservationSummaries?api-version=2019-01-01 |
Power BI 系統整合
您也可以使用 Power BI 來報告成本。 適用於 Power BI Desktop 的成本管理連接器可用來建立功能強大的自訂報告,以協助您更加了解 Azure 的支出。 成本管理連接器目前支援具有 Microsoft 客戶合約或 Enterprise 合約 (EA) 的客戶。
相關內容
- 請閱讀成本管理文件,以了解如何監視及控制 Azure 費用。 或者,如果您想要利用成本管理來將資源使用最佳化的話。