共用方式為


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.Partner.Sdk.Contracts.V1.Contracts.RoleManagement.UserMember

[確定]

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.Partner.Sdk.Contracts.V1.Common.ResourceAttributes

參考通用物件屬性

Microsoft.Partner.Sdk.Contracts.V1.Contracts.RoleManagement.UserMember

描述使用者的成員資訊。

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.Partner.Sdk.Contracts.V1.Common.ResourceAttributes

取得屬性。

displayName

string

取得或設定使用者的顯示名稱。

id

string

成員的識別碼。

roleId

string

使用者角色的識別碼。

userPrincipalName

string

取得或設定使用者主體的名稱。