全部產品
Search

搜尋本產品

    Cloud Config：UpdateConfigRule - 修改規則

    文件中心

    Cloud Config：UpdateConfigRule - 修改規則

    更新時間：Feb 24, 2026

    修改規則的描述資訊、規則入參和風險等級等。

    介面說明

    本文將提供一個樣本，將規則cr-a260626622af0005****的風險等級修改為3（低風險）。

    調試

    您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

    調試

    授權資訊

    下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

    • 操作：是指具體的許可權點。

    • 存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。

    • 資源類型：是指操作中支援授權的資源類型。具體說明如下：

      • 對於必選的資源類型，用前面加 * 表示。

      • 對於不支援資源級授權的操作，用全部資源表示。

    • 條件關鍵字：是指雲產品自身定義的條件關鍵字。

    • 關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    config:UpdateConfigRule

    update

    *Rule

    acs:config:*:{#accountId}:rule/{#ConfigRuleId}

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    ConfigRuleId

    string

    是

    規則 ID。

    關於如何擷取規則 ID，請參見 ListConfigRules 。

    cr-a260626622af0005****
    Description

    string

    否

    規則描述。最多輸入 500 個字元。

    最多可以定義6組標籤。如果資源同時具有指定的所有標籤，則視為“合規”。
    InputParameters

    object

    否

    規則參數。

    {"tag1Key":"ECS","tag1Value":"test"}
    MaximumExecutionFrequency

    string

    否

    規則執行循環。取值：

    • One_Hour：1 小時。

    • Three_Hours：3 小時。

    • Six_Hours：6 小時。

    • Twelve_Hours：12 小時。

    • TwentyFour_Hours（預設值）：24 小時。

    說明

    當ConfigRuleTriggerTypes設定為ScheduledNotification時，需要設定該參數。

    One_Hour
    ResourceTypesScope

    array

    否

    規則評估的資源類型。多個資源類型之間用半形逗號（,）分隔。

    ACS::ECS::Instance

    string

    否

    規則評估的資源類型。多個資源類型之間用半形逗號（,）分隔。

    ACS::ECS::Instance
    RiskLevel

    integer

    否

    規則風險等級。取值：

    • 1：高風險。

    • 2：中風險。

    • 3：低風險。

    3
    ClientToken

    string

    否

    保證請求等冪性。從您的用戶端產生一個參數值，確保不同請求間該參數值唯一。ClientToken只支援 ASCII 字元，且不能超過 64 個字元。

    1594295238-f9361358-5843-4294-8d30-b5183fac****
    RegionIdsScope

    string

    否

    規則僅對指定地區 ID 中的資源生效。多個地區 ID 之間用半形逗號（,）分隔。

    說明

    僅適用於規則模板。

    cn-hangzhou
    ExcludeRegionIdsScope

    string

    否

    規則對指定地區內資源無效，即不對該地區內資源執行評估。多個地區 ID 之間用半形逗號（,）分隔。

    cn-shanghai
    ExcludeResourceIdsScope

    string

    否

    規則對指定資源 ID 無效，即不對該資源執行評估。多個資源 ID 之間用半形逗號（,）分隔。

    說明

    僅適用於規則模板。

    lb-t4nbowvtbkss7t326****
    ResourceIdsScope

    string

    否

    規則對指定資源 ID 生效。多個資源 ID 之間用半形逗號（,）分隔。

    lb-5cmbowstbkss9ta03****
    ConfigRuleTriggerTypes

    string

    否

    規則引發機制。取值：

    • ConfigurationItemChangeNotification：配置變更。

    • ScheduledNotification：周期執行。

    說明

    僅自訂規則能修改該參數。

    ConfigurationItemChangeNotification
    ResourceGroupIdsScope

    string

    否

    規則僅對指定資源群組 ID 中的資源生效。多個資源群組 ID 之間用半形逗號（,）分隔。

    說明

    僅適用於規則模板。

    rg-aekzc7r7rhx****
    ExcludeResourceGroupIdsScope

    string

    否

    規則對指定資源群組 ID 中的資源無效，即不對該資源群組內的資源評估。多個資源群組 ID 之間用半形逗號（,）分隔。

    rg-bnczc6r7rml****
    TagKeyScope deprecated

    string

    否

    已廢棄，請使用 TagsScope 欄位。

    規則僅對綁定指定標籤的資源生效。

    說明

    僅適用於規則模板，且TagKeyScope和TagValueScope必須同時設定。

    ECS
    TagValueScope deprecated

    string

    否

    已廢棄，請使用 TagsScope 欄位。

    規則僅對綁定指定標籤的資源生效。

    說明

    僅適用於規則模板，且TagKeyScope和TagValueScope必須同時設定。

    test
    TagKeyLogicScope

    string

    否

    參數TagsScope 取多值時的邏輯關係，例如：當參數TagsScope取值為"TagsScope.1.TagKey":"a","TagsScope.1.TagValue":"a","TagsScope.2.TagKey":"b","TagsScope.2.TagValue":"b"時，如果該參數為AND，則表示規則僅對同時綁定標籤a:a和b:b的資源生效。不填寫取預設邏輯OR。

    也可以用於已廢棄欄位TagKeyScope欄位（不推薦），例如：當參數TagKeyScope取值為ECS,OSS時，如果該參數為AND，則表示規則僅對同時綁定標籤ECS和OSS的資源生效。

    取值：

    • AND：與。

    • OR：或。

    枚舉值：

    • OR :

      OR

    • AND :

      AND

    AND
    TagsScope

    array<object>

    否

    標籤範圍

    object

    否

    TagKey

    string

    否

    標籤鍵。

    key-1
    TagValue

    string

    否

    標籤值。

    value-1
    ExcludeTagsScope

    array<object>

    否

    排除的標籤範圍

    object

    否

    TagKey

    string

    否

    標籤鍵。

    key-2
    TagValue

    string

    否

    標籤值。

    value-2
    ConfigRuleName

    string

    否

    規則名稱。

    關於如何擷取規則名稱，請參見 ListAggregateConfigRules 。

    存在所有指定標籤
    Conditions

    string

    否

    自訂條件規則的條件，JSON 格式

    {"ComplianceConditions":"{\"operator\":\"and\",\"children\":[{\"operator\":\"StringEquals\",\"featurePath\":\"$.Status\",\"desired\":\"1\",\"featureSource\":\"CONFIGURATION\"}]}"}
    ExtendContent

    string

    否

    選填，擴充內容，與 24h 周期觸發配合使用，用於設定觸發時間。

    {"fixedHour":"12"}
    Tag deprecated

    array<object>

    否

    資源的標籤。該入參已棄用，請忽略，傳入不會生效。

    最多支援綁定 20 個標籤。

    object

    否

    資源的標籤。

    最多支援綁定 20 個標籤。

    Key

    string

    否

    標籤鍵。

    key-1
    Value

    string

    否

    標籤值

    value-1
    ResourceNameScope

    string

    否

    規則僅對指定資源名稱的資源生效。

    i-xxx

    關於公用請求參數的詳情，請參見公用參數。

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    無

    ConfigRuleId

    string

    規則 ID。

    cr-a260626622af0005****
    RequestId

    string

    請求 ID。

    6EC7AED1-172F-42AE-9C12-295BC2ADB751

    樣本

    正常返回樣本

    JSON格式

    {
  "ConfigRuleId": "cr-a260626622af0005****",
  "RequestId": "6EC7AED1-172F-42AE-9C12-295BC2ADB751"
}

    錯誤碼

    HTTP status code

    錯誤碼

    錯誤資訊

    描述
    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. 服務不可用。

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

    變更歷史

    更多資訊，參考變更詳情。