Atualizar 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, atualize um objeto accessReview existente para alterar uma ou mais de suas propriedades.
Essa API não se destina a alterar os revisores ou as decisões de uma revisão. Para alterar os revisores, use as APIs addReviewer ou removeReviewer . Para interromper uma revisão única já iniciada ou uma instância já iniciada de uma revisão recorrente, mais cedo, use a API de parada . Para aplicar as decisões ao grupo de destino ou aos direitos de acesso ao aplicativo, use a API de aplicação .
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.ReadWrite.Membership | AccessReview.ReadWrite.All |
Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
Aplicativo | AccessReview.ReadWrite.Membership | Indisponível. |
Solicitação HTTP
PATCH /accessReviews/{reviewId}
Cabeçalhos de solicitação
Nome | Tipo | Descrição |
---|---|---|
Autorização | string | {token} de portador. Obrigatório. |
Corpo da solicitação
No corpo da solicitação, forneça uma representação JSON dos parâmetros de um objeto accessReview .
A tabela a seguir mostra as propriedades que podem ser fornecidas quando você atualiza um accessReview.
Propriedade | Tipo | Descrição |
---|---|---|
displayName | Cadeia de caracteres | O nome da revisão de acesso. |
startDateTime | DateTimeOffset | O DateTime quando a revisão está agendada para ser iniciada. Isso deve ser uma data no futuro. |
endDateTime | DateTimeOffset | O DateTime quando a revisão está agendada para terminar. Isso deve ser pelo menos um dia depois da data de início. |
description | Cadeia de caracteres | A descrição, para mostrar aos revisores. |
Resposta
Se for bem-sucedido, esse método retornará um 204 Accepted
código de resposta e um objeto accessReview no corpo da resposta.
Exemplo
Este é um exemplo de atualização de uma revisão de acesso única (não recorrente).
Solicitação
No corpo da solicitação, forneça uma representação JSON das novas propriedades do objeto accessReview .
PATCH https://graph.microsoft.com/beta/accessReviews/006111db-0810-4494-a6df-904d368bd81b
Content-type: application/json
{
"displayName":"TestReview new name"
}
Resposta
Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.
HTTP/1.1 204 Accepted
Content-type: application/json
{
"id": "006111db-0810-4494-a6df-904d368bd81b",
"displayName": "TestReview new name",
"startDateTime": "2017-02-10T00:35:53.214Z",
"endDateTime": "2017-03-12T00:35:53.214Z",
"status": "Initializing",
"businessFlowTemplateId": "6e4f3d20-c5c3-407f-9695-8460952bcc68",
"reviewerType": "delegated",
"description": "Sample description"
}
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de