privilegedAccessGroupAssignmentScheduleRequest: updateRequest

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.

Atualize um objeto privilegedAccessGroupAssignmentScheduleRequest com o resultado de uma avaliação de extensão personalizada para uma solicitação de associação de grupo ou atribuição de propriedade.

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

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

Permissões

Escolha a(s) permissão(s) marcada(s) como menos privilegiada(s) para essa API. Use uma permissão ou permissões com privilégios mais altos 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 com privilégios mais elevados
Delegado (conta corporativa ou de estudante) PrivilegedAssignmentSchedule.ReadWrite.AzureADGroup Indisponível.
Delegado (conta pessoal da Microsoft) Sem suporte. Sem suporte.
Application PrivilegedAssignmentSchedule.ReadWrite.AzureADGroup Indisponível.

Importante

Para acesso delegado usando contas corporativas ou de estudante, o usuário conectado deve ser proprietário ou membro do grupo ou ser atribuído a uma função do Microsoft Entra com suporte ou uma função personalizada que conceda as permissões necessárias para esta operação. Esta operação dá suporte às seguintes funções internas, que fornecem apenas o menor privilégio necessário:

  • Para grupos atribuíveis à função: Administrador de Função Privilegiada
  • Para grupos não atribuíveis à função: Gravador de Diretório, Administrador de Grupos, Administrador de Governança de Identidade ou Administrador de Usuário

As atribuições de função para o usuário que está chamando devem ter como escopo o nível do diretório.

Outras funções com permissões para gerenciar grupos (como Administradores do Exchange para grupos do Microsoft 365 não atribuíveis a funções) e administradores com atribuições no nível da unidade administrativa podem gerenciar grupos por meio da API de grupos e substituir as alterações feitas no Microsoft Entra PIM por meio das APIs PIM for Groups.

Solicitação HTTP

POST /identityGovernance/privilegedAccess/group/assignmentScheduleRequests/{privilegedAccessGroupAssignmentScheduleRequestId}/updateRequest

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

Forneça um objeto JSON com os seguintes parâmetros no corpo da solicitação.

Parâmetro Tipo Descrição
evaluationId Cadeia de caracteres O identificador exclusivo da avaliação de extensão personalizada. Opcional.
evaluationOutcome evaluationOutcome O resultado da avaliação da extensão personalizada. Os valores possíveis são: approved, denied, unknownFutureValue. Opcional.
motivo Cadeia de caracteres O motivo do resultado da avaliação. Opcional.
Informações de agendamento requestSchedule A agenda atualizada para a atribuição de grupo. Opcional.

Resposta

Se for bem-sucedida, essa ação retornará um código de 200 OK resposta e um objeto privilegedAccessGroupAssignmentScheduleRequest no corpo da resposta.

Exemplo

Solicitação

O exemplo a seguir envia uma avaliação de extensão personalizada aprovada.

POST https://graph.microsoft.com/beta/identityGovernance/privilegedAccess/group/assignmentScheduleRequests/f4b57a8c-da56-4ae0-8aef-65c3a043dab4/updateRequest
Content-Type: application/json

{
  "evaluationId": "d4e5f6a7-b8c9-4d0e-9f1a-2b3c4d5e6f7a",
  "evaluationOutcome": "approved",
  "reason": "The ticket information is valid.",
  "scheduleInfo": {
    "startDateTime": "2026-09-16T19:00:00Z",
    "expiration": {
      "type": "afterDuration",
      "duration": "PT8H"
    }
  }
}

Resposta

O exemplo a seguir mostra a resposta. A resposta pode ser abreviada para facilitar a legibilidade.

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

{
  "@odata.type": "#microsoft.graph.privilegedAccessGroupAssignmentScheduleRequest",
  "id": "f4b57a8c-da56-4ae0-8aef-65c3a043dab4",
  "status": "Granted",
  "action": "selfActivate",
  "principalId": "11bb11bb-cc22-dd33-ee44-55ff55ff55ff",
  "accessId": "member",
  "groupId": "55aa55aa-bb66-cc77-dd88-99ee99ee99ee",
  "justification": "Respond to the service incident"
}
  • Última atualização em