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

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

最終更新日:May 16, 2026

RunInstances を呼び出す際に ImageFamily パラメーターを指定すると、最新のアクティブなイメージが自動的に選択されます。

操作手順

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

  2. RunInstances API を呼び出します。

    この例では、次のパラメーターを使用して、image-test イメージファミリーからインスタンスを作成します。

    • RegionId:リージョン ID (cn-hangzhou など)。

    • InstanceType:インスタンスタイプ (ecs.g6.large など)。

    • ImageFamily:イメージファミリー名 (image-test など)。

    • SecurityGroupId:セキュリティグループ ID (sg-bp1i4c0xgqxadew2**** など)。

    • VSwitchId:vSwitch ID (vsw-bp1ddbrxdlrcbim46**** など)。

    レスポンスでインスタンス ID が返されます。

    {
        "RequestId": "409D4604-84D0-4F16-B99E-809E2E72****",
        "InstanceIdSets": {
            "InstanceIdSet": [
                "i-bp1env7nl3mijm2t****"
            ]
        }
    }
  3. インスタンスで使用されているイメージを確認します。

    1. DescribeImageFromFamily API を呼び出して、イメージファミリー内の最新のアクティブなイメージを照会します。

      この例では、次のパラメーターを使用して、image-test イメージファミリーを照会します。

      • RegionId:イメージファミリーのリージョン ID。

      • ImageFamily:イメージファミリー名 (image-test など)。

      レスポンスで最新のアクティブなイメージ ID が返されます。11

    2. DescribeInstances API を呼び出して、インスタンスのイメージを照会します。

      次のパラメーターを設定します。

      • RegionId:インスタンスのリージョン ID。

      • InstanceIds:JSON 配列フォーマットのインスタンス ID (["i-bp1env7nl3mijm2t****"] など)。

      インスタンスのイメージ ID が、イメージファミリーから取得した最新のアクティブなイメージ ID と一致することを確認します。if8