Utilizzare l'interfaccia a riga di comando e l'API del motore per suggerimenti

gcloud

Per elencare gli approfondimenti per un progetto Google Cloud, esegui il seguente 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

Sostituisci quanto segue:

• PROJECT_ID: l'ID progetto per cui vuoi elencare gli approfondimenti. Puoi anche elencare tutti gli approfondimenti per una cartella, un'organizzazione o un account di fatturazione.
• LOCATION: la località per cui elencare gli approfondimenti, ad esempio global, europe, asia-east1 o us-central1-a.

• INSIGHT_TYPE: il tipo di informazione di Network Analyzer da richiedere, ad esempio google.networkanalyzer.vpcnetwork.connectivityInsight.

  Per un elenco completo dei tipi di insight, consulta Gruppi e tipi di insight.

I seguenti campi sono facoltativi:

• EXPRESSION: applica questo filtro booleano a ogni risorsa che vuoi elencare.

  Se l'espressione restituisce True, l'elemento è elencato. Per maggiori dettagli ed esempi di espressioni di filtro, esegui $ gcloud topic filters o consulta la documentazione di gcloud topic filters.

• LIMIT: il numero massimo di risorse da elencare. Il numero predefinito di risorse elencate è illimitato.

• PAGE_SIZE: il numero massimo di risorse da elencare per pagina.

  Le dimensioni della pagina predefinite sono determinate dal servizio. In caso contrario, non è prevista la suddivisione in pagine. La paginazione potrebbe essere applicata prima o dopo FILTER e LIMIT.

• SORT_BY: un elenco di nomi di chiavi di campo separati da virgola in base ai quali ordinare una risorsa.

  L'ordine predefinito è crescente. Per specificare un ordine decrescente, anteponi un campo con ~ (una tilde).

API

Per ottenere informazioni su un progetto Google Cloud, invia una richiesta GET al metodo projects.locations.insightTypes.insights:

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

Sostituisci quanto segue:

• PROJECT_ID: l'ID progetto.
• LOCATION: la località per cui elencare gli approfondimenti, ad esempio global, europe, asia-east1 o us-central1-a.

• INSIGHT_TYPE: il tipo di insight di Network Analyzer da elencare, ad esempio google.networkanalyzer.vpcnetwork.connectivityInsight.

  Per un elenco completo dei tipi di insight, consulta Gruppi e tipi di insight.

L'esempio seguente mostra una risposta di esempio per questo 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

Per elencare i dettagli di un determinato insight, esegui il seguente comando:

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

Sostituisci quanto segue:

• INSIGHT_ID: l'ID dell'insight da descrivere.
• PROJECT_ID: l'ID del progetto contenente l'approfondimento.
• LOCATION: la località per cui elencare gli approfondimenti.

• INSIGHT_TYPE: il tipo di informazione di Network Analyzer, ad esempiogoogle.networkanalyzer.vpcnetwork.connectivityInsight.

  Per un elenco completo dei tipi di insight, consulta Gruppi e tipi di insight.

API

Per visualizzare i dettagli di un'intuizione, effettua una richiesta GET al metodo projects.locations.insightTypes.insights:

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

Sostituisci quanto segue:

• PROJECT_ID: l'ID progetto.
• LOCATION: la posizione dell'approfondimento.

• INSIGHT_TYPE: il tipo di informazione di Network Analyzer, ad esempiogoogle.networkanalyzer.vpcnetwork.connectivityInsight.

  Per un elenco completo dei tipi di insight, consulta Gruppi e tipi di insight.

• INSIGHT_ID: l'ID dell'approfondimento.