Historial de listasDefinitions

Espacio de nombres: microsoft.graph

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

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

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.

Si el usuario que ha iniciado sesión no tiene al menos el miembro de rol de directorio Lector global, solo se devuelven 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

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

GET https://graph.microsoft.com/v1.0/identityGovernance/accessReviews/historyDefinitions

// Code snippets are only available for the latest version. Current version is 5.x

// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=csharp
var result = await graphClient.IdentityGovernance.AccessReviews.HistoryDefinitions.GetAsync();

mgc identity-governance access-reviews history-definitions list

// Code snippets are only available for the latest major version. Current major version is $v1.*

// Dependencies
import (
	  "context"
	  msgraphsdk "github.com/microsoftgraph/msgraph-sdk-go"
	  //other-imports
)


// To initialize your graphClient, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=go
historyDefinitions, err := graphClient.IdentityGovernance().AccessReviews().HistoryDefinitions().Get(context.Background(), nil)

// Code snippets are only available for the latest version. Current version is 6.x

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

AccessReviewHistoryDefinitionCollectionResponse result = graphClient.identityGovernance().accessReviews().historyDefinitions().get();

const options = {
	authProvider,
};

const client = Client.init(options);

let historyDefinitions = await client.api('/identityGovernance/accessReviews/historyDefinitions')
	.get();

<?php
use Microsoft\Graph\GraphServiceClient;


$graphServiceClient = new GraphServiceClient($tokenRequestContext, $scopes);


$result = $graphServiceClient->identityGovernance()->accessReviews()->historyDefinitions()->get()->wait();

Import-Module Microsoft.Graph.Identity.Governance

Get-MgIdentityGovernanceAccessReviewHistoryDefinition

# Code snippets are only available for the latest version. Current version is 1.x
from msgraph import GraphServiceClient
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python

result = await graph_client.identity_governance.access_reviews.history_definitions.get()

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
                }
            ]
        }
    ]
}