

# 既存のキャパシティ予約へのインスタンスの起動
<a name="capacity-reservations-launch"></a>

キャパシティ予約でインスタンスを起動できるのは、次の場合のみです。
+ 一致する属性 (インスタンスタイプ、プラットフォーム、アベイラビリティーゾーン、テナンシー) があります
+ 十分なキャパシティがあります
+ `active` 状態です

インスタンスを起動するときに、インスタンスを任意の `open` キャパシティ予約 に起動するか、特定のキャパシティ予約に起動するか、またはキャパシティ予約のグループに起動するかを指定できます。

または、一致する属性と使用可能な容量を持つ `open` キャパシティ予約がある場合でも、キャパシティーの予約 でインスタンスを実行しないように設定できます。

キャパシティ予約にインスタンスを起動すると、起動されたインスタンスの数だけ使用可能なキャパシティーが減少します。例えば、3 つのインスタンスを起動すると、キャパシティ予約の使用可能なキャパシティは 3 つ減少します。

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

**既存のキャパシティ予約でインスタンスを起動するには**

1. 手順に従って[インスタンスを起動](ec2-launch-instance-wizard.md)しますが、次のステップを完了してプレイスメントグループとキャパシティ予約の設定を指定するまでインスタンスを起動しないでください。

1. **[高度な詳細]** を展開し、以下の操作を行います。

   1. **[プレイスメントグループ]** で、インスタンスを起動するクラスタープレイスメントグループを選択してください。

   1. **[Capacity Reservation]** (キャパシティ予約) で、キャパシティ予約の設定に応じて、次のいずれかのオプションを選択してください。
      + **[なし]** — インスタンスがキャパシティ予約に起動しないようにします。インスタンスはオンデマンド型キャパシティーで実行されます。
      + **[開く]** — 選択したインスタンスの数に対して一致する属性と十分なキャパシティのあるキャパシティ予約にインスタンスを起動します。十分なキャパシティを持つ、一致するキャパシティ予約がない場合は、インスタンスはオンデマンドのキャパシティーを使用します。
      + **[キャパシティ予約の指定]** — 選択したキャパシティ予約にインスタンスを起動します。選択されたこの キャパシティ予約に選択したインスタンスの数に対して十分なキャパシティがない場合、インスタンスの起動に失敗します。
      + **[キャパシティ予約リソースグループの指定]** — 選択したキャパシティ予約グループで一致する属性および利用可能なキャパシティを持つ任意のキャパシティ予約にインスタンスを起動します。選択したグループに、一致する属性と使用可能な容量を持つキャパシティ予約がない場合、インスタンスはオンデマンド型キャパシティに起動します。
      + **[キャパシティ予約の指定]** — キャパシティ予約にインスタンスを起動します。キャパシティ予約 ID が指定されていない場合、インスタンスはオープンキャパシティ予約で起動します。キャパシティがない場合、インスタンスは起動に失敗します。
      + **[キャパシティ予約リソースグループのみを指定]** – キャパシティ予約リソースグループのキャパシティ予約でインスタンスを起動します。キャパシティ予約リソースグループ ARN が指定されていない場合、インスタンスはオープンキャパシティ予約で起動します。キャパシティがない場合、インスタンスは起動に失敗します。

1. **[Summary]** (概要) パネルでインスタンスの設定を確認し、**[Launch instance]** (インスタンスを起動) を選択してください。

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

