Agregar un miembro

Espacio de nombres: microsoft.graph

Use esta API para agregar un miembro (usuario, grupo o dispositivo) a una unidad administrativa. Actualmente solo es posible agregar un miembro a la vez a una unidad administrativa.

Permisos

Se requiere uno de los siguientes permisos para llamar a esta API. Para obtener más información, incluido cómo elegir permisos, vea Permisos.

Tipo de permiso Permisos (de menos a más privilegiados)
Delegado (cuenta profesional o educativa) AdministrativeUnit.ReadWrite.All
Delegado (cuenta de Microsoft personal) No admitida.
Aplicación AdministrativeUnit.ReadWrite.All

Para agregar un miembro a una unidad administrativa, se debe asignar a la entidad de seguridad de llamada uno de los siguientes roles de Azure AD:

  • Administrador de roles con privilegios
  • Administrador global

Solicitud HTTP

POST /directory/administrativeUnits/{id}/members/$ref

Encabezados de solicitud

Nombre Descripción
Authorization {token} de portador. Obligatorio.
Tipo de contenido application/json. Obligatorio.

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporcione el id elemento de un usuario, grupo, dispositivo o directoryObject que se va a agregar.

Respuesta

Si se ejecuta correctamente, este método devuelve el código de respuesta 204 No Content. No devuelve nada en el cuerpo de la respuesta.

Ejemplo

Solicitud

Aquí tiene un ejemplo de la solicitud.

POST https://graph.microsoft.com/v1.0/directory/administrativeUnits/{id}/members/$ref
Content-type: application/json

{
  "@odata.id":"https://graph.microsoft.com/v1.0/groups/{id}"
}

Respuesta

Aquí tiene un ejemplo de la respuesta.

HTTP/1.1 204 No Content