accessPackageAssignmentRequest: cancelar

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.

No Microsoft Entra Gestão de Direitos, cancele os objetos accessPackageAssignmentRequest que estão num estado cancelável: accepted, , pendingApproval, pendingNotBeforependingApprovalEscalated.

Esta API está disponível nas seguintes implementações de cloud nacionais.

Serviço global US Government L4 US Government L5 (DOD) China operada pela 21Vianet

Permissões

Escolha a permissão ou permissões marcadas como menos privilegiadas para esta API. Utilize uma permissão ou permissões com privilégios mais elevados apenas se a sua aplicação o exigir. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja a referência de permissões.

Tipo de permissão Permissões com menos privilégios Permissões com privilégios superiores
Delegado (conta corporativa ou de estudante) EntitlementMgmt-SubjectAccess.ReadWrite EntitlementManagement.ReadWrite.All
Delegado (conta pessoal da Microsoft) Sem suporte. Sem suporte.
Aplicativo Sem suporte. Sem suporte.

Dica

A função e a permissão necessárias para o acesso delegado através de contas escolares ou profissionais dependem de cujo pedido está a ser cancelado.

Os utilizadores finais cancelam o seu próprio pedido:

  • O utilizador com sessão iniciada não precisa de uma função de administrador.
  • A permissão com menos privilégios é EntitlementMgmt-SubjectAccess.ReadWrite.

Administradores que cancelam pedidos submetidos por outras pessoas:

  • A permissão com menos privilégios é EntitlementManagement.ReadWrite.All.
  • Tem de ser atribuída uma função de administrador suportada ao utilizador com sessão iniciada. Funções suportadas, do menor para o mais privilegiado:

Em cenários apenas de aplicações, a aplicação de chamadas pode ser atribuída a uma das funções suportadas anteriores em vez da permissão da aplicação EntitlementManagement.ReadWrite.All . A função gestor de atribuições de pacotes do Access tem menos privilégios do que a permissão da aplicação EntitlementManagement.ReadWrite.All .

Para obter mais informações, veja Delegação e funções na gestão de direitos e como delegar a governação de acesso aos gestores de pacotes de acesso na gestão de direitos.

Solicitação HTTP

Observação

O /accessPackageAssignmentRequests caminho será descontinuado em breve. Use o caminho /assignmentRequests no lugar.

POST /identityGovernance/entitlementManagement/assignmentRequests/{accessPackageAssignmentRequestId}/cancel
POST /identityGovernance/entitlementManagement/accessPackageAssignmentRequests/{id}/cancel

Cabeçalhos de solicitação

Nome Descrição
Autorização {token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.

Corpo da solicitação

No corpo do pedido, forneça uma representação JSON de um objeto accessPackageAssignmentRequest .

Para que um utilizador não administrador cancele o seu próprio pedido, o pedido tem de conter o ID do accessPackageAssignmentRequest e um requestStatus com um valor de cancelled.

Resposta

Se tiver êxito, este método retornará um código de resposta 200 OK. Não devolve nada no corpo da resposta.

Exemplos

Solicitação

O exemplo a seguir mostra uma solicitação.

POST https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/accessPackageAssignmentRequests/{id}/cancel

{
  "id":"request-id",
  "requestStatus":"cancelled"
}

Resposta

O exemplo a seguir mostra a resposta.

HTTP/1.1 200 OK