Manage account profiles - Add new user member to role
將新的使用者成員新增至指定的角色。
POST https://api.partnercenter.microsoft.com/v{version}/roles/{role_id}/usermembers
URI 參數
名稱 | 位於 | 必要 | 類型 | Description |
---|---|---|---|---|
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"
名稱 | 必要 | 類型 | Description |
---|---|---|---|
Authorization | True |
string |
授權持有人權杖 |
Accept | True |
string |
可接受的內容類型;廣泛加入類型應用程式/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"
名稱 | 類型 | Description |
---|---|---|
accountId |
string |
取得或設定系結角色指派的帳戶識別碼。 |
displayName |
string |
取得或設定使用者的顯示名稱。 |
id |
string |
成員的識別碼。 |
roleId |
string |
使用者角色的識別碼。 |
userPrincipalName |
string |
取得或設定使用者主體的名稱。 |
回應
名稱 | 類型 | Description |
---|---|---|
200 OK |
object |
[確定] Media Types: "application/json", "application/xml", "text/xml", "text/json" |
201 Created |
Microsoft. |
[確定] 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" |
定義
名稱 | Description |
---|---|
Microsoft. |
參考通用物件屬性 |
Microsoft. |
描述使用者的成員資訊。 |
Microsoft.Partner.Sdk.Contracts.V1.Common.ResourceAttributes
參考通用物件屬性
名稱 | 類型 | Description |
---|---|---|
etag |
string |
取得或設定 etag。 提供者中的物件版本。 |
objectType |
string |
物件的型別。 |
Microsoft.Partner.Sdk.Contracts.V1.Contracts.RoleManagement.UserMember
描述使用者的成員資訊。
名稱 | 類型 | Description |
---|---|---|
accountId |
string |
取得或設定系結角色指派的帳戶識別碼。 |
attributes |
Microsoft. |
取得屬性。 |
displayName |
string |
取得或設定使用者的顯示名稱。 |
id |
string |
成員的識別碼。 |
roleId |
string |
使用者角色的識別碼。 |
userPrincipalName |
string |
取得或設定使用者主體的名稱。 |