更新终态配置。

调试

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

请求参数

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

系统规定参数。取值:UpdateStateConfiguration

RegionId String cn-hangzhou

地域ID。

Description String ACS-ECS-InventoryDataCollection

描述内容。

Parameters Map { "policy": { "ACS:Application": { "Collection": "Enabled" }, "ACS:Network": { "Collection": "Enabled" } } }

参数。

ConfigureMode String ApplyOnce

配置模式。 ApplyOnce:配置只应用一次(更新配置后重新应用)。 ApplyAndMonitor: 配置只应用一次,成功应用后,后续只检查配置是否漂移。 ApplyAndAutoCorrect:总是应用配置。

ScheduleType String rate

调度类型。

ScheduleExpression String 1 hour

调度表达式。

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

目标资源。

ClientToken String DASKJJLKADS-AHKLJHJSAKL-AJK

幂等token。

StateConfigurationId String sc-asfgdhj12345

终态配置ID。

Tags Map {"Key": "oos", "Value": "sc"}

标签。

ResourceGroupId String rg-acfmxsn4m4******

资源组ID。

返回数据

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

请求ID。

StateConfiguration Array of StateConfiguration

配置清单。

UpdateTime String 2021-03-22T03:13:32Z

更新时间。

CreateTime String 2021-03-22T03:13:32Z

创建时间。

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

目标资源。

Tags Map

标签。

StateConfigurationId String StateConfigurationId

创建生成的配置ID。

ScheduleExpression String 1 hour

定时表达式。

TemplateName String ACS-ECS-InventoryDataCollection

模板名称。

TemplateVersion String v1

模板版本。

ConfigureMode String ApplyAndAutoCorrect

配置模式。

ScheduleType String rate

定时类型。

Parameters String {"policy": {"ACS:Network": {"Collection": "Enabled"}, "ACS:Application": {"Collection": "Enabled"}}}

参数。

Description String 收集Inventory数据

终态配置的描述信息。

ResourceGroupId String rg-acfmxsn4m4******

资源组ID。

TemplateId String t-1234asadf

模板ID。

示例

请求示例

http(s)://[Endpoint]/?Action=UpdateStateConfiguration
&RegionId=cn-hangzhou
&Description=ACS-ECS-InventoryDataCollection
&ConfigureMode=ApplyOnce
&ScheduleType=rate
&ScheduleExpression=1 hour
&Targets={ "ResourceType": "ALIYUN::ECS::Instance", "Filters": [ { "Type": "All", "RegionId": "cn-hangzhou", "Parameters": { "RegionId": "cn-hangzhou", "Status": "Running" } } ] }
&ClientToken=DASKJJLKADS-AHKLJHJSAKL-AJK
&StateConfigurationId=sc-asfgdhj12345
&ResourceGroupId=rg-acfmxsn4m4******
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<UpdateStateConfigurationResponse>
    <RequestId>1306108F-610C-40FD-AAD5-DA13E8B00BE9</RequestId>
    <StateConfiguration>
        <UpdateTime>2021-03-22T03:13:32Z</UpdateTime>
        <CreateTime>2021-03-22T03:13:32Z</CreateTime>
        <Targets>{ "ResourceType": "ALIYUN::ECS::Instance", "Filters": [ { "Type": "All", "RegionId": "cn-hangzhou", "Parameters": { "RegionId": "cn-hangzhou", "Status": "Running" } } ] }</Targets>
        <StateConfigurationId>StateConfigurationId</StateConfigurationId>
        <ScheduleExpression>1 hour</ScheduleExpression>
        <TemplateName>ACS-ECS-InventoryDataCollection</TemplateName>
        <TemplateVersion>v1</TemplateVersion>
        <ConfigureMode>ApplyAndAutoCorrect</ConfigureMode>
        <ScheduleType>rate</ScheduleType>
        <Parameters>{"policy": {"ACS:Network": {"Collection": "Enabled"}, "ACS:Application": {"Collection": "Enabled"}}}</Parameters>
        <Description>收集Inventory数据</Description>
        <ResourceGroupId>rg-acfmxsn4m4******</ResourceGroupId>
        <TemplateId>t-1234asadf</TemplateId>
    </StateConfiguration>
</UpdateStateConfigurationResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "1306108F-610C-40FD-AAD5-DA13E8B00BE9",
  "StateConfiguration" : [ {
    "UpdateTime" : "2021-03-22T03:13:32Z",
    "CreateTime" : "2021-03-22T03:13:32Z",
    "Targets" : "{ \"ResourceType\": \"ALIYUN::ECS::Instance\", \"Filters\": [ { \"Type\": \"All\", \"RegionId\": \"cn-hangzhou\", \"Parameters\": { \"RegionId\": \"cn-hangzhou\", \"Status\": \"Running\" } } ] }",
    "StateConfigurationId" : "StateConfigurationId",
    "ScheduleExpression" : "1 hour",
    "TemplateName" : "ACS-ECS-InventoryDataCollection",
    "TemplateVersion" : "v1",
    "ConfigureMode" : "ApplyAndAutoCorrect",
    "ScheduleType" : "rate",
    "Parameters" : "{\"policy\": {\"ACS:Network\": {\"Collection\": \"Enabled\"}, \"ACS:Application\": {\"Collection\": \"Enabled\"}}}",
    "Description" : "收集Inventory数据",
    "ResourceGroupId" : "rg-acfmxsn4m4******",
    "TemplateId" : "t-1234asadf"
  } ]
}

错误码

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