RunInstances API オペレーションで ImageFamily リクエストパラメーターを指定すると、Elastic Compute Service (ECS) インスタンスを作成できます。ECS は指定されたイメージ ファミリー内で利用可能な最新のイメージを自動的に選択するため、イメージ ID を手動で照会・更新する必要はありません。
前提条件
開始する前に、以下の条件を満たしていることを確認してください。
少なくとも 1 つの利用可能なカスタムイメージを含むイメージ ファミリー
イメージ ファミリーの名前(例:
image-test)対象リージョン内のセキュリティグループ ID および vSwitch ID
イメージ ファミリーからインスタンスを作成する
OpenAPI Explorer にログインします。
以下のリクエストパラメーターを指定して、RunInstances を呼び出します。
ImageFamilyを設定すると、ECS はそのファミリー内で利用可能な最新のイメージを自動的に使用します。イメージ ID の明示的な指定は不要です。正常な応答には、InstanceIdSets.InstanceIdSet内に新規インスタンス ID が含まれます。この ID をコピーしてください。ステップ 3b で使用します。パラメーター 説明 例 RegionIdインスタンスを作成するリージョン ap-southeast-1InstanceTypeインスタンスタイプ ecs.g6.largeImageFamilyイメージ ファミリーの名前。ECS はこのファミリー内で利用可能な最新のイメージを自動的に選択します。 image-testSecurityGroupIdセキュリティグループ ID sg-bp1i4c0xgqxadew2****VSwitchIdvSwitch ID vsw-bp1ddbrxdlrcbim46****{ "RequestId": "409D4604-84D0-4F16-B99E-809E2E72****", "InstanceIdSets": { "InstanceIdSet": [ "i-bp1env7nl3mijm2t****" ] } }インスタンスが正しいイメージを使用していることを確認します。
イメージ ファミリー内で利用可能な最新のイメージを取得するには、DescribeImageFromFamily を呼び出します。
パラメーター 説明 例 RegionIdイメージ ファミリーのリージョン ap-southeast-1ImageFamilyイメージ ファミリーの名前 image-test応答では、イメージ ファミリー内で利用可能な最新のカスタムイメージのイメージ ID が返されます。このイメージ ID をメモしてください。ステップ 3b で使用します。

新規インスタンスで使用されているイメージを確認するには、DescribeInstances を呼び出します。
パラメーター 説明 例 RegionIdインスタンスのリージョン ap-southeast-1InstanceIdsステップ 2 で取得したインスタンス ID ["i-bp1env7nl3mijm2t****"]応答で、インスタンスのイメージ ID がステップ 3a で取得したイメージ ID と一致することを確認してください。一致した場合、そのインスタンスはイメージ ファミリー内で利用可能な最新のイメージを使用しています。
