Listar accessReviews (preterido)

Artigo
11/22/2024

Namespace: microsoft.graph

Importante

As APIs na versão /beta no Microsoft Graph estão sujeitas a alterações. Não há suporte para o uso dessas APIs em aplicativos de produção. Para determinar se uma API está disponível na v1.0, use o seletor Versão.

Cuidado

Esta versão da API de revisão de acesso foi preterida e deixará de devolver dados a 19 de maio de 2023. Utilize a API de revisões de acesso.

Obtenha os objetos accessReview para um determinado businessFlowTemplate. É devolvida uma lista de zero ou mais objetos accessReview , para cada revisão de acesso única e periódica que foi criada com esse modelo de fluxo de negócio. Os IDs do modelo de fluxo de negócio são sensíveis a maiúsculas e minúsculas.

Observação

Se qualquer uma das revisões de acesso que correspondem ao filtro for uma revisão de acesso periódica, será devolvido um objeto accessReview para representar cada série periódica como um todo, além de qualquer instância atual, passada e próxima. Por exemplo, se existir uma revisão de acesso periódica mensal dos membros convidados do grupo A, uma revisão de acesso periódica trimestral dos membros convidados do grupo B e uma revisão de acesso única dos membros convidados do grupo C, cada uma destas periodicidades acaba de começar e as consultas do autor da chamada para revisões de acesso com um modelo de fluxo de negócio de revisões de membros convidados de grupos, serão devolvidos três objetos que representam as três séries, bem como três objetos para as instâncias de revisão de acesso atuais e, potencialmente, três objetos para as próximas instâncias. Para obter as instâncias de uma revisão de acesso periódica ou a instância de revisão de acesso agendada para um determinado mês ou trimestre, o autor da chamada pode navegar subsequentemente na relação de instância do objeto acesso periódicoReview . A relação de instância está ligada aos objetos accessReview de uma instância atual ou anterior da revisão de acesso periódica.

Se muitas revisões de acesso corresponderem ao filtro, para melhorar a eficiência e evitar tempos limite, obtenha o conjunto de resultados em páginas, incluindo o $top parâmetro de consulta com um tamanho de página, por exemplo 100, e o $skip=0 parâmetro de consulta no pedido. Estes parâmetros podem ser incluídos mesmo quando não prevê que o pedido abrange várias páginas. Quando um conjunto de resultados abrange várias páginas, o Microsoft Graph devolve essa página com uma @odata.nextLink propriedade na resposta que contém um URL para a página seguinte de resultados. Se essa propriedade estiver presente, continue a fazer pedidos com o @odata.nextLink URL em cada resposta, até que todos os resultados sejam devolvidos, conforme descrito em paginar dados do Microsoft Graph na sua aplicação.

Os objetos accessReview devolvidos por esta API não incluem propriedades de estrutura aninhadas, como definições ou relações. Para obter as definições ou relações de revisão de acesso, utilize a API get accessReview .

Esta API está disponível nas seguintes implementações de cloud nacionais.

Serviço global	US Government L4	US Government L5 (DOD)	China operada pela 21Vianet
✅	✅	✅	✅

Permissões

Escolha a permissão ou permissões marcadas como menos privilegiadas para esta API. Utilize uma permissão ou permissões com privilégios mais elevados apenas se a sua aplicação o exigir. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja a referência de permissões.

Tipo de permissão	Permissões com menos privilégios	Permissões com privilégios superiores
Delegado (conta corporativa ou de estudante)	AccessReview.Read.All	AccessReview.ReadWrite.Membership, AccessReview.ReadWrite.All
Delegado (conta pessoal da Microsoft)	Sem suporte.	Sem suporte.
Application	AccessReview.Read.All	AccessReview.ReadWrite.Membership

O utilizador com sessão iniciada também tem de ter uma função de diretório que lhes permita ler uma revisão de acesso.

Solicitação HTTP

GET /accessReviews?$filter=businessFlowTemplateId eq {businessFlowTemplate-id}&$top={pagesize}&$skip=0

Cabeçalhos de solicitação

Nome	Tipo	Descrição
Autorização	string	{token} de portador. Obrigatório.

Corpo da solicitação

Não forneça um corpo do pedido.

Resposta

Se for bem-sucedido, este método devolve um 200 OK código de resposta e uma matriz de objetos accessReview no corpo da resposta.

Exemplos

Solicitação

O exemplo seguinte mostra um pedido para obter todas as revisões de acesso únicas e periódicas de um modelo de fluxo de negócio "6e4f3d20-c5c3-407f-9695-8460952bcc68".

GET https://graph.microsoft.com/beta/accessReviews?$filter=businessFlowTemplateId+eq+'6e4f3d20-c5c3-407f-9695-8460952bcc68'&$top=100&$skip=0


// 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.AccessReviews.GetAsync((requestConfiguration) =>
{
	requestConfiguration.QueryParameters.Filter = "businessFlowTemplateId eq '6e4f3d20-c5c3-407f-9695-8460952bcc68'";
	requestConfiguration.QueryParameters.Top = 100;
	requestConfiguration.QueryParameters.Skip = 0;
});

