创建终态配置。

调试

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

请求参数

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

系统规定参数。取值:CreateStateConfiguration

RegionId String cn-hangzhou

地域ID。

Description String 收集Inventory数据

终态配置的描述信息。

TemplateName String ACS-ECS-InventoryDataCollection

模板名称。内容限制为字母、数字、中划线、下划线,长度200字符。

TemplateVersion String v1

版本号,如不填默认为最新的版本号。

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

参数。

ConfigureMode String ApplyOnce

配置模式。

ApplyOnce:配置只应用一次(更新配置后重新应用)。

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

ApplyAndAutoCorrect:总是应用配置。

ScheduleType String rate

调度类型。可选值:rate。

ScheduleExpression String 1 hour 或 30 minutes

调度表达式。调度间隔不得小于30分钟。

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

目标资源。

ClientToken String DASKJJLKADS-AHKLJHJSAKL-AJK

幂等token。

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

标签。

ResourceGroupId String rg-acfmxsn4m4******

资源组ID。

返回数据

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

请求ID。

StateConfiguration Object

终态配置。

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 sc-a538febe18fabcdef

创建生成的配置ID。

ScheduleExpression String 1 hour

定时表达式。

TemplateName String ACS-ECS-InventoryDataCollection

模板名称。

TemplateVersion String v1

模板版本。

ConfigureMode String ApplyAndAutoCorrect

配置模式。

ScheduleType String rate

定时类型。

Parameters Map

参数。

Description String 收集Inventory数据

描述信息。

ResourceGroupId String rg-acfmxsn4m4******

资源组ID。

TemplateId String t-1234asadf

模板ID。

示例

请求示例

http(s)://[Endpoint]/?Action=CreateStateConfiguration
&RegionId=cn-hangzhou
&Description=收集Inventory数据
&TemplateName=ACS-ECS-InventoryDataCollection
&TemplateVersion=v1
&Parameters={     "policy": {       "ACS:Application": {         "Collection": "Enabled"       },       "ACS:Network": {         "Collection": "Enabled"       }     }   }
&ConfigureMode=ApplyOnce
&ScheduleType=rate
&ScheduleExpression=1 hour 或 30 minutes
&Targets={     "ResourceType": "ALIYUN::ECS::Instance",     "Filters": [       {         "Type": "All",         "RegionId": "cn-hangzhou",         "Parameters": {           "RegionId": "cn-hangzhou",           "Status": "Running"         }       }     ]   }
&ClientToken=DASKJJLKADS-AHKLJHJSAKL-AJK
&ResourceGroupId=rg-acfmxsn4m4******
&公共请求参数

正常返回示例

XML格式

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

<CreateStateConfigurationResponse>
    <RequestId>1306108F-610C-40FD-AAD5-DA13E8B00BE9</RequestId>
    <StateConfiguration>
        <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>sc-a538febe18fabcdef</StateConfigurationId>
        <ScheduleExpression>1 hour</ScheduleExpression>
        <TemplateName>ACS-ECS-InventoryDataCollection</TemplateName>
        <TemplateVersion>v1</TemplateVersion>
        <ConfigureMode>ApplyAndAutoCorrect</ConfigureMode>
        <ScheduleType>rate</ScheduleType>
        <Description>收集Inventory数据</Description>
        <ResourceGroupId>rg-acfmxsn4m4******</ResourceGroupId>
        <Tags>
            <oos>inventory</oos>
        </Tags>
        <TemplateId>t-1234asadf</TemplateId>
    </StateConfiguration>
</CreateStateConfigurationResponse>

JSON格式

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

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

错误码

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