Partilhar via


Manage account profiles - Add new user member to role

Adiciona um novo membro do utilizador à função especificada.

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

Parâmetros do URI

Name Em Necessário Tipo Description
role_id
path True

string

O identificador de papéis.

version
path True

string

Versão Api.

Cabeçalho do Pedido

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

Name Necessário Tipo Description
Authorization True

string

Ficha do Portador de Autorização

Accept True

string

Tipo de conteúdo aceitável; aplicação/json tipo amplamente accepeted

ms-correlationid

string

Usado para rastrear pedidos internamente. Se um ms-correlaid não for fornecido, o servidor gerará um novo para cada pedido

ms-requestid

string

Usado para idempoteência de pedidos. Se um ms-requestid não for fornecido, o servidor gerará um novo para cada pedido

Corpo do Pedido

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

Name Tipo Description
accountId

string

Obtém ou define o id de conta onde a atribuição de funções está empatada.

displayName

string

Obtém ou define o nome de visualização para o utilizador.

id

string

O identificador do membro.

roleId

string

O identificador do papel do utilizador.

userPrincipalName

string

Obtém ou define o nome do principal utilizador.

Respostas

Name 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 desaparecida ou inválida. O corpo de resposta fornecerá os detalhes do erro.

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

401 Unauthorized

O pedido não foi autenticado. O cliente precisa de autenticar primeiro com o serviço API do parceiro.

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

403 Forbidden

O pedido foi autenticado, mas foi recusado, uma vez que o chamador não tem o direito de o invocar.

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

404 Not Found

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

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

500 Internal Server Error

O serviço API do parceiro ou uma das suas dependências não cumpriu o pedido. Os chamadores podem voltar a tentar isto.

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

Definições

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

Refere-se aos atributos comuns do objeto

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

Descreve as informações dos membros de um utilizador.

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

Refere-se aos atributos comuns do objeto

Name Tipo Description
etag

string

Fica ou define o etag. A versão de objeto em fornecedores.

objectType

string

O tipo de objeto.

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

Descreve as informações dos membros de um utilizador.

Name Tipo Description
accountId

string

Obtém ou define o id de conta onde a atribuição de funções está empatada.

attributes

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

Obtém os atributos.

displayName

string

Obtém ou define o nome de visualização para o utilizador.

id

string

O identificador do membro.

roleId

string

O identificador do papel do utilizador.

userPrincipalName

string

Obtém ou define o nome do principal utilizador.