调用EvaluatePreConfigRules执行预检规则评估_配置审计(CloudConfig)-阿里云帮助中心

执行预检规则对资源进行合规预检。

接口说明

关于预检规则的概念、运行原理和集成过程，请参见预检规则的定义与运行原理。

预检规则和规则模板是同源规则，当您创建资源后，预检规则可以持续检测资源的合规性。

调试

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

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称	类型	必填	描述	示例值
ResourceEvaluateItems	object []	是	预检规则评估项列表。
ResourceLogicalId	string	否	资源逻辑 ID。说明如果该参数为空，则按照`ResourceProperties`的 Base64 位生成。	ResourceLogicId-test
ResourceType	string	否	资源类型。关于如何获取预检规则的标识，请参见 ListPreManagedRules 。说明参数`ResourceType`、`Identifier`和`ResourceProperties`必须同时设置。	ACS::ECS::Instance
Rules	object []	否	预检规则列表。
Identifier	string	否	规则标识。关于如何获取规则标识，请参见 ListPreManagedRules 。说明参数`ResourceType`、`Identifier`和`ResourceProperties`必须同时设置。	ecs-instance-deletion-protection-enabled
InputParameters	string	否	规则参数。	{}
ResourceProperties	string	否	资源配置项（即将创建的资源属性），例如：资源的规格、所属地域、名称、状态、端口或网口开关状态等。说明参数`ResourceType`、`Identifier`和`ResourceProperties`必须同时设置。	{"ResourceGroupId":"","Memory":8192,"InstanceChargeType":"PostPaid","Cpu":2}
EnableManagedRules	boolean	否	是否启用规则模板。取值： true：启用规则模板。 false（默认值）：不启用规则模板。	false

关于公共请求参数的详情，请参见公共参数。

返回参数

名称	类型	描述	示例值
	object	无。
RequestId	string	请求 ID。	129ECF1C-7897-1131-BD0F-4B588AC05400
ResourceEvaluations	object []	资源评估结果列表。
ResourceLogicalId	string	资源逻辑 ID。说明如果请求参数为空，则自动根据`ResourceProperties`的 Base64 位生成。	ResourceLogicId-test
ResourceType	string	资源类型。	ACS::ECS::Instance
Rules	object []	预检规则列表。
Identifier	string	规则标识。	ecs-instance-deletion-protection-enabled
ComplianceType	string	预检规则的合规类型。取值： COMPLIANT：合规。 NON_COMPLIANT：不合规。 NOT_APPLICABLE：不适用。	NON_COMPLIANT
Annotation	string	不合规原因。	{\"configuration\":\"false\",\"desiredValue\":\"True\",\"operator\":\"StringEquals\",\"property\":\"$.DeletionProtection\"}
HelpUrl	string	托管规则修正指导的文档链接。	https://example.aliyundoc.com

关于公共请求参数的详情，请参见公共参数。

示例

正常返回示例

JSON格式

{
  "RequestId": "129ECF1C-7897-1131-BD0F-4B588AC05400",
  "ResourceEvaluations": [
    {
      "ResourceLogicalId": "ResourceLogicId-test",
      "ResourceType": "ACS::ECS::Instance",
      "Rules": [
        {
          "Identifier": "ecs-instance-deletion-protection-enabled",
          "ComplianceType": "NON_COMPLIANT",
          "Annotation": "{\\\"configuration\\\":\\\"false\\\",\\\"desiredValue\\\":\\\"True\\\",\\\"operator\\\":\\\"StringEquals\\\",\\\"property\\\":\\\"$.DeletionProtection\\\"}",
          "HelpUrl": "https://example.aliyundoc.com"
        }
      ]
    }
  ]
}

错误码

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

变更历史

变更时间

变更内容概要

操作

2023-06-13

API 内部配置变更，不影响调用

看变更集

变更项	变更内容
	API 内部配置变更，不影响调用。