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

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

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

追蹤建立資源請求的進度

create-resource 命令會傳回一個物件,您可以使用該ProgressEvent物件來監控資源建立請求的目前狀態。如需詳細資訊,請參閱追蹤資源操作請求的進度