從 Enterprise 合約遷移至 Microsoft 客戶合約 API

發行項
08/15/2024

本文可協助您了解 Enterprise 合約 (EA) 與 Microsoft 客戶合約 (MCA) 帳戶之間的資料結構、API 和其他系統整合差異。成本管理同時支援這兩種帳戶類型的 API。請先檢閱設定 Microsoft 客戶合約的計費帳戶一文，再繼續進行。

具有現有 EA 帳戶的組織在設定 MCA 帳戶時，應該檢閱本文。以前在更新 EA 帳戶時，只需要進行最少量的一些工作就能從舊註冊移至新註冊。不過，移轉至 MCA 帳戶則需要額外的工作。需要進行額外的工作是因為基礎計費子系統有所變更，因此會影響所有成本相關的 API 和服務供應項目。

MCA API 和整合

MCA API 和新的整合可讓您：

透過原生 Azure API 獲得完整的 API 可用性。
在單一計費帳戶中設定多個發票。
存取結合了 Azure 服務使用量、第三方 Marketplace 使用量和 Marketplace 購買的 API。
使用成本管理來檢視所有帳單設定檔 (與註冊相同) 的成本。
存取新的 API 以顯示成本、在成本超過預先定義的閾值時收到通知，並自動匯出原始資料。

移轉檢查清單

下列項目可協助您轉換至 MCA API。

熟悉新的 Microsoft 客戶合約計費帳戶。
確定您使用的 API，並在下一節查看哪些 API 已遭到取代。
熟悉 Azure Resource Manager REST API。
如果您尚未使用 Azure Resource Manager API，請使用 Microsoft Entra ID 註冊您的用戶端應用程式。
使用存取控制 (IAM) 向在 Microsoft Entra 應用程式註冊期間建立的應用程式，授與計費帳戶的讀取存取權。
更新所有程式碼，以使用 Microsoft Entra 驗證。
更新任何程式設計程式碼，以使用 MCA API 呼叫來取代 EA API 呼叫。
將錯誤處理機制更新為使用新的錯誤碼。
檢閱其他整合供應項目 (例如 Power BI)，以進行其他所需的動作。

已由 MCA API 取代的 EA 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
價位表	/pricesheet	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 /SingleReservationRecommendations	Microsoft.Consumption/reservationRecommendations
保留使用量	/reservationdetails /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 使用量見解內容套件和連接器	Azure 使用量見解連接器

用來取得餘額和信用額度的 API

取得餘額摘要 API 用來提供您下列項目的每月摘要：

餘額
新增購買商品
Azure Marketplace 服務費用
調整
服務超額費用

所有使用量 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。若要選擇適合您的解決方案，請參閱選擇成本詳細資料解決方案。這兩個解決方案都提供相同的成本詳細資料檔案，並在資料中有市集購買，而以前只會顯示在至今為止的餘額摘要中。

與所有成本管理 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 相同)。
AdditionalInfo	additionalInfo
ChargesBilledSeparately	isAzureCreditEligible	屬性相反。如果 isAzureCreditEnabled 為 true，則 ChargesBilledSeparately 會是 false。
ConsumedQuantity	數量
ConsumedService	consumedService	確切的字串值可能會不同。
ConsumedServiceId	無
CostCenter	costCenter
日期和 usageStartDate	date
Day	無	剖析開始日期的日子。
DepartmentId	invoiceSectionId	確切的值會不同。
DepartmentName	invoiceSectionName	確切的字串值可能會不同。如有需要，請將發票區段設定為符合部門。
ExtendedCost 和成本	costInBillingCurrency
InstanceId	resourceId
是定期費用	無
Location	location
計量類別目錄	meterCategory	確切的字串值可能會不同。
MeterId	meterId	確切的字串值會不同。
MeterName	meterName	確切的字串值可能會不同。
MeterRegion	meterRegion	確切的字串值可能會不同。
MeterSubCategory	meterSubCategory	確切的字串值可能會不同。
Month	無	剖析開始日期的月份。
供應項目名稱	無	使用 publisherName 和 productOrderName。
OfferID	無
訂單編號	無
PartNumber	無	使用 meterId 和 productOrderName 來唯一識別價格。
方案名稱	productOrderName
產品	產品
ProductId	productId	確切的字串值會不同。
發行者名稱	publisherName
ResourceGroup	resourceGroupName
ResourceGuid	meterId	確切的字串值會不同。
資源位置	resourceLocation
ResourceLocationId	無
ResourceName	無
ResourceRate	effectivePrice
ServiceAdministratorId	N/A
ServiceInfo1	serviceInfo1
ServiceInfo2	serviceInfo2
ServiceName	meterCategory	確切的字串值可能會不同。
ServiceTier	meterSubCategory	確切的字串值可能會不同。
StoreServiceIdentifier	N/A
SubscriptionGuid	subscriptionId
SubscriptionId	subscriptionId
SubscriptionName	subscriptionName
標籤	標記	tags 屬性會套用至根物件，而非套用至 properties 巢狀屬性。
UnitOfMeasure	unitOfMeasure	確切的字串值會不同。
usageEndDate	date
Year	無	剖析開始日期的年份。
(新增)	billingCurrency	費用的計價貨幣。
(新增)	billingProfileId	帳單設定檔的唯一識別碼 (與註冊相同)。
(新增)	billingProfileName	帳單設定檔的名稱 (與註冊相同)。
(新增)	chargeType	用來區分 Azure 服務使用量、Marketplace 使用量和購買。
(新增)	invoiceId	發票的唯一識別碼。空白代表當前所處的月份。
(新增)	publisherType	購買的發行者類型。空白代表使用量。
(新增)	serviceFamily	購買的類型。空白代表使用量。
(新增)	servicePeriodEndDate	已購買服務的結束日期。
(新增)	servicePeriodStartDate	已購買服務的開始日期。

計費週期 API 已由發票 API 加以取代

MCA 計費帳戶不會使用計費週期。相反地，這些帳戶會使用發票將成本範圍限定在特定計費週期。計費週期 API 已由發票 API 加以取代。所有使用量 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`

價位表 API

本節將討論現有的價位表 API，並針對 Microsoft 客戶合約提供移至價位表 API 的建議。文中也會討論適用於 Microsoft 客戶合約的價位表 API，並說明價位表中的欄位。 Enterprise 取得價位表和 Enterprise 取得計費週期 API 已由適用於 Microsoft 客戶合約的價位表 API (Microsoft.Billing/billingAccounts/billingProfiles/pricesheet) 加以取代。新 API 會以非同步 REST 格式同時支援 JSON 和 CSV 格式。所有使用量 API 都會取代為使用 Microsoft Entra ID 進行驗證和授權的原生 Azure API。如需如何呼叫 Azure REST API 的詳細資訊，請參閱開始使用 REST。

計費企業版 API

您以前使用計費企業版 API 搭配 Enterprise 註冊來取得價格和計費週期資訊。使用 Microsoft Entra Web 權杖進行驗證和授權。

若要使用價位表和計費週期 API 來取得指定 Enterprise 註冊的適用價格：

方法	要求 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}/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}/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 使用量或 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://managment.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 客戶合約的新價位表中所對應的欄位：

舊屬性	新屬性	備註
billingPeriodId	不適用	不適用。若為 Microsoft 客戶合約，發票和相關聯的價位表已取代 billingPeriodId 的概念。
meterId	meterId
unitOfMeasure	unitOfMeasure	確切的字串值可能會不同。
includedQuantity	includedQuantity	不適用於 Microsoft 客戶合約中的服務。
partNumber	不適用	相反地，請使用 productOrderName (與 offerID 相同) 和 meterID 的組合。
unitPrice	unitPrice	單價適用於 Microsoft 客戶合約所使用的服務。
currencyCode	pricingCurrency	Microsoft 客戶合約具有以定價貨幣和計費貨幣表示的價格。 currencyCode 會對應至 Microsoft 客戶合約中的 pricingCurrency。
offerID	productOrderName	除了 OfferID，您也可以使用 productOrderName，但這與 OfferID 不同。不過，productOrderName 和計量會決定舊版註冊中與 meterId 和 OfferID 相關的 Microsoft 客戶合約定價。

使用量價位表 API 作業

針對 Enterprise 合約，您以前會依 subscriptionId 或計費週期來針對某個範圍使用「使用量價位表 API」的取得和依計費週期取得作業。該 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 客戶合約，而且提供額外屬性。

計費帳戶中某個帳單設定檔範圍的價位表

這是現有的 API。其已更新為會針對計費帳戶中的帳單設定檔來提供價位表。

依計費帳戶的範圍價位表

當您在計費帳戶的註冊範圍中取得價位表時，就會使用 Azure Resource Manager 驗證。

若要在計費帳戶的註冊帳戶中取得價位表：

方法	要求 URI
GET	`/providers/Microsoft.Billing/billingAccounts/65085863/providers/Microsoft.Consumption/pricesheets/download?api-version=2019-01-01`

若為 Microsoft 客戶合約，請使用下一節中的資訊。其會提供用於 Microsoft 客戶合約的欄位屬性。

計費帳戶中某個帳單設定檔範圍的價位表

已更新的「依計費帳戶的價位表 API」會取得 CSV 格式的價位表。若要在 MCA 的帳單設定檔範圍取得價位表：

方法	要求 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 相同。
計量名稱	meterName	計量的名稱。計量代表 Azure 服務的可部署資源。
計量類別目錄	服務	計量的分類類別名稱。與 Microsoft 客戶合約價位表中的服務相同。確切的字串值會不同。
計量子類別	meterSubCategory	計量的子分類類別名稱。根據服務中的高階功能集差異分類。例如，基本 SQL DB 與標準 SQL DB。
計量區域	meterRegion
單位	不適用	可以從 unitOfMeasure 進行剖析。
測量單位	unitOfMeasure
組件編號	不適用	請使用 productOrderName 和 MeterID (而不是組件編號) 來唯一識別帳單設定檔的價格。欄位會列在 MCA 發票上，而不是 MCA 發票中的組件編號上。
單價	unitPrice	Microsoft 客戶合約單價。
貨幣代碼	pricingCurrency	Microsoft 客戶合約會以定價貨幣和計費貨幣來表示價格。貨幣代碼與 Microsoft 客戶合約中的 pricingCurrency 相同。
內含數量	includedQuantity	不適用於 Microsoft 客戶合約中的服務。會與零值一起顯示。
優惠識別碼	productOrderName	請改用 productOrderName，而不是 OfferID。不同於 OfferID，不過 productOrderName 和計量會決定 Microsoft 客戶合約中的定價。與舊版註冊中的 meterId 和 OfferID 有關。

Microsoft 客戶合約價格的定義方式與 Enterprise 合約不同。 Enterprise 註冊中的服務價格對於產品、組件編號、計量及供應項目而言是唯一的。組件編號不會用於 Microsoft 客戶合約。

屬於 Microsoft 客戶合約的 Azure 使用量服務價格，對於 productOrderName 和 meterID 而言是唯一的。這兩項代表服務計量和產品方案。

若要讓使用量詳細資料 API 中的價位表和使用量協調一致，您可以使用 productOrderName 和 meterID。

具有帳單設定檔擁有者、參與者、讀者和發票管理者權限的使用者可以下載價位表。

服務若以使用量作為其價格依據，價位表便會包含該服務。這些服務包括 Azure 使用量和 Marketplace 使用量。在每個服務期間結束時，最新價格將會鎖定起來，並套用至單一服務期間的使用量。針對 Azure 使用量服務，服務期間通常是行事曆月份。

已淘汰的價位表 API 欄位

下列欄位要不就是無法在 Microsoft 客戶合約價位表 API 中使用，就是已有相同的欄位。

已淘汰的欄位	描述
billingPeriodId	不適用。對應至 MCA 的 InvoiceId。
offerID	不適用。對應至 MCA 的 productOrderName。
meterCategory	不適用。對應至 MCA 的服務。
單位	不適用。可以從 unitOfMeasure 進行剖析。
currencyCode	與 MCA 的 pricingCurrency 相同。
meterLocation	與 MCA 的 meterRegion 相同。
partNumber	不適用，因為 MCA 發票中未列出組件編號。請使用 meterId 和 productOrderName 組合來唯一識別價格，而不要使用組件編號。
totalIncludedQuantity	不適用。
pretaxStandardRate	不適用。

保留執行個體費用 API 已遭到取代

您可以使用保留執行個體費用 API 來取得保留購買的計費交易。新的 API 包含所有購買項目，包括第三方 Marketplace 供應項目。所有使用量 API 都會取代為使用 Microsoft Entra ID 進行驗證和授權的原生 Azure API。如需如何呼叫 Azure REST API 的詳細資訊，請參閱開始使用 REST。保留執行個體費用 API 已由交易 API 加以取代。

若要使用交易 API 來取得保留購買交易：

方法	要求 URI
GET	`https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/transactions?api-version=2018-11-01-preview`

建議 API 已遭到取代

保留執行個體購買建議 API 可提供過去 7 天、30 天或 60 天的虛擬機器使用量。某些 API 也會提供保留購買建議。其中包含：

共用保留執行個體建議 API
單一保留執行個體建議 API

所有使用量 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`

保留使用量 API 已遭到取代

您可以使用保留執行個體使用量 API 來取得註冊中的保留使用量。如果註冊中有多個保留執行個體，您也可以使用此 API 來取得所有保留執行個體購買的使用量。

其中包含：

保留執行個體使用量詳細資料
保留執行個體使用量摘要

所有使用量 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 費用。或者，如果您想要利用成本管理來將資源使用最佳化的話。

共用方式為

從 Enterprise 合約遷移至 Microsoft 客戶合約 API

MCA API 和整合

移轉檢查清單

已由 MCA API 取代的 EA API

用來取得餘額和信用額度的 API

用來取得成本和使用量的 API

計費週期 API 已由發票 API 加以取代

價位表 API

計費企業版 API

適用於 Microsoft 客戶合約的價位表 API

舊的回應主體

新的回應主體

使用量價位表 API 作業

依計費帳戶的範圍價位表

計費帳戶中某個帳單設定檔範圍的價位表

已淘汰的價位表 API 欄位

保留執行個體費用 API 已遭到取代

建議 API 已遭到取代

保留使用量 API 已遭到取代

Power BI 整合

意見反應

其他資源

共用方式為

從 Enterprise 合約遷移至 Microsoft 客戶合約 API

MCA API 和整合

移轉檢查清單

已由 MCA API 取代的 EA API

用來取得餘額和信用額度的 API

用來取得成本和使用量的 API

計費週期 API 已由發票 API 加以取代

價位表 API

計費企業版 API

適用於 Microsoft 客戶合約的價位表 API

舊的回應主體

新的回應主體

使用量價位表 API 作業

依計費帳戶的範圍價位表

計費帳戶中某個帳單設定檔範圍的價位表

已淘汰的價位表 API 欄位

保留執行個體費用 API 已遭到取代

建議 API 已遭到取代

保留使用量 API 已遭到取代

Power BI 整合

相關內容

意見反應

其他資源