

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 使用 建立和管理暖集區的範例 AWS CLI
<a name="examples-warm-pools-aws-cli"></a>

您可以使用 AWS 管理主控台、 AWS Command Line Interface (AWS CLI) 或 SDKs 建立和管理暖集區。

以下範例說明如何使用 AWS CLI建立和管理暖集區。

**Topics**
+ [範例 1：將執行個體保持為 `Stopped` 狀態](#warm-pool-configuration-ex1)
+ [範例 2：將執行個體保持為 `Running` 狀態](#warm-pool-configuration-ex2)
+ [範例 3：將執行個體保持為 `Hibernated` 狀態](#warm-pool-configuration-ex3)
+ [範例 4：縮減時將執行個體傳回暖集區](#warm-pool-configuration-ex4)
+ [範例 5：指定暖集區中的執行個體數量下限](#warm-pool-configuration-ex5)
+ [範例 6：使用自訂規格定義暖集區大小](#warm-pool-configuration-ex6)
+ [範例 7：定義暖集區絕對大小](#warm-pool-configuration-ex7)
+ [範例 8：刪除暖集區](#delete-warm-pool-cli)

## 範例 1：將執行個體保持為 `Stopped` 狀態
<a name="warm-pool-configuration-ex1"></a>

以下 [put-warm-pool](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/put-warm-pool.html) 範例會建立一個暖集區，可將執行個體維持在 `Stopped` 狀態。

```
aws autoscaling put-warm-pool --auto-scaling-group-name my-asg /
  --pool-state Stopped
```

## 範例 2：將執行個體保持為 `Running` 狀態
<a name="warm-pool-configuration-ex2"></a>

以下 [put-warm-pool](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/put-warm-pool.html) 範例會建立一個暖集區，可將執行個體維持在 `Running` 狀態，而不是 `Stopped` 狀態。

```
aws autoscaling put-warm-pool --auto-scaling-group-name my-asg /
  --pool-state Running
```

## 範例 3：將執行個體保持為 `Hibernated` 狀態
<a name="warm-pool-configuration-ex3"></a>

以下 [put-warm-pool](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/put-warm-pool.html) 範例會建立一個暖集區，可將執行個體維持在 `Hibernated` 狀態，而不是 `Stopped` 狀態。這讓您可以停止執行個體而不刪除其記憶體內容 (RAM)。

```
aws autoscaling put-warm-pool --auto-scaling-group-name my-asg /
  --pool-state Hibernated
```

## 範例 4：縮減時將執行個體傳回暖集區
<a name="warm-pool-configuration-ex4"></a>

以下 [put-warm-pool](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/put-warm-pool.html) 範例會建立一個暖集區，可將執行個體維持在 `Stopped` 狀態，並包含 `--instance-reuse-policy` 選項。執行個體重複使用政策值 `'{"ReuseOnScaleIn": true}'` 會告訴 Amazon EC2 Auto Scaling 在 Auto Scaling 群組縮減時將執行個體傳回暖集區。

```
aws autoscaling put-warm-pool --auto-scaling-group-name my-asg /
  --pool-state Stopped --instance-reuse-policy '{"ReuseOnScaleIn": true}'
```

## 範例 5：指定暖集區中的執行個體數量下限
<a name="warm-pool-configuration-ex5"></a>

以下 [put-warm-pool](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/put-warm-pool.html) 範例建立一個至少維護 4 個執行個體的暖集區，使至少有 4 個執行個體可用於處理流量峰值。

```
aws autoscaling put-warm-pool --auto-scaling-group-name my-asg /
  --pool-state Stopped --min-size 4
```

## 範例 6：使用自訂規格定義暖集區大小
<a name="warm-pool-configuration-ex6"></a>

根據預設，Amazon EC2 Auto Scaling 會管理暖集區的大小，作為 Auto Scaling 群組的最大容量和所需容量之間的差異。不過，您可以使用 `--max-group-prepared-capacity`選項，獨立於群組的最大容量來管理暖集區的大小。

下列 [put-warm-pool](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/put-warm-pool.html) 範例會建立暖集區，並設定暖集區和 Auto Scaling 群組中可同時存在的執行個體數量上限。如果群組的所需容量為 800，則暖集區在執行此命令後初始化時，最初的大小為 100。

```
aws autoscaling put-warm-pool --auto-scaling-group-name my-asg /
  --pool-state Stopped --max-group-prepared-capacity 900
```

若要維持暖集區中的執行個體數目下限，請使用命令納入 `--min-size` 選項，如下所示。

```
aws autoscaling put-warm-pool --auto-scaling-group-name my-asg /
  --pool-state Stopped --max-group-prepared-capacity 900 --min-size 25
```

## 範例 7：定義暖集區絕對大小
<a name="warm-pool-configuration-ex7"></a>

如果將 `--max-group-prepared-capacity` 和 `--min-size` 選項設定為相同的值，則暖集區具有絕對大小。以下 [put-warm-pool](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/put-warm-pool.html) 範例會建立一個維持恆定暖集區大小 (包含 10 個執行個體) 的暖集區。

```
aws autoscaling put-warm-pool --auto-scaling-group-name my-asg /
  --pool-state Stopped --min-size 10 --max-group-prepared-capacity 10
```

## 範例 8：刪除暖集區
<a name="delete-warm-pool-cli"></a>

使用下列 [delete-warm-pool](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/delete-warm-pool.html) 命令來刪除暖集區。

```
aws autoscaling delete-warm-pool --auto-scaling-group-name my-asg
```

如果暖集區中具有執行個體，或有擴展活動正在進行中，請合併使用 [delete-warm-pool](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/delete-warm-pool.html) 命令與 `--force-delete` 選項。此選項也會終止 Amazon EC2 執行個體和任何未完成的生命週期動作。

```
aws autoscaling delete-warm-pool --auto-scaling-group-name my-asg --force-delete
```