Microsoft Graph の従量制課金 API とサービスに関する FAQ
この記事では、Microsoft Graph の従量制課金 API とサービスに関してよく寄せられる質問に対する回答を示します。
課金を設定するには、アプリケーションの登録と使用する Azure サブスクリプションの両方に対するアクセス許可が必要です。 アプリケーションの登録に必要なアクセス許可は、アプリケーション所有者またはアプリケーション管理者です。 Azure サブスクリプションに必要なアクセス許可は、サブスクリプション共同作成者、所有者/リソース グループ共同作成者、または所有者です。
はい。サービス プリンシパルに割り当てられたアプリの登録には、アプリケーション管理者または同様のロールが必要です。 ロールのスコープは、課金用に設定されたターゲット アプリケーションのみに限定して、過度に広範なアクセス許可が付与されないようにすることができます。
はい。Azure リソースのマネージド ID を作成できます。 サブスクリプションまたはリソース グループにロールベースのアクセス制御を割り当て、マネージド ID に関連付けられているサービス プリンシパルにMicrosoft Entra アプリケーション管理者ロールを追加します。 詳細については、「 チュートリアル: Windows VM/VMSS を使用して Azure リソースにアクセスする 」を参照してください。
課金設定を確認する方法については、「 従量制課金 API とサービスを有効にする」を参照してください。
はい。Microsoft Teamsエクスポート API では、API 呼び出しの一部として model
パラメーターを渡す必要があります。
model
パラメーターの値によっては、特定のデータにユーザー ライセンスが必要な場合もあります。 詳細については、「 Teams API の支払いモデルとライセンス要件」を参照してください。
使用されているパラメーター model
判断する最善の方法は、呼び出し元のアプリケーションのコードを検査することです。
model=a
パラメーターを使用して呼び出される Teams エクスポート API のシード容量は、ターゲット テナント内の適格なユーザーの数に基づいて計算されます。 その後、シードされた容量は、そのテナントに対して実行されている各アプリケーションに適用されます。
シード容量は月の初めに評価され、適格なライセンスはシードされた容量のテナント レベルの計算にカウントされます。 その後、各アプリケーションは、それが枯渇するまで、それに割り当てられたシードされた容量を消費します。 その後、アプリケーションによる追加消費が従量制課金され、月次請求に表示されます。
API 呼び出しが失敗し、402 支払いが必要なエラーが発生します。 これは、有効なユーザー ライセンスを持つユーザーをターゲットにし、 model=a
パラメーターを渡す場合でも発生します。
必要な model
パラメーターなしで API を呼び出す場合、API は既定で評価モードの動作になります。 評価モードでは、402 支払いが必要なエラーを返す前に、1 か月あたりの API 呼び出し数が制限されます。 評価モードは、評価と開発専用に提供され、運用環境での使用を目的としたものではありません。
アプリケーション登録の所有者は、Microsoft Graph の従量制課金 API とサービスの課金を処理します。 アプリケーション登録の所有者である必要があるアプリケーションを取得した場合は、アプリケーションによって使用される従量制課金 API とサービスに対して責任を負います。
セキュリティ ポリシーとコンプライアンス ポリシーの対象となるユーザーごとにライセンスが必要です。 その他のシナリオでは、ライセンスが必要ない場合があります。 詳細については、「 Teams API の支払いモデルとライセンス要件」を参照してください。
課金データは、Microsoft Graph サービスというサービス名で Microsoft Graph 課金リソースを作成するために使用される Azure サブスクリプションに送信され、通常、トランザクションが発生してから 24 時間後に使用できます。
詳細については、「 Azure のコスト管理と課金の概要」を参照してください。
次の表は、課金料金を確認および監視するために最も頻繁に使用されるツールの一覧です。
型 | 説明 |
---|---|
コスト分析 | 消費量を表示する対話型グラフ。 ヒント: 累積コストを使用し、サービス名 Microsoft Graph サービスでフィルター処理します。 |
輸出 | 必要な頻度 (日単位や月単位など) で詳細なレポートを作成します。 |
アラート | フィルターを組み合わせてアラートを構成します。 |
次の表は、課金の詳細を集計または分割する方法を示しています。
型 | Exports プロパティ | コスト分析、予算、アラート フィルター |
---|---|---|
測定情報 | MeterName、MeterId、MeterCategory、MeterSubcategory、ProductName、ConsumedService | Meter、Meter カテゴリ、Meter サブカテゴリ、サービス名 |
リソース情報 | InstanceId、ResourceType、ResourceGroup、SubscriptionGuid | リソース、リソース guid、リソースの種類、リソース グループ、サービス名 |
タグ | TenantId | TenantId |
AdditionalInfo | AppId、TenantId |
一部のエンドポイントではメーターが共有される場合があり、課金データをエンドポイント別に分割することはできません。 または、クライアント アプリでクライアント側の API ログを設定したり、 Microsoft Graph アクティビティ ログを使用したりできます。
従量制課金 API には、次の制限事項が適用されます。
- Microsoft Graph の従量制課金 API とサービスは現在、Microsoft グローバル環境でのみ使用でき、世界中の Microsoft Graph エンドポイントを介してアクセスされる Microsoft 365 GCC デプロイを含む、国内クラウドデプロイでは使用できません。 各国のクラウドの詳細については、「 National Cloud のデプロイ」を参照してください。
- ターゲット アプリケーションは、機密クライアント アプリケーション (Web アプリケーション、Web API、デーモン/サービスなど) である必要があります。 パブリック クライアント アプリケーション (デスクトップ アプリケーションとモバイル アプリケーション) はサポートされていません。
- Azure マネージド ID は、従量制課金 API を呼び出すためにサポートされていません。 詳細については、「 マネージド ID をサポートする Azure サービス」を参照してください。