コントロール パネル ベンダーとして顧客の同意を得る
-
[アーティクル]
-
-
コントロール パネル ベンダー (CPV) として、REST API を使用して、CSP 顧客のテナントへのアクセス許可を取得するための同意を取得および削除できます。
POST https://api.partnercenter.microsoft.com/v1/customers/{<customer_id>}/applicationconsents
同意を取得する
URI パラメーター
名前 |
/ |
必須 |
Type |
説明 |
customer_id |
path |
True |
string |
パートナー センターで生成された顧客の ID |
メディアの種類: application/json
名前 |
必須 |
Type |
説明 |
承認 |
True |
string |
対象ユーザー向けのアクセス トークン https://api.partnercenter.microsoft.com |
承諾 |
True |
string |
受け入れ可能なコンテンツ タイプ。広く受け入れ可能な型 application/json |
ms-correlationid |
|
string |
要求を内部的に追跡するために使用されます。 ms-correlationid が指定されていない場合、サーバーは要求ごとに新しいものを生成します |
ms-requestid |
|
string |
要求のべき等性に使用されます。 ms-requestid が指定されていない場合、サーバーは要求ごとに新しいものを生成します |
要求本文
メディアの種類: application/json
名前 |
Type |
説明 |
applicationId |
string |
CPV パートナーのアプリケーション ID |
applicationGrants |
Microsoft.Partner.Core.ApplicationConsents.ApplicationGrant[] |
テナント内の顧客のアクセス権を取得するためのアプリケーション許可の一覧 |
Responses
名前 |
Type |
説明 |
200 OK |
|
要求は成功しました。 メディアの種類: "application/json"、"application/xml"、"text/xml"、"text/json" |
201 Created |
|
アプリケーションの同意が作成されます。 メディアの種類: "application/json"、"application/xml"、"text/xml"、"text/json" |
400 Bad Request |
|
入力が見つからないか、無効でした。 応答本文には、エラーの詳細が含まれています。 メディアの種類: "application/json"、"application/xml"、"text/xml"、"text/json" |
401 権限がありません |
|
要求が認証されませんでした。 クライアントは、有効な対象ユーザーに対して有効なアクセス トークンを渡す必要があります。 メディアの種類: "application/json"、"application/xml"、"text/xml"、"text/json" |
403 許可されていません |
|
要求は認証されましたが、呼び出し元に呼び出し権限がないため拒否されました。 メディアの種類: "application/json"、"application/xml"、"text/xml"、"text/json" |
404 見つかりません |
|
リソースが見つからないか、指定された入力パラメーターで使用できません。 メディアの種類: "application/json"、"application/xml"、"text/xml"、"text/json" |
500 内部サーバー エラー |
|
パートナー API サービスまたはその依存関係のいずれかが要求を満たさませんでした。 呼び出し元は要求を再試行できます。 メディアの種類: "application/json"、"application/xml"、"text/xml"、"text/json" |
定義
Microsoft.Partner.Core.ApplicationConsents.ApplicationGrant
名前 |
Type |
説明 |
enterpriseApplicationId |
string |
アクセス権を取得するリソースの GUID 表現 |
scope |
string |
アクセスを取得するためのスコープのコンマ区切り値 |
同意を削除する
DELETE https://api.partnercenter.microsoft.com/v1/customers/{customer_id}/applicationconsents/{application_id}
URI パラメーター
名前 |
/ |
必須 |
Type |
説明 |
customer_id |
path |
True |
string |
パートナー センターで生成された顧客の ID |
Application_id |
path |
True |
string |
CPV アプリケーションの ID |
メディアの種類: application/json
名前 |
必須 |
Type |
説明 |
承認 |
True |
string |
対象ユーザーのアクセス トークン https://api.partnercenter.microsoft.com |
承諾 |
True |
string |
受け入れ可能なコンテンツ タイプ (通常は application/json と入力します) |
ms-correlationid |
|
string |
要求を内部的に追跡するために使用されます。 ms-correlationid が指定されていない場合、サーバーは要求ごとに新しいものを生成します |
ms-requestid |
|
string |
要求のべき等性に使用されます。 ms-requestid が指定されていない場合、サーバーは要求ごとに新しいものを生成します |
Responses
名前 |
Type |
説明 |
200 OK |
|
要求は成功しました。 メディアの種類: "application/json"、"application/xml"、"text/xml"、"text/json" |
201 Created |
|
アプリケーションの同意が削除されます。 メディアの種類: "application/json"、"application/xml"、"text/xml"、"text/json" |
400 Bad Request |
|
入力が見つからないか、無効でした。 応答本文には、エラーの詳細が含まれています。 メディアの種類: "application/json"、"application/xml"、"text/xml"、"text/json" |
401 権限がありません |
|
要求が認証されませんでした。 クライアントは、有効な対象ユーザーに対して有効なアクセス トークンを渡す必要があります。 メディアの種類: "application/json"、"application/xml"、"text/xml"、"text/json" |
403 許可されていません |
|
要求は認証されましたが、呼び出し元にそれを呼び出す権限がないため、拒否されました。 メディアの種類: "application/json"、"application/xml"、"text/xml"、"text/json" |
404 見つかりません |
|
リソースが見つからないか、指定された入力パラメーターで使用できません。 メディアの種類: "application/json"、"application/xml"、"text/xml"、"text/json" |
500 内部サーバー エラー |
|
パートナー API サービスまたはその依存関係のいずれかが要求を満たすことができませんでした。 呼び出し元は要求を再試行できます。 メディアの種類: "application/json"、"application/xml"、"text/xml"、"text/json" |
次の手順