本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 使用 建立資源 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`命令時，您可以將所需的狀態直接內嵌傳遞為字串，或者，對於更複雜的所需狀態定義，請指定檔案位置。

following AWS Command Line Interface (AWS CLI) 命令會建立 資源，並在 `desired-state` 參數中指定除了指定日誌群組名稱之外`90`，資源的 `RetentionInDays` 屬性設為 。

```
$ 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)。