**既存のキャパシティ予約でインスタンスを起動するには**  
[run-instances](https://docs.aws.amazon.com/cli/latest/reference/ec2/run-instances.html) コマンドを使用して `--capacity-reservation-specification` オプションを指定します。

次の例では、属性と使用可能なキャパシティが一致する任意の開いているキャパシティ予約でインスタンスを起動します。

```
aws ec2 run-instances \
    --image-id ami-0abcdef1234567890 \
    --count 1 \
    --instance-type t2.micro \
    --key-name my-key-pair \
    --subnet-id subnet-0abcdef1234567890 \
    --capacity-reservation-specification CapacityReservationPreference=open
```

次の例では、インスタンスを `targeted` のキャパシティ予約に起動します。

```
aws ec2 run-instances \
    --image-id ami-0abcdef1234567890 \
    --count 1 \
    --instance-type t2.micro \
    --key-name my-key-pair \
    --subnet-id subnet-0abcdef1234567890 \
    --capacity-reservation-specification \
        CapacityReservationTarget={CapacityReservationId=cr-1234abcd56EXAMPLE}
```

次の例では、インスタンスを指定されたキャパシティ予約グループに起動します。

```
aws ec2 run-instances \
    --image-id ami-0abcdef1234567890 \
    --count 1 \
    --instance-type t2.micro \
    --key-name my-key-pair \
    --subnet-id subnet-0abcdef1234567890 \
    --capacity-reservation-specification \
        CapacityReservationTarget={CapacityReservationResourceGroupArn=arn:aws:resource-groups:us-west-2:123456789012:group/my-cr-group}
```

次の例では、インスタンスを 1 つのキャパシティ予約にのみ起動します。キャパシティ予約 ID が指定されていないため、インスタンスは、一致する属性および使用可能なキャパシティを持つ任意のオープンキャパシティ予約で起動します。

```
aws ec2 run-instances \
    --image-id ami-0abcdef1234567890 \
    --count 1 \
    --instance-type t2.micro \
    --key-name my-key-pair \
    --subnet-id subnet-0abcdef1234567890 \
    --capacity-reservation-specification \
        CapacityReservationPreference=capacity-reservations-only
```

次の例では、インスタンスを特定のキャパシティ予約のみで起動します。指定されたキャパシティ予約でキャパシティがない場合、インスタンスは起動に失敗します。

```
aws ec2 run-instances \
    --image-id ami-0abcdef1234567890 \
    --count 1 \
    --instance-type t2.micro \
    --key-name my-key-pair \
    --subnet-id subnet-0abcdef1234567890 \
    --capacity-reservation-specification \
        CapacityReservationPreference=capacity-reservations-only \
        CapacityReservationTarget={CapacityReservationId=cr-1234abcd56EXAMPLE}
```

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

**既存のキャパシティ予約でインスタンスを起動するには**  
[New-EC2Instance](https://docs.aws.amazon.com/powershell/latest/reference/items/New-EC2Instance.html) コマンドレットを使用します。

次の例では、属性と使用可能なキャパシティが一致する任意の開いているキャパシティ予約でインスタンスを起動します。

```
New-EC2Instance `
    -ImageId ami-0abcdef1234567890 `
    -InstanceType t2.micro `
    -KeyName "my-key-pair" `
    -SubnetId subnet-0abcdef1234567890 `
    -CapacityReservationSpecification_CapacityReservationPreference "open"
```

次の例では、インスタンスを `targeted` のキャパシティ予約に起動します。

```
New-EC2Instance `
    -ImageId ami-0abcdef1234567890 `
    -InstanceType t2.micro `
    -KeyName "my-key-pair" `
    -SubnetId subnet-0abcdef1234567890 `
    -CapacityReservationTarget_CapacityReservationId cr-1234abcd56EXAMPLE
```

次の例では、インスタンスを指定されたキャパシティ予約グループに起動します。

```
New-EC2Instance `
    -ImageId ami-0abcdef1234567890 `
    -InstanceType t2.micro `
    -KeyName "my-key-pair" `
    -SubnetId subnet-0abcdef1234567890 `
    -CapacityReservationTarget_CapacityReservationResourceGroupArn `
        "arn:aws:resource-groups:us-west-2:123456789012:group/my-cr-group"
```

次の例では、インスタンスを 1 つのキャパシティ予約にのみ起動します。キャパシティ予約 ID が指定されていないため、インスタンスは、一致する属性および使用可能なキャパシティを持つ任意のオープンキャパシティ予約で起動します。

```
New-EC2Instance `
    -ImageId ami-0abcdef1234567890 `
    -InstanceType t2.micro `
    -KeyName "my-key-pair" `
    -SubnetId subnet-0abcdef1234567890 `
    -CapacityReservationSpecification_CapacityReservationPreference "capacity-reservations-only"
```

次の例では、インスタンスを特定のキャパシティ予約のみで起動します。指定されたキャパシティ予約でキャパシティがない場合、インスタンスは起動に失敗します。

```
New-EC2Instance `
    -ImageId ami-0abcdef1234567890 `
    -InstanceType t2.micro `
    -KeyName "my-key-pair" `
    -SubnetId subnet-0abcdef1234567890 `
    -CapacityReservationSpecification_CapacityReservationPreference "capacity-reservations-only" `
    -CapacityReservationTarget_CapacityReservationId cr-1234abcd56EXAMPLE
```

------