Recommender CLI und API verwenden

gcloud

Führen Sie den folgenden Befehl aus, um Statistiken für ein Google Cloud-Projekt aufzulisten:

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

Ersetzen Sie Folgendes:

• PROJECT_ID: Die Projekt-ID, für die Sie Statistiken auflisten möchten. Sie können auch alle Statistiken für einen Ordner, eine Organisation oder ein Abrechnungskonto auflisten.
• LOCATION: Der Standort, für den Statistiken aufgeführt werden sollen, z. B. global, europe, asia-east1 oder us-central1-a.

• INSIGHT_TYPE: Der angeforderte Typ der Network Analyzer-Statistik, z. B. google.networkanalyzer.vpcnetwork.connectivityInsight.

  Eine vollständige Liste der Insight-Typen finden Sie unter Insight-Gruppen und ‑Typen.

Die folgenden Felder sind optional:

• EXPRESSION: Wenden Sie diesen booleschen Filter auf jede Ressource an, die Sie auflisten möchten.

  Wenn der Ausdruck als True ausgewertet wird, wird dieses Element aufgelistet. Für weitere Informationen und Beispiele zu Filterausdrücken führen Sie $ gcloud topic filters aus oder lesen Sie die Dokumentation zu gcloud topic filters an.

• LIMIT: Die maximale Anzahl von Ressourcen, die aufgelistet werden sollen. Die Standardanzahl der aufgelisteten Ressourcen ist unbegrenzt.

• PAGE_SIZE: Die maximale Anzahl von Ressourcen, die pro Seite aufgelistet werden sollen.

  Die Standardseitengröße wird vom Dienst bestimmt, ansonsten gibt es keine Seitenwechsel. Seitenwechsel können vor oder nach FILTER und LIMIT eingefügt werden.

• SORT_BY: Eine Liste von durch Kommas getrennten Feldschlüsselnamen, nach denen für eine Ressource sortiert wird.

  Die Standardreihenfolge ist aufsteigend. Wenn Sie eine absteigende Reihenfolge angeben möchten, stellen Sie dem Feld ~ (eine Tilde) voran.

API

Wenn Sie Statistiken für ein Google Cloud-Projekt abrufen möchten, senden Sie eine GET-Anfrage an die Methode projects.locations.insightTypes.insights:

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

Ersetzen Sie Folgendes:

• PROJECT_ID: Projekt-ID.
• LOCATION: Der Standort, für den Statistiken aufgeführt werden sollen, z. B. global, europe, asia-east1 oder us-central1-a.

• INSIGHT_TYPE: Der zu listende Network Analyzer-Erkenntnistyp, z. B. google.networkanalyzer.vpcnetwork.connectivityInsight.

  Eine vollständige Liste der Insight-Typen finden Sie unter Insight-Gruppen und ‑Typen.

Das folgende Beispiel zeigt eine Beispielantwort für diesen Befehl.

{
  "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

Führen Sie den folgenden Befehl aus, um Details zu einer bestimmten Statistik aufzulisten:

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

Ersetzen Sie Folgendes:

• INSIGHT_ID: Die ID der zu beschreibenden Statistik.
• PROJECT_ID: die ID des Projekts, das die Statistik enthält.
• LOCATION: Der Standort, für den Statistiken aufgelistet werden sollen.

• INSIGHT_TYPE: Der Typ der Network Analyzer-Statistik, z. B. google.networkanalyzer.vpcnetwork.connectivityInsight.

  Eine vollständige Liste der Insight-Typen finden Sie unter Insight-Gruppen und ‑Typen.

API

Zum Abrufen von Details zu einer Statistik stellen Sie eine GET-Anfrage an die Methode projects.locations.insightTypes.insights.

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

Ersetzen Sie Folgendes:

• PROJECT_ID: Projekt-ID.
• LOCATION: den Standort der Statistik.

• INSIGHT_TYPE: Der Typ der Network Analyzer-Statistik, z. B. google.networkanalyzer.vpcnetwork.connectivityInsight.

  Eine vollständige Liste der Insight-Typen finden Sie unter Insight-Gruppen und ‑Typen.

• INSIGHT_ID: Statistik-ID für die Statistik