本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

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

**重要**  
该 AWS OpsWorks Stacks 服务于 2024 年 5 月 26 日终止，新客户和现有客户均已禁用。我们强烈建议客户尽快将其工作负载迁移到其他解决方案。如果您对迁移有疑问，请通过 re [AWS : Post 或通过 Pre](https://repost.aws/) mium Su [AWS pp](https://aws.amazon.com/support) ort 与 AWS 支持 团队联系。

 OpsWorks Stacks 命令行界面 (CLI) 提供的功能与控制台相同，可用于各种任务。 OpsWorks Stacks CLI 是其中的 AWS CLI一部分。有关更多信息，包括如何安装和配置 AWS CLI，请转到[什么是 AWS 命令行界面？](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 的工作站，也可以运行适用于 Windows 的 AWS 工具，通过 PowerShell 命令行执行 OpsWorks 堆栈操作。有关更多信息，请参阅适用于 [Windows 的 AWS 工具 PowerShell](https://aws.amazon.com/documentation/powershell/)。

OpsWorks 堆栈命令的常规格式如下：

```
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 为使用默认的区域终端节点。加拿大（中部）地区终端节点 AWS CLI 仅在 API 中可用；它不适用于您在中创建的堆栈。 AWS 管理控制台有关更多信息，请参阅[配置 Amazon Web Services Region](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 执行各种常见任务。