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

预览

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

Cloud 弃用和重大更改 Recommender 提供了有关 Cloud 弃用和重大更改的建议。它确定了将受到即将弃用和重大更改影响的 Cloud 资源，同时提供了有关如何管理这些资源的准则。您可以通过 Google Cloud CLI、API 和 BigQuery 导出功能查看建议。

须知事项

1. 登录您的 Google Cloud 账号。如果您是 Google Cloud 新手，请创建一个账号来评估我们的产品在实际场景中的表现。新客户还可获享 $300 赠金，用于运行、测试和部署工作负载。

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. 确保您的 Google Cloud 项目已启用结算功能。

4. 启用 Recommender API。

   启用 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. 确保您的 Google Cloud 项目已启用结算功能。

7. 启用 Recommender API。

   启用 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

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

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

价格

云弃用和重大更改 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 位置（例如，global 或 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 位置（例如，global 或 us-central1-a）。

BigQuery 导出

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

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

1. 按照 BigQuery 导出文档将建议导出到 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 节，因为接受格式错误的请求可能会导致安全性漏洞。

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

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