Cloud 弃用和破坏性更改常规 Recommender

预览

此功能须遵守服务专用条款的“通用服务条款”部分中的“非正式版产品条款”。 非正式版功能“按原样”提供，可能只能获得有限的支持。 如需了解详情，请参阅发布阶段说明。

Cloud 弃用和破坏性更改常规 Recommender 提供有关 Cloud 弃用和破坏性更改的建议。本文档确定了会受即将进行的弃用和破坏性更改影响的 Cloud 资源，同时提供了有关如何管理这些资源的指导。您可以通过 Google Cloud CLI、API 和 BigQuery Export 查看建议。

须知事项

1. Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

2. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

3. Make sure that billing is enabled for your Google Cloud project.

4. Enable the Recommender API.

   Enable the API

5. In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

   Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

   Go to project selector

6. Make sure that billing is enabled for your Google Cloud project.

7. Enable the Recommender API.

   Enable the API

注意：您只需在单个结算项目上启用该 API。然后，您可以使用此结算项目和 --billing-project 标志检索其他项目、整个组织或结算账号的建议和数据分析。

4. 确保您拥有以下角色：

说明	角色
查看建议	recommender.cloudDeprecationRecommendationViewer
查看和更新建议	recommender.cloudDeprecationRecommendationAdmin

所需的角色

本部分介绍了使用 Cloud 弃用和破坏性更改常规 Recommender 所需的角色和必要权限。

角色	包含的权限
roles/recommender.cloudDeprecationRecommendationViewer	recommender.cloudDeprecationGeneralInsights.get recommender.cloudDeprecationGeneralInsights.list recommender.cloudDeprecationGeneralRecommendations.get recommender.cloudDeprecationGeneralRecommendations.list
roles/recommender.cloudDeprecationRecommendationAdmin	recommender.cloudDeprecationGeneralInsights.update recommender.cloudDeprecationGeneralRecommendations.update

如需详细了解角色以及如何授予访问权限，请参阅以下内容：

• 了解角色
• 管理对项目、文件夹和组织的访问权限

价格

Cloud 弃用和破坏性更改常规 Recommender 可免费使用。如需了解其他价格层级，请参阅 Recommender 价格。

查看云弃用建议

您可以使用控制台、Google Cloud CLI、Recommender API 或通过 BigQuery Export 列出建议。

控制台

1. 转到 Recommendation Hub。

   前往 Recommendation Hub

2. 将过滤条件字段设置为 Recommender:google.cloud.deprecation.GeneralRecommender。

   注意：您必须拥有正确的 IAM 权限（上文列出）才能查看建议。如果您拥有正确的权限，并且页面未显示任何建议，则表示项目没有任何满足建议的条件的弃用或破坏性更改。

Google Cloud CLI

此标签页会显示使用 Google Cloud CLI 列出建议和数据分析的命令。

• 列出建议

  gcloud recommender recommendations list \
    --billing-project=BILLING_PROJECT_ID  \
    --project=PROJECT_ID  \
    --location=LOCATION  \
    --recommender=google.cloud.deprecation.GeneralRecommender \
    --format=yaml
  

• 列出数据分析

  gcloud recommender insights list \
    --billing-project=BILLING_PROJECT_ID  \
    --project=PROJECT_ID  \
    --location=LOCATION  \
    --insight-type=google.cloud.deprecation.GeneralInsight \
    --format=yaml
  

替换以下内容：

• 将 BILLING_PROJECT_ID 替换为您使用 Recommender API 启用的项目的 ID。
• 将 PROJECT_ID 替换为您的 Google Cloud 项目的标识符。
• 将 LOCATION 替换为与建议关联的资源所在的 Google Cloud 位置（例如全球或 us-central1-a）。

API

此标签页会显示使用 Recommender API 列出建议和数据分析的命令。

• 列出建议

  curl -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "x-goog-user-project: BILLING_PROJECT_ID " \
  "https://recommender.googleapis.com/v1/projects/PROJECT_ID /locations/LOCATION /recommenders/google.cloud.deprecation.GeneralRecommender/recommendations"
  

• 列出数据分析

  curl -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  -H "x-goog-user-project: BILLING_PROJECT_ID " \
  "https://recommender.googleapis.com/v1/projects/PROJECT_ID /locations/LOCATION /insightTypes/google.cloud.deprecation.GeneralInsight/insights"
  

替换以下内容：

• 将 BILLING_PROJECT_ID 替换为您使用 Recommender API 启用的项目的 ID。
• 将 PROJECT_ID 替换为您的 Google Cloud 项目的标识符。
• 将 LOCATION 替换为与建议关联的资源所在的 Google Cloud 位置（例如全球或 us-central1-a）。

BigQuery Export

此标签页显示使用 BigQuery Export 列出建议的命令。

Cloud 弃用建议也包含在 BigQuery Export 中。借助 BigQuery Export，您可以查看组织的建议的每日快照。

1. 按照 BigQuery Export 文档将建议导出到 BigQuery。

2. 查询所有弃用建议：

   SELECT *
   FROM `<project>.<dataset>.recommendations_export`
   WHERE DATE(_PARTITIONTIME) = "<date>"
   and recommender = "google.cloud.deprecation.GeneralRecommender"
   

可用的建议子类型

下表介绍了可用和可公开的建议子类型。

子类型	弃用还是破坏性更改？
GCE_METADATA_SERVER_HEADER_WHITESPACE	Compute Engine 将在 Compute Engine 元数据服务中强制执行 HTTP 请求格式检查，以符合 RFC 7230 第 3.2 节，因为接受格式错误的请求可能会导致安全漏洞。

警告：已忽略的建议不会重新生成，并且会在所有界面上隐藏实例的弃用建议。而是在应用建议后将其标记为“已成功”。

请注意，此表并不全面，可能会有意省略安全敏感的弃用或破坏性更改。