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

调试

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

请求参数

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

系统规定参数。取值:ModifyDegradeRule

Strategy Integer 0

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

Threshold Float 0.5

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

RuleId Long 123

降级规则ID。

RecoveryTimeoutMs Integer 2000

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

StatDurationMs Integer 2000

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

SlowRtMs Integer 3000

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

MinRequestAmount Integer 10

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

HalfOpenBaseAmountPerStep Integer 3

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

HalfOpenRecoveryStepNum Integer 2

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

AhasRegionId String cn-hangzhou

地域

返回数据

名称 类型 示例值 描述
Message String null

错误信息

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

请求ID

Data Object

返回数据

SlowRtMs Integer 5000

慢调用RT

HalfOpenRecoveryStepNum Integer 2

熔断恢复阶段数

Namespace String default

命名空间

StatDurationMs Integer 2000

统计窗口时长

RuleId Long 123

规则ID

Strategy Integer 0

阈值类型

Resource String handleService

资源名

AppName String ahas-demo

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

HalfOpenBaseAmountPerStep Integer 3

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

RecoveryTimeoutMs Integer 2000

熔断时长

MinRequestAmount Integer 10

触发熔断的最小请求数

Threshold Float 0.5

阈值

Enable Boolean true

是否开启

Code String 200

返回码

Success Boolean true

是否成功

示例

请求示例

http(s)://[Endpoint]/?Action=ModifyDegradeRule
&Strategy=0
&Threshold=0.5
&RuleId=123
&RecoveryTimeoutMs=2000
&StatDurationMs=2000
&SlowRtMs=3000
&MinRequestAmount=10
&HalfOpenBaseAmountPerStep=3
&HalfOpenRecoveryStepNum=2
&AhasRegionId=cn-hangzhou
&公共请求参数

正常返回示例

XML格式

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

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

JSON格式

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

{
  "Message" : "null",
  "RequestId" : "3FEEAD12-CE22-4EDE-A729-CE94EC070610",
  "Data" : {
    "SlowRtMs" : 5000,
    "HalfOpenRecoveryStepNum" : 2,
    "Namespace" : "default",
    "StatDurationMs" : 2000,
    "RuleId" : 123,
    "Strategy" : 0,
    "Resource" : "handleService",
    "AppName" : "ahas-demo",
    "HalfOpenBaseAmountPerStep" : 3,
    "RecoveryTimeoutMs" : 2000,
    "MinRequestAmount" : 10,
    "Threshold" : 0.5,
    "Enable" : true
  },
  "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不合法

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