Actualizar accessReviewInstance

Espacio de nombres: microsoft.graph

Actualice las propiedades de un objeto accessReviewInstance . Solo se pueden actualizar las propiedades reviewers y fallbackReviewers , pero la propiedad scope también es necesaria en el cuerpo de la solicitud. Solo puede agregar revisores a la propiedad fallbackReviewers , pero no puede quitar los fallbackReviewers existentes.

Para actualizar una accessReviewInstance, su estado debe ser InProgress.

Nota

La actualización de accessReviewInstance solo actualizará esa instancia. El accessReviewScheduleDefinition primario y cualquier objeto accessReviewInstance futuro no cambiará. Para realizar actualizaciones que se apliquen a todas las instancias futuras, actualice el objeto accessReviewScheduleDefinition primario.

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) AccessReview.ReadWrite.All
Delegado (cuenta personal de Microsoft) No admitida.
Aplicación AccessReview.ReadWrite.All

Solicitud HTTP

PUT /identityGovernance/accessReviews/definitions/{accessReviewScheduleDefinitionId}/instances/{accessReviewInstanceId}

Encabezados de solicitud

Nombre Descripción
Authorization {token} de portador. Obligatorio.
Content-Type application/json. Obligatorio.

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporcione solo los valores de las propiedades que se deben actualizar. Las propiedades ya existentes que no se incluyen en el cuerpo de la solicitud mantendrán sus valores anteriores o se recalcularán en función de los cambios en otros valores de propiedad.

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

Propiedad Tipo Descripción
fallbackReviewers colección accessReviewReviewerScope Esta colección de ámbitos de revisor se usa para definir la lista de revisores de reserva. Se notificará a estos revisores de reserva que realicen acciones si no se encuentra ningún usuario en la lista de revisores especificados. Esto podría ocurrir cuando se especifica el propietario del grupo como revisor, pero el propietario del grupo no existe, o cuando el administrador se especifica como revisor, pero el administrador de un usuario no existe. Opcional. Actualizable.
Revisores colección accessReviewReviewerScope Esta colección de ámbitos de revisión de acceso se usa para definir quiénes son los revisores. Para obtener ejemplos de opciones para asignar revisores, consulte Asignación de revisores a la definición de revisión de acceso mediante microsoft Graph API. Opcional. Actualizable.
ámbito accessReviewScope Creado en función del ámbito y la instanciaEnumerationScope en el nivel accessReviewScheduleDefinition . Define el ámbito de los usuarios revisados en un grupo. Solo lectura. Obligatorio pero no actualizado.

Respuesta

Si se ejecuta correctamente, este método devuelve un 200 OK código de respuesta y un objeto accessReviewInstance actualizado en el cuerpo de la respuesta.

Al intentar quitar los fallbackReviewers existentes, se devuelve un código de 409 Conflict respuesta.

Ejemplos

Solicitud

PATCH https://graph.microsoft.com/v1.0/identityGovernance/accessReviews/definitions/5dcfcc88-da88-4252-8629-a0807b4b076d/instances/720b8ee0-cee4-42ac-b164-894c48703acc
Content-Type: application/json

{
    "scope": {
        "@odata.type": "#microsoft.graph.principalResourceMembershipsScope",
        "principalScopes": [
            {
                "@odata.type": "#microsoft.graph.accessReviewQueryScope",
                "query": "/v1.0/users",
                "queryType": "MicrosoftGraph"
            },
            {
                "@odata.type": "#microsoft.graph.accessReviewQueryScope",
                "query": "/v1.0/groups",
                "queryType": "MicrosoftGraph"
            }
        ],
        "resourceScopes": [
            {
                "@odata.type": "#microsoft.graph.accessReviewQueryScope",
                "query": "/beta/roleManagement/directory/roleDefinitions/9b895d92-2cd3-44c7-9d02-a6ac2d5ea5c3",
                "queryType": "MicrosoftGraph"
            }
        ]
    },
    "reviewers": [
        {
            "query": "/users/1ed8ac56-4827-4733-8f80-86adc2e67db5",
            "queryType": "MicrosoftGraph"
        }
    ],
    "fallbackReviewers": [
        {
            "query": "/users/4562bcc8-c436-4f95-b7c0-4f8ce89dca5e",
            "queryType": "MicrosoftGraph"
        },
        {
            "query": "/users/1ed8ac56-4827-4733-8f80-86adc2e67db5",
            "queryType": "MicrosoftGraph"
        }
    ]
}

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.context": "https://graph.microsoft.com/v1.0/$metadata#identityGovernance/accessReviews/definitions('5dcfcc88-da88-4252-8629-a0807b4b076d')/instances/$entity",
    "id": "720b8ee0-cee4-42ac-b164-894c48703acc",
    "startDateTime": "2021-12-14T11:15:43.207Z",
    "endDateTime": "2021-12-15T11:15:43.207Z",
    "status": "InProgress",
    "scope": {
        "@odata.type": "#microsoft.graph.principalResourceMembershipsScope",
        "principalScopes": [
            {
                "@odata.type": "#microsoft.graph.accessReviewQueryScope",
                "query": "/v1.0/users",
                "queryType": "MicrosoftGraph",
                "queryRoot": null
            },
            {
                "@odata.type": "#microsoft.graph.accessReviewQueryScope",
                "query": "/v1.0/groups",
                "queryType": "MicrosoftGraph",
                "queryRoot": null
            }
        ],
        "resourceScopes": [
            {
                "@odata.type": "#microsoft.graph.accessReviewQueryScope",
                "query": "/beta/roleManagement/directory/roleDefinitions/9b895d92-2cd3-44c7-9d02-a6ac2d5ea5c3",
                "queryType": "MicrosoftGraph",
                "queryRoot": null
            }
        ]
    },
    "reviewers": [
        {
            "query": "/v1.0/users/4562bcc8-c436-4f95-b7c0-4f8ce89dca5e",
            "queryType": "MicrosoftGraph",
            "queryRoot": null
        }
    ],
    "fallbackReviewers": [
        {
            "query": "/v1.0/users/4562bcc8-c436-4f95-b7c0-4f8ce89dca5e",
            "queryType": "MicrosoftGraph",
            "queryRoot": null
        },
        {
            "query": "/v1.0/users/1ed8ac56-4827-4733-8f80-86adc2e67db5",
            "queryType": "MicrosoftGraph",
            "queryRoot": null
        }
    ]
}