使用 AWS OpsWorks Stacks CLI

重要

AWS OpsWorks Stacks 不再接受新客户。在 2024 年 5 月 26 日之前，现有客户将能够照常使用 OpsWorks 控制台、API、CLI 和 CloudFormation 资源，届时这些工具或资源将停用。为准备此过渡，我们建议您尽快将堆栈过渡到AWS Systems Manager。有关更多信息，请参阅 AWS OpsWorks Stacks 生命周期终止常见问题解答 和 将 AWS OpsWorks Stacks 应用程序迁移到 AWS Systems Manager Application Manager：

AWS OpsWorks Stacks 命令行界面 (CLI) 提供了与控制台相同的功能，可用于执行各种任务。AWS OpsWorks Stacks CLI 是 AWS CLI的一部分。有关更多信息，包括如何安装和配置 AWS CLI，请转到什么是 AWS 命令行界面？ 有关各个命令的完整说明，请转到 AWS OpsWorks Stacks 参考。

注意

如果您使用基于 Windows 的工作站，则还可以运行 AWS Tools for Windows PowerShell 通过命令行执行 AWS OpsWorks Stacks 操作。有关更多信息，请参阅AWS Tools for Windows PowerShell。

AWS 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 对象。以下部分包含一些示例。有关各命令返回值的详细说明，请转到 AWS OpsWorks Stacks 参考。

注意

AWS CLI 命令必须指定一个区域，如示例中所示。--region 参数的有效值显示在下表中。要简化您的 AWS OpsWorks Stacks 命令字符串，请配置 CLI 来指定默认区域，这样就可以忽略 --region 参数。如果您通常使用多个区域的终端节点，请不要配置 AWS CLI 来使用默认区域终端节点。加拿大（中部）区域终端节点仅在 API 和 AWS CLI 中可用；它不适用于在 AWS Management Console 中创建的堆栈。有关更多信息，请参阅配置 Amazon Web Services 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 命令，您必须具有适当的权限。有关 AWS OpsWorks Stacks 权限的更多信息，请参阅管理用户权限。要确定特定命令所需的权限，请参阅 AWS OpsWorks Stacks 参考中的命令参考页面。

以下部分介绍如何使用 AWS OpsWorks Stacks CLI 来执行各种常见任务。