Manage account profiles - Add new user member to role
指定したロールに新しいユーザー メンバーを追加します。
POST https://api.partnercenter.microsoft.com/v{version}/roles/{role_id}/usermembers
URI パラメーター
名前 | / | 必須 | 型 | 説明 |
---|---|---|---|---|
role_id
|
path | True |
string |
ロール識別子。 |
version
|
path | True |
string |
API のバージョン。 |
要求ヘッダー
Media Types: "application/json", "application/xml", "text/xml", "application/x-www-form-urlencoded", "text/json"
名前 | 必須 | 型 | 説明 |
---|---|---|---|
Authorization | True |
string |
承認ベアラー トークン |
Accept | True |
string |
受け入れ可能なコンテンツ タイプ。広く accepeted 型の application/json |
ms-correlationid |
string |
要求を内部的に追跡するために使用されます。 ms-correlationid が指定されていない場合、サーバーは要求ごとに新しいものを生成します |
|
ms-requestid |
string |
要求のべき等性に使用されます。 ms-requestid が指定されていない場合、サーバーは要求ごとに新しいものを生成します |
要求本文
Media Types: "application/json", "application/xml", "text/xml", "application/x-www-form-urlencoded", "text/json"
名前 | 型 | 説明 |
---|---|---|
accountId |
string |
ロールの割り当てが関連付けられているアカウント ID を取得または設定します。 |
displayName |
string |
ユーザーの表示名を取得または設定します。 |
id |
string |
メンバーの識別子。 |
roleId |
string |
ユーザーのロールの識別子。 |
userPrincipalName |
string |
ユーザー プリンシパルの名前を取得または設定します。 |
応答
名前 | 型 | 説明 |
---|---|---|
200 OK |
object |
OK Media Types: "application/json", "application/xml", "text/xml", "text/json" |
201 Created |
Microsoft. |
OK Media Types: "application/json", "application/xml", "text/xml", "text/json" |
400 Bad Request |
入力が見つからないか、無効でした。 応答本文には、エラーの詳細が表示されます。 Media Types: "application/json", "application/xml", "text/xml", "text/json" |
|
401 Unauthorized |
要求が認証されませんでした。 クライアントは、最初にパートナー API サービスで認証する必要があります。 Media Types: "application/json", "application/xml", "text/xml", "text/json" |
|
403 Forbidden |
要求は認証されましたが、呼び出し元はそれを呼び出す権限がないため拒否されました。 Media Types: "application/json", "application/xml", "text/xml", "text/json" |
|
404 Not Found |
リソースが見つからないか、指定された入力パラメーターで使用できません。 Media Types: "application/json", "application/xml", "text/xml", "text/json" |
|
500 Internal Server Error |
パートナー API サービスまたはその依存関係のいずれかが要求を満たすことができませんでした。 呼び出し元はこれを再試行できます。 Media Types: "application/json", "application/xml", "text/xml", "text/json" |
定義
名前 | 説明 |
---|---|
Microsoft. |
共通オブジェクト属性を参照します。 |
Microsoft. |
ユーザーのメンバー情報について説明します。 |
Microsoft.Partner.Sdk.Contracts.V1.Common.ResourceAttributes
共通オブジェクト属性を参照します。
名前 | 型 | 説明 |
---|---|---|
etag |
string |
etag を取得または設定します。 プロバイダー内のオブジェクトのバージョン。 |
objectType |
string |
オブジェクトの型。 |
Microsoft.Partner.Sdk.Contracts.V1.Contracts.RoleManagement.UserMember
ユーザーのメンバー情報について説明します。
名前 | 型 | 説明 |
---|---|---|
accountId |
string |
ロールの割り当てが関連付けられているアカウント ID を取得または設定します。 |
attributes |
Microsoft. |
属性を取得します。 |
displayName |
string |
ユーザーの表示名を取得または設定します。 |
id |
string |
メンバーの識別子。 |
roleId |
string |
ユーザーのロールの識別子。 |
userPrincipalName |
string |
ユーザー プリンシパルの名前を取得または設定します。 |