accessPackageAssignment: filterByCurrentUser

Namespace: microsoft.graph

No Gerenciamento de Direitos do Microsoft Entra, recupere uma lista de objetos accessPackageAssignment filtrados no usuário conectado.

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) EntitlementMgmt-SubjectAccess.ReadWrite EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All
Delegado (conta pessoal da Microsoft) Sem suporte. Sem suporte.
Aplicativo Sem suporte. Sem suporte.

Solicitação HTTP

GET /identityGovernance/entitlementManagement/assignments/filterByCurrentUser(on='parameterValue')

Parâmetros de função

A tabela a seguir mostra os parâmetros que podem ser usados com esta função.

Parâmetro Tipo Descrição
on accessPackageAssignmentFilterByCurrentUserOptions A lista de opções de usuário que podem ser usadas para filtrar na lista de atribuições de pacote de acesso. Os valores possíveis são: target, createdBy.
  • target é usado para obter os accessPackageAssignment objetos em que o usuário conectado é o destino. A lista resultante inclui todas as atribuições, atuais e expiradas, para o chamador em todos os catálogos e pacotes de acesso.

  • createdBy é usado para obter os accessPackageAssignment objetos criados pelo usuário conectado. A lista resultante inclui todas as atribuições que o chamador criou para si mesmo ou em nome de outras pessoas, como no caso de atribuição direta do administrador, em todos os catálogos e pacotes de acesso.

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, esse método retornará um código de 200 OK resposta e uma coleção accessPackageAssignment no corpo da resposta.

Quando um conjunto de resultados se estende por várias páginas, o Microsoft Graph retorna essa página com uma @odata.nextLink propriedade na resposta que contém uma URL para a próxima página de resultados. Se essa propriedade estiver presente, continue fazendo solicitações adicionais com a @odata.nextLink URL em cada resposta, até que todos os resultados sejam retornados. Para obter mais informações, consulte paginação de dados do Microsoft Graph em seu aplicativo.

Exemplos

Solicitação

GET https://graph.microsoft.com/v1.0/identityGovernance/entitlementManagement/assignments/filterByCurrentUser(on='target')

Resposta

Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.

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

{
  "value": [
    {
      "id": "5521fb4f-6a6c-410a-9191-461a65fd39d4",
      "state": "delivered",
      "status": "Delivered",
      "expiredDateTime": "null",
      "schedule": {
        "@odata.type": "microsoft.graph.entitlementManagementSchedule"
      }
    }
  ]
}