调用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不合法 |
访问错误中心查看更多错误码。