准备工作

1. 确保已下载、安装并初始化以下 CLI 插件：

   • IBM Cloud CLI
   • infrastructure-service 插件

   有关更多信息，请参阅 CLI 参考。

2. 确保您已创建 IBM Cloud VPC。

从连接到实例的引导卷创建映像

1. 要找到要从中创建映像的实例，请在区域中 列出实例。 记下命令输出中的实例标识。

   ibmcloud is instances
   

2. 停止正在运行的实例，然后从卷创建映像。

   ibmcloud is instance-stop INSTANCE_ID
   

3. 运行 image-create 命令 以创建引导卷的映像。 指定源卷的标识。

   ibmcloud is image-create IMAGE_NAME [--source-volume VOLUME_ID]
   

   请参阅以下示例：

   $ ibmcloud is image-create test-ifv-vol1 --source-volume ecc68c2f-96a1-4862-bc86-14f47e5d9ed8
   Creating image test-ifv-vol1 in resource group  under account Test Account as user test.user@ibm.com...
   ID                 5b2fd4ee-c636-44c4-9673-453fca36832e
   Name               test-ifv-vol1
   CRN                crn:v1:bluemix:public:is:us-south:a/a123456::image:5b2fd4ee-c636-44c4-9673-453fca36832e
   Status             pending
   Status reason      Code                   Message                                                More info
                      image_request_queued   The image request is accepted and waiting for system   -
                                             resources to become available.
   Operating system   Name             Architecture   Vendor   Version                 Dedicated host only
                      centos-8-amd64   amd64          CentOS   8.x - Minimal Install   false
   Source volume      ID                                     Name
                      ecc68c2f-96a1-4862-bc86-14f47e5d9ed8   aa-1-bx-boot-1617035447000
   Created            2021-05-20T09:43:16+08:00
   Visibility         private
   File size(GB)      -
   Encryption         none
   Resource group     f22cf48f-8836-4527-9131-1d7c73ba85e9
   

使用 CLI 调度定制映像生命周期状态更改

创建自定义映像时，还可以使用 ibmcloud is image-create 命令的 --deprecate-at 或 --obsolete-at 选项，同时安排 IBM Cloud VPC 自定义映像的生命周期状态更改。

要调度 deprecate-at 或 obsolete-at 属性，请以 ISO 8601 (YYYY-MM-DDThh:mm:ss+hh:mm) 日期和时间格式指定日期。

• YYYY 是四位数的年份。
• MM 是两位数的月份。
• DD 是两位数的日期。
• T 分隔日期和时间信息。
• hh 是两位数的小时。
• mm 是两位数的分钟数。
• +hh:mm 或 -hh:mm 是全球标准时区。

例如，北美中央标准时区（CST）2025 年 9 月 30 日晚上 8:00 的日期是 2025-09-30T20:00:00-06:00

安排日期和时间时，不能使用当前日期和时间。 计划的日期和时间必须是未来的。 如果同时定义 deprecate-at 和 obsolete-at 日期和时间，那么 deprecate-at 日期必须晚于 obsolete-at 日期和时间。

ibmcloud is image-create IMAGE_NAME [--source-volume VOLUME_ID] [--deprecate-at YYYY-MM-DDThh:mm:ss+hh:mm] [--obsolete-at YYYY-MM-DDThh:mm:ss+hh:mm]

准备工作

开始之前，请确保 设置 API 环境。

使用 API 从实例引导创建映像

1. 找到要从中创建映像的实例和引导卷。 使用 list instance 方法获取可用实例的列表。

   curl -X GET "$vpc_api_endpoint/v1/instances?version=2024-06-11&generation=2" -H "Authorization: Bearer $iam_token"
   

2. 记下实例标识，并使用它来 检索实例 详细信息。

   curl -X GET "$vpc_api_endpoint/v1/instances/$instance_id?version=2024-06-11&generation=2" -H "Authorization: Bearer $iam_token"
   

   响应包含 volume_attachments 部分中引导卷的名称，标识和其他详细信息。

   "volume_attachments": [
    {
     "device": {
       "id": "a8a15363-a6f7-4f01-af60-715e85b28141"
       },
     "href": "https://us-south.iaas.cloud.ibm.com/v1/instances/e402fa1b-96f6-4aa2-a8d7-703aac843651/volume_attachments/7389-a8a15363-a6f7-4f01-af60-715e85b28141",
     "id": "a8a15363-a6f7-4f01-af60-715e85b28141",
     "name": "my-boot-volume-attachment",
     "volume": {
       "crn": "crn:[...]",
       "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/49c5d61b-41e7-4c01-9b7a-1a97366c6916",
       "id": "49c5d61b-41e7-4c01-9b7a-1a97366c6916",
       "name": "my-boot-volume"
       }
     }
   ]
   

3. 如果实例正在运行，请通过在 POST /instances 调用中指定 stop 操作来将其停止:

   curl -X POST \
   "$vpc_api_endpoint/v1/instances/{instance-id}/gen/actions?ersion=2024-06-11&generation=2"
   -H "Authorization: Bearer $iam_token"\
   -d '{"type":"stop"}'
   

