Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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.
Observação
A partir de 1 de abril de 2025, Gerenciamento de Permissões do Microsoft Entra deixarão de estar disponíveis para compra e, a 1 de outubro de 2025, iremos extinguir e descontinuar o suporte deste produto. Pode encontrar mais informações aqui.
Obtenha uma lista dos objetos inactiveGroupFinding e respetivas propriedades em ambientes AWS, Azure e GCP.
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) | Sem suporte. | Sem suporte. |
| Delegado (conta pessoal da Microsoft) | Sem suporte. | Sem suporte. |
| Application | PermissionsAnalytics.Read.OwnedBy | Indisponível. |
Solicitação HTTP
Listar grupos inativos do AWS:
GET /identityGovernance/permissionsAnalytics/aws/findings/microsoft.graph.inactiveGroupFinding
Listar grupos inativos do Azure:
GET /identityGovernance/permissionsAnalytics/azure/findings/microsoft.graph.inactiveGroupFinding
Listar grupos inativos do GCP:
GET /identityGovernance/permissionsAnalytics/gcp/findings/microsoft.graph.inactiveGroupFinding
Parâmetros de consulta opcionais
Este método suporta os $filter parâmetros de consulta OData e $orderby para 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, este método devolve um 200 OK código de resposta e uma coleção de objetos inactiveGroupFinding no corpo da resposta.
Exemplos
Solicitação
O exemplo seguinte mostra um pedido para listar grupos inativos do GCP.
GET https://graph.microsoft.com/beta/identityGovernance/permissionsAnalytics/gcp/findings/microsoft.graph.inactiveGroupFinding
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
{
"@odata.context": "https://graph.microsoft.com/beta/$metadata#identityGovernance/permissionsAnalytics/gcp/findings/microsoft.graph.inactiveGroupFinding",
"value": [
{
"id": "MSxJbmFjdGl2ZUdyb3VwRmluZGluZyw2MDI0NA",
"createdDateTime": "2023-10-17T15:46:31.448597Z",
"permissionsCreepIndex": {
"score": 1
},
"actionSummary": {
"assigned": 3011,
"exercised": 0,
"available": 7075
},
"group": {
"@odata.type": "#microsoft.graph.gcpGroup",
"id": "dGVzdGdyb3VwQGNsb3Vka25veC5pbw",
"externalId": "testgroup@cloudknox.io",
"displayName": "testgroup",
"source": {
"@odata.type": "#microsoft.graph.gsuiteSource",
"identityProviderType": "gsuite",
"domain": "carbide-bonsai-205017"
},
"authorizationSystem": {
"@odata.type": "#microsoft.graph.gcpAuthorizationSystem",
"authorizationSystemId": "carbide-bonsai-205017",
"authorizationSystemName": "ck-staging",
"authorizationSystemType": "gcp",
"id": "MSxnY3AsY2FyYmlkZS1ib25zYWktMjA1MDE3"
}
}
},
{
"id": "MSxJbmFjdGl2ZUdyb3VwRmluZGluZyw2MDI0NQ",
"createdDateTime": "2023-10-17T15:46:31.448597Z",
"permissionsCreepIndex": {
"score": 1
},
"actionSummary": {
"assigned": 3061,
"exercised": 0,
"available": 7075
},
"group": {
"@odata.type": "#microsoft.graph.gcpGroup",
"id": "ZW5naW5lZXJpbmdAY2xvdWRrbm94Lmlv",
"externalId": "engineering@cloudknox.io",
"displayName": "engineering",
"source": {
"@odata.type": "#microsoft.graph.gsuiteSource",
"identityProviderType": "gsuite",
"domain": "carbide-bonsai-205017"
},
"authorizationSystem": {
"@odata.type": "#microsoft.graph.gcpAuthorizationSystem",
"authorizationSystemId": "carbide-bonsai-205017",
"authorizationSystemName": "ck-staging",
"authorizationSystemType": "gcp",
"id": "MSxnY3AsY2FyYmlkZS1ib25zYWktMjA1MDE3"
}
}
}
]
}