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

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

最終更新日:Apr 30, 2025

API 操作を呼び出すことで、ImageFamily パラメーターに基づいて Elastic Compute Service (ECS) インスタンスを作成できます。システムは、ECS インスタンスのイメージファミリーで利用可能な最新のイメージを自動的に選択します。このトピックでは、イメージファミリーから ECS インスタンスを作成する方法について説明します。

手順

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

  2. RunInstances 操作を呼び出して、ECS インスタンスを作成します。

    この例では、image-test という名前のイメージファミリーを使用して ECS インスタンスを作成します。次の API リクエストパラメーターを指定します。

    • RegionId: リージョン ID を指定します。例: ap-southeast-1

    • 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. ECS インスタンスのイメージ情報を確認します。

    1. DescribeImageFromFamily 操作を呼び出して、指定したイメージファミリーで利用可能な最新のカスタムイメージをクエリします。

      この例では、image-test イメージファミリーの最新のイメージをクエリします。次の API リクエストパラメーターを指定します。

      • RegionId: イメージファミリーのリージョン ID を指定します。

      • ImageFamily: イメージファミリーを指定します。例: image-test

      次の図は、利用可能な最新のカスタムイメージの ID が表示されるサンプルレスポンスを示しています。11

    2. DescribeInstances 操作を呼び出して、インスタンスのイメージ情報をクエリします。

      次の API リクエストパラメーターを指定します。

      • RegionId: インスタンスのリージョン ID を選択します。

      • InstanceIds: ["i-bp1env7nl3mijm2t****"] の形式でインスタンス ID を指定します。

      次の例は、サンプルレスポンスの一部を示しています。インスタンスのイメージ ID は、イメージファミリーで利用可能な最新のイメージの ID と同じです。if8