すべてのプロダクト
Search
ドキュメントセンター

Elastic Compute Service:イメージ ファミリーから ECS インスタンスを作成する

最終更新日:Apr 01, 2026

RunInstances API オペレーションで ImageFamily リクエストパラメーターを指定すると、Elastic Compute Service (ECS) インスタンスを作成できます。ECS は指定されたイメージ ファミリー内で利用可能な最新のイメージを自動的に選択するため、イメージ ID を手動で照会・更新する必要はありません。

前提条件

開始する前に、以下の条件を満たしていることを確認してください。

  • 少なくとも 1 つの利用可能なカスタムイメージを含むイメージ ファミリー

  • イメージ ファミリーの名前(例: image-test

  • 対象リージョン内のセキュリティグループ ID および vSwitch ID

イメージ ファミリーからインスタンスを作成する

  1. OpenAPI Explorer にログインします。

  2. 以下のリクエストパラメーターを指定して、RunInstances を呼び出します。ImageFamily を設定すると、ECS はそのファミリー内で利用可能な最新のイメージを自動的に使用します。イメージ ID の明示的な指定は不要です。正常な応答には、InstanceIdSets.InstanceIdSet 内に新規インスタンス ID が含まれます。この ID をコピーしてください。ステップ 3b で使用します。

    パラメーター説明
    RegionIdインスタンスを作成するリージョンap-southeast-1
    InstanceTypeインスタンスタイプecs.g6.large
    ImageFamilyイメージ ファミリーの名前。ECS はこのファミリー内で利用可能な最新のイメージを自動的に選択します。image-test
    SecurityGroupIdセキュリティグループ IDsg-bp1i4c0xgqxadew2****
    VSwitchIdvSwitch IDvsw-bp1ddbrxdlrcbim46****
    {
        "RequestId": "409D4604-84D0-4F16-B99E-809E2E72****",
        "InstanceIdSets": {
            "InstanceIdSet": [
                "i-bp1env7nl3mijm2t****"
            ]
        }
    }
  3. インスタンスが正しいイメージを使用していることを確認します。

    1. イメージ ファミリー内で利用可能な最新のイメージを取得するには、DescribeImageFromFamily を呼び出します。

      パラメーター説明
      RegionIdイメージ ファミリーのリージョンap-southeast-1
      ImageFamilyイメージ ファミリーの名前image-test

      応答では、イメージ ファミリー内で利用可能な最新のカスタムイメージのイメージ ID が返されます。このイメージ ID をメモしてください。ステップ 3b で使用します。

      11

    2. 新規インスタンスで使用されているイメージを確認するには、DescribeInstances を呼び出します。

      パラメーター説明
      RegionIdインスタンスのリージョンap-southeast-1
      InstanceIdsステップ 2 で取得したインスタンス ID["i-bp1env7nl3mijm2t****"]

      応答で、インスタンスのイメージ ID がステップ 3a で取得したイメージ ID と一致することを確認してください。一致した場合、そのインスタンスはイメージ ファミリー内で利用可能な最新のイメージを使用しています。

      if8