Historial de listasDefinitions

Espacio de nombres: microsoft.graph

Recupere los objetos accessReviewHistoryDefinition creados en los últimos 30 días, incluidas todas las propiedades anidadas.

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.
Application AccessReview.ReadWrite.All

Si el usuario que ha iniciado sesión no es un miembro de rol de directorio Administración global o un miembro de rol de directorio lector global, solo se devolverán las definiciones que creó el usuario que inició sesión.

Solicitud HTTP

GET /identityGovernance/accessReviews/historyDefinitions

Parámetros de consulta opcionales

Este método admite los $topparámetros de consulta , $filter, $expandy $skip OData para ayudar a personalizar la respuesta. Para obtener información general, vea Parámetros de consulta OData. Incluir ?$expand=instances devolverá los objetos accessReviewHistoryDefinitions junto con sus instancias asociadas.

El tamaño de página predeterminado de esta API es 100 objetos accessReviewHistoryDefinitions . Para mejorar la eficacia y evitar tiempos de espera debidos a grandes conjuntos de resultados, aplique la paginación mediante los $skip parámetros de consulta y $top . Para obtener más información, vea Paginación de los datos de Microsoft Graph en su aplicación.

Encabezados de solicitud

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

Cuerpo de la solicitud

No proporcione un cuerpo de solicitud para este método.

Respuesta

Si se ejecuta correctamente, este método devuelve un 200 OK código de respuesta y una colección de objetos accessReviewHistoryDefinition en el cuerpo de la respuesta.

Ejemplos

Solicitud

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.count": 1,
    "value": [
        {
            "@odata.type": "#microsoft.graph.accessReviewHistoryDefinition",
            "id": "67e3de15-d263-45a9-8f4f-71271b495db7",
            "displayName": "Last year's ELM assignment reviews - one time",
            "reviewHistoryPeriodStartDateTime": "2021-01-01T00:00:00Z",
            "reviewHistoryPeriodEndDateTime": "2021-04-05T00:00:00Z",
            "decisions": [
                "approve",
                "deny",
                "dontKnow",
                "notReviewed",
                "notNotified"
            ],
            "status": "done",
            "createdDateTime": "2021-04-14T00:22:48.9392594Z",
            "createdBy": {
                "id": "957f1027-c0ee-460d-9269-b8444459e0fe",
                "displayName": "MOD Administrator",
                "userPrincipalName": "admin@contoso.com"
            },
            "scopes": [
                {
                    "@odata.type": "#microsoft.graph.accessReviewQueryScope",
                    "queryType": "MicrosoftGraph",
                    "query": "/identityGovernance/accessReviews/definitions?$filter=contains(scope/query, 'accessPackageAssignments')",
                    "queryRoot": null
                }
            ]
        }
    ]
}