4. 通过使用引导卷标识，创建映像。 请参阅以下示例：

    curl -X POST "$vpc_api_endpoint/v1/images?version=2024-06-11&generation=2"
    -H "Authorization: Bearer $iam_token"
    -d '{
         "name": "my-image",
         "source_volume": {"id": "4fec84ef-baf9-405d-bf3b-9d5a60e068f7"}
         }`
   

   在示例响应中，source_volume 指示用于创建映像的引导卷。 另外，请注意，映像加密显示为 none，因为源卷使用了缺省 IBM管理的加密。 如果 使用的是自己的根密钥，响应将显示 user-managed。

   {
    "created_at": "2021-05-20T00:05:13.873893Z",
    "crn": "crn:[...]",
    "encryption": "none",
    "file": {},
    "href": "https://us-south.iaas.cloud.ibm.com/v1/images/4fec84ef-baf9-405d-bf3b-9d5a60e068f7",
    "id": "4fec84ef-baf9-405d-bf3b-9d5a60e068f7",
    "name": "test-ifv-boot-volume",
    "operating_system": {
      "architecture": "amd64",
      "display_name": "CentOS 8.x - Minimal Install (amd64)",
      "family": "CentOS",
      "href": "https://us-south.iaas.cloud.ibm.com/v1/operating_systems/centos-8-amd64",
      "name": "centos-8-amd64",
      "vendor": "CentOS",
      "version": "8.x - Minimal Install"
      },
    "resource_group": {
      "href": "https://us-south.iaas.cloud.ibm.com/v1/resource_groups/3fad3f2204eb4998c3964d254ffcd771",
      "id": "3fad3f2204eb4998c3964d254ffcd771",
      "name": "Default"
      },
    "status": "pending",
    "status_reasons": [],
    "visibility": "private",
    "source_volume":  {
      "id": "4fec84ef-baf9-405d-bf3b-9d5a60e068f7",
      "crn": "crn:[...]",
      "href": "",
      "name": "my-boot-volume"
      }
    }
   

从卷创建映像并指定您自己的加密密钥

1. 如上一节所述，找到实例和引导卷信息。 停止实例。

2. 获取密钥管理服务实例标识和根密钥 CRN。

   • Key Protect-检索实例标识和云资源名称(CRN)。

3. 发出 API 请求以 创建映像。 如以下示例所示，指定卷 ID 和根密钥的 CRN。

   curl -X POST "$vpc_api_endpoint/v1/images?version=2024-06-11&generation=2"
   -H "Authorization: Bearer $iam_token"
       -d '{
            "name": "my-encrypted-image",
            "source_volume": {"id": "4fec84ef-baf9-405d-bf3b-9d5a60e068f7"}
            "encryption_key":{"crn":"crn:[...key:...]"
           },
   

   响应包含有关根密钥的信息。

   {
    "created_at": "2021-05-20T00:05:13.873893Z",
    "crn": "crn:[...]",
    "encryption_key": {
      "crn": "crn:[...key:...]"
      },
    "encryption": "user_managed",
    "file": {},
    "href": "https://us-south.iaas.cloud.ibm.com/v1/images/4fec84ef-baf9-405d-bf3b-9d5a60e068f7",
    "id": "4fec84ef-baf9-405d-bf3b-9d5a60e068f7",
    "name": "test-ifv-boot-volume",
    "operating_system": {
      "architecture": "amd64",
      "display_name": "CentOS 8.x - Minimal Install (amd64)",
      "family": "CentOS",
      "href": "https://us-south.iaas.cloud.ibm.com/v1/operating_systems/centos-8-amd64",
      "name": "centos-8-amd64",
      "vendor": "CentOS",
      "version": "8.x - Minimal Install"
      },
    "resource_group": {
      "href": "https://us-south.iaas.cloud.ibm.com/v1/resource_groups/3fad3f2204eb4998c3964d254ffcd771",
      "id": "3fad3f2204eb4998c3964d254ffcd771",
      "name": "Default"
      },
    "status": "pending",
    "status_reasons": [],
    "visibility": "private",
    "source_volume":  {
      "id": "4fec84ef-baf9-405d-bf3b-9d5a60e068f7",
      "crn": "crn:[...]",
      "href": "",
      "name": "ifv-boot-vol"
      }
    }
   

使用 API 调度定制映像生命周期状态更改

从卷创建映像时，可以同时安排自定义映像的生命周期状态更改。

要调度 deprecation_at 或 obsolescence_at 属性，请以 ISO 8601 (YYYY-MM-DDThh:mm:ss+hh:mm) 日期和时间格式指定日期。

• YYYY 是四位数的年份
• MM 是两位数的月份
• DD 是两位数的日期
• T 分隔日期和时间信息
• hh 是两位数的小时
• mm 是两位数的分钟数
• +hh:mm 或 -hh:mm 是全球标准时区

例如，北美中央标准时区（CST）2023 年 9 月 30 日晚上 8:00 的日期是 2023-09-30T20:00:00-06:00

安排日期和时间时，不能使用当前日期和时间。 计划的日期和时间必须是未来的。 如果同时定义 deprecation_at 和 obsolescence_at 日期和时间，那么 obsolescence_at 日期必须晚于 deprecation_at 日期和时间。

curl -X POST "$vpc_api_endpoint/v1/images?version=2023-02-21&generation=2"\
-H "Authorization: Bearer $iam_token"\
-d '{
      "name": "test-ifv-boot-volume",
      "source_volume": {
    	  "id": "4fec84ef-baf9-405d-bf3b-9d5a60e068f7"
      },
      "deprecation_at": "2025-11-28T06:11:28+05:30",
      "obsolescence_at": "2025-12-28T06:11:28+05:30"
    }'