

# キャパシティブロックを使用してインスタンスを起動する
<a name="capacity-blocks-launch"></a>

キャパシティブロックを使用するには、インスタンスの起動時にキャパシティブロックの予約 ID を指定する必要があります。キャパシティブロックでインスタンスを起動すると、起動したインスタンスの数だけ、使用できるキャパシティの数が減ります。例えば、購入したインスタンスのキャパシティが 8 インスタンスで、4 つのインスタンスを起動した場合、使用できるキャパシティは 4 つ減ります。

予約が終了する前にキャパシティブロックで実行中のインスタンスを終了すると、新しいインスタンスを代わりに起動することができます。キャパシティブロック内のインスタンスを停止または終了すると、インスタンスのクリーンアップに数分かかります。置き換える別のインスタンスを起動できるのは、その後です。この間、インスタンスは停止または `shutting-down` 状態になります。このプロセスが完了すると、インスタンスの状態が `stopped` か `terminated` に変わります。その後、キャパシティブロックの利用可能な容量が更新され、使用できる別のインスタンスが表示されます。

**要件**
+ キャパシティブロックがあるアベイラビリティーゾーンとは異なるアベイラビリティーゾーンのサブネットでインスタンスを起動することはできません。
+ インスタンスは、キャパシティブロックのプラットフォームとは異なるプラットフォームの AMI を使用して起動することはできません。
+  ローカルゾーン内のキャパシティブロックを使用するには、ローカルゾーンにオプトインされている必要があります。

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

**キャパシティブロックでインスタンスを起動するには**

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

1. 画面上部のナビゲーションバーで、キャパシティブロックの予約の [リージョン] を選択してください。

1. Amazon EC2 コンソールダッシュボードで、[**インスタンスを起動**] を選択してください。

1. [インスタンスを起動する](ec2-launch-instance-wizard.md)ための手順に従います。

1. **[高度な詳細]** を展開し、**[購入オプション]** で **[キャパシティブロック]** を選択します。次に、以下のいずれかを行ってください。
   + 特定のキャパシティブロックでインスタンスを起動するには、[**キャパシティ予約**] で [**キャパシティ予約を指定**] を選択し、キャパシティブロックを選択します。
   + （*UltraServers のみ*) UltraServer キャパシティブロックリソースグループでインスタンスを起動するには、[**キャパシティ予約**] で [**キャパシティ予約リソースグループを指定**] を選択し、次にリソースグループを選択します。

1. **[インスタンスを起動]** を選択してください。

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

**キャパシティブロックを使用してインスタンスを起動するには**  
`instance-market-options MarketType` オプションで [run-instances](https://docs.aws.amazon.com/cli/latest/reference/ec2/run-instances.html) コマンドを使用します。

次の例では、インスタンスを特定のキャパシティブロックで起動します。

```
aws ec2 run-instances \
--image-id {{ami-0abcdef1234567890}} \
--count {{1}} \
--instance-type {{p5.48xlarge}} \
--key-name {{my-key-pair}} \
--subnet-id {{subnet-0abcdef1234567890}} \
--instance-market-options MarketType='capacity-block' \
--capacity-reservation-specification CapacityReservationTarget={CapacityReservationId={{capacity_block_id}}}
```

次の例では、インスタンスを UltraServer のキャパシティブロックリソースグループに起動します。

```
aws ec2 run-instances \
--image-id {{ami-0abcdef1234567890}} \
--count {{1}} \
--instance-type {{p6e-gb200.36xlarge}} \
--key-name {{my-key-pair}} \
--subnet-id {{subnet-0abcdef1234567890}} \
--instance-market-options MarketType='capacity-block' \
--capacity-reservation-specification CapacityReservationTarget={CapacityReservationResourceGroupArn={{resource_group_arn}}}
```

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

**キャパシティブロックでインスタンスを起動するには**  
次に定義されているように、`-InstanceMarketOption` オプションで [New-EC2Instance](https://docs.aws.amazon.com/powershell/latest/reference/items/New-EC2Instance.html) コマンドレットを使用します。

```
$marketoption = New-Object Amazon.EC2.Model.InstanceMarketOptionsRequest
$marketoption.MarketType = "capacity-block"
```

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

```
New-EC2Instance `
-ImageId {{ami-0abcdef1234567890}} `
-InstanceType {{p5.48xlarge}} `
-KeyName "{{my-key-pair}}" `
-SubnetId {{subnet-0abcdef1234567890}} `
-InstanceMarketOptions $marketoption `
-CapacityReservationTarget_CapacityReservationId {{capacity_block_id}}
```

次の例では、インスタンスを UltraServer のキャパシティブロックリソースグループで起動します。

```
New-EC2Instance `
-ImageId {{ami-0abcdef1234567890}} `
-InstanceType {{p6e-gb200.36xlarge}} `
-KeyName "{{my-key-pair}}" `
-SubnetId {{subnet-0abcdef1234567890}} `
-InstanceMarketOptions $marketoption `
-CapacityReservationTarget_CapacityReservationResourceGroupArn "{{resource_group_arn}}"
```

------

**関連リソース**
+ キャパシティブロックをターゲットとする起動テンプレートを作成するには、「[Amazon EC2 起動テンプレートにインスタンス起動パラメータを保存する](ec2-launch-templates.md)」を参照してください。
+ EC2 フリートを使用してキャパシティブロックでインスタンスを起動するには、「[チュートリアル: キャパシティブロックにインスタンスを起動するように EC2 フリートを設定する](ec2-fleet-launch-instances-capacity-blocks-walkthrough.md)」を参照してください。
+ キャパシティブロックを使用して EKS マネージド型ノードグループを設定するには、「**Amazon EKS ユーザーガイド**」の「[Capacity Blocks for ML を使用してマネージドノードグループを作成する](https://docs.aws.amazon.com/eks/latest/userguide/capacity-blocks-mng.html)」を参照してください。
+ キャパシティブロックを使用して AWS ParallelCluster を設定するには、「[ML on AWS ParallelCluster](https://catalog.workshops.aws/ml-on-aws-parallelcluster/en-US)」を参照してください。