開始前に

1. 以下の CLI プラグインをダウンロード、インストール、初期化したことを確認します。

   • IBM Cloud CLI
   • infrastructure-service プラグイン

   詳しくは、CLI リファレンスを参照してください。

2. IBM Cloud VPC を作成していることを確認します。

インスタンスにアタッチされているブートボリュームからイメージを作成する

1. イメージの作成元のインスタンスを見つけるには、リージョン内の インスタンスをリスト します。 コマンド出力のインスタンス ID をメモします。

   ibmcloud is instances
   

2. ボリュームからイメージを作成する前に、 実行中のインスタンスを停止します。

   ibmcloud is instance-stop INSTANCE_ID
   

3. image-create コマンドを実行して、ブート・ボリュームのイメージを作成します。 ソース・ボリュームの ID を指定します。

   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 は4桁の年です。
• MM は2桁の月です。
• DD は2桁の日付です。
• T は、日付と時刻の情報を区切ります。
• hh は 2 桁の時間です。
• mm は2桁の分です。
• +hh:mm または -hh:mm は、協定世界時のタイム・ゾーンです。

例えば、北米中央標準時の2025年9月30日午後8時の日付は次のようになる。 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. インスタンス ID をメモし、それを使用して インスタンスを取得 します。

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

   応答の volume_attachments セクションには、ブート・ボリュームの名前、ID、およびその他の詳細が含まれています。

   "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. ブート・ボリューム ID を使用して、 イメージを作成します。 以下の例を参照してください。

    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 は、イメージの作成に使用されるブートボリュームを示しています。 また、ソースボリュームではデフォルトの「 IBM 」による管理型暗号化が使用されていたため、画像の暗号化が「 none 」として表示される点にご注意ください。 自分のルート・キーを使用した 場合、レスポンスは代わりに 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. 鍵管理サービス・インスタンス ID とルート鍵 CRN を取得します。

   • Key Protect-インスタンス ID とクラウド・リソース名(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 は4桁の年号です
• MM は2桁の月です
• DD は2桁の日付です
• T は、日付と時刻の情報を区切ります。
• hh は 2 桁の時間です。
• mm 2桁の分です
• +hh:mm または -hh:mm は協定世界時のタイム・ゾーンです。

たとえば、2023年9月30日午後8時（北米中央標準時）の日付は次のようになる。 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"
    }'