次の方法で共有

EA の使用状況の詳細 API からの移行

EA customers who were previously using the Enterprise Reporting APIs behind the consumption.azure.com endpoint to obtain usage details and marketplace charges need to migrate to new and improved solutions. 手順の概要と、古い API と新しいソリューションのコントラクトの違いについて説明します。

The dataset is referred to as cost details instead of usage details.

Note

すべての Azure Enterprise Reporting API は廃止されます。 できるだけ早く Microsoft Cost Management API に移行する必要があります。

新しいソリューションの一般提供

次の表に、使用可能な移行先の概要と、最適なソリューションを選択する際に考慮事項の概要を示します。

Solution Description Considerations Onboarding info
Exports スケジュールに従ってストレージへの定期的なデータ ダンプ - ワークロードに最もスケーラブルなソリューション。
- より大きなデータセットにファイルパーティショニングを使用するように構成できます。
- 独自のクエリ可能なデータストアと統合できるコスト データセットの確立と拡張に最適です。
-データを保持できるストレージ アカウントへのアクセスが必要です。		 - Azure Portal での構成
API を使用してエクスポートの作成を自動化
- エクスポート API リファレンス
コストの詳細 API オンデマンド ダウンロード - 小規模なコスト データセットに役立ちます。
- セキュリティまたは管理容易性の問題のために Azure Storage へのエクスポートが実現できないシナリオに役立ちます。		 - 必要に応じて小規模なコスト データセットを取得する
- Cost Details API

Generally we recommend using Exports if you have ongoing data ingestion needs and/or a large monthly cost details dataset. 詳細については、「コスト状況の詳細データを取り込む」を参照してください。 ワークロードの決定に役立つ追加情報が必要な場合は、「コストの詳細ソリューションの選択」を参照してください。

API を呼び出すためのアクセス許可を SPN に割り当てる

プログラムでエクスポート API またはコストの詳細 API を呼び出す場合は、適切なアクセス許可を持つサービス プリンシパルを構成する必要があります。 詳細については、「ACM API へのアクセス許可の割り当て」を参照してください。

Microsoft Consumption Usage Details API を回避する

Consumption Usage Details API は、現在 EA のお客様をサポートしているもう 1 つのエンドポイントです。 この API に移行しないでください。 このドキュメントで前述したように、エクスポートまたは Cost Details API に移行します。 Consumption Usage Details API は将来非推奨となり、以下のエンドポイントの背後に配置されます。

GET https://management.azure.com/{scope}/providers/Microsoft.Consumption/usageDetails?api-version=2021-10-01

この API は同期エンドポイントであり、毎月のコスト データセットの増加に伴い、支出と月のサイズの両方が増加するため、スケーリングできません。 現在 Consumption Usage Details API を使用している場合は、できるだけ早くいずれかの Cost Details API のエクスポートに移行することをお勧めします。 正式な非推奨の発表は、将来行われます。 従量課金の使用状況の詳細から移行する方法の詳細については、「Consumption Usage Details API からの移行」を参照してください。

Migration benefits

新しいソリューションは、EA Reporting Usage Details API よりも多くの利点を提供します。 次に概要を示します。

  • セキュリティと安定性 - 新しいソリューションでは、データにアクセスするためにサービス プリンシパルやユーザー トークンが必要です。 EA Reporting API の認証に使用される API キーよりも安全です。 これらのレガシ API のキーは 6 か月間有効で、漏洩すると機密性の高い財務データが公開される可能性があります。 さらに、キーが更新されず、6 か月の有効期限が切れる前にワークロードに統合されない場合、データ アクセスは取り消されます。 これにより、お客様のワークロードが中断されます。
  • Scalability - The EA Reporting APIs aren't built to scale well as your Azure usage increases. 使用状況の詳細データセットは、クラウドにデプロイするリソースが増えるにつれて、非常に大きくなる可能性があります。 新しいソリューションは非同期であり、インフラストラクチャの広範な機能強化により、あらゆるサイズのデータセットのダウンロードが成功します。
  • すべての使用状況の詳細詳細に対する 1 つのデータセット - Azure と Azure Marketplace の使用状況の詳細が新しいソリューションで 1 つのデータセットにマージされました。 1 つのデータセットにより、すべての料金を表示するために呼び出す必要がある API の数が減ります。
  • Purchase amortization - Customers who purchase Reservations can see an Amortized view of their costs using the new solutions.
  • Schema consistency - Each solution that is available provides files with matching fields. これにより、シナリオに基づいてソリューション間を簡単に移動できます。
  • コスト割り当ての統合 - エンタープライズ契約および Microsoft 顧客契約のお客様は、新しいソリューションを使用して、構成したコスト配賦ルールに関連する料金を表示できます。 For more information about cost allocation, see Allocate costs.
  • 改善を進める - 新しいソリューションは積極的に開発されています。 ソリューションは、リリース時にすべての新機能を受け取ります。

