Actualización de administrativeunit

Espacio de nombres: microsoft.graph

Importante

Las API de la /beta versión de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de versiones .

Actualice las propiedades de un objeto administrativeUnit .

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 personal de Microsoft) No admitida.
Application AdministrativeUnit.ReadWrite.All

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

  • Administrador de roles con privilegios
  • Administrador global

Solicitud HTTP

PATCH /administrativeUnits/{id}
PATCH /directory/administrativeUnits/{id}

Encabezados de solicitud

Nombre Descripción
Authorization {token} de portador. Obligatorio.

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporcione los valores de los campos relevantes que deben actualizarse. Las propiedades existentes que no se incluyan en el cuerpo de la solicitud mantendrán los valores anteriores o se recalcularán según los cambios efectuados en otros valores de propiedad. Para obtener el mejor rendimiento, no debe incluir valores existentes que no hayan cambiado.

Propiedad Tipo Descripción
description String Descripción de la unidad administrativa.
displayName String Nombre para mostrar de la unidad administrativa.
membershipRule String Regla de pertenencia dinámica para la unidad administrativa. Para obtener más información sobre las reglas que puede usar para unidades administrativas dinámicas y grupos dinámicos, consulte Uso de atributos para crear reglas avanzadas.
membershipRuleProcessingState String Se usa para controlar si la regla de pertenencia dinámica se procesa activamente. On Establézcalo en cuando desee que la regla de pertenencia dinámica esté activa y Paused si desea dejar de actualizar la pertenencia dinámicamente.
membershipType String Tipo de pertenencia para la unidad administrativa. Puede ser dynamic o assigned.
visibility String Visibilidad de la unidad administrativa. Si no se establece, el valor predeterminado es public. Se puede establecer en HiddenMembership, que oculta la pertenencia de los no miembros.

Dado que el recurso administrativeUnit admite extensiones, puede usar la PATCH operación para agregar, actualizar o eliminar sus propios datos específicos de la aplicación en propiedades personalizadas de una extensión en una instancia de administrativeUnit existente.

Respuesta

Si se ejecuta correctamente, este método devuelve un código de respuesta 204 No Content.

Ejemplo

En el ejemplo siguiente se establece una regla de pertenencia dinámica en una unidad administrativa existente para incluir todos los usuarios cuyo país está Estados Unidos.

Solicitud

PATCH https://graph.microsoft.com/beta/administrativeUnits/4d7ea995-bc0f-45c0-8c3e-132e93bf95f8
Content-type: application/json

{
    "membershipType": "Dynamic",
    "membershipRule": "(user.country -eq \"United States\")",
    "membershipRuleProcessingState": "On"
}

Respuesta

HTTP/1.1 204 No Content

Vea también