調(diào)用StartConfigRuleEvaluation接口使指定規(guī)則或合規(guī)包（合規(guī)包中的規(guī)則）執(zhí)行一次評估。

說明 本接口僅用于觸發(fā)規(guī)則執(zhí)行一次評估。如果您需要查看規(guī)則的本次評估結(jié)果，請調(diào)用ListConfigRuleEvaluationResults接口。更多信息，請參見ListConfigRuleEvaluationResults。

本文將提供一個示例，使規(guī)則cr-bdb6626622af0012****執(zhí)行一次評估。

調(diào)試

您可以在OpenAPI Explorer中直接運(yùn)行該接口，免去您計算簽名的困擾。運(yùn)行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。

請求參數(shù)

名稱 類型 是否必選 示例值 描述
Action String 是 StartConfigRuleEvaluation

要執(zhí)行的操作，取值：StartConfigRuleEvaluation。

ConfigRuleId String 否 cr-bdb6626622af0012****

規(guī)則ID。

關(guān)于如何獲取規(guī)則ID，請參見ListConfigRules。

RevertEvaluation Boolean 否 false

是否恢復(fù)已忽略的評估結(jié)果。取值：

  • true：恢復(fù)已忽略的評估結(jié)果。
  • false：不恢復(fù)已忽略的評估結(jié)果。
CompliancePackId String 否 cp-ac16626622af0053****

合規(guī)包ID。

關(guān)于如何獲取合規(guī)包ID，請參見ListCompliancePacks。

說明 參數(shù)CompliancePackId和ConfigRuleId必須二選一。

關(guān)于公共請求參數(shù)的詳情，請參見公共參數(shù)。

返回數(shù)據(jù)

名稱 類型 示例值 描述
RequestId String C32EEAD7-BF64-5927-977A-AFF9342B7275

請求ID。
Result Boolean true

規(guī)則執(zhí)行結(jié)果。取值：

  • true：成功。
  • false：失敗。

示例

請求示例

http(s)://[Endpoint]/?Action=StartConfigRuleEvaluation
&ConfigRuleId=cr-bdb6626622af0012****
&RevertEvaluation=false
&<公共請求參數(shù)>

正常返回示例

XML格式 

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

<StartConfigRuleEvaluationResponse>
    <RequestId>C32EEAD7-BF64-5927-977A-AFF9342B7275</RequestId>
    <Result>true</Result>
</StartConfigRuleEvaluationResponse>

JSON格式 

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

{
  "RequestId" : "C32EEAD7-BF64-5927-977A-AFF9342B7275",
  "Result" : true
}

錯誤碼

HttpCode 錯誤碼 錯誤信息 描述
400 ConfigRuleNotExists The ConfigRule does not exist. 此規(guī)則不存在。
400 NoPermission You are not authorized to perform this operation. 您無權(quán)執(zhí)行此操作。
404 AccountNotExisted Your account does not exist. 您的賬號不存在。
503 ServiceUnavailable The request has failed due to a temporary failure of the server. 服務(wù)不可用。

訪問錯誤中心查看更多錯誤碼。