調用PutConfigRule接口新建或修改規則。

調試

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

請求參數

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

要執行的操作，取值：PutConfigRule。

ConfigRuleId String 否 cr-2a914fcf617e00c9****

規則ID。
ConfigRuleName String 是 RDS實例CPU核數滿足最低要求

規則名稱。
Description String 否 RDS實例的CPU核數大于等于設置的閾值，視為“合規”。

規則的描述信息。
InputParameters String 否 {"cpuCount": "2"}

規則入參。
SourceOwner String 是 ALIYUN

規則來源的歸屬。取值：

  • CUSTOM_FC：用戶自定義函數。
  • ALIYUN：托管規則。
SourceIdentifier String 是 rds-cpu-min-count-limit

規則標識。

  • 如果規則使用了托管規則，則該參數為規則標識。
  • 如果規則使用了自定義函數，則該參數為函數ARN。
SourceDetailMessageType String 是 ConfigurationItemChangeNotification

規則的觸發機制。取值：

  • ConfigurationItemChangeNotification：配置變更。
  • ScheduledNotification：周期執行。
SourceMaximumExecutionFrequency String 否 Twelve_Hours

規則執行周期。取值：

  • One_Hour：1小時。
  • Three_Hours：3小時。
  • Six_Hours：6小時。
  • Twelve_Hours：12小時。
  • TwentyFour_Hours：24小時。
ScopeComplianceResourceId String 否 vpc-6weoy5flv41pj4wvr****

待評估資源ID。

  • 如果為空，則該規則評估ScopeComplianceResourceTypes指定的所有資源類型。
  • 如果不為空，則該規則評估指定的資源。
ScopeComplianceResourceTypes String 是 ["ACS::RDS::DBInstance"]

待評估的資源類型列表。
RiskLevel Integer 是 1

風險等級。取值：

  • 1：高風險。
  • 2：中風險。
  • 3：低風險。
ClientToken String 否 1594295238-f9361358-5843-4294-8d30-b5183fac****

保證請求冪等性。從您的客戶端生成一個參數值，確保不同請求間該參數值唯一。ClientToken只支持ASCII字符，且不能超過64個字符。
MultiAccount Boolean 否 false

該參數計劃于2021年06月30日00時00分00秒前下線，其替代功能賬號組的API將于2021年05月30日00時00分00秒前上線。如果您正在使用該參數，建議您在2021年05月30日00時00分00秒之后切換為賬號組的API。關于賬號組，請參見賬號組。

MemberId Long 否 123456789

該參數計劃于2021年06月30日00時00分00秒前下線，其替代功能賬號組的API將于2021年05月30日00時00分00秒前上線。如果您正在使用該參數，建議您在2021年05月30日00時00分00秒之后切換為賬號組的API。關于賬號組，請參見賬號組。

返回數據

名稱 類型 示例值 描述
ConfigRuleId String cr-76ac4fcfb57e00c9****

規則ID。
RequestId String A7A0FFF8-0B44-40C6-8BBF-3A185EFDF3F7

請求ID。

示例

請求示例

http(s)://[Endpoint]/?Action=PutConfigRule
&ConfigRuleName=RDS實例CPU核數滿足最低要求
&RiskLevel=1
&ScopeComplianceResourceTypes=["ACS::RDS::DBInstance"]
&SourceDetailMessageType=ConfigurationItemChangeNotification
&SourceIdentifier=rds-cpu-min-count-limit
&SourceOwner=ALIYUN
&<公共請求參數>

正常返回示例

XML格式 

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

<PutConfigRuleResponse>
	<ConfigRuleId>cr-76ac4fcfb57e00c9****</ConfigRuleId>
	<RequestId>A7A0FFF8-0B44-40C6-8BBF-3A185EFDF3F7</RequestId>
</PutConfigRuleResponse>

JSON格式 

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

{
  "ConfigRuleId" : "cr-76ac4fcfb57e00c9****",
  "RequestId" : "A7A0FFF8-0B44-40C6-8BBF-3A185EFDF3F7"
}

錯誤碼

HttpCode 錯誤碼 錯誤信息 描述
400 ExceedMaxRuleCount The maximum number of rules is exceeded. 超過規則上限。
400 ConfigRuleNotExists The ConfigRule does not exist. 此規則不存在。
400 ConfigRuleExists The ConfigRule already exists. 規則名稱重復。
404 AccountNotExisted Your account does not exist. 您的賬號不存在。
503 ServiceUnavailable The request has failed due to a temporary failure of the server. 服務不可用。

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