

# 起動テンプレートの変更 (起動テンプレートのバージョンの管理)
<a name="manage-launch-template-versions"></a>

起動テンプレートは変更不可能です。起動テンプレートを作成したら、それを変更することはできません。代わりに、必要な変更を含む新しいバージョンの起動テンプレートを作成できます。

起動テンプレートの別のバージョンの作成、デフォルトバージョンの設定、起動テンプレートバージョンの説明、不要になった[バージョンの削除](delete-launch-template.md#delete-launch-template-version)を行うことができます。

**Topics**
+ [起動テンプレートのバージョンの作成](#create-launch-template-version)
+ [デフォルトの起動テンプレートのバージョンの設定](#set-default-launch-template-version)
+ [起動テンプレートのバージョンの説明](#describe-launch-template-version)

## 起動テンプレートのバージョンの作成
<a name="create-launch-template-version"></a>

起動テンプレートのバージョンを作成する際、新しいバージョンに新しい起動パラメータを指定するか、または既存のバージョンをベースとして使用できます。各パラメータの説明については、「[Amazon EC2 インスタンス設定パラメータのリファレンス](ec2-instance-launch-parameters.md)」を参照してください。

------
#### [ Console ]

**起動テンプレートのバージョンを作成するには**

1. Amazon EC2 コンソールの [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/) を開いてください。

1. ナビゲーションペインで、[**Launch Templates**] を選択してください。

1. 起動テンプレートを選択し、[**アクション**]、[**Modify template (Create new version)**] の順に選択してください。

1. [**Template version description**] (テンプレートバージョンの説明) に、起動テンプレートバージョンについての説明を入力してください。

1. (オプション) **[Source template]** (ソーステンプレート) を展開し、新しい起動テンプレートバージョンのベースとして使用する起動テンプレートのバージョンを選択してください。新しい起動テンプレートバージョンは、この起動テンプレートバージョンから起動パラメータを継承します。

1. 必要に応じて起動パラメータを変更します。

1. [**起動テンプレートの作成**] を選択してください。

------
#### [ AWS CLI ]

**起動テンプレートのバージョンを作成するには**  
[create-launch-template-version](https://docs.aws.amazon.com/cli/latest/reference/ec2/create-launch-template-version.html) コマンドを使用します。新しいバージョンのベースとなるソースバージョンを指定できます。新しいバージョンはこのバージョンの起動パラメータを継承し、`--launch-template-data` を使用してパラメータを上書きできます。次の例では、起動テンプレートのバージョン 1 に基づいて新しいバージョンを作成し、異なる AMI ID を指定します。

```
aws ec2 create-launch-template-version \
    --launch-template-id lt-0abcd290751193123 \
    --version-description WebVersion2 \
    --source-version 1 \
    --launch-template-data "ImageId=ami-0abcdef1234567890"
```

------
#### [ PowerShell ]

**起動テンプレートのバージョンを作成するには**  
[New-EC2LaunchTemplateVersion](https://docs.aws.amazon.com/powershell/latest/reference/items/New-EC2LaunchTemplateVersion.html) コマンドレットを使用します。新しいバージョンのベースとなるソースバージョンを指定できます。新しいバージョンはこのバージョンの起動パラメータを継承し、`LaunchTemplateData` を使用してパラメータを上書きできます。次の例では、起動テンプレートのバージョン 1 に基づいて新しいバージョンを作成し、異なる AMI ID を指定します。

```
New-EC2LaunchTemplateVersion `
    -LaunchTemplateId lt-0abcd290751193123 `
    -VersionDescription WebVersion2 `
    -SourceVersion 1 `
    -LaunchTemplateData (
        New-Object `
            -TypeName Amazon.EC2.Model.RequestLaunchTemplateData `
            -Property @{ImageId = 'ami-0abcdef1234567890'}
    )
```

------

## デフォルトの起動テンプレートのバージョンの設定
<a name="set-default-launch-template-version"></a>

起動テンプレートにデフォルトバージョンを設定できます。起動テンプレートからインスタンスを起動し、バージョンを指定しない場合、インスタンスはデフォルトバージョンのパラメータを使用して起動されます。

------
#### [ Console ]

**デフォルトの起動テンプレートのバージョンを設定するには**

1. Amazon EC2 コンソールの [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/) を開いてください。

1. ナビゲーションペインで、[**Launch Templates**] を選択してください。

1. 起動テンプレートを選択し、[**アクション**]、[**デフォルトバージョンの設定**] を選択してください。

1. [**テンプレートバージョン**] で、デフォルトバージョンとして設定するバージョン番号を選択し、[**デフォルトバージョンとして設定**] を選択してください。

------
#### [ AWS CLI ]

**デフォルトの起動テンプレートのバージョンを設定するには**  
[modify-launch-template](https://docs.aws.amazon.com/cli/latest/reference/ec2/modify-launch-template.html) コマンドを使用します。

```
aws ec2 modify-launch-template \
    --launch-template-id lt-0abcd290751193123 \
    --default-version 2
```

------
#### [ PowerShell ]

**デフォルトの起動テンプレートのバージョンを設定するには**  
[Edit-EC2LaunchTemplate](https://docs.aws.amazon.com/powershell/latest/reference/items/Edit-EC2LaunchTemplate.html) コマンドレットを使用します。

```
Edit-EC2LaunchTemplate `
    -LaunchTemplateId lt-0abcd290751193123 `
    -DefaultVersion 2
```

------

## 起動テンプレートのバージョンの説明
<a name="describe-launch-template-version"></a>

コンソールを使用して、選択した起動テンプレートのすべてのバージョンを表示したり、特定のバージョン番号と一致する最新バージョンやデフォルトバージョンの起動テンプレートを一覧表示したりできます。AWS CLI を使用すると、指定した起動テンプレートのすべてのバージョン、各バージョン、特定範囲のバージョンを表示できます。また、アカウント内にあるすべての起動テンプレートについて、すべての最新バージョンを表示したり、すべてのデフォルトバージョンを表示したりすることもできます。

------
#### [ Console ]

**起動テンプレートのバージョンを説明するには**

1. Amazon EC2 コンソールの [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/) を開いてください。

1. ナビゲーションペインで、[**Launch Templates**] を選択してください。

1. 特定の起動テンプレートのバージョンを表示したり、特定のバージョン番号と一致する最新バージョンやデフォルトバージョンの起動テンプレートを一覧表示したりできます。
   + 起動テンプレートのバージョンを表示するには、起動テンプレートを選択してください。[**バージョン**] タブの [**バージョン**] から、詳細を表示するバージョンを選択してください。
   + 特定のバージョン番号と一致する最新バージョンの起動テンプレートを一覧表示するには、検索バーから [**最新バージョン**] を選択し、バージョン番号を選択してください。
   + 特定のバージョン番号と一致するデフォルトバージョンの起動テンプレートを一覧表示するには、検索バーから [**デフォルトバージョン**] を選択し、バージョン番号を選択してください。

------
#### [ AWS CLI ]

**起動テンプレートのバージョンを説明するには**  
[describe-launch-template-versions](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-launch-template-versions.html) コマンドを使用して、バージョン番号を指定します。次の例では、バージョン `1` と *`3`* を指定しています。

```
aws ec2 describe-launch-template-versions \
    --launch-template-id lt-0abcd290751193123 \
    --versions 1 3
```

**アカウント内にある起動テンプレートの最新バージョンやデフォルトバージョンを記述するには**  
[delete-launch-template-versions](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-launch-template-versions.html) コマンドを使用し、`$Latest` または `$Default` を指定するか、両方を指定します。呼び出しでは、起動テンプレートの ID と名前を省略する必要があります。バージョン番号を指定することはできません。

```
aws ec2 describe-launch-template-versions \
    --versions "$Latest,$Default"
```

------
#### [ PowerShell ]

**起動テンプレートのバージョンを説明するには**  
[Get-EC2TemplateVersion](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2TemplateVersion.html) コマンドレットを使用して、バージョン番号を指定します。次の例では、バージョン `1` と *`3`* を指定しています。

```
Get-EC2TemplateVersion `
    -LaunchTemplateId lt-0abcd290751193123 `
    -Version 1,3
```

**アカウント内にある起動テンプレートの最新バージョンやデフォルトバージョンを記述するには**  
[Get-EC2TemplateVersion](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2TemplateVersion.html) コマンドレットを使用して `$Latest`、`$Default`、またはその両方を指定します。呼び出しでは、起動テンプレートの ID と名前を省略する必要があります。バージョン番号を指定することはできません。

```
Get-EC2TemplateVersion `
    -Version '$Latest','$Default'
```



------