Atualizar adminConsentRequestPolicy

Namespace: microsoft.graph

Atualize as propriedades de um objeto adminConsentRequestPolicy .

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)	Policy.ReadWrite.ConsentRequest	Directory.ReadWrite.All
Delegado (conta pessoal da Microsoft)	Sem suporte.	Sem suporte.
Application	Policy.ReadWrite.ConsentRequest	Directory.ReadWrite.All

Para cenários delegados, o usuário de chamada precisa pertencer a pelo menos as funções Administrador de Aplicativos ou Administrador de Aplicativos na NuvemMicrosoft Entra.

Solicitação HTTP

PUT /policies/adminConsentRequestPolicy

Cabeçalhos de solicitação

Nome	Descrição
Autorização	{token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.
Content-Type	application/json. Obrigatório.

Corpo da solicitação

No corpo da solicitação, forneça uma representação JSON do objeto adminConsentRequestPolicy .

A tabela a seguir mostra as propriedades necessárias ao atualizar o adminConsentRequestPolicy.

Propriedade	Tipo	Descrição
isEnabled	Booliano	Especifica se o recurso de solicitação de consentimento do administrador está habilitado ou desabilitado.
notifyReviewers	Booliano	Especifica se os revisores receberão notificações.
lembretesEnabled	Booliano	Especifica se os revisores receberão emails de lembrete.
requestDurationInDays	Int32	Especifica a duração em que a solicitação está ativa antes de expirar automaticamente se nenhuma decisão for aplicada.
Revisores	coleção accessReviewReviewerScope	A lista de revisores para o consentimento do administrador.

Resposta

Se for bem-sucedido, esse método retornará um 204 No content código de resposta e um objeto adminConsentRequestPolicy atualizado no corpo da resposta.

Exemplos

Solicitação

HTTP

PUT https://graph.microsoft.com/v1.0/policies/adminConsentRequestPolicy 
Content-Type: application/json

{
  "isEnabled": true,
  "notifyReviewers": true,
  "remindersEnabled": true,
  "requestDurationInDays": 5,
  "reviewers": [
    {
      "query": "/users/b6879be8-fb87-4482-a72e-18445d2b5c54",
      "queryType": "MicrosoftGraph"
    },
    {
      "query": "/users/b3427cc5-bf69-4dcd-95f7-ed1eb432f5e9",
      "queryType": "MicrosoftGraph"
    }
  ]
}

JavaScript

const options = {
	authProvider,
};

const client = Client.init(options);

const adminConsentRequestPolicy = {
  isEnabled: true,
  notifyReviewers: true,
  remindersEnabled: true,
  requestDurationInDays: 5,
  reviewers: [
    {
      query: '/users/b6879be8-fb87-4482-a72e-18445d2b5c54',
      queryType: 'MicrosoftGraph'
    },
    {
      query: '/users/b3427cc5-bf69-4dcd-95f7-ed1eb432f5e9',
      queryType: 'MicrosoftGraph'
    }
  ]
};

await client.api('/policies/adminConsentRequestPolicy')
	.put(adminConsentRequestPolicy);

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

Resposta

HTTP/1.1 204 No Content
Content-Type: text/plain