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