Usar a CLI e a API Recommender

gcloud

Para listar insights de um projeto Google Cloud , execute o seguinte comando:

 gcloud recommender insights list \     --project=PROJECT_ID \     --location=LOCATION \     --insight-type=INSIGHT_TYPE \     --filter=EXPRESSION \     --limit=LIMIT \     --page-size=PAGE_SIZE \     --sort-by=SORT_BY \     --format=json 

Substitua:

• PROJECT_ID: o ID do projeto para o qual você quer listar insights. Também é possível listar todos os insights de uma pasta, organização ou conta de faturamento.
• LOCATION: o local em que os insights serão listados, como global, europe, asia-east1 ou us-central1-a.

• INSIGHT_TYPE: o tipo de insight do Network Analyzer a ser solicitado, como google.networkanalyzer.vpcnetwork.connectivityInsight.

  Para ver uma lista completa dos tipos de insight, consulte Grupos e tipos de insight.

Os seguintes campos são opcionais:

• EXPRESSION: aplique esse filtro booleano a cada recurso que você quer listar.

  Se a expressão for avaliada como True, esse item será listado. Para mais detalhes e exemplos de expressões de filtro, execute $ gcloud topic filters ou consulte a documentação de gcloud topic filters.

• LIMIT: o número máximo de recursos a serem listados. O número padrão de recursos listados é ilimitado.

• PAGE_SIZE: o número máximo de recursos a serem listados por página.

  O tamanho da página padrão é determinado pelo serviço. Caso contrário, não haverá paginação. A paginação pode ser aplicada antes ou depois de FILTER e LIMIT.

• SORT_BY: uma lista de nomes de chave de campo separados por vírgulas para classificar de acordo com um recurso.

  A ordem padrão é crescente. Para especificar uma ordem decrescente, prefixe um campo com ~ (um til).

API

Para acessar insights de um projeto Google Cloud , faça uma solicitação GET para o método projects.locations.insightTypes.insights:

 https://recommender.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/insightTypes/INSIGHT_TYPE/insights 

Substitua:

• PROJECT_ID: o ID do projeto.
• LOCATION: o local em que os insights serão listados, como global, europe, asia-east1 ou us-central1-a.

• INSIGHT_TYPE: o tipo de insight do Network Analyzer a listar, como google.networkanalyzer.vpcnetwork.connectivityInsight.

  Para ver uma lista completa dos tipos de insight, consulte Grupos e tipos de insight.

O exemplo a seguir mostra uma resposta de amostra para este comando:

 {   "name": "projects/{project_number}/locations/{location}/insightTypes/google.networkanalyzer.hybridconnectivity.dynamicRouteInsight/insights/{insight_id}",   "description": "Dynamic route is fully shadowed by a peering subnet route",   "content": {     "networkUri": "//compute.googleapis.com/projects/{project_id}/global/networks/{network_name}",     "region": "{location}",     "ipRange": "{ip_range}",     "priority": 100,     "nextHopUri": "//compute.googleapis.com/projects/{project_id}/regions/{location}/vpnTunnels/{tunnel_name}",     "cloudRouterUri": "//compute.googleapis.com/projects/{project_id}/regions/{location}/routers/{router_name}",     "shadowingRouteUris": [       "//compute.googleapis.com/projects/{project_id}/global/routes/{route_name}"     ],     "shadowingRouteType": "PEERING_SUBNET"   },   "lastRefreshTime": "2022-09-15T21:10:57.187942979Z",   "observationPeriod": "611870.625920374s",   "stateInfo": {     "state": "ACTIVE"   },   "category": "PERFORMANCE",   "targetResources": [     "//compute.googleapis.com/projects/{project_id}/regions/{location}/vpnTunnels/{tunnel_name}"   ],   "insightSubtype": "DYNAMIC_ROUTE_FULLY_SHADOWED",   "severity": "MEDIUM" } 

gcloud

Para listar detalhes de um insight específico, execute o seguinte comando:

 gcloud recommender insights describe INSIGHT_ID \     --project=PROJECT_ID \     --location=LOCATION \     --insight-type=INSIGHT_TYPE 

Substitua:

• INSIGHT_ID: o ID do insight a ser descrito.
• PROJECT_ID: o ID do projeto que contém o insight.
• LOCATION: o local para o qual insights serão listados.

• INSIGHT_TYPE: o tipo do insight do Network Analyzer, como google.networkanalyzer.vpcnetwork.connectivityInsight.

  Para ver uma lista completa dos tipos de insight, consulte Grupos e tipos de insight.

API

Para ver detalhes sobre um insight, faça uma solicitação GETpara o método projects.locations.insightTypes.insights:

 https://recommender.googleapis.com/v1/projects/PROJECT/locations/LOCATION/insightTypes/INSIGHT_TYPE/insights/INSIGHT_ID 

Substitua:

• PROJECT_ID: o ID do projeto.
• LOCATION: o local do insight.

• INSIGHT_TYPE: o tipo do insight do Network Analyzer, como google.networkanalyzer.vpcnetwork.connectivityInsight.

  Para ver uma lista completa dos tipos de insight, consulte Grupos e tipos de insight.

• INSIGHT_ID: o ID do insight.