创建终态配置。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 CreateStateConfiguration

系统规定参数。取值：CreateStateConfiguration。
ScheduleExpression String 是 1 hour 或 30 minutes

调度表达式。调度间隔不得小于30分钟。
ScheduleType String 是 rate

调度类型。可选值：rate。
Targets String 是 { "ResourceType": "ALIYUN::ECS::Instance", "Filters": [ { "Type": "All", "RegionId": "cn-hangzhou", "Parameters": { "RegionId": "cn-hangzhou", "Status": "Running" } } ] }

目标资源。
TemplateName String 是 ACS-ECS-InventoryDataCollection

模板名称。内容限制为字母、数字、中划线、下划线，长度200字符。
RegionId String 否 cn-hangzhou

地域ID。
Description String 否 收集Inventory数据

终态配置的描述信息。
TemplateVersion String 否 v1

版本号，如不填默认为最新的版本号。
Parameters String 否 { "policy": { "ACS:Application": { "Collection": "Enabled" }, "ACS:Network": { "Collection": "Enabled" } } }

参数。
ConfigureMode String 否 ApplyOnce

配置模式。

ApplyOnce：配置只应用一次（更新配置后重新应用）。

ApplyAndMonitor： 配置只应用一次，成功应用后，后续只检查配置是否漂移。

ApplyAndAutoCorrect：总是应用配置。
ClientToken String 否 DASKJJLKADS-AHKLJHJSAKL-AJK

幂等token。
Tags Json 否 {"Key": "oos", "Value": "inventory"}

标签。

返回数据

名称 类型 示例值 描述
RequestId String 1306108F-610C-40FD-AAD5-DA13E8B00BE9

请求ID。
StateConfiguration Struct

终态配置。
ConfigureMode String ApplyAndAutoCorrect

配置模式。
CreateTime String 2021-03-22T03:13:32Z

创建时间。
Description String 收集Inventory数据

描述信息。
Parameters Map {"policy": {"ACS:Network": {"Collection": "Enabled"}, "ACS:Application": {"Collection": "Enabled"}}}

参数。
ScheduleExpression String 1 hour

定时表达式。
ScheduleType String rate

定时类型。
StateConfigurationId String sc-a538febe18fabcdef

创建生成的配置ID。
Tags Map {"Key": "oos", "Value": "inventory"}

标签。
Targets String { "ResourceType": "ALIYUN::ECS::Instance", "Filters": [ { "Type": "All", "RegionId": "cn-hangzhou", "Parameters": { "RegionId": "cn-hangzhou", "Status": "Running" } } ] }

目标资源。
TemplateId String t-1234asadf

模板ID。
TemplateName String ACS-ECS-InventoryDataCollection

模板名称。
TemplateVersion String v1

模板版本。

示例

请求示例

http(s)://[Endpoint]/?Action=CreateStateConfiguration
&ScheduleExpression=1 hour
&ScheduleType=rate
&Targets={     "ResourceType": "ALIYUN::ECS::Instance",     "Filters": [       {         "Type": "All",         "RegionId": "cn-hangzhou",         "Parameters": {           "RegionId": "cn-hangzhou",           "Status": "Running"         }       }     ]   }
&TemplateName=test_state_config
&<公共请求参数>

正常返回示例

XML格式 

<RequestId>1306108F-610C-40FD-AAD5-DA13E8B00BE9</RequestId>
<StateConfiguration>
    <ConfigureMode>ApplyAndAutoCorrect</ConfigureMode>
    <ScheduleExpression>1 hour</ScheduleExpression>
    <ScheduleType>rate</ScheduleType>
    <Parameters>{"policy": {"ACS:Network": {"Collection": "Enabled"}, "ACS:Application": {"Collection": "Enabled"}}}</Parameters>
    <Description>test sc</Description>
    <StateConfigurationId>sc-a538febe18fabcdef</StateConfigurationId>
    <CreateTime>2021-03-22T03:13:32Z</CreateTime>
    <TemplateVersion>v1</TemplateVersion>
    <TemplateName>ACS-ECS-InventoryDataCollection</TemplateName>
    <Targets>{     "ResourceType": "ALIYUN::ECS::Instance",     "Filters": [       {         "Type": "All",         "RegionId": "cn-hangzhou",         "Parameters": {           "RegionId": "cn-hangzhou",           "Status": "Running"         }       }     ]   }</Targets>
    <Tags>{"Key": "oos", "Value": "inventory"}</Tags>
    <TemplateId>t-1234asadf</TemplateId>
</StateConfiguration>

JSON格式 

{"RequestId":"1306108F-610C-40FD-AAD5-DA13E8B00BE9","StateConfiguration":{"ConfigureMode":"ApplyAndAutoCorrect","ScheduleExpression":"1 hour","ScheduleType":"rate","Parameters":"{\"policy\": {\"ACS:Network\": {\"Collection\": \"Enabled\"}, \"ACS:Application\": {\"Collection\": \"Enabled\"}}}","Description":"test sc","StateConfigurationId":"sc-a538febe18fabcdef","CreateTime":"2021-03-22T03:13:32Z","TemplateVersion":"v1","TemplateName":"ACS-ECS-InventoryDataCollection","Targets":"{     \"ResourceType\": \"ALIYUN::ECS::Instance\",     \"Filters\": [       {         \"Type\": \"All\",         \"RegionId\": \"cn-hangzhou\",         \"Parameters\": {           \"RegionId\": \"cn-hangzhou\",           \"Status\": \"Running\"         }       }     ]   }","Tags":"{\"Key\": \"oos\", \"Value\": \"inventory\"}","TemplateId":"t-1234asadf"}}

错误码

访问错误中心查看更多错误码。