Share via

Actualización de delegatedAdminRelationship

  • Artículo

Espacio de nombres: microsoft.graph

Importante

Las API de la versión /beta 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 Versión.

Actualice las propiedades de un objeto delegatedAdminRelationship .

Se aplican las restricciones siguientes:

  • Puede actualizar esta relación cuando su propiedad de estado es created.
  • Puede actualizar la propiedad autoExtendDuration cuando el estado es o createdactive.
  • Solo puede quitar el rol de administrador global Microsoft Entra cuando la propiedad status es active, lo que indica una operación de ejecución prolongada.

Esta API está disponible en las siguientes implementaciones nacionales de nube.

Servicio global Gobierno de EE. UU. L4 Us Government L5 (DOD) China operada por 21Vianet
✅ ❌ ❌ ❌

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.

Tipo de permiso Permisos con privilegios mínimos Permisos con privilegios más altos
Delegado (cuenta profesional o educativa) DelegatedAdminRelationship.ReadWrite.All No disponible.
Delegado (cuenta personal de Microsoft) No admitida. No admitida.
Aplicación DelegatedAdminRelationship.ReadWrite.All No disponible.

Para llamar a esta API mediante permisos de aplicación, debe aprovisionar la entidad de servicio identificada por appId2832473f-ec63-45fb-976f-5d45a7d4bb91 y denominada Administración delegada del cliente asociado en el inquilino del asociado. Para aprovisionar la entidad de servicio en el inquilino del asociado, llame a la API Create servicePrincipal.

Solicitud HTTP

PATCH /tenantRelationships/delegatedAdminRelationships/{delegatedAdminRelationshipId}

Encabezados de solicitud

Nombre Descripción
Authorization {token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización.
If-Match If-match: {etag}. Último valor ETag conocido para la propiedad delegatedAdminRelationship que se va a actualizar. Recupere el valor ETag de una operación LIST o GET. Obligatorio.
Content-Type application/json. Obligatorio.

Cuerpo de la solicitud

En el cuerpo de la solicitud, únicamente proporcione los valores de las propiedades que deben actualizarse. Las propiedades existentes que no se incluyen en el cuerpo de la solicitud mantienen sus valores anteriores o se recalculan en función de los cambios realizados en otros valores de propiedad.

En la tabla siguiente se especifican las propiedades que se pueden actualizar.

Propiedad Tipo Descripción
accessDetails delegatedAdminAccessDetails Identificadores de los roles administrativos a los que el asociado solicita o tiene acceso en el inquilino del cliente.
autoExtendDuration Duración Duración por la que se extiende automáticamente la validez de la relación, indicada en formato ISO 8601. Los valores admitidos son: P0D, PT0S, P180D. El valor predeterminado es PT0S. PT0S indica que la relación expira cuando se alcanza endDateTime y no se extiende automáticamente.
Cliente delegatedAdminRelationshipCustomerParticipant El nombre para mostrar y el identificador único del cliente de la relación.
displayName Cadena Nombre para mostrar de la relación utilizada para facilitar la identificación. Debe ser único en todas las relaciones de administrador delegado del asociado. La longitud máxima es de 50 caracteres.
duration Duración Duración de la relación en formato ISO 8601. Debe ser un valor entre P1D e P2Y inclusivo.

Respuesta

Si se ejecuta correctamente, este método devuelve un 200 OK código de respuesta o 202 Accepted . El cuerpo de la respuesta contiene un objeto delegatedAdminRelationship cuando la respuesta es 200 OK.

Encabezados de respuesta

Nombre Descripción
Content-Type application/json.
Ubicación Ubicación de la operación de ejecución prolongada.
Retry-After Hora a la que se puede realizar una llamada API posterior a la dirección URL de ubicación para comprobar el estado de la operación de ejecución prolongada.

Este método devuelve una 202 Accepted respuesta si quita el rol Microsoft Entra administrador global de la relación mientras su propiedad de estado es active. La respuesta incluye una dirección URL en el encabezado Location que puede usar para supervisar el progreso de la operación.

Si no proporciona el identificador de plantilla que corresponde al rol de administrador global de Microsoft Entra en la unifiedRoles matriz en la accessDetails propiedad del cuerpo de la solicitud, la API devuelve 200 OK y el objeto delegatedAdminRelationship original en el cuerpo de la respuesta.

Ejemplos

Solicitud

En el ejemplo siguiente se muestra la solicitud.

PATCH https://graph.microsoft.com/beta/tenantRelationships/delegatedAdminRelationships/5d027261-d21f-4aa9-b7db-7fa1f56fb163-8777b240-c6f0-4469-9e98-a3205431b836
If-Match: W/"JyI0NzAwNjg0NS0wMDAwLTE5MDAtMDAwMC02MGY0Yjg4MzAwMDAiJw=="
Content-Type: application/json

{
  "displayName": "Updated Contoso admin relationship",
  "duration": "P31D",
  "customer": {
    "tenantId": "52eaad04-13a2-4a2f-9ce8-93a294fadf36"
  },
  "accessDetails": {
    "unifiedRoles": [
      {
        "roleDefinitionId": "44367163-eba1-44c3-98af-f5787879f96a"
      },
      {
        "roleDefinitionId": "29232cdf-9323-42fd-ade2-1d097af3e4de"
      },
      {
        "roleDefinitionId": "69091246-20e8-4a56-aa4d-066075b2a7a8"
      },
      {
        "roleDefinitionId": "3a2c62db-5318-420d-8d74-23affee5d9d5"
      }
    ]
  },
  "autoExtendDuration": "P180D"
}

Respuesta

En el ejemplo siguiente se muestra la respuesta.

Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.

HTTP/1.1 200 OK
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.delegatedAdminRelationship",
  "@odata.context": "https://graph.microsoft.com/beta/tenantRelationships/$metadata#delegatedAdminRelationships/$entity",
  "@odata.etag": "W/\"JyIwMzAwZTM0ZS0wMDAwLTAyMDAtMDAwMC02MTRjZjI1YzAwMDAiJw==\"",
  "id": "5d027261-d21f-4aa9-b7db-7fa1f56fb163-8777b240-c6f0-4469-9e98-a3205431b836",
  "displayName": "Updated Contoso admin relationship",
  "duration": "P31D",
  "status": "created",
  "createdDateTime": "2022-02-10T11:24:42.3148266Z",
  "lastModifiedDateTime": "2022-02-10T11:26:44.9941884Z",
  "customer": {
    "tenantId": "52eaad04-13a2-4a2f-9ce8-93a294fadf36"
  },
  "accessDetails": {
    "unifiedRoles": [
      {
        "roleDefinitionId": "44367163-eba1-44c3-98af-f5787879f96a"
      },
      {
        "roleDefinitionId": "29232cdf-9323-42fd-ade2-1d097af3e4de"
      },
      {
        "roleDefinitionId": "69091246-20e8-4a56-aa4d-066075b2a7a8"
      },
      {
        "roleDefinitionId": "3a2c62db-5318-420d-8d74-23affee5d9d5"
      }
    ]
  },
  "autoExtendDuration": "P180D"
}

A continuación se muestra una respuesta de ejemplo que devuelve un 202 Accepted código de respuesta junto con los encabezados Location y Retry-After .

HTTP/1.1 202 Accepted
Location: https://graph.microsoft.com/beta/tenantRelationships/delegatedAdminRelationships/5e5594d3-6f82-458b-b567-77db4811f0cd-00000000-0000-0000-0000-000000001234/operations/d8dbb27b-7fe7-4523-a3df-f766355fe0f2
Retry-After: 10
Content-Type: application/json

{
}