使用 Recommender CLI 和 API

网络分析器使用 Recommender 命令。Recommender 是一项 Google Cloud 服务,可提供有关 Google Cloud 产品和服务的使用建议。 如需查看 Recommender 数据分析类型的完整列表,请参阅 Recommender 数据分析类型

请求数据分析

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:要为其列出数据分析的位置,例如 globaleuropeasia-east1us-central1-a
  • INSIGHT_TYPE:请求的网络分析器数据分析类型,例如 google.networkanalyzer.vpcnetwork.connectivityInsight

    如需查看数据分析类型的完整列表,请参阅数据分析组和类型

以下字段是可选的:

  • EXPRESSION:将此布尔过滤条件应用于您要列出的每个资源。

    如果表达式的计算结果为 True,则系统会列出相应项。如需了解详情以及过滤条件表达式的示例,请运行 $ gcloud topic filters 或查看 gcloud topic filters 文档

  • LIMIT:要列出的资源数上限;列出的默认资源数量不受限制。

  • PAGE_SIZE:每页列出的资源数上限。

    默认页大小由服务确定,否则不进行分页。可以在 FILTERLIMIT 之前或之后应用分页。

  • 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:要为其列出数据分析的位置,例如 globaleuropeasia-east1us-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。

数据分析组和类型

如需详细了解网络分析器数据分析,请参阅数据分析组和类型