

# キャパシティ所有者の中断可能なキャパシティ予約
<a name="capacity-owner-procedures"></a>

キャパシティ所有者は、ソースキャパシティ予約を所有するアカウントです。中断可能なキャパシティ予約を作成して未使用のキャパシティを他のチームと共有しつつ、必要に応じて再利用するための制御を維持します。

このセクションでは、ユーザー (キャパシティ所有者) が中断可能なキャパシティ予約を作成、変更、再利用、追跡する方法について説明します。

**Topics**
+ [中断可能なキャパシティ予約の作成](#creating-interruptible-cr)
+ [中断可能なキャパシティ予約を表示する](#view-interruptible-cr)
+ [中断可能なキャパシティ予約の変更](#modify-interruptible-cr)
+ [再利用プロセスと追跡](#reclamation-process)
+ [中断可能な予約の共有](#sharing-interruptible-reservations)

## 中断可能なキャパシティ予約の作成
<a name="creating-interruptible-cr"></a>

中断可能なキャパシティ予約を作成して、ソース予約から未使用のキャパシティを他のワークロードで使用できるようにしながら、必要に応じて再利用するための制御を維持します。

### 前提条件
<a name="interruptible-cr-prerequisites"></a>

中断可能な割り当てを作成する前に、ソースのオンデマンドキャパシティ予約が次の要件を満たしていることを確認してください。
+ キャパシティ予約は、終了日が設定されていないアクティブな状態である必要があります。保留中、期限切れ、キャンセル済み、または終了日がスケジュールされた予約から割り当てを作成することはできません。
+ キャパシティ予約には、割り当て可能なキャパシティが必要です。使用可能なインスタンス (未使用のキャパシティとも呼ばれます) のみを割り当てることができます。
+ ソースキャパシティ予約ごとに作成できる中断可能な割り当ては 1 つだけです。割り当てが既に存在する場合は、新しい割り当てを作成する前に、割り当てを変更またはキャンセルする必要があります。
+ 中断可能なキャパシティ予約には、一度に最大 1,000 個のインスタンスを割り当てることができます。

コンソールまたは AWS CLI を使用して、中断可能なキャパシティ予約を作成できます。

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

**中断可能なキャパシティ予約を作成するには**

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

1. **[キャパシティ予約]** を選択します。

1. キャパシティ予約を選択します。

1. **[アクション]**、**[中断可能な割り当てを作成]** を選択します。

1. **[割り当てるインスタンス]** で、割り当てるインスタンスの数を入力します。

1. (オプション) タグを追加します。

1. **[中断可能なキャパシティ割り当てを作成]** を選択します。

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

**中断可能なキャパシティ予約を作成するには**  
[create-interruptible-capacity-reservation-allocation](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ec2/create-interruptible-capacity-reservation-allocation.html) コマンドを使用します。

```
aws ec2 create-interruptible-capacity-reservation-allocation \
    --capacity-reservation-id {{cr-1234567890abcdef0}} \
    --instance-count {{10}}
```

------

## 中断可能なキャパシティ予約を表示する
<a name="view-interruptible-cr"></a>

中断可能なキャパシティ予約を作成したら、アカウントまたは特定のリソースから中断可能な予約を表示できます。

### お使いのアカウントの中断可能なキャパシティ予約をすべて表示する
<a name="view-all-interruptible-cr"></a>

お使いのアカウントの中断可能なキャパシティ予約を表示するには、次の手順に沿って操作します。

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

**お使いのアカウントの中断可能なキャパシティ予約を表示するには**

1. コンソールのキャパシティ予約ページに移動します。

1. タイプ列で **[中断可能]** な予約を探します。

1. 中断可能な予約を選択して詳細を表示します。

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

**お使いのアカウントの中断可能なキャパシティ予約を表示するには**

```
aws ec2 describe-capacity-reservations \
    --capacity-reservation-id {{cr-interruptible-id}} \
    --filters Name=interruptible,Values=true
```

------

### 特定のソースから中断可能なキャパシティ予約を表示する
<a name="view-interruptible-cr-from-source"></a>

次の手順を使用して、特定のソースのキャパシティ予約から作成された中断可能なキャパシティ予約を表示します。

```
aws ec2 describe-capacity-reservations \
    --capacity-reservation-id {{cr-source-id}}
```

レスポンスには中断可能なキャパシティ予約 ID と割り当ての詳細を含む `interruptibleCapacityAllocations` オブジェクトが表示されます。レスポンス構造の詳細については、「*Amazon EC2 API リファレンス*」の「[InterruptibleCapacityAllocation](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/API_InterruptibleCapacityAllocation.html)」を参照してください。

## 中断可能なキャパシティ予約の変更
<a name="modify-interruptible-cr"></a>

中断可能なキャパシティ予約を編集またはキャンセルするには、次の手順に沿って操作します。

**注記**  
割り当てを減らすと、まず利用可能なインスタンスを再利用してから、リクエストされた数に達するまでインスタンスを実行します。使用可能なインスタンスで数を完全に満たすことができる場合、終了は発生しません。割り当てられたインスタンス数に対するすべての変更は、中断可能なキャパシティ予約ではなく、ソースキャパシティ予約を通じて行われます。
中断可能なキャパシティ予約は、一度に最大 1,000 インスタンスしか変更できません (増減)。

### 中断可能なキャパシティ予約を編集する
<a name="edit-interruptible-allocation"></a>

中断可能なキャパシティ予約を編集するには、次の手順に沿って操作します。

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

1. ソースキャパシティ予約の詳細ページで、**[アクション]** を選択します。次に、**[中断可能なキャパシティ予約を編集] **を選択します。

1. **[割り当てるインスタンス]** で、新しい数を入力します。
   + 共有するキャパシティをさらに追加する
   + ソースキャパシティ予約にキャパシティを呼び戻す

1. **[更新]** を選択します。

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

```
aws ec2 update-interruptible-capacity-reservation-allocation \
    --capacity-reservation-id {{cr-1234567890abcdef0}} \
    --target-instance-count {{80}}
```

------

### 中断可能なキャパシティ予約をキャンセルする
<a name="cancel-interruptible-allocation"></a>

次の手順を使用して、割り当てを完全に削除し、すべてのキャパシティを戻します。

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

1. ソースキャパシティ予約の詳細ページから、中断可能なキャパシティ割り当ての詳細に移動します。

1. **[中断可能な割り当てを編集]** を選択します。

1. インスタンス数には、**0** と入力します。

1. **[更新]** を選択します。

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

```
aws ec2 update-interruptible-capacity-reservation-allocation \
--capacity-reservation-id {{cr-1234567890abcdef0}} \
--target-instance-count {{0}}
```

------

## 再利用プロセスと追跡
<a name="reclamation-process"></a>

キャパシティを再利用する場合:
+ 実行中のインスタンスは、EventBridge イベントを通じて 2 分間の中断警告を受け取ります。
+ 通知期間後、再利用されたキャパシティで実行中のインスタンスはシャットダウン状態になり、終了します。
+ 終了すると、ソースキャパシティ予約で、再利用されたインスタンスをすぐに使用できるようになります。
+ 完了すると、割り当てステータスは **[更新中]** から **[アクティブ]** に変わります。

インスタンスタイプとシャットダウン時間によっては、完全な再利用までに数分かかる場合があります。プロセスの完了時に受け取る EventBridge 通知の詳細については、「[再利用の完了](monitor-interruptible-cr.md#reclamation-completion)」を参照してください。

### 再利用ステータスを追跡する
<a name="track-reclamation-status"></a>

ソース予約を記述して、再利用の進行状況をモニタリングします。

```
aws ec2 describe-capacity-reservations \
--capacity-reservation-id {{cr-1234567890abcdef0}}
```

レスポンスには、 `interruptibleCapacityAllocation` オブジェクト内の以下のフィールドが表示されます。
+ `instance-count`: 現在割り当てられているインスタンス
+ `target-instance-count`: 再利用後にリクエストされた数量
+ `status`: 再利用時には **[更新中]**、完了時には **[アクティブ]**

## 中断可能な予約の共有
<a name="sharing-interruptible-reservations"></a>

中断可能な予約は、AWS Resource Access Manager (RAM) を使用して AWS 組織内でのみ共有できます。

考慮事項:
+ 消費者アカウントが組織を離れると、中断可能な予約はそのアカウントから自動的に共有解除されます。
+ 共有されていない予約で実行されているすべてのインスタンスは、最終的に終了します。
+ 他のすべての共有機能は、標準のキャパシティ予約と同じように機能します。

完全な共有手順については、「[キャパシティ予約の共有](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/capacity-reservation-sharing.html)」を参照してください。