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

# 使用创建资源 AWS 云端控制 API
<a name="resource-operations-create"></a>

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

## 编写资源的所需状态
<a name="resource-operations-create-desiredstate"></a>

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

资源的属性在其资源类型架构中定义。这包括属性是否为必需属性、有效值和其他属性约束。有关查看资源属性定义的更多信息，请参阅[查看资源类型架构](resource-types.md#resource-types-schemas)。

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

例如，假设您要创建一个具有特定名称且保留期为 90 天的[https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-logs-loggroup.html](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-logs-loggroup.html)资源。首先，您必须编写 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}'
```

## 跟踪创建资源请求的进度
<a name="resource-operations-create-progress"></a>

该 `create-resource` 命令将返回一个 `ProgressEvent` 对象，您可以使用该对象监控资源创建请求的当前状态。有关更多信息，请参阅 [跟踪资源操作请求的进度](resource-operations-manage-requests.md#resource-operations-manage-requests-track)。