Listar programControlTypesList programControlTypes

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 recurso de revisões do Azure AD Access , liste todos os objetos programControlType .In the Azure AD access reviews feature, list all the programControlType objects.

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) ProgramControl. Read. All, ProgramControl. ReadWrite. AllProgramControl.Read.All, ProgramControl.ReadWrite.All
Delegado (conta pessoal da Microsoft)Delegated (personal Microsoft account) Sem suporte.Not supported.
AplicativoApplication ProgramControl. Read. All ', ProgramControl. ReadWrite. AllProgramControl.Read.All`, ProgramControl.ReadWrite.All

O usuário conectado também deve estar em uma função de diretório que permite que ele leia um programa.The signed in user must also be in a directory role that permits them to read a program.

Solicitação HTTPHTTP request

GET /programControlTypes

Cabeçalhos de solicitaçãoRequest headers

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

Corpo da solicitaçãoRequest body

Nenhum corpo de solicitação deve ser fornecido.No request body should be supplied.

RespostaResponse

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

ExemploExample

SolicitaçãoRequest
GET https://graph.microsoft.com/beta/programControlTypes
RespostaResponse

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": "842169fe-e1b7-4ce9-98b6-6a9db02eec6b",
            "displayName": "Access Reviews for External Users' access to groups"
        },
        {
            "id": "7fbc909b-efe1-4c72-8ae6-99cb30b882de",
            "displayName": "Access Reviews for External Users' access to applications"
        },
        {
            "id": "50839a84-e23c-44a7-a8cc-16e162afc656",
            "displayName": "Access Reviews for All Users' assignment to applications"
        },
        {
            "id": "6e4f3d20-c5c3-407f-9695-8460952bcc68",
            "displayName": "Access Reviews for Microsoft 365 groups' membership"
        }
    ]
}

Confira tambémSee also

MétodoMethod Tipo de retornoReturn Type DescriçãoDescription
Listar programControls de um programaList programControls of a program coleção programControlprogramControl collection Obter uma coleção de controles de um programa.Get a collection of the controls of a program.