Compartilhar via


accessPackageAssignmentRequest: 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 accessPackageAssignmentRequest 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

Observação

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

GET /identityGovernance/entitlementManagement/assignmentRequests/filterByCurrentUser(on='parameterValue')
GET /identityGovernance/entitlementManagement/accessPackageAssignmentRequests/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 accessPackageAssignmentRequestFilterByCurrentUserOptions A lista de opções de utilizador atuais que podem ser utilizadas para filtrar na lista de pedidos de atribuição de pacotes de acesso. Os valores possíveis são target, createdBy, approver.
  • target é utilizado para obter os accessPackageAssignmentRequest objetos em que o utilizador com sessão iniciada é o destino. A lista resultante inclui todos os pedidos de atribuição, atuais e expirados, que foram pedidos pelo autor da chamada ou para o autor da chamada, em todos os catálogos e pacotes de acesso.

  • createdBy é utilizado para obter os accessPackageAssignmentRequest objetos criados pelo utilizador com sessão iniciada. A lista resultante inclui todos os pedidos de atribuição que o autor da chamada criou para si ou em nome de outras pessoas, como, por exemplo, em caso de atribuição direta de administrador, em todos os catálogos e pacotes de acesso.

  • approveré utilizado para obter os accessPackageAssignmentRequest objetos em que o utilizador com sessão iniciada é um aprovador permitido em qualquer (accessPackageAssignment/accessPackageAssignmentPolicy/requestApprovalSettings/approvalStagesprimaryApproversou escalationApprovers). A lista resultante inclui os pedidos de atribuição no estado pendente , em todos os catálogos e pacotes de acesso e que precisam de uma decisão do autor da chamada. A lista resultante inclui os pedidos de atribuição num pending estado, em todos os catálogos e pacotes de acesso e que precisam de uma decisão do autor da chamada.

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 accessPackageAssignmentRequest no corpo da resposta.

Exemplos

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

Solicitação

GET https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/accessPackageAssignmentRequests/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.accessPackageAssignmentRequest",
            "createdDateTime": "2021-01-19T20:02:23.907Z",
            "completedDate": "2021-01-19T20:02:40.97Z",
            "id": "46c1410d-ef96-44c5-ae9c-a577d014fe0e",
            "requestType": "AdminAdd",
            "requestState": "Delivered",
            "requestStatus": "Fulfilled",
            "isValidationOnly": false,
            "expirationDateTime": null,
            "justification": null,
            "answers": [],
            "schedule": {
                "startDateTime": "2021-01-19T20:01:57.643Z",
                "recurrence": null,
                "expiration": {
                    "endDateTime": null,
                    "duration": null,
                    "type": "noExpiration"
                }
            }
        }
    ]
}