Importante

Os SDKs do Microsoft Graph usam a versão v1.0 da API por padrão e não oferecem suporte a todos os tipos, propriedades e APIs disponíveis na versão beta. Para obter detalhes sobre como acessar a API beta com o SDK, consulte Usar os SDKs do Microsoft Graph com a API beta.

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.



mgc-beta access-reviews list --top "100" --skip "0" --filter "businessFlowTemplateId eq '6e4f3d20-c5c3-407f-9695-8460952bcc68'"

Importante

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.



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

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


requestFilter := "businessFlowTemplateId eq '6e4f3d20-c5c3-407f-9695-8460952bcc68'"
requestTop := int32(100)
requestSkip := int32(0)

requestParameters := &graphaccessreviews.AccessReviewsRequestBuilderGetQueryParameters{
	Filter: &requestFilter,
	Top: &requestTop,
	Skip: &requestSkip,
}
configuration := &graphaccessreviews.AccessReviewsRequestBuilderGetRequestConfiguration{
	QueryParameters: requestParameters,
}

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

Importante

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.


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

GraphServiceClient graphClient = new GraphServiceClient(requestAdapter);

AccessReviewCollectionResponse result = graphClient.accessReviews().get(requestConfiguration -> {
	requestConfiguration.queryParameters.filter = "businessFlowTemplateId eq '6e4f3d20-c5c3-407f-9695-8460952bcc68'";
	requestConfiguration.queryParameters.top = 100;
	requestConfiguration.queryParameters.skip = 0;
});

Importante

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.


const options = {
	authProvider,
};

const client = Client.init(options);

let accessReviews = await client.api('/accessReviews')
	.version('beta')
	.filter('businessFlowTemplateId eq \'6e4f3d20-c5c3-407f-9695-8460952bcc68\'')
	.skip(0)
	.top(100)
	.get();

Importante

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.


<?php
use Microsoft\Graph\Beta\GraphServiceClient;
use Microsoft\Graph\Beta\Generated\AccessReviews\AccessReviewsRequestBuilderGetRequestConfiguration;


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

$requestConfiguration = new AccessReviewsRequestBuilderGetRequestConfiguration();
$queryParameters = AccessReviewsRequestBuilderGetRequestConfiguration::createQueryParameters();
$queryParameters->filter = "businessFlowTemplateId eq '6e4f3d20-c5c3-407f-9695-8460952bcc68'";
$queryParameters->top = 100;
$queryParameters->skip = 0;
$requestConfiguration->queryParameters = $queryParameters;


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

Importante

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.


Import-Module Microsoft.Graph.Beta.Identity.Governance

Get-MgBetaAccessReview -Filter "businessFlowTemplateId eq '6e4f3d20-c5c3-407f-9695-8460952bcc68'" -Top 100 -Skip 0

Importante

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.


# Code snippets are only available for the latest version. Current version is 1.x
from msgraph_beta import GraphServiceClient
from msgraph_beta.generated.access_reviews.access_reviews_request_builder import AccessReviewsRequestBuilder
from kiota_abstractions.base_request_configuration import RequestConfiguration
# To initialize your graph_client, see https://learn.microsoft.com/en-us/graph/sdks/create-client?from=snippets&tabs=python
query_params = AccessReviewsRequestBuilder.AccessReviewsRequestBuilderGetQueryParameters(
		filter = "businessFlowTemplateId eq '6e4f3d20-c5c3-407f-9695-8460952bcc68'",
		top = 100,
		skip = 0,
)

request_configuration = RequestConfiguration(
query_parameters = query_params,
)

result = await graph_client.access_reviews.get(request_configuration = request_configuration)

Importante

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.

Resposta

Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.

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

{
    "value":[
       {
         "id": "2b83cc42-09db-46f6-8c6e-16fec466a82d",
         "displayName": "review",
         "startDateTime": "2017-11-14T01:14:54.89Z",
         "endDateTime": "2017-12-14T01:14:54.89Z",
         "status": "InProgress",
         "businessFlowTemplateId": "6e4f3d20-c5c3-407f-9695-8460952bcc68",
         "reviewerType": "self",
         "description": "",
         "reviewedEntity":{"id":"3b4f7e74-eb82-4120-9ff5-ba429c1ea6df","displayName":"Salesforce"}
       }
    ]
}

Obter acessoDescrição

Compartilhar via

Listar accessReviews (preterido)

Permissões

Solicitação HTTP

Cabeçalhos de solicitação

Corpo da solicitação

Resposta

Exemplos

Solicitação

Resposta

Comentários

Recursos adicionais

Compartilhar via

Listar accessReviews (preterido)

Permissões

Solicitação HTTP

Cabeçalhos de solicitação

Corpo da solicitação

Resposta

Exemplos

Solicitação

Resposta

Conteúdo relacionado

Comentários

Recursos adicionais