Compartilhar via


Manage account profiles - Add new user member to role

Adiciona um novo membro de usuário à função especificada.

POST https://api.partnercenter.microsoft.com/v{version}/roles/{role_id}/usermembers

Parâmetros de URI

Nome Em Obrigatório Tipo Description
role_id
path True

string

O identificador da função.

version
path True

string

Versão da API.

Cabeçalho da solicitação

Media Types: "application/json", "application/xml", "text/xml", "application/x-www-form-urlencoded", "text/json"

Nome Obrigatório Tipo Description
Authorization True

string

Token de portador de autorização

Accept True

string

Tipo de conteúdo aceitável; aplicativo/json de tipo amplamente accepeted

ms-correlationid

string

Usado para acompanhar solicitações internamente. Se uma ms-correlationid não for fornecida, o servidor gerará uma nova para cada solicitação

ms-requestid

string

Usado para idempotency de solicitações. Se um ms-requestid não for fornecido, o servidor gerará um novo para cada solicitação

Corpo da solicitação

Media Types: "application/json", "application/xml", "text/xml", "application/x-www-form-urlencoded", "text/json"

Nome Tipo Description
accountId

string

Obtém ou define a ID da conta em que a atribuição de função está vinculada.

displayName

string

Obtém ou define o nome de exibição do usuário.

id

string

O identificador do membro.

roleId

string

O identificador da função do usuário.

userPrincipalName

string

Obtém ou define o nome da entidade de segurança do usuário.

Respostas

Nome Tipo Description
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

Havia uma entrada ausente ou inválida. O corpo da resposta fornecerá os detalhes do erro.

Media Types: "application/json", "application/xml", "text/xml", "text/json"

401 Unauthorized

A solicitação não foi autenticada. O cliente precisa se autenticar com o serviço de API do parceiro primeiro.

Media Types: "application/json", "application/xml", "text/xml", "text/json"

403 Forbidden

A solicitação foi autenticada, mas foi recusada, pois o chamador não tem os direitos de invocá-la.

Media Types: "application/json", "application/xml", "text/xml", "text/json"

404 Not Found

O recurso não foi encontrado ou não está disponível com os parâmetros de entrada fornecidos.

Media Types: "application/json", "application/xml", "text/xml", "text/json"

500 Internal Server Error

O serviço de API do parceiro ou uma de suas dependências não conseguiu atender à solicitação. Os chamadores podem repetir isso.

Media Types: "application/json", "application/xml", "text/xml", "text/json"

Definições

Nome Description
Microsoft.Partner.Sdk.Contracts.V1.Common.ResourceAttributes

Refere-se aos atributos de objeto comuns

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

Descreve as informações de membro de um usuário.

Microsoft.Partner.Sdk.Contracts.V1.Common.ResourceAttributes

Refere-se aos atributos de objeto comuns

Nome Tipo Description
etag

string

Obtém ou define a etag. A versão do objeto em provedores.

objectType

string

O tipo de objeto.

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

Descreve as informações de membro de um usuário.

Nome Tipo Description
accountId

string

Obtém ou define a ID da conta em que a atribuição de função está vinculada.

attributes

Microsoft.Partner.Sdk.Contracts.V1.Common.ResourceAttributes

Obtém os atributos.

displayName

string

Obtém ou define o nome de exibição do usuário.

id

string

O identificador do membro.

roleId

string

O identificador da função do usuário.

userPrincipalName

string

Obtém ou define o nome da entidade de segurança do usuário.