Listar accessPackageAssignmentRequests

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 de versão.

No gerenciamento de direitos do Azure AD,recupere uma lista de objetos accessPackageAssignmentRequest. A lista resultante inclui todas as solicitações de atribuição, atuais e bem como expiradas, que o chamador tem acesso à leitura, em todos os catálogos e pacotes de acesso.

Permissões

Uma das seguintes permissões é obrigatória para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.

Tipo de permissão Permissões (da com menos para a com mais privilégios)
Delegado (conta corporativa ou de estudante) EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All
Delegado (conta pessoal da Microsoft) Sem suporte.
Aplicativo EntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All

Solicitação HTTP

GET /identityGovernance/entitlementManagement/accessPackageAssignmentRequests

Parâmetros de consulta opcionais

Este método dá suporte aos $select parâmetros de consulta , $expand e $filter OData para ajudar a personalizar a resposta. Para obter informações gerais, acesse Parâmetros de consulta OData.

Cenários de exemplo para o uso de parâmetros de consulta

  • Para recuperar o pacote de acesso de cada solicitação, $expand=accessPackage inclua na consulta.
  • Para recuperar apenas solicitações para um pacote de acesso específico, inclua na consulta um filtro como $expand=accessPackage&$filter=accessPackage/id eq '9bbe5f7d-f1e7-4eb1-a586-38cdf6f8b1ea' .
  • Para recuperar a atribuição resultante, $expand=accessPackageAssignment inclua na consulta.
  • Para obter mais detalhes sobre o solicitante, $expand=requestor inclua na consulta.

Cabeçalhos de solicitação

Nome Descrição
Autorização {token} de portador. Obrigatório.

Corpo da solicitação

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

Resposta

Se tiver êxito, este método retornará um código de resposta e uma coleção de 200 OK objetos accessPackageAssignmentRequest no corpo da resposta.

Exemplos

Solicitação

Este é um exemplo de solicitação. O URI de solicitação inclui apenas retornar solicitações em um estado específico e para retornar detalhes do solicitante e sua $filter $expand organização conectada também.

GET https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/accessPackageAssignmentRequests?$expand=requestor($expand=connectedOrganization)&$filter=(requestState eq 'PendingApproval')

Resposta

Este é um exemplo de 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": "433dafca-5047-4614-95f7-a03510b1ded3",
      "requestType": "UserAdd",
      "requestState": "PendingApproval",
      "createdDateTime": "2019-10-25T22:55:11.623Z",
      "justification": "Need access",
      "answers": [],
      "requestor": {
        "connectedOrganizationId": "c3c2adbc-a863-437f-9383-ee578665317d",
        "id": "ba7ef0fb-e16f-474b-87aa-02815d061e67",
        "displayName": "displayname",
        "email": "displayname@example.com",
        "type": "User",
        "connectedOrganization": {
          "id": "c3c2adbc-a863-437f-9383-ee578665317d",
          "displayName": "example"
        }
      }
    }
  ]
}