Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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:
- Uma função no sistema de Gestão de Direitos:
- Gestor de atribuições de pacotes de acesso. Esta é a opção com menos privilégios
- Gestor de pacotes de acesso
- Proprietário do catálogo
- Uma função de Microsoft Entra mais privilegiada:
- Administrador de Governação de Identidades
- Uma função no sistema de Gestão de Direitos:
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