使用创建资源 AWS Cloud Control API - 云控制 API

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

使用创建资源 AWS Cloud Control API

使用 create-resource 命令创建资源。

编写资源的所需状态

API要让 Cloud Control 创建资源,您必须指定要创建的资源的所需状态。所需状态由您要指定的资源属性及其所需值的列表组成。

资源的属性在其资源类型架构中定义。这包括属性是否为必需属性、有效值和其他属性约束。有关查看资源属性定义的更多信息,请参阅查看资源类型架构

您指定的所需状态必须对资源类型架构有效。

例如,假设您要创建一个具有特定名称且保留期为 90 天的AWS::Logs::LogGroup资源。首先,您必须撰写所需资源的状态,格式为JSON文本。

{ "LogGroupName": "CloudApiLogGroup", "RetentionInDays": 90 }

调用 create-resource 命令时,您可以以字符串形式直接内联传递所需状态,或者,对于更复杂的所需状态定义,可以指定文件位置。

以下 AWS Command Line Interface (AWS CLI) 命令创建资源,并在desired-state参数中指定资源RetentionInDays属性设置为90,此外还指定日志组名称。

$ aws cloudcontrol create-resource --type-name AWS::Logs::LogGroup \ --desired-state '{"LogGroupName": "CloudApiLogGroup", "RetentionInDays":90}'

跟踪创建资源请求的进度

create-resource 命令将返回一个 ProgressEvent 对象,您可以使用该对象监控资源创建请求的当前状态。有关更多信息,请参阅 跟踪资源操作请求的进度