调用ModifyDegradeRule接口修改降级规则。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String ModifyDegradeRule

系统规定参数。取值:ModifyDegradeRule。

RuleId Long 123

降级规则ID。

Strategy Integer 0

阈值类型,即降级的策略,取值为0时表示按慢调用比例降级,取值为1时表示按异常比例降级。

Threshold Float 0.5

阈值类型所对应的降级阈值,超过该值时会触发接口的降级。

RecoveryTimeoutMs Integer 2000

熔断时长。在该时间段内,该接口的请求都会快速失败。

StatDurationMs Integer 2000

统计窗口时长,单位MS。默认值为1000。

SlowRtMs Integer 3000

慢调用RT。请求的响应时间超过该值时统计为慢调用。阈值类型为“慢调用比例”时需设置该字段。

MinRequestAmount Integer 10

触发熔断的最小请求数目,若当前统计窗口请求数小于此值,即使达到熔断条件规则也不会触发。默认值为5。

HalfOpenBaseAmountPerStep Integer 3

熔断恢复每步最小通过数目,默认值为5。

HalfOpenRecoveryStepNum Integer 2

熔断恢复阶段数,默认值为1。

返回数据

名称 类型 示例值 描述
Code String 200

返回码

Data Struct

返回数据

AppName String ahas-demo

应用名,若为EDAS应用,则AppName为EDAS中的App ID,可在EDAS控制台“应用管理>基本信息”中查看对应的ID。

Enable Boolean true

是否开启

HalfOpenBaseAmountPerStep Integer 3

熔断恢复每步最小通过数目,默认值为5。

HalfOpenRecoveryStepNum Integer 2

熔断恢复阶段数

MinRequestAmount Integer 10

触发熔断的最小请求数

Namespace String default

命名空间

RecoveryTimeoutMs Integer 2000

熔断时长

Resource String handleService

资源名

RuleId Long 123

规则ID

SlowRtMs Integer 5000

慢调用RT

StatDurationMs Integer 2000

统计窗口时长

Strategy Integer 0

阈值类型

Threshold Float 0.5

阈值

Message String null

错误信息

RequestId String 3FEEAD12-CE22-4EDE-A729-CE94EC070610

请求ID

Success Boolean true

是否成功

示例

请求示例

http(s)://[Endpoint]/?Action=ModifyDegradeRule
&RuleId=123
&<公共请求参数>

正常返回示例

XML 格式

<ModifyDegradeRuleResponse>
  <Message>null</Message>
  <RequestId>3FEEAD12-CE22-4EDE-A729-CE94EC070610</RequestId>
  <Data>
        <MinRequestAmount>10</MinRequestAmount>
        <RuleId>123</RuleId>
        <Resource>handleService</Resource>
        <SlowRtMs>5000</SlowRtMs>
        <Namespace>default</Namespace>
        <AppName>ahas-demo</AppName>
        <HalfOpenRecoveryStepNum>2</HalfOpenRecoveryStepNum>
        <RecoveryTimeoutMs>2000</RecoveryTimeoutMs>
        <Enable>true</Enable>
        <Strategy>0</Strategy>
        <HalfOpenBaseAmountPerStep>3</HalfOpenBaseAmountPerStep>
        <Threshold>0.5</Threshold>
        <StatDurationMs>2000</StatDurationMs>
  </Data>
  <Code>200</Code>
  <Success>true</Success>
</ModifyDegradeRuleResponse>

JSON 格式

{
    "Message":"null",
    "RequestId":"3FEEAD12-CE22-4EDE-A729-CE94EC070610",
    "Data":
    {
        "MinRequestAmount":"10",
        "RuleId":"123",
        "Resource":"handleService",
        "SlowRtMs":"5000",
        "Namespace":"default",
        "AppName":"ahas-demo",
        "HalfOpenRecoveryStepNum":"2",
        "RecoveryTimeoutMs":"2000",
        "Enable":"true",
        "Strategy":"0",
        "HalfOpenBaseAmountPerStep":"3",
        "Threshold":"0.5",
        "StatDurationMs":"2000"
    },
    "Code":"200",
    "Success":"true"
}

错误码

HttpCode 错误码 错误信息 描述
400 IllegalArgument.HalfOpenBaseAmountPerStep The specified HalfOpenBaseAmountPerStep is invalid. 参数HalfOpenBaseAmountPerStep不合法
400 IllegalArgument.HalfOpenRecoveryStepNum The specified HalfOpenRecoveryStepNum is invalid. 参数HalfOpenRecoveryStepNum不合法
400 IllegalArgument.MinRequestAmount The specified MinRequestAmount is invalid. 参数MinRequestAmount不合法
400 IllegalArgument.RecoveryTimeoutMs The specified RecoveryTimeoutMs is invalid. 参数RecoveryTimeoutMs不合法
400 IllegalArgument.RuleId The specified RuleId is invalid. 参数RuleId不合法
400 IllegalArgument.SlowRtMS The specified SlowRtMs is invalid. 参数SlowRtMs不合法
400 IllegalArgument.Strategy The specified Strategy is invalid. 参数Strategy不合法
400 IllegalArgument.Threshold The specified Threshold is invalid. 参数Threshold不合法

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