Listar accessPackageAssignmentPoliciesList accessPackageAssignmentPolicies

Namespace: microsoft.graphNamespace: microsoft.graph

Importante

As APIs na /beta versão do Microsoft Graph estão sujeitas a alterações.APIs under the /beta version in Microsoft Graph are subject to change. Não há suporte para o uso dessas APIs em aplicativos de produção.Use of these APIs in production applications is not supported. Para determinar se uma API está disponível no v 1.0, use o seletor de versão .To determine whether an API is available in v1.0, use the Version selector.

No Gerenciamento de direitos do Azure ad, recupere uma lista de objetos accessPackageAssignmentPolicy .In Azure AD entitlement management, retrieve a list of accessPackageAssignmentPolicy objects. Se o usuário delegado estiver em uma função de diretório, a lista resultante incluirá todas as políticas de atribuição que o chamador tem acesso para ler, entre todos os catálogos e pacotes de acesso.If the delegated user is in a directory role, the resulting list includes all the assignment policies that the caller has access to read, across all catalogs and access packages. Se o usuário delegado for um Gerenciador de pacotes do Access ou proprietário do catálogo, ele deverá recuperar as políticas para os pacotes do Access que eles podem ler com o accessPackages de lista incluindo $expand=accessPackageAssignmentPolicies como um parâmetro de consulta.If the delegated user is an access package manager or catalog owner, they should instead retrieve the policies for the access packages they can read with list accessPackages by including $expand=accessPackageAssignmentPolicies as a query parameter.

PermissõesPermissions

Uma das seguintes permissões é obrigatória para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Tipo de permissãoPermission type Permissões (da com menos para a com mais privilégios)Permissions (from least to most privileged)
Delegado (conta corporativa ou de estudante)Delegated (work or school account) EntitlementManagement. Read. All, EntitlementManagement. ReadWrite. AllEntitlementManagement.Read.All, EntitlementManagement.ReadWrite.All
Delegado (conta pessoal da Microsoft)Delegated (personal Microsoft account) Sem suporte.Not supported.
AplicativoApplication Sem suporte.Not supported.

Solicitação HTTPHTTP request

GET /identityGovernance/entitlementManagement/accessPackageAssignmentPolicies

Parâmetros de consulta opcionaisOptional query parameters

Este método dá suporte a alguns parâmetros de consulta OData para ajudar a personalizar a resposta.This method supports some of the OData query parameters to help customize the response. Por exemplo, para recuperar uma política de atribuição de pacote do Access com um nome de exibição especificado, inclua $filter=displayName eq 'Employee sales support' na consulta.For example, to retrieve an access package assignment policy with a specified display name, include $filter=displayName eq 'Employee sales support' in the query. Para obter informações gerais, acesse Parâmetros de consulta OData.For general information, see OData query parameters.

Cabeçalhos de solicitaçãoRequest headers

NomeName DescriçãoDescription
AutorizaçãoAuthorization {token} de portador.Bearer {token}. Obrigatório.Required.

Corpo da solicitaçãoRequest body

Não forneça um corpo de solicitação para esse método.Do not supply a request body for this method.

RespostaResponse

Se tiver êxito, este método retornará um 200 OK código de resposta e uma coleção de objetos accessPackageAssignmentPolicy no corpo da resposta.If successful, this method returns a 200 OK response code and a collection of accessPackageAssignmentPolicy objects in the response body.

ExemplosExamples

SolicitaçãoRequest

Este é um exemplo de solicitação.The following is an example of the request.

GET https://graph.microsoft.com/beta/identityGovernance/entitlementManagement/accessPackageAssignmentPolicies

RespostaResponse

Este é um exemplo de resposta.The following is an example of the response.

Observação: o objeto response mostrado aqui pode ser encurtado para legibilidade. Todas as propriedades serão retornadas de uma chamada real.Note: The response object shown here might be shortened for readability. All the properties will be returned from an actual call.

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

{
  "value": [
    {
      "id": "b2eba9a1-b357-42ee-83a8-336522ed6cbf",
      "accessPackageId": "1b153a13-76da-4d07-9afa-c6c2b1f2e824",
      "displayName": "All Users",
      "description": "All users can request for access to the directory.",
      "canExtend": false,
      "durationInDays": 365,
      "accessReviewSettings": null
    }
  ]
}