Compartir a través de


Manage account profiles - Add new user member to role

Agrega un nuevo miembro de usuario al rol especificado.

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

Parámetros de identificador URI

Nombre En Requerido Tipo Description
role_id
path True

string

Identificador del rol.

version
path True

string

Versión de api.

Encabezado de la solicitud

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

Nombre Requerido Tipo Description
Authorization True

string

Token de portador de autorización

Accept True

string

Tipo de contenido aceptable; aplicación/json de tipo ampliamente accepeted

ms-correlationid

string

Se usa para realizar el seguimiento de solicitudes internamente. Si no se proporciona un valor ms-correlationid, el servidor generará uno nuevo para cada solicitud.

ms-requestid

string

Se usa para la idempotencia de las solicitudes. Si no se proporciona un ms-requestid, el servidor generará uno nuevo para cada solicitud.

Cuerpo de la solicitud

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

Nombre Tipo Description
accountId

string

Obtiene o establece el identificador de cuenta donde está vinculada la asignación de roles.

displayName

string

Obtiene o establece el nombre para mostrar del usuario.

id

string

Identificador del miembro.

roleId

string

Identificador del rol del usuario.

userPrincipalName

string

Obtiene o establece el nombre de la entidad de seguridad de usuario.

Respuestas

Nombre Tipo Description
200 OK

object

Aceptar

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

201 Created

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

Aceptar

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

400 Bad Request

Faltaba o faltaba una entrada no válida. El cuerpo de la respuesta proporcionará los detalles del error.

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

401 Unauthorized

La solicitud no se ha autenticado. El cliente debe autenticarse primero con el servicio de API de asociado.

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

403 Forbidden

La solicitud se autenticó pero se rechazó, ya que el autor de la llamada no tiene los derechos para invocarla.

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

404 Not Found

El recurso no se encuentra o no está disponible con los parámetros de entrada especificados.

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

500 Internal Server Error

El servicio de API del asociado o una de sus dependencias no pudo cumplir la solicitud. Los autores de llamadas pueden reintentar esto.

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

Definiciones

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

Hace referencia a los atributos de objeto comunes

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

Describe la información de miembro de un usuario.

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

Hace referencia a los atributos de objeto comunes

Nombre Tipo Description
etag

string

Obtiene o establece la etag. Versión del objeto en proveedores.

objectType

string

Tipo del objeto.

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

Describe la información de miembro de un usuario.

Nombre Tipo Description
accountId

string

Obtiene o establece el identificador de cuenta donde está vinculada la asignación de roles.

attributes

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

Obtiene los atributos.

displayName

string

Obtiene o establece el nombre para mostrar del usuario.

id

string

Identificador del miembro.

roleId

string

Identificador del rol del usuario.

userPrincipalName

string

Obtiene o establece el nombre de la entidad de seguridad de usuario.