Partilhar via

accessPackageAssignment: reprocesso

  • Artigo

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, os autores de chamadas podem reavaliar e impor automaticamente um objeto accessPackageAssignment das atribuições de um utilizador para um pacote de acesso específico. A assignmentState do pacote de acesso tem de ser Delivered para que o administrador reprocesse a atribuição do utilizador. Apenas os administradores com a função Gestor de Atribuições de Pacotes de Acesso, ou superior, no Microsoft Entra gestão de direitos podem realizar esta ação.

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) EntitlementManagement.ReadWrite.All Indisponível.
Delegado (conta pessoal da Microsoft) Sem suporte. Sem suporte.
Application EntitlementManagement.ReadWrite.All Indisponível.

Dica

Em cenários delegados com contas escolares ou profissionais, o utilizador com sessão iniciada também tem de ter uma função de administrador com permissões de função suportadas através de uma das seguintes opções:

  • Uma função no sistema de Gestão de Direitos em que as funções com menos privilégios são:
    • 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
  • Mais funções de Microsoft Entra privilegiadas suportadas para esta operação:
    • Administrador de Governação de Identidades

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

POST /identityGovernance/entitlementManagement/accessPackageAssignments/{id}/reprocess

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

Não forneça um corpo de solicitação para esse método.

Resposta

Se for bem-sucedido, este método devolve um 202 Accepted código de resposta e reavalia e impõe as atribuições do utilizador do objeto accessPackageAssignment, o que significa que a status do pacote de acesso é alterada para entrega. Se a atribuição não existir, este método devolve404 Not Found ou, se o ID não for válido, este método devolve um 400 Bad Request código de resposta.

Exemplos

Solicitação

O exemplo a seguir mostra uma solicitação.

POST https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/accessPackageAssignments/d82eb508-acc4-43cc-bcf1-7c1c4a2c073b/reprocess

Resposta

O exemplo a seguir mostra a resposta.

HTTP/1.1 202 Accepted