使用 AWS OpsWorks Stacks CLI - AWS OpsWorks

使用 AWS OpsWorks Stacks CLI

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

注意

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

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 管理控制台中创建的堆栈。有关更多信息,请参阅配置 AWS 区域

区域名称 命令代码
美国东部(俄亥俄)区域 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 来执行各种常见任务。