API 操作を呼び出すことで、ImageFamily パラメーターに基づいて Elastic Compute Service (ECS) インスタンスを作成できます。システムは、ECS インスタンスのイメージファミリーで利用可能な最新のイメージを自動的に選択します。このトピックでは、イメージファミリーから ECS インスタンスを作成する方法について説明します。
手順
OpenAPI Explorer にログオンします。
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****" ] } }ECS インスタンスのイメージ情報を確認します。
DescribeImageFromFamily 操作を呼び出して、指定したイメージファミリーで利用可能な最新のカスタムイメージをクエリします。
この例では、
image-testイメージファミリーの最新のイメージをクエリします。次の API リクエストパラメーターを指定します。RegionId: イメージファミリーのリージョン ID を指定します。
ImageFamily: イメージファミリーを指定します。例:
image-test。
次の図は、利用可能な最新のカスタムイメージの ID が表示されるサンプルレスポンスを示しています。

DescribeInstances 操作を呼び出して、インスタンスのイメージ情報をクエリします。
次の API リクエストパラメーターを指定します。
RegionId: インスタンスのリージョン ID を選択します。
InstanceIds:
["i-bp1env7nl3mijm2t****"]の形式でインスタンス ID を指定します。
次の例は、サンプルレスポンスの一部を示しています。インスタンスのイメージ ID は、イメージファミリーで利用可能な最新のイメージの ID と同じです。
