全部產品
Search

搜尋本產品

    Microservices Engine：UpdateCircuitBreakerRule - 更新熔斷規則

    文件中心

    Microservices Engine：UpdateCircuitBreakerRule - 更新熔斷規則

    更新時間：Dec 16, 2025

    更新熔斷規則。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    mse:UpdateCircuitBreakerRule

    update

    *全部資源

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    Namespace

    string

    是

    應用所屬的微服務命空間。

    default
    AppName

    string

    是

    應用程式名稱。

    spring-cloud-a
    Threshold

    number

    否

    熔斷比例閾值：觸發熔斷的比例閾值，取值範圍為 0 - 1，代表 0% - 100%。

    0.8
    Enable

    boolean

    否

    規則的啟用狀態。

    枚舉值：

    • true :

      開啟

    • false :

      關閉

    true
    AppId

    string

    否

    應用 ID。

    hkhon1po62@c3df23522bXXXXX
    Strategy

    integer

    否

    閾實值型別：選擇以慢調用比例或異常比例作為閾值。

    枚舉值：

    • 0 :

      慢調用比例

    • 1 :

      異常比例

    0
    RetryTimeoutMs

    integer

    否

    熔斷時間長度（單位毫秒）：即熔斷觸發後持續的時間。資源進入熔斷狀態後，在配置的熔斷時間長度內，請求都會快速失敗。取值需要為 1000 的整數倍，預設值為 10000，即 10 秒。

    10000
    StatIntervalMs

    integer

    否

    統計視窗時間長度（單位毫秒）：統計的時間視窗長度，取值範圍為 1 秒~120 分鐘。預設值為 20000，即 20 秒。

    20000
    MaxAllowedRtMs

    integer

    否

    慢調用 RT（單位毫秒）：超過該時間長度則判定為慢請求，閾實值型別為慢調用比例時必填。

    200
    MinRequestAmount

    integer

    否

    觸發熔斷的最小請求數目，若當前統計視窗請求數小於此值，即使達到熔斷條件規則也不會觸發。預設值為 10。

    10
    HalfOpenBaseAmountPerStep

    integer

    否

    熔斷恢複每步最小通過數目，預設值為 1。

    5
    HalfOpenRecoveryStepNum

    integer

    否

    熔斷恢複階段數，預設值為 1。

    1
    RuleId

    integer

    是

    規則 ID。

    1
    AcceptLanguage

    string

    否

    返回結果顯示的語言。取值：zh-CN（預設值）：中文，en-US：英文

    zh

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    Message

    string

    響應資訊。

    OK
    RequestId

    string

    請求 ID。

    EE5C32A1-BC0E-4B79-817C-103E4EDF****
    Code

    string

    響應碼。

    200
    Data

    object

    規則資訊。

    Namespace

    string

    應用所屬的微服務命名空間。

    default
    Id

    integer

    規則 ID。

    1
    AppName

    string

    應用程式名稱。

    spring-cloud-a
    Resource

    string

    介面名稱：適用該規則的應用資源。需要與控制台介面詳情處介面名稱一致。

    /a
    Strategy

    integer

    閾實值型別：選擇以慢調用比例或異常比例作為閾值。

    枚舉值：

    • 0 :

      慢調用比例

    • 1 :

      異常比例

    0
    Threshold

    number

    熔斷比例閾值：觸發熔斷的比例閾值，取值範圍為 0 - 1，代表 0% - 100%。

    0.8
    Enable

    boolean

    規則的啟用狀態。

    true
    RetryTimeoutMs

    integer

    熔斷時間長度（單位毫秒）：即熔斷觸發後持續的時間。資源進入熔斷狀態後，在配置的熔斷時間長度內，請求都會快速失敗。

    10000
    StatIntervalMs

    integer

    統計視窗時間長度（單位毫秒）：統計的時間視窗長度，取值範圍為 1 秒~120 分鐘。

    20000
    AppId

    string

    應用 ID。

    hkhon1po62@c3df23522bXXXXX
    MaxAllowedRtMs

    integer

    慢調用 RT（單位毫秒）：閾實值型別為慢調用比例時，超過該時間長度則判定為慢請求。

    200
    MinRequestAmount

    integer

    觸發熔斷的最小請求數目，若當前統計視窗請求數小於此值，即使達到熔斷條件規則也不會觸發。

    10
    HalfOpenBaseAmountPerStep

    integer

    熔斷恢複每步最小通過數目。

    5
    HalfOpenRecoveryStepNum

    integer

    熔斷恢複階段數。

    1
    Success

    boolean

    請求結果。

    枚舉值：

    • true :

      請求成功

    • false :

      請求失敗

    true

    樣本

    正常返回樣本

    JSON格式

    {
  "Message": "OK",
  "RequestId": "EE5C32A1-BC0E-4B79-817C-103E4EDF****",
  "Code": "200",
  "Data": {
    "Namespace": "default",
    "Id": 1,
    "AppName": "spring-cloud-a",
    "Resource": "/a",
    "Strategy": 0,
    "Threshold": 0.8,
    "Enable": true,
    "RetryTimeoutMs": 10000,
    "StatIntervalMs": 20000,
    "AppId": "hkhon1po62@c3df23522bXXXXX",
    "MaxAllowedRtMs": 200,
    "MinRequestAmount": 10,
    "HalfOpenBaseAmountPerStep": 5,
    "HalfOpenRecoveryStepNum": 1
  },
  "Success": true
}

    錯誤碼

    HTTP status code

    錯誤碼

    錯誤資訊

    描述
    400 IllegalRequest Invalid request:%s 非法請求： %s
    400 InvalidParameter Parameter error:%s 請求參數錯誤：%s
    500 InternalError Console error. Try again later:%s 控制台錯誤.稍後重試：%s
    403 NoPermission You are not authorized to perform this operation:%s 沒有許可權使用此介面：%s
    404 NotFound Not found:%s 資源不存在：%s

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

    變更歷史

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