弃用自定义映像

Linux Windows

Compute Engine 可让您在映像上设置弃用状态，以便弃用您所拥有的自定义映像。每个弃用状态都会引起服务器的不同响应，从而帮助您以一种可管理的方式将用户从不受支持的映像转移出去。可以使用 Google Cloud Console、Google Cloud CLI 或 Compute Engine API 方法来弃用映像。

弃用状态

支持以下弃用状态：

ACTIVE：映像处于活跃状态，并且可以正常使用。映像系列指向一个系列中最新、最活跃的映像。
DEPRECATED：映像被标记为“已弃用”，但仍可用于创建虚拟机。您可以为此映像创建新的链接。即使此映像是某个系列中最新的映像，映像系列也不会再指向此映像。

如果您使用 Google Cloud CLI 创建具有已弃用映像的虚拟机，则请求会成功并显示一条警告。
OBSOLETE：映像被标记为“已作废”，无法再使用。如果您尝试在请求中使用此映像，系统会返回一条错误消息。您仍然可以使用指向此映像的现有链接。
DELETED：此映像已删除。如果您尝试使用已删除的映像，系统会返回一条错误消息。

您可以通过将弃用状态更改为 ACTIVE 来还原弃用（使映像再次变为活跃状态）。

准备工作

如果您要使用本指南中的命令行示例，请执行以下操作：
1. 安装或更新到 Google Cloud CLI 的最新版本。
2. 设置默认区域和可用区。
如果您要使用本指南中的 API 示例，请设置 API 访问权限。
阅读映像文档。

弃用自定义映像

控制台

在 Google Cloud Console 中，转到映像页面。

转到“映像”
对于您想要弃用的映像，点击操作。
选择弃用。
对于状态，选择已弃用或已作废。如需详细了解状态，请参阅弃用状态。
可选：指定替换映像。
点击弃用映像。

gcloud

使用 gcloud compute images deprecate 命令设置映像的弃用状态。

gcloud compute images deprecate IMAGE_NAME \
    --state STATE \
    --replacement REPLACEMENT

请替换以下内容：

IMAGE_NAME：要弃用的映像的名称
STATE：弃用状态
REPLACEMENT：用于替换弃用映像的映像

API

向 images().deprecate 方法发出 POST 请求。指定要弃用的映像的名称。

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/global/images/RESOURCE_ID/deprecate

{
  "state": "STATE",
  "replacement": "REPLACEMENT"
}

请替换以下内容：

PROJECT_ID：映像所属的项目。
RESOURCE_ID：要弃用的映像的名称。
STATE：此资源的弃用状态。
REPLACEMENT：用于替换弃用映像的映像。