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

可接受的内容类型;广泛加入类型 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.Partner.Sdk.Contracts.V1.Contracts.RoleManagement.UserMember

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

引用公共对象属性

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

描述用户的成员信息。

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

获取属性。

displayName

string

获取或设置用户的显示名称。

id

string

成员的标识符。

roleId

string

用户角色的标识符。

userPrincipalName

string

获取或设置用户主体的名称。