EA の使用状況の詳細 API からの移行
以前、 consumption.azure.com エンドポイントの背後にある Enterprise Reporting API を使用して使用状況の詳細とマーケットプレースの料金を取得していた EA のお客様は、新しい改善されたソリューションに移行する必要があります。 手順の概要と、古い API と新しいソリューションのコントラクトの違いについて説明します。
データセットは、使用状況の詳細ではなく、コストの詳細と呼ばれます。
Note
2024 年 5 月 1 日に、Azure Enterprise Reporting API は廃止される予定です。 その前に Microsoft Cost Management API に移行してください。
新しいソリューションの一般提供
次の表に、使用可能な移行先の概要と、最適なソリューションを選択する際に考慮事項の概要を示します。
| 解決策 | 説明 | 考慮事項 | オンボード情報 |
|---|---|---|---|
| エクスポート | スケジュールに従ってストレージへの定期的なデータ ダンプ | - ワークロードに最もスケーラブルなソリューション。 - より大きなデータセットにファイルパーティショニングを使用するように構成できます。 - 独自のクエリ可能なデータストアと統合できるコスト データセットの確立と拡張に最適です。 -データを保持できるストレージ アカウントへのアクセスが必要です。 |
- Azure Portal での構成 API を使用してエクスポートの作成を自動化 - エクスポート API リファレンス |
| コストの詳細 API | オンデマンド ダウンロード | - 小規模なコスト データセットに役立ちます。 - セキュリティまたは管理容易性の問題のために Azure Storage へのエクスポートが実現できないシナリオに役立ちます。 |
- 必要に応じて小規模なコスト データセットを取得する - コストの詳細の API |
一般に、継続的なデータ インジェストのニーズがある場合や、毎月のコストの詳細データセットが大きい場合は、Exports を使用することをお勧めします。 詳細については、「コスト状況の詳細データを取り込む」を参照してください。 ワークロードの決定に役立つ追加情報が必要な場合は、「コストの詳細ソリューションの選択」を参照してください。
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 からの移行」を参照してください。
移行の利点
新しいソリューションは、EA Reporting Usage Details API よりも多くの利点を提供します。 次に概要を示します。
- セキュリティと安定性 - 新しいソリューションでは、データにアクセスするためにサービス プリンシパルやユーザー トークンが必要です。 EA Reporting API の認証に使用される API キーよりも安全です。 これらのレガシ API のキーは 6 か月間有効で、漏洩すると機密性の高い財務データが公開される可能性があります。 さらに、キーが更新されず、6 か月の有効期限が切れる前にワークロードに統合されない場合、データ アクセスは取り消されます。 これにより、お客様のワークロードが中断されます。
- スケーラビリティ - EA Reporting API は、Azure の使用量が増加するにつれて、スケーリング用に構築されていません。 使用状況の詳細データセットは、クラウドにデプロイするリソースが増えるにつれて、非常に大きくなる可能性があります。 新しいソリューションは非同期であり、インフラストラクチャの広範な機能強化により、あらゆるサイズのデータセットのダウンロードが成功します。
- すべての使用状況の詳細詳細に対する 1 つのデータセット - Azure と Azure Marketplace の使用状況の詳細が新しいソリューションで 1 つのデータセットにマージされました。 1 つのデータセットにより、すべての料金を表示するために呼び出す必要がある API の数が減ります。
- 購入償却 - 予約を購入したお客様は、新しいソリューションを使用してコストの償却ビューを表示できます。
- スキーマの一貫性 - 使用可能な各ソリューションは、一致するフィールドを持つファイルを提供します。 これにより、シナリオに基づいてソリューション間を簡単に移動できます。
- コスト割り当ての統合 - エンタープライズ契約および Microsoft 顧客契約のお客様は、新しいソリューションを使用して、構成したコスト配賦ルールに関連する料金を表示できます。 コスト割り当ての詳細については、「コストの割り当て」を参照してください。
- 改善を進める - 新しいソリューションは積極的に開発されています。 ソリューションは、リリース時にすべての新機能を受け取ります。
Enterprise Usage API からの移行
次の表は、コストの詳細データを取り込むために現在使用しているさまざまな API をまとめたものです。 以下のいずれかの API を使用している場合は、上記で取り上げた新しいソリューションのいずれかに移行する必要があります。 すべての API は、https://consumption.azure.com エンドポイントの背後にあります。
| エンドポイント | API コメント |
|---|---|
/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 |
データ フィールド マッピング
次の表に、現在使用しているソリューションで使用できる古いフィールドの概要と、新しいソリューションで使用するフィールドを示します。
| 古いフィールド | 新しいフィールド | コメント |
|---|---|---|
| accountId | 利用不可 - AccountName を使用してアカウント情報を取得します。 | |
| accountName | AccountName | |
| accountOwnerEmail | AccountOwnerId | |
| additionalInfo | AdditionalInfo: | |
| chargesBilledSeparately | isAzureCreditEligible | プロパティは反対です。 isAzureCreditEnabled が true の場合、ChargesBilledSeparately は false になります。 |
| consumedQuantity | 件数 | |
| consumedService | ConsumedService | |
| consumedServiceId | ConsumedService | consumedServiceId は、数値のみを提供します。ConsumedService は、サービスの名前を提供します。 |
| コスト | CostInBillingCurrency | |
| costCenter | CostCenter | |
| 日付 | 日 | 古いフィールドの形式は yyyy-mm-dd で、新しいフィールドの形式は mm/dd/yyyy です。 |
| departmentId | InvoiceSectionId | フィールドは現在空です。 DepartmentName を使用して部署情報を取得します。 |
| departmentName | InvoiceSectionName | |
| extendedCost | CostInBillingCurrency | |
| instanceId | ResourceId | |
| isRecurringCharge | 必要に応じて、Frequency と Term fields を使用し、次に進みます。 |
|
| location | ResourceLocationNormalized | ResourceLocationNormalized はコストの詳細レポートに存在しますが、エクスポートにはまだ含まれていません。 |
| meterCategory | MeterCategory | |
| meterId | MeterId | |
| meterName | MeterName | |
| meterRegion | MeterRegion | |
| meterSubCategory | MeterSubCategory | |
| offerId | OfferId | |
| orderNumber | 使用できません。 | |
| partNumber | PartNumber | |
| planName | PlanName | |
| product | ProductName | |
| publisherName | 発行元 | |
| resourceGroup | ResourceGroup | |
| ResourceGUID | MeterId | 値はさまざまです。 resourceGuid は、GUID 値です。 meterId は、長い数字です。 |
| resourceLocation | ResourceLocation | |
| resourceLocationId | 使用できません。 | |
| resourceRate | EffectivePrice | |
| serviceInfo1 | ServiceInfo1 | |
| serviceInfo2 | ServiceInfo2 | |
| serviceName | MeterCategory | |
| serviceTier | MeterSubCategory | |
| storeServiceIdentifier | 使用できません。 | |
| subscriptionGuid | SubscriptionId | |
| subscriptionId | SubscriptionId | |
| subscriptionName | SubscriptionName | |
| tags | タグ | 新しいフィールドには、キーと値のペアを囲む {} がありません。 |
| unitOfMeasure | UnitOfMeasure |
次のステップ
- 「EA Reporting から Azure Resource Manager API への移行」に関するページを参照してください。