起動テンプレートを使用した EC2 インスタンスの起動

run-instances コマンドを使用して --launch-template パラメータを指定します。オプションで、使用する起動テンプレートのバージョンを指定します。バージョンを指定しない場合は、デフォルトバージョンが使用されます。

aws ec2 run-instances \
    --launch-template LaunchTemplateId=lt-0abcd290751193123,Version=1

起動テンプレートパラメータを上書きするには、run-instances コマンドでパラメータを指定します。次の例では、起動テンプレートで指定されたインスタンスタイプを上書きします (ある場合)。

aws ec2 run-instances \
    --launch-template LaunchTemplateId=lt-0abcd290751193123 \
    --instance-type t2.small

複雑な構造の一部である入れ子状のパラメータを指定した場合、インスタンスは、起動テンプレートで指定された複雑な構造および、指定した入れ子状の追加パラメータを使用して起動されます。

次の例で、インスタンスは、タグ Owner=TeamA および起動テンプレートで指定された他のタグを使用して起動されます。起動テンプレートに既存の Owner のキーのタグがある場合、値は TeamA に置き換えられます。

aws ec2 run-instances \
    --launch-template LaunchTemplateId=lt-0abcd290751193123 \
    --tag-specifications "ResourceType=instance,Tags=[{Key=Owner,Value=TeamA}]"

次の例で、インスタンスは、/dev/xvdb という名前のデバイス名を持つボリューム、および起動テンプレートで指定された他のブロックデバイスマッピングを使用して起動されます。起動テンプレートに /dev/xvdb 用に定義された既存のボリュームがある場合、値は指定された値で置き換えられます。

aws ec2 run-instances \
    --launch-template LaunchTemplateId=lt-0abcd290751193123 \
    --block-device-mappings "DeviceName=/dev/xvdb,Ebs={VolumeSize=20,VolumeType=gp2}"

[New-EC2Instance] コマンドを使用して、-LaunchTemplate パラメータを指定します。オプションで、使用する起動テンプレートのバージョンを指定します。バージョンを指定しない場合は、デフォルトバージョンが使用されます。

Import-Module AWS.Tools.EC2
New-EC2Instance `
    -LaunchTemplate ( 
        New-Object -TypeName Amazon.EC2.Model.LaunchTemplateSpecification -Property @{ 
            LaunchTemplateId = 'lt-0abcd290751193123'; 
            Version          = '4' 
    } 
)

起動テンプレートパラメータを上書きするには、[New-EC2Instance] コマンドでパラメータを指定します。次の例では、起動テンプレートで指定されたインスタンスタイプを上書きします (ある場合)。

Import-Module AWS.Tools.EC2
New-EC2Instance `
    -InstanceType t4g.small `
    -LaunchTemplate (
        New-Object -TypeName Amazon.EC2.Model.LaunchTemplateSpecification -Property @{ 
            LaunchTemplateId = 'lt-0abcd290751193123'; 
            Version          = '4' 
    } 
) 

複雑な構造の一部である入れ子状のパラメータを指定した場合、インスタンスは、起動テンプレートで指定された複雑な構造および、指定した入れ子状の追加パラメータを使用して起動されます。

次の例で、インスタンスは、タグ Owner=TeamA および起動テンプレートで指定された他のタグを使用して起動されます。起動テンプレートに既存の Owner のキーのタグがある場合、値は TeamA に置き換えられます。

Import-Module AWS.Tools.EC2
New-EC2Instance `
    -InstanceType t4g.small  `
    -LaunchTemplate ( 
        New-Object -TypeName Amazon.EC2.Model.LaunchTemplateSpecification -Property @{ 
            LaunchTemplateId = 'lt-0abcd290751193123'; 
            Version          = '4' 
        } 
) `
    -TagSpecification ( 
        New-Object -TypeName Amazon.EC2.Model.TagSpecification -Property @{ 
            ResourceType = 'instance'; 
            Tags         = @( 
                @{key = "Owner"; value = "TeamA" }, 
                @{key = "Department"; value = "Operations" } 
            ) 
        } 
)

次の例で、インスタンスは、/dev/xvdb という名前のデバイス名を持つボリューム、および起動テンプレートで指定された他のブロックデバイスマッピングを使用して起動されます。起動テンプレートに /dev/xvdb 用に定義された既存のボリュームがある場合、値は指定された値で置き換えられます。

Import-Module AWS.Tools.EC2
New-EC2Instance `
    -InstanceType t4g.small  `
    -LaunchTemplate ( 
        New-Object -TypeName Amazon.EC2.Model.LaunchTemplateSpecification -Property @{ 
            LaunchTemplateId = 'lt-0abcd290751193123'; 
            Version          = '4' 
    } 
) `
    -BlockDeviceMapping  ( 
        New-Object -TypeName Amazon.EC2.Model.BlockDeviceMapping -Property @{ 
            DeviceName = '/dev/xvdb'; 
            EBS        = ( 
                New-Object -TypeName Amazon.EC2.Model.EbsBlockDevice -Property @{ 
                    VolumeSize = 25; 
                    VolumeType = 'gp3' 
                } 
            ) 
        } 
)