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

# 使用 OpsWorks Stacks CLI
<a name="cli-examples"></a>

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

Stacks OpsWorks 命令列界面 (CLI) 提供與主控台相同的功能，可用於各種任務。Stacks CLI OpsWorks 是 的一部分 AWS CLI。如需詳細資訊，包括如何安裝和設定 AWS CLI，請前往[什麼是 AWS Command Line Interface？](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html)。如需每個命令的完整說明，請前往 [OpsWorks Stacks 參考](https://docs.aws.amazon.com/cli/latest/reference/opsworks/index.html)。

**注意**  
如果您使用的是 Windows 型工作站，您也可以執行 AWS Tools for Windows PowerShell，從命令列執行 OpsWorks Stacks 操作。如需詳細資訊，請參閱[適用於 Windows PowerShell 的 AWS 工具](https://aws.amazon.com/documentation/powershell/)。

OpsWorks Stacks 命令具有下列一般格式：

```
aws opsworks --region us-west-1 opsworks command-name [--argument1 value] [...]
```

若引數值為 JSON 物件，您應逸出 `"` 字元，否則命令會傳回錯誤，顯示 JSON 無效。例如，若 JSON 物件為 `"{"somekey":"somevalue"}"`，您應將其格式化為 `"{\"somekey\":\"somevalue\"}"`。另一種方法為將 JSON 物件放置在檔案中，然後在命令列中使用 `file://` 以包含它。以下範例會使用存放在 appsource.json 中的應用程式來源物件建立應用程式。

```
aws opsworks --region us-west-1 create-app --stack-id 8c428b08-a1a1-46ce-a5f8-feddc43771b8 --name SimpleJSP --type java --app-source file://appsource.json 
```

大多數命令會傳回一或多個值，並封裝為 JSON 物件。以下章節包含一些範例。如需每個命令傳回值的詳細說明，請前往 [OpsWorks Stacks 參考](https://docs.aws.amazon.com/cli/latest/reference/opsworks/index.html)。

**注意**  
AWS CLI 命令必須指定區域，如範例所示。--region 參數的有效值如下表所示。若要簡化 OpsWorks Stacks 命令字串，請設定 CLI 以指定您的預設區域，讓您可以省略 `--region` 參數。如果您通常在多個區域端點中工作，請勿 AWS CLI 將 設定為使用預設區域端點。加拿大 （中部） 區域端點僅在 API 中提供 AWS CLI ，不適用於您在 中建立的堆疊 AWS 管理主控台。如需詳細資訊，請參閱[設定 AWS 區域](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-getting-started.html#cli-installing-specifying-region)。  


| 區域名稱 | 命令程式碼 | 
| --- | --- | 
| 美國東部 (俄亥俄) 區域 | us-east-2 | 
| 美國東部 (維吉尼亞北部) 區域 | us-east-1 | 
| 美國西部 (加利佛尼亞北部) 區域 | us-west-1 | 
| 美國西部 (奧勒岡) 區域 | us-west-2 | 
| 加拿大 (中部) 區域 | ca-central-1 | 
| 歐洲 (愛爾蘭) 區域 | eu-west-1 | 
| 歐洲 (倫敦) 區域 | eu-west-2 | 
| 歐洲 (巴黎) 區域 | eu-west-3 | 
| 歐洲 (法蘭克福) 區域 | eu-central-1 | 
| 亞太地區 (東京) 區域 | ap-northeast-1 | 
| 亞太 (首爾) 區域 | ap-northeast-2 | 
| 亞太區域 (孟買) 區域 | ap-south-1 | 
| 亞太區域 (新加坡) 區域 | ap-southeast-1 | 
| 亞太 (雪梨) 區域 | ap-southeast-2 | 
| 南美洲 (聖保羅) 區域 | sa-east-1 | 

若要使用 CLI 命令，您必須擁有適當的許可。如需 OpsWorks Stacks 許可的詳細資訊，請參閱[管理使用者許可](opsworks-security-users.md)。若要判斷特定命令需要的許可，請參閱 [OpsWorks Stacks 參考](https://docs.aws.amazon.com/cli/latest/reference/opsworks/index.html)中該命令的參考頁面。

下列各節說明如何使用 OpsWorks Stacks CLI 來執行各種常見任務。