EA の使用状況の詳細 API からの移行
以前、 consumption.azure.com エンドポイントの背後にある Enterprise Reporting API を使用して使用状況の詳細とマーケットプレースの料金を取得していた EA のお客様は、新しい改善されたソリューションに移行する必要があります。 手順の概要と、古い API と新しいソリューションのコントラクトの違いについて説明します。
データセットは、使用状況の詳細ではなく、コストの詳細と呼ばれます。
Note
すべての 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 | |
| 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 | InvoiceSectionName | |
| extendedCost | CostInBillingCurrency | |
| instanceId | ResourceId | |
| isRecurringCharge | 必要に応じて、Frequency と Term fields を使用し、次に進みます。 |
|
| location | 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 への移行」に関するページを参照してください。