画像ファミリーは、関連する画像のグループを分類するために使用されます。 カスタムイメージを作成するとき、またはイメージ属性を編集するときに、カスタムイメージのイメージファミリを設定できます。 このトピックでは、カスタムイメージのイメージファミリを指定する方法について説明します。
手順
ECSコンソールでのイメージファミリーの設定
次のいずれかの方法を使用して、カスタムイメージのイメージファミリを設定できます。
カスタムイメージを作成するときに、カスタムイメージのイメージファミリを設定します。
詳細については、「インスタンスからカスタムイメージを作成する」または「スナップショットからカスタムイメージを作成する」をご参照ください。
カスタムイメージの属性を変更するときに、カスタムイメージのイメージファミリを設定します。
詳細については、「カスタムイメージの属性の変更」をご参照ください。
名前を指定してイメージファミリーを作成したり、既存のイメージファミリーを選択したりできます。
説明名前の長さは 2 ~ 128 文字である必要があります。 数字、特殊文字、http:// 、またはhttps:// で始めることはできません。 英数字、ピリオド (.) 、アンダースコア (_) 、ハイフン (-) 、およびコロン (:) を使用できます。
(オプション) カスタムイメージのイメージファミリを表示します。
カスタム画像リストの上をオンにします。
[画像ファミリ] セクションで、画像ファミリの名前をクリックして、画像ファミリ内の画像を表示します。
APIを呼び出してイメージファミリーを指定する
この例では、CreateImage操作を呼び出して、カスタムイメージの作成時にイメージファミリーを指定します。
OpenAPI Explorerコンソールにログインします。
CreateImage操作を呼び出して、カスタムイメージを作成し、イメージファミリーを設定します。
この例では、カスタムイメージがインスタンスから作成され、イメージファミリー名が
hangzhou-image
に設定されています。 次のAPIリクエストパラメーターに注意してください。RegionId: リージョンのID。 例:
cn-hangzhou
InstanceId: インスタンスのID。 例:
i-bp117mtgmllecpwl ****
ImageFamily: イメージファミリー名。 例:
hangzhou-image
カスタムイメージを作成したら、カスタムイメージのIDを取得できます。
DescribeImages操作を呼び出して、前の手順で作成したカスタムイメージのイメージファミリーを照会します。
次のAPIリクエストパラメーターを指定します。
RegionId: 前の手順と同じリージョンID。
ImageId: 前の手順で作成したカスタムイメージのID。
次の図は、レスポンスのサンプルを示しています。
ImageFamily
パラメーターの値はhangzhou-image
です。
参考資料
イメージファミリーを設定したら、イメージファミリーを変更できます。 詳細については、「イメージの属性とタグの変更」または「ModifyImageAttribute」をご参照ください。
イメージファミリーを設定した後、イメージファミリーを使用してECSインスタンスを作成できます。 詳細については、「イメージファミリーを使用したECSインスタンスの作成」をご参照ください。