Acesso de listaRevisões (preterida)

  • Artigo

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 está preterida e deixará de retornar dados em 19 de maio de 2023. Use a API de revisões de acesso.

Recupere os objetos accessReview para um businessFlowTemplate específico. Uma lista de zero ou mais objetos accessReview são retornados para cada revisão de acesso única e recorrente criada com esse modelo de fluxo de negócios. Observe que as IDs de modelo de fluxo de negócios são sensíveis a maiúsculas de minúsculas.

Observação

Se qualquer uma das revisões de acesso que correspondem ao filtro for uma revisão de acesso recorrente, um objeto accessReview será retornado para representar cada série recorrente como um todo, além de qualquer instância atual, passada e próxima. Por exemplo, se houver uma revisão de acesso recorrente mensal de membros convidados do grupo A, uma revisão trimestral de acesso recorrente de membros convidados do grupo B e uma revisão de acesso único de membros convidados do grupo C, cada uma dessas recorrências acaba de começar, e as consultas de chamada para revisões de acesso com um modelo de fluxo de negócios de revisões de membros convidados de grupos, três objetos serão retornados representando as três séries, bem como três objetos para as instâncias atuais de revisão de acesso e, potencialmente, três objetos para as próximas instâncias. Para recuperar as instâncias de uma revisão de acesso recorrente ou a instância de revisão de acesso agendada para um determinado mês ou trimestre, o chamador pode navegar posteriormente na relação de instância do objeto accessReview recorrente. A relação de instância é vinculada aos objetos accessReview para instâncias atuais ou passadas da revisão de acesso recorrente.

Se muitas revisões de acesso corresponderem ao filtro, para melhorar a eficiência e evitar tempo limite, recupere 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 na solicitação. Esses parâmetros podem ser incluídos mesmo quando você não prevê que a solicitação abrangerá várias páginas. Quando um conjunto de resultados abrange várias páginas, o Microsoft Graph retorna essa página com uma @odata.nextLink propriedade na resposta que contém uma URL para a próxima página de resultados. Se essa propriedade estiver presente, continue fazendo solicitações adicionais com o @odata.nextLink URL em cada resposta, até que todos os resultados sejam retornados, conforme descrito em paginação de dados do Microsoft Graph no aplicativo.

Os objetos accessReview retornados por essa API não incluirão propriedades aninhadas da estrutura, como configurações ou relações. Para recuperar as configurações ou as relações de revisão de acesso, use a API get accessReview .

Essa API está disponível nas seguintes implantações nacionais de nuvem.

Serviço global Governo dos EUA L4 GOVERNO DOS EUA L5 (DOD) China operada pela 21Vianet
✅ ✅ ✅ ✅

Permissões

Escolha a permissão ou as permissões marcadas como menos privilegiadas para essa API. Use uma permissão ou permissões privilegiadas mais altas somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.

Tipo de permissão Permissões menos privilegiadas Permissões privilegiadas mais altas
Delegado (conta corporativa ou de estudante) AccessReview.Read.All AccessReview.ReadWrite.Membership, AccessReview.ReadWrite.All
Delegado (conta pessoal da Microsoft) Sem suporte. Sem suporte.
Aplicativo AccessReview.Read.All AccessReview.ReadWrite.Membership

O usuário conectado também deve estar em 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 de solicitação.

Resposta

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

Exemplos

Solicitação

O exemplo a seguir mostra uma solicitação para recuperar todas as revisões de acesso pontuais e recorrentes para um modelo de fluxo de negócios '6e4f3d20-c5c3-407f-9695-8460952bcc68'.

GET https://graph.microsoft.com/beta/accessReviews?$filter=businessFlowTemplateId+eq+'6e4f3d20-c5c3-407f-9695-8460952bcc68'&$top=100&$skip=0
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"}
       }
    ]
}

Conteúdo relacionado