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. |
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 |
获取或设置用户主体的名称。 |