Permissão de listaGrantPreApprovalPolicies
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.
Recupere a lista de objetos permissionGrantPreApprovalPolicy no locatário.
Permissões
Escolha a permissão ou as permissões marcadas como menos privilegiadas para essa API. Use uma permissão ou permissões privilegiadas mais altas somente se o aplicativo exigir. Para obter detalhes sobre permissões delegadas e de aplicativo, consulte Tipos de permissão. Para saber mais sobre essas permissões, consulte a referência de permissões.
Tipo de permissão | Permissões menos privilegiadas | Permissões privilegiadas mais altas |
---|---|---|
Delegado (conta corporativa ou de estudante) | Policy.Read.PermissionGrant | Policy.ReadWrite.PermissionGrant |
Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
Aplicativo | Policy.Read.PermissionGrant | Policy.ReadWrite.PermissionGrant |
Para ler a configuração, o usuário chamador também deve receber pelo menos uma das seguintes funções Microsoft Entra.
- Leitor Global
- Administrador de Aplicativos
- Administrador de Aplicativos de Nuvem
Solicitação HTTP
GET /policies/permissionGrantPreApprovalPolicies
Parâmetros de consulta opcionais
Esse método não dá suporte aos parâmetros de consulta OData ajudar a personalizar a resposta. Para obter informações gerais, acesse Parâmetros de consulta OData.
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, esse método retornará um 200 OK
código de resposta e uma coleção de objetos permissionGrantPreApprovalPolicy no corpo da resposta.
Exemplos
Solicitação
GET https://graph.microsoft.com/beta/policies/permissionGrantPreApprovalPolicies
Resposta
Observação: o objeto de resposta mostrado aqui pode ser encurtado para legibilidade.
No exemplo a seguir:
A ID
71ba13dc-5947-4e59-bcc5-0ad5c339a853
da política tem as seguintes configurações:- A condição para o
chat
tipo de recurso:- Indica que todos os chats, independentemente dos rótulos de confidencialidade, estão no escopo
- Especifica que todas as permissões de aplicativo para todas as APIs são pré-aprovadas
- A condição para o
group
tipo de recurso:- Especifica dois rótulos de confidencialidade que estão no escopo
- Especifica que duas permissões de aplicativo para o
00000003-0000-0000-c000-000000000000
aplicativo de recursos são pré-aprovadas
- A condição para o
A ID
bd4b701c-a54e-42b8-9f56-e4b4b229be3b
da política tem as seguintes configurações:- A condição para o
group
tipo de recurso:- Indica que todos os grupos, independentemente dos rótulos de confidencialidade, estão no escopo
- Especifica que todas as permissões de aplicativo para o
00000003-0000-0000-c000-000000000000
aplicativo de recursos são pré-aprovadas
- A condição para o
HTTP/1.1 200 OK
Content-Type: application/json
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#policies/permissionGrantPreApprovalPolicies",
"value": [
{
"id": "71ba13dc-5947-4e59-bcc5-0ad5c339a853",
"deletedDateTime": null,
"conditions": [
{
"scopeType": "chat",
"sensitivityLabels": {
"@odata.type": "#microsoft.graph.allScopeSensitivityLabels",
"labelKind": "all"
},
"permissions": {
"@odata.type": "#microsoft.graph.allPreApprovedPermissions",
"permissionKind": "all",
"permissionType": "application"
}
},
{
"scopeType": "group",
"scopeSensitivityLabels": {
"@odata.type": "microsoft.graph.enumeratedScopeSensitivityLabels",
"labelKind": "enumerated",
"sensitivityLabels": [
"d9c43deb-f3e1-4422-9fd6-ccf22a3206b8",
"c99dade2-aa54-4890-ac1c-a146fa26bd1e"
]
},
"permissions": {
"@odata.type": "#microsoft.graph.enumeratedPreApprovedPermissions",
"permissionKind": "enumerated",
"permissionType": "application",
"resourceApplicationId": "00000003-0000-0000-c000-000000000000",
"permissionIds": [
"134483aa-3dda-4d65-ac91-b8dda1417875",
"9d33613d-f855-483b-bca7-ea63ac9f5485"
]
}
}
]
},
{
"id": "bd4b701c-a54e-42b8-9f56-e4b4b229be3b",
"deletedDateTime": null,
"conditions": [
{
"scopeType": "group",
"sensitivityLabels": {
"@odata.type": "#microsoft.graph.allScopeSensitivityLabels",
"labelKind": "all"
},
"permissions": {
"@odata.type": "#microsoft.graph.allPermissionsOnResourceApp",
"permissionKind": "allPermissionsOnResourceApp",
"permissionType": "application",
"resourceApplicationId": "00000003-0000-0000-c000-000000000000"
}
}
]
}
]
}
Comentários
https://aka.ms/ContentUserFeedback.
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulteEnviar e exibir comentários de