Enterprise Usage API からの移行

次の表は、コストの詳細データを取り込むために現在使用しているさまざまな API をまとめたものです。 以下のいずれかの API を使用している場合は、上記で取り上げた新しいソリューションのいずれかに移行する必要があります。 すべての API は、https://consumption.azure.com エンドポイントの背後にあります。

Endpoint API Comments
/v3/enrollments/{enrollmentNumber}/usagedetails/download?billingPeriod={billingPeriod} - API メソッド: GET
- 同期(非ポーリング)
- データ形式: CSV
/v3/enrollments/{enrollmentNumber}/usagedetails/download?startTime=2017-01-01&endTime=2017-01-10 - API メソッド: GET
- 同期(非ポーリング)
- データ形式: CSV
/v3/enrollments/{enrollmentNumber}/usagedetails - API メソッド: GET
- 同期(非ポーリング)
- データ形式: JSON
/v3/enrollments/{enrollmentNumber}/billingPeriods/{billingPeriod}/usagedetails - API メソッド: GET
- 同期(非ポーリング)
- データ形式: JSON
/v3/enrollments/{enrollmentNumber}/usagedetailsbycustomdate?startTime=2017-01-01&endTime=2017-01-10 - API メソッド: GET
- 同期(非ポーリング)
- データ形式: JSON
/v3/enrollments/{enrollmentNumber}/usagedetails/submit?billingPeriod={billingPeriod} - API メソッド: POST
- 非同期 (ポーリング ベース)
- データ形式: CSV
/v3/enrollments/{enrollmentNumber}/usagedetails/submit?startTime=2017-04-01&endTime=2017-04-10 - API メソッド: POST
- 非同期 (ポーリング ベース)
- データ形式: CSV

データ フィールド マッピング

次の表に、現在使用しているソリューションで使用できる古いフィールドの概要と、新しいソリューションで使用するフィールドを示します。

Old field New field Comments
accountId
accountName AccountName
accountOwnerEmail AccountOwnerId
additionalInfo AdditionalInfo
chargesBilledSeparately isAzureCreditEligible プロパティは反対です。 isAzureCreditEnabled が true の場合、ChargesBilledSeparately は false になります。
consumedQuantity Quantity
consumedService ConsumedService
consumedServiceId ConsumedService consumedServiceId は、数値のみを提供します。
ConsumedService は、サービスの名前を提供します。
cost CostInBillingCurrency
costCenter CostCenter
date Date 古いフィールドの形式は yyyy-mm-dd で、新しいフィールドの形式は mm/dd/yyyy です。
departmentId InvoiceSectionId
departmentName InvoiceSectionName
extendedCost CostInBillingCurrency
instanceId ResourceId
isRecurringCharge 必要に応じて、Frequency と Term fields を使用し、次に進みます。
位置 ResourceLocationNormalized
meterCategory MeterCategory
meterId MeterId
meterName MeterName
meterRegion MeterRegion
meterSubCategory MeterSubCategory
offerId OfferId
orderNumber Not available.
partNumber PartNumber
planName PlanName
product ProductName
publisherName PublisherName
resourceGroup ResourceGroup
resourceGuid MeterId Values vary. resourceGuid は、GUID 値です。 meterId は、長い数字です。
resourceLocation ResourceLocation
resourceLocationId Not available.
resourceRate EffectivePrice
serviceInfo1 ServiceInfo1
serviceInfo2 ServiceInfo2
serviceName MeterCategory
serviceTier MeterSubCategory
storeServiceIdentifier Not available.
subscriptionGuid SubscriptionId
subscriptionId SubscriptionId
subscriptionName SubscriptionName
tags Tags 新しいフィールドには、キーと値のペアを囲む {} がありません。
unitOfMeasure UnitOfMeasure

Related content