イメージファミリーは、関連するカスタムイメージをグループ化し、イメージバージョンを一元管理できるようにする機能です。カスタムイメージは、作成時にイメージファミリーに割り当てるか、後からイメージの属性を編集してファミリーに追加できます。
前提条件
作業を開始する前に、以下をご確認ください。
カスタムイメージ、またはインスタンスやスナップショットからカスタムイメージを作成する権限があること
ECS コンソールでカスタムイメージを作成または変更するために必要な権限があること
ECS コンソールでのイメージファミリーの設定
イメージの作成時、または既存のイメージの属性を変更することで、カスタムイメージをイメージファミリーに割り当てます。
イメージ作成時にイメージファミリーを設定するには：
「インスタンスからカスタムイメージを作成」または「スナップショットからカスタムイメージを作成」をご参照ください。イメージ作成フォームには [イメージファミリー] フィールドがあり、新しいファミリー名を入力するか、既存のファミリー名を選択できます。
イメージ属性を変更してイメージファミリーを設定するには：
「カスタムイメージの属性を変更」をご参照ください。
イメージファミリーの命名規則：
名前は 2～128 文字で、使用できる文字は、英字、数字、ピリオド (.)、アンダースコア (_)、ハイフン (-)、コロン (:) です。数字、特殊文字、http://、https:// で始めることはできません。たとえば、web-prod-2024 や hangzhou.app:v2 は有効な名前です。
(オプション) ファミリー別のイメージ表示
カスタムイメージリストの上にある
をオンにします。[イメージファミリー] セクションで、イメージファミリーの名前をクリックすると、そのファミリーに含まれるイメージが表示されます。
API を使用したイメージファミリーの設定
CreateImage API オペレーションを使用すると、カスタムイメージを作成し、1 つのステップでイメージファミリーに割り当てることができます。以下の例では OpenAPI Explorer を使用します。
OpenAPI Explorer コンソールにログインします。
次のパラメーターを指定して CreateImage オペレーションを呼び出し、インスタンスからカスタムイメージを作成してイメージファミリーに割り当てます。
パラメーター 説明 例 RegionIdインスタンスが存在するリージョン cn-hangzhouInstanceIdソースインスタンスの ID i-bp117mtgmllecpwl****ImageFamily割り当てるイメージファミリー名 hangzhou-image操作が完了したら、応答で返されたカスタムイメージ ID をメモします。
DescribeImages オペレーションを呼び出して、イメージファミリーの割り当てを確認します。次のパラメーターを指定します。
RegionId：前のステップと同じリージョンImageId：前のステップで取得したイメージ ID
応答には
ImageFamilyフィールドが含まれます。その値が指定したファミリー名 (この例ではhangzhou-image) と一致することを確認します。
次のステップ
イメージファミリー名の変更：「イメージの属性とタグを変更」をご参照いただくか、ModifyImageAttribute を呼び出します。
イメージファミリーを使用した ECS インスタンスの起動：「イメージファミリーを使用して ECS インスタンスを作成」をご参照ください。