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

# 建立執行個體 (create-instance)
<a name="cli-examples-create-instance"></a>

**重要**  
 AWS OpsWorks Stacks 此服務已於 2024 年 5 月 26 日終止，並已針對新客戶和現有客戶停用。我們強烈建議客戶盡快將其工作負載遷移至其他解決方案。如果您對遷移有任何疑問，請透過 [AWS re：Post](https://repost.aws/) 或透過 [AWS Premium Support](https://aws.amazon.com/support) 聯絡 AWS 支援 團隊。

使用 [create-instance](https://docs.aws.amazon.com/cli/latest/reference/opsworks/create-instance.html) 命令來在指定堆疊上建立執行個體。

**Topics**
+ [使用預設主機名稱建立執行個體](#cli-examples-create-instance-default)
+ [使用主題主機名稱建立執行個體](#cli-examples-create-instance-themed)
+ [使用自訂 AMI 建立執行個體](#cli-examples-create-instance-custom-ami)

## 使用預設主機名稱建立執行個體
<a name="cli-examples-create-instance-default"></a>

```
C:\>aws opsworks --region us-west-1 create-instance --stack-id 935450cc-61e0-4b03-a3e0-160ac817d2bb
    --layer-ids 5c8c272a-f2d5-42e3-8245-5bf3927cb65b --instance-type m1.large --os "Amazon Linux"
```

引數如下：
+ `stack-id` – 您可以從主控台上的堆疊設定頁面取得堆疊 ID (尋找 **OpsWorks ID**) 或呼叫 [describe-stacks](https://docs.aws.amazon.com/cli/latest/reference/opsworks/describe-stacks.html)。
+ `layer-ids` – 您可以從 主控台的 layer 詳細資訊頁面取得 layer IDs （尋找 **OpsWorks ID**) 或呼叫 [describe-layers](https://docs.aws.amazon.com/cli/latest/reference/opsworks/describe-layers.html)。在此範例中，執行個體僅屬於一個 layer。
+ `instance-type` – 定義記憶體、CPU、儲存體容量，和執行個體每小時成本的規格。此範例為 `m1.large`。
+ `os` – 執行個體的作業系統。此範例為 Amazon Linux。

命令會傳回包含執行個體 ID 的 JSON 物件，如下所示：

```
{
    "InstanceId": "5f9adeaa-c94c-42c6-aeef-28a5376002cd"
}
```

此範例會使用預設主機名稱 (僅為一個整數) 建立執行個體。下列章節說明如何使用從主題產生的主機名稱建立執行個體。

## 使用主題主機名稱建立執行個體
<a name="cli-examples-create-instance-themed"></a>

您也可以使用主題主機名稱建立執行個體。您會在建立堆疊時指定主題。如需詳細資訊，請參閱[建立新的堆疊](workingstacks-creating.md)。若要建立執行個體，首先請呼叫 [get-hostname-suggestion](https://docs.aws.amazon.com/cli/latest/reference/opsworks/get-hostname-suggestion.html) 以產生名稱。例如：

```
C:\>aws opsworks get-hostname-suggestion --region us-west-1 --layer-id 5c8c272a-f2d5-42e3-8245-5bf3927cb65b
```

若您指定預設 `Layer Dependent` 主題，`get-hostname-suggestion` 只會將數字附加到 layer 的短名。如需詳細資訊，請參閱[建立新的堆疊](workingstacks-creating.md)。

命令會傳回產生的主機名稱。

```
{
    "Hostname": "php-app2",
    "LayerId": "5c8c272a-f2d5-42e3-8245-5bf3927cb65b"
}
```

您接著可以使用 `hostname` 引數將產生的名稱傳遞給 `create-instance`，如下所示：

```
c:\>aws --region us-west-1 opsworks create-instance --stack-id 935450cc-61e0-4b03-a3e0-160ac817d2bb
   --layer-ids 5c8c272a-f2d5-42e3-8245-5bf3927cb65b --instance-type m1.large --os "Amazon Linux" --hostname "php-app2"
```

## 使用自訂 AMI 建立執行個體
<a name="cli-examples-create-instance-custom-ami"></a>

以下 [create-instance](https://docs.aws.amazon.com/cli/latest/reference/opsworks/create-instance.html) 命令會使用自訂 AMI 建立執行個體，該自訂 AMI 必須來自堆疊的區域。如需如何為 Stacks 建立自訂 AMI OpsWorks 的詳細資訊，請參閱 [使用自訂 AMI](workinginstances-custom-ami.md)。

```
C:\>aws opsworks create-instance --region us-west-1 --stack-id c5ef46ce-3ccd-472c-a3de-9bec94c6028e
   --layer-ids 6ff8a2ac-c9cc-49cf-9c67-fc852539ade4 --instance-type c3.large --os Custom
   --ami-id ami-6c61f104
```

引數如下：
+ `stack-id` – 您可以從主控台上的堆疊設定頁面取得堆疊 ID (尋找 **OpsWorks ID**) 或呼叫 [describe-stacks](https://docs.aws.amazon.com/cli/latest/reference/opsworks/describe-stacks.html)。
+ `layer-ids` – 您可以從 主控台的 layer 詳細資訊頁面取得 layer IDs （尋找 **OpsWorks ID**) 或呼叫 [describe-layers](https://docs.aws.amazon.com/cli/latest/reference/opsworks/describe-layers.html)。在此範例中，執行個體僅屬於一個 layer。
+ `instance-type` – 值定義執行個體的記憶體、CPU、儲存體容量和每小時成本，且必須與 AMI 相容 (此範例中為 `c3.large`)。
+ `os` – 執行個體的作業系統；自訂 AMI 必須設為 `Custom`。
+ `ami-id` – AMI ID，形式看起來應該像 `ami-6c61f104`

**注意**  
當您使用自訂 AMI 時，不支援區塊型設備映射，因此您為 `--block-device-mappings` 選項指定的值將會遭到忽略。

命令會傳回包含執行個體 ID 的 JSON 物件，如下所示：

```
{
    "InstanceId": "5f9adeaa-c94c-42c6-aeef-28a5376002cd"
}
```