代理管理者関係の統計情報を取得する
適用対象: パートナー センター
すべての顧客のパートナーに関連付けられている、確立またはアクティブな委任された管理 (DAP) リレーションシップの数に関する情報を返します。
目的: パートナーは、顧客と DAP 関係を削除する - パートナー センター アプリ開発者を使用して、顧客テナントを安全に管理し、90 日を超える非アクティブな DAP リレーションシップを削除するために準拠しています。
この API はアクティブな DAP の統計情報を追跡するのに役立ちます。これにより、パートナーはアクティブな DAP を詳細な委任された管理者特権 (GDAP) に移行できます。
Note
この API は有効期間が短く、DAP 廃止フェーズ中にサポートされます。 DAP 非推奨プログラムを投稿すると、この API は廃止されます。
前提条件
資格情報
このシナリオでは、アプリとユーザーの資格情報を使用した認証のみがサポートされます。
アクセス トークンを受信するためのトークン交換
詳細については、「Web API にアクセスするようにアプリを構成する」を参照してください。
PowerShell コンソールから次のコマンドを実行して、パートナー テナントでパートナー 顧客委任管理istration API アプリのサービス プリンシパルを作成します。
Microsoft Entra ID に接続します。
Connect-MgGraph例: Azure AD PowerShell から Microsoft Graph PowerShell に移行します。 詳細については、「Microsoft Graph PowerShell SDK の概要」を参照してください。
これにより、サインインするための対話型ウィンドウが開きます。 サンドボックス パートナー テナントの資格情報を入力します。
次に、新しいサービス プリンシパルを作成します。
New-MgServicePrincipal -AppId 2832473f-ec63-45fb-976f-5d45a7d4bb91詳細については、「New-MgServicePrincipal (Microsoft.Graph.Applications)」を参照してください。
ObjectId AppId 表示名 c1bf31da-09e5-4985-ab50-3232d4ae4f5a 2832473f-ec63-45fb-976f-5d45a7d4bb91 パートナー顧客の委任された管理参加 次に、Azure portal に移動し、アプリの登録し、パブリック クライアント アプリを作成するか、既存のアプリを使用して、テナントにアプリを作成します。
[API のアクセス許可>の表示] を選択します。組織が使用するアクセス許可>API を追加する
パートナー顧客の委任された管理委任>されたアクセス許可の追加アクセス許可>の選択
この新しいアクセス許可に対して管理者の同意を付与します。
このアプリ (ログインしたテナント管理者) を使用して、(リソース https://api.partnercustomeradministration.microsoft.comを含む) App+User トークンを使用して GDAP API を呼び出すようになりました。
POST https://login.microsoftonline.com/<partner_tenant_id>/oauth2/token grant_type=client_credentials&scope:https://api.partnercustomeradministration.microsoft.com&client_id:<client_id>&client_secret:<client_secret>
REST 要求
要求の構文
| 認証方法 | 要求 URI |
|---|---|
| GET | https://traf-pcsvcadmin-prod.trafficmanager.net/CustomerServiceAdminApi/Web/v1/delegatedAdminStatistics |
URI パラメーター
この API には URI パラメーターは必要ありません。
要求ヘッダー
| ヘッダー | 説明 | Value |
|---|---|---|
| 承認 | ベアラー <token>形式の承認トークン。 |
String |
要求本文
この API の要求本文は指定しないでください。
要求の例
GET https://traf-pcsvcadmin-prod.trafficmanager.net/CustomerServiceAdminApi/Web/v1/ delegatedAdminStatistics
HTTP/1.1
Authorization: Bearer \<token\>
Content-Type: application/json; charset=utf-8
REST 応答
成功した場合、このメソッドは、応答本文でデリゲートされた管理Statistics リソースのコレクションを返します。
応答の成功とエラーのコード
各応答には、成功または失敗とその他のデバッグ情報を示す HTTP 状態コードが付属しています。 ネットワーク トレース ツールを使用して、このコード、エラーの種類、およびその他のパラメーターを読み取ります。 完全な一覧については、パートナー センターの REST エラーコードに関する記事を参照してください。
delegated管理Statistics リソース
委任された管理 Privilege (DAP) リレーションシップの使用状況の統計情報を含むオブジェクトを表します。
プロパティ
| プロパティ | タイプ | 説明 |
|---|---|---|
| id | String | パートナー テナントの一意識別子。 |
| partnerTenantId | String | パートナー テナントの一意識別子。 |
| totalDapCustomerCount | int | DAP アクセス権を持つ顧客の合計数。 |
| establishedDapCount | delegated管理AccessCount コレクション | 確立された DAP の数 (作成) と作成日。 例: 2021 年 6 月 18 日に 10 個の DAP が作成された場合、応答には "count" が 10、"date" が "6/18/2021" になります。 |
| inactiveDapCount | delegated管理AccessCount コレクション | サインインの最後の日付でサインインした顧客の数。 例: パートナーが 2021 年 6 月 18 日に 10 人の顧客テナントにサインインした場合、応答には "count" が 10、"date" が "6/18/2021" になります。 |
delegated管理AccessCount リソース
1 日あたりの委任された管理者の数を表します。
| プロパティ | タイプ | 説明 |
|---|---|---|
| 日付 | String | アクション [確立またはサインイン] の日付。 |
| カウント | int | 顧客の数。 |
応答の例
{
"@odata.context": "https://traf-pcsvcadmin-prod.trafficmanager.net/CustomerServiceAdminApi/Web/v1/$metadata#delegatedAdminStatistics/$entity",
"id": "8984fecd-00a2-4686-ba43-b5c20866944a",
"partnerTenantId": "8984fecd-00a2-4686-ba43-b5c20866944a",
"totalDapCustomerCount": 200,
"establishedDapCount": [
{
"date": "6/18/2021",
"count": 1
},
{
"date": "2/18/2022",
"count": 1
}
],
"inactiveDapCount": [
{
"date": "2/18/2022",
"count": 1
},
{
"date": "2/24/2022",
"count": 1
}
]
}
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示