使用 Recommender CLI 和 API

網路分析器使用建議工具指令。建議工具是一項 Google Cloud 服務，可針對 Google Cloud 產品和服務提供使用建議。如需完整的建議工具洞察類型清單，請參閱建議工具洞察類型。

要求洞察

gcloud

如要列出 Google Cloud 專案的洞察資料，請執行下列指令：

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

更改下列內容：

• PROJECT_ID：您要列出洞察資料的專案 ID。您也可以列出資料夾、組織或帳單帳戶的所有洞察資料。
• LOCATION：要列出洞察資料的位置，例如 global、europe、asia-east1 或 us-central1-a。

• INSIGHT_TYPE：要求的網路分析器洞察類型，例如 google.networkanalyzer.vpcnetwork.connectivityInsight。

  如需完整的洞察類型清單，請參閱「洞察群組和類型」。

以下為選擇性欄位：

• EXPRESSION：對要列出的每個資源套用這個布林值篩選條件。

  如果運算式評估結果為 True，系統就會列出項目。如要進一步瞭解篩選運算式並查看範例，請執行 $ gcloud topic filters 或參閱「gcloud topic filters 說明文件」。

• LIMIT：要列出的資源數量上限；預設列出的資源數量無上限。

• PAGE_SIZE：每頁要列出的資源數量上限。

  預設網頁大小由服務決定；否則不會分頁。分頁可能會在 FILTER 和 LIMIT 之前或之後套用。

• SORT_BY：以半形逗號分隔的欄位索引鍵名稱清單，做為資源的排序依據。

  預設為遞增排序。如要指定遞減排序，請在欄位前面加上 ~ (波浪號)。

API

如要取得 Google Cloud 專案的洞察資料，請對 projects.locations.insightTypes.insights 方法發出 GET 要求：

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

更改下列內容：

• PROJECT_ID：專案 ID。
• LOCATION：要列出洞察資料的位置，例如 global、europe、asia-east1 或 us-central1-a。

• INSIGHT_TYPE：要列出的網路分析器洞察類型，例如 google.networkanalyzer.vpcnetwork.connectivityInsight。

  如需完整的洞察類型清單，請參閱「洞察群組和類型」。

以下範例顯示這項指令的回應範例：

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

如要列出特定洞察的詳細資料，請執行下列指令：

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

更改下列內容：

• INSIGHT_ID：要說明的洞察 ID。
• PROJECT_ID：包含洞察的專案 ID。
• LOCATION：要列出洞察的位置。

• INSIGHT_TYPE：洞察的網路分析器洞察類型，例如 google.networkanalyzer.vpcnetwork.connectivityInsight。

  如需完整的洞察類型清單，請參閱「洞察群組和類型」。

API

如要取得洞察的詳細資訊，請向 projects.locations.insightTypes.insights 方法發出 GET 要求：

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

更改下列內容：

• PROJECT_ID：專案 ID。
• LOCATION：洞察的位置。

• INSIGHT_TYPE：洞察的網路分析器洞察類型，例如 google.networkanalyzer.vpcnetwork.connectivityInsight。

  如需完整的洞察類型清單，請參閱「洞察群組和類型」。

• INSIGHT_ID：洞察的洞察 ID。

洞察群組和類型

如要進一步瞭解網路分析器洞察，請參閱「洞察群組和類型」。