Obter accessReview (preterido)
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.
No recurso Microsoft Entra revisões de acesso, recupere um objeto accessReview.
Para recuperar os revisores da revisão de acesso, use a API de revisores do list accessReview . Para recuperar as decisões da revisão de acesso, use a API de decisões do accessReview da lista ou a API de decisões do accessReview .
Se essa for uma revisão de acesso recorrente, nenhuma decisão será associada à série de revisão de acesso recorrente. Em vez disso, use a instances
relação dessa série para recuperar uma coleção accessReview das instâncias passadas, atuais e futuras da revisão de acesso. Cada instância passada e atual terá decisões.
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 |
Para chamar essa API, o usuário conectado também deve estar em uma função de diretório que lhes permita ler uma revisão de acesso ou o usuário pode ser atribuído como revisor na revisão de acesso. Para obter mais detalhes, confira os requisitos de função e permissão para revisões de acesso.
Solicitação HTTP
GET /accessReviews/{reviewId}
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 para esse método.
Resposta
Se for bem-sucedido, esse método retornará um 200 OK
código de resposta e um objeto accessReview no corpo da resposta.
Exemplo
Solicitação
GET https://graph.microsoft.com/beta/accessReviews/2b83cc42-09db-46f6-8c6e-16fec466a82d
Resposta
Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.
HTTP/1.1 200 OK
Content-type: application/json
{
"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"},
"settings": {
"mailNotificationsEnabled": true,
"remindersEnabled": true,
"justificationRequiredOnApproval": true,
"autoReviewEnabled": false,
"activityDurationInDays": 30,
"autoApplyReviewResultsEnabled": false,
"accessRecommendationsEnabled": false,
"recurrenceSettings": {
"recurrenceType": "onetime",
"recurrenceEndType": "endBy",
"durationInDays": 0,
"recurrenceCount": 0
},
"autoReviewSettings": {
"notReviewedResult": "Deny"
}
}
}