從取用使用量詳細資料 API 移轉
本文討論從已規劃淘汰的取用使用量詳細資料 API (部分機器翻譯) 移轉。 確切日期目前尚未決定。 建議您不要使用此 API 組建報告管線，並儘快移轉。
Enterprise 合約 (EA) 報告 API (會使用 API 金鑰進行驗證，並透過 consumption.azure.com URI 端點存取) 已被淘汰。 使用這些 API 的 EA 客戶應移轉至 Microsoft 成本管理成本詳細資料 (部分機器翻譯) API。 舊版 EA 報告 API 僅適用於具有 Enterprise 合約的客戶。
如果您使用取用使用量詳細資料 API，我們「建議」但不強制移轉至成本管理成本詳細資料 (部分機器翻譯) API。
使用量和成本管理 API 適用於 EA Microsoft 客戶合約 (MCA) 客戶。 因此，保留在 EA 下的 Azure Government 客戶不會受到負面影響。
當您從 EA 移轉至 MCA 時，建議您從 EA 報告使用量詳細資料 API 移至成本管理成本詳細資料 API，並使用匯出。
移轉目的地
請先閱讀選擇成本詳細資料解決方案一文，再選擇您的工作負載適用的解決方案。 一般而言，如果您有進行中的資料擷取需求和或大型每月使用量詳細資料資料集，建議您匯出。 如需詳細資訊，請參閱內嵌使用量詳細資料。
如果您有較小的使用量詳細資料資料集或不適用匯出的案例，請考慮改用成本詳細資料 (部分機器翻譯) 報表。 如需詳細資訊，請參閱視需要取得小型成本資料集。
注意
[成本詳細資料] 報表僅適用於有 Enterprise 合約或 Microsoft 客戶合約的客戶。 如果您有 MSDN、隨用隨付或 Visual Studio 訂閱，您可以移轉至匯出或使用使用量詳細資料 API 繼續。
移轉優點
新的解決方案可透過使用量詳細資料 API 提供許多優點。 摘要如下：
- 所有使用量詳細資料的單一資料集 - Azure 和 Azure Marketplace 使用量詳細資料已合併成一個資料集。 這可減少您需要呼叫的 API 數目，以查看所有費用。
- 可擴縮性 - Marketplaces API 已被取代，因其會升級無法隨著 Azure 使用量增加而調整的呼叫模式。 您將更多資源部署到雲端時，使用量詳細資料資料集可能會變得很大。 Marketplaces API 是編頁同步 API，因此未最佳化，以高效率和可靠性有效地透過網路傳輸大量資料。 匯出和成本詳細資料 API 為非同步。 它們會提供 CSV 檔案，可透過網路直接下載。
- API 改善 - 匯出和成本詳細資料 API 是 Azure 支援持續進行的解決方案。 所有新功能都會整合到其中。
- 結構描述一致性 - [成本詳細資料] 報表和 [匯出] 會根據您的案例提供有相符欄位的檔案，因此您可以從一個解決方案移至另一個解決方案。
- 成本配置整合 - 使用匯出或成本詳細資料 API 的「Enterprise 合約」和「Microsoft 客戶合約」客戶，可以檢視本身設定的成本配置規則相關費用。 如需成本配置的詳細資訊，請參閱配置成本。
欄位差異
下表摘要說明使用量詳細資料 API 和匯出/成本詳細資料 API 之間的欄位差異。 匯出和成本詳細資料 API 會提供 CSV 檔案下載，而不會提供由取用 API 提供的編頁 JSON 回應。
Enterprise 合約欄位對應
使用使用量詳細資料 API 的 Enterprise 合約客戶擁有類型 legacy 的使用量詳細資料記錄。 因為用於這些記錄的基礎帳單系統，所有 Enterprise 合約客戶都有這種記錄。 舊版使用量詳細資料記錄的範例如下：
{
"value": [
{
"id": "{id}",
"name": "{name}",
"type": "Microsoft.Consumption/usageDetails",
"kind": "legacy",
"tags": {
"env": "newcrp",
"dev": "tools"
},
"properties": {
…...
}
}
舊版使用量詳細資料記錄的完整範例會顯示在使用量詳細資料 - 清單 - REST API (Azure 使用量) 中
下表提供舊欄位和新欄位之間的對應。 匯出和成本詳細資料 API 所產生的 CSV 檔案中提供新的屬性。 若要深入瞭解欄位，請參閱瞭解使用量詳細資料欄位。
粗體屬性名稱不會變更。
| 舊屬性 | 新屬性 |
|---|---|
| accountName | AccountName |
| AccountOwnerId | AccountOwnerId |
| additionalInfo | AdditionalInfo |
| AvailabilityZone | AvailabilityZone |
| billingAccountId | BillingAccountId |
| billingAccountName | BillingAccountName |
| billingCurrency | BillingCurrencyCode |
| billingPeriodEndDate | BillingPeriodEndDate |
| billingPeriodStartDate | BillingPeriodStartDate |
| billingProfileId | BillingProfileId |
| billingProfileName | BillingProfileName |
| chargeType | ChargeType |
| consumedService | ConsumedService |
| 成本 | CostInBillingCurrency |
| costCenter | CostCenter |
| date | Date |
| effectivePrice | EffectivePrice |
| 頻率 | 頻率 |
| invoiceSection | InvoiceSectionName |
| InvoiceSectionId | InvoiceSectionId |
| isAzureCreditEligible | IsAzureCreditEligible |
| meterCategory | 計量類別目錄 |
| meterId | MeterId |
| meterName | MeterName |
| MeterRegion | MeterRegion |
| meterSubCategory | MeterSubCategory |
| offerId | OfferId |
| partNumber | PartNumber |
| PayGPrice | PayGPrice |
| PlanName | PlanName |
| PricingModel | PricingModel |
| product | ProductName |
| ProductOrderId | ProductOrderId |
| ProductOrderName | ProductOrderName |
| PublisherName | PublisherName |
| PublisherType | PublisherType |
| 數量 | 數量 |
| ReservationId | ReservationId |
| ReservationName | ReservationName |
| resourceGroup | ResourceGroup |
| resourceId | ResourceId |
| resourceLocation | 資源位置 |
| resourceName | ResourceName |
| serviceFamily | ServiceFamily |
| ServiceInfo1 | ServiceInfo1 |
| ServiceInfo2 | ServiceInfo2 |
| subscriptionId | SubscriptionId |
| subscriptionName | SubscriptionName |
| Tags (標籤) | 標籤 |
| 字詞 | 詞彙 |
| unitOfMeasure | UnitOfMeasure |
| unitPrice | UnitPrice |
| CostAllocationRuleName | CostAllocationRuleName |
Microsoft 客戶合約欄位對應
使用使用量詳細資料 API 的 Microsoft 客戶合約客戶擁有類型 modern 的使用量詳細資料記錄。 因為用於這些記錄的基礎帳單系統，所有 Microsoft 客戶合約客戶都有這種記錄。 MCA 使用量詳細資料記錄的範例如下：
{
"value": [
{
"id": "{id}",
"name": "{name}",
"type": "Microsoft.Consumption/usageDetails",
"kind": "modern",
"tags": {
"env": "newcrp",
"dev": "tools"
},
"properties": {
…...
}
}
舊版使用量詳細資料記錄的完整範例會顯示在使用量詳細資料 - 清單 - REST API (Azure 使用量) 中
下表顯示舊欄位和新欄位之間的對應。 匯出和成本詳細資料 API 所產生的 CSV 檔案中提供新的屬性。 因解決方案間差異而需要對應的欄位會顯示為粗體文字。
如需詳細資訊，請參閱瞭解使用量詳細資料欄位。
| 舊屬性 | 新屬性 |
|---|---|
| invoiceId | invoiceId |
| previousInvoiceId | previousInvoiceId |
| billingAccountId | billingAccountId |
| billingAccountName | billingAccountName |
| billingProfileId | billingProfileId |
| billingProfileName | billingProfileName |
| invoiceSectionId | invoiceSectionId |
| invoiceSectionName | invoiceSectionName |
| partnerTenantId | partnerTenantId |
| partnerName | partnerName |
| resellerName | resellerName |
| resellerMpnId | resellerMpnId |
| customerTenantId | customerTenantId |
| customerName | customerName |
| costCenter | costCenter |
| billingPeriodEndDate | billingPeriodEndDate |
| billingPeriodStartDate | billingPeriodStartDate |
| servicePeriodEndDate | servicePeriodEndDate |
| servicePeriodStartDate | servicePeriodStartDate |
| date | date |
| serviceFamily | serviceFamily |
| productOrderId | productOrderId |
| productOrderName | productOrderName |
| consumedService | consumedService |
| meterId | meterId |
| meterName | meterName |
| meterCategory | meterCategory |
| meterSubCategory | meterSubCategory |
| meterRegion | meterRegion |
| productIdentifier | ProductId |
| product | ProductName |
| subscriptionGuid | SubscriptionId |
| subscriptionName | subscriptionName |
| publisherType | publisherType |
| publisherId | publisherId |
| publisherName | publisherName |
| resourceGroup | resourceGroupName |
| INSTANCENAME | ResourceId |
| resourceLocationNormalized | 位置 |
| resourceLocation | 位置 |
| effectivePrice | effectivePrice |
| 數量 | 數量 |
| unitOfMeasure | unitOfMeasure |
| chargeType | chargeType |
| billingCurrencyCode | billingCurrency |
| pricingCurrencyCode | pricingCurrency |
| costInBillingCurrency | costInBillingCurrency |
| costInPricingCurrency | costInPricingCurrency |
| costInUsd | costInUsd |
| paygCostInBillingCurrency | paygCostInBillingCurrency |
| paygCostInUSD | paygCostInUsd |
| exchangeRatePricingToBilling | exchangeRatePricingToBilling |
| exchangeRateDate | exchangeRateDate |
| isAzureCreditEligible | isAzureCreditEligible |
| serviceInfo1 | serviceInfo1 |
| serviceInfo2 | serviceInfo2 |
| additionalInfo | additionalInfo |
| 標記 | 標記 |
| partnerEarnedCreditRate | partnerEarnedCreditRate |
| partnerEarnedCreditApplied | partnerEarnedCreditApplied |
| marketPrice | PayGPrice |
| 頻率 | 頻率 |
| 術語 | 術語 |
| reservationId | reservationId |
| reservationName | reservationName |
| pricingModel | pricingModel |
| unitPrice | unitPrice |
| exchangeRatePricingToBilling | exchangeRatePricingToBilling |
相關內容
- 若要深入了解成本管理 + 帳單自動化，請參閱成本管理自動化概觀。