Compartilhar via


accessPackageAssignment: filterByCurrentUser

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, obtenha uma lista de objetos accessPackageAssignment filtrados no utilizador com sessão iniciada.

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.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/accessPackageAssignments/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 utilizador atuais que podem ser utilizadas para filtrar na lista de atribuições de pacotes de acesso. Os valores possíveis são: target, createdBy.
  • target é utilizado para obter os accessPackageAssignment objetos em que o utilizador com sessão iniciada é o destino. A lista resultante inclui todas as atribuições, atuais e expiradas, para o autor da chamada em todos os catálogos e pacotes de acesso.

  • createdBy é utilizado para obter os accessPackageAssignment objetos criados pelo utilizador com sessão iniciada. A lista resultante inclui todas as atribuições que o autor da chamada criou para si ou em nome de outras pessoas, como, por exemplo, no caso de atribuição direta de 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, este método devolve um 200 OK código de resposta e uma coleção accessPackageAssignment no corpo da resposta.

Quando um conjunto de resultados abrange várias páginas, o Microsoft Graph devolve essa página com uma @odata.nextLink propriedade na resposta que contém um URL para a página seguinte de resultados. Se essa propriedade estiver presente, continue a fazer mais pedidos com o @odata.nextLink URL em cada resposta, até que todos os resultados sejam devolvidos. Para obter mais informações, veja Paginar dados do Microsoft Graph na sua aplicação.

Exemplos

O exemplo seguinte obtém a status de atribuições de pacotes de acesso direcionadas para o utilizador com sessão iniciada.

Solicitação

O exemplo a seguir mostra uma solicitação.

GET https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/accessPackageAssignments/filterByCurrentUser(on='target')

Resposta

O exemplo a seguir mostra a resposta.

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

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

{
  "value": [
        {
            "@odata.type": "#microsoft.graph.accessPackageAssignment",
            "id": "5521fb4f-6a6c-410a-9191-461a65fd39d4",
            "catalogId": "34cfe9a8-88bc-4c82-b3d8-6b77d7035c33",
            "accessPackageId": "ca6992f8-e413-49a1-9619-c9819f4f73e0",
            "assignmentPolicyId": "7c6e6874-789e-4f11-b351-cc7b5883deef",
            "targetId": "2cb14f51-0108-41d8-89da-cd0e05e2c988",
            "assignmentStatus": "Delivered",
            "assignmentState": "Delivered",
            "isExtended": false,
            "expiredDateTime": null,
            "schedule": {
                "startDateTime": "2021-01-19T20:02:36.013Z",
                "recurrence": null,
                "expiration": {
                    "endDateTime": "2022-01-19T20:02:36.013Z",
                    "duration": null,
                    "type": "afterDateTime"
                }
            }
        }
  ]
}