调用CreateDegradeRule接口创建降级规则。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | CreateDegradeRule |
系统规定参数。取值:CreateDegradeRule。 |
AppName | String | 是 | ahas-demo |
应用名(避免中文命名),若为EDAS应用,则AppName为EDAS中的App ID,可在EDAS控制台“应用管理>基本信息”中查看对应的ID。 |
Namespace | String | 是 | default |
AHAS命名空间,默认为default,可以在控制台上创建不同namespace用于逻辑隔离。 |
RecoveryTimeoutMs | Integer | 是 | 5000 |
熔断时长。在该时间段内,该接口的请求都会快速失败。 |
Resource | String | 是 | handleService |
资源名。 |
Strategy | Integer | 是 | 0 |
阈值类型,即降级的策略,取值为0时表示按慢调用比例降级,取值为1时表示按异常比例降级。 |
Threshold | Float | 是 | 0.6 |
阈值类型所对应的降级阈值,超过该值时会触发接口的降级。 |
Enable | Boolean | 否 | true |
规则是否开启。默认为false。 |
StatDurationMs | Integer | 否 | 2000 |
统计窗口时长,单位MS。默认值为1000。 |
SlowRtMs | Integer | 否 | 2000 |
慢调用RT。请求的响应时间超过该值时统计为慢调用。阈值类型为“慢调用比例”时需设置该字段。 |
MinRequestAmount | Integer | 否 | 10 |
触发熔断的最小请求数目,若当前统计窗口请求数小于此值,即使达到熔断条件规则也不会触发。默认值为5。 |
HalfOpenBaseAmountPerStep | Integer | 否 | 5 |
熔断恢复每步最小通过数目,默认值为5。 |
HalfOpenRecoveryStepNum | Integer | 否 | 1 |
熔断恢复阶段数,默认值为1。 |
详细参数说明参照文档降级规则
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
Code | String | 200 |
错误码。 |
Data | Struct |
规则数据。 |
|
AppName | String | ahas-demo |
应用名,若为EDAS应用,则AppName为EDAS中的App ID,可在EDAS控制台“应用管理>基本信息”中查看对应的ID。 |
Enable | Boolean | true |
规则是否开启。 |
HalfOpenBaseAmountPerStep | Integer | 5 |
熔断恢复每步最小通过数目,默认值为5。 |
HalfOpenRecoveryStepNum | Integer | 1 |
熔断恢复阶段数。 |
MinRequestAmount | Integer | 10 |
触发熔断的最小请求数。 |
Namespace | String | default |
命名空间。 |
RecoveryTimeoutMs | Integer | 5000 |
熔断时长。 |
Resource | String | handleService |
资源名。 |
RuleId | Long | 1 |
规则ID。 |
SlowRtMs | Integer | 2000 |
慢调用RT。 |
StatDurationMs | Integer | 2000 |
统计窗口时长。 |
Strategy | Integer | 0 |
阈值类型。 |
Threshold | Float | 0.6 |
降级阈值。 |
Message | String | null |
错误信息。 |
RequestId | String | 3FEEAD12-CE22-4EDE-A729-CE94EC070610 |
请求Request ID。 |
Success | Boolean | true |
是否成功。 |
示例
请求示例
http(s)://[Endpoint]/?Action=CreateDegradeRule
&AppName=ahas-demo
&Namespace=default
&RecoveryTimeoutMs=5000
&Resource=handleService
&Strategy=0
&Threshold=0.6
&<公共请求参数>
正常返回示例
XML
格式
<CreateDegradeRuleResponse>
<Message>参数AppName不合法</Message>
<RequestId>3FEEAD12-CE22-4EDE-A729-CE94EC070610</RequestId>
<Data>
<MinRequestAmount>10</MinRequestAmount>
<RuleId>1</RuleId>
<Resource>handleService</Resource>
<SlowRtMs>2000</SlowRtMs>
<Namespace>default</Namespace>
<AppName>ahas-demo</AppName>
<HalfOpenRecoveryStepNum>1</HalfOpenRecoveryStepNum>
<RecoveryTimeoutMs>5000</RecoveryTimeoutMs>
<Enable>true</Enable>
<Strategy>0</Strategy>
<HalfOpenBaseAmountPerStep>5</HalfOpenBaseAmountPerStep>
<StatDurationMs>2000</StatDurationMs>
<Threshold>0.6</Threshold>
</Data>
<Code>IllegalArgument.AppName</Code>
<Success>false</Success>
</CreateDegradeRuleResponse>
JSON
格式
{"Message":"null","RequestId":"3FEEAD12-CE22-4EDE-A729-CE94EC070610","Data":{"MinRequestAmount":"10","RuleId":"1","Resource":"handleService","SlowRtMs":"2000","Namespace":"default","AppName":"ahas-demo","HalfOpenRecoveryStepNum":"1","RecoveryTimeoutMs":"5000","Enable":"true","Strategy":"0","HalfOpenBaseAmountPerStep":"5","StatDurationMs":"2000","Threshold":"0.6"},"Code":"200","Success":"true"}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | IllegalArgument.AppName | The specified AppName is invalid. | 参数AppName不合法 |
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.Namespace | The specified Namespace is invalid. | 参数Namespace不合法 |
400 | IllegalArgument.RecoveryTimeoutMs | The specified RecoveryTimeoutMs is invalid. | 参数RecoveryTimeoutMs不合法 |
400 | IllegalArgument.Resource | The specified Resource is invalid. | 参数Resource不合法 |
400 | IllegalArgument.SlowRtMS | The specified SlowRtMs is invalid. | 参数SlowRtMs不合法 |
400 | IllegalArgument.StatDurationMs | The specified StatDurationMs is invalid. | 参数StatDurationMs不合法 |
400 | IllegalArgument.Strategy | The specified Strategy is invalid. | 参数Strategy不合法 |
400 | IllegalArgument.Threshold | The specified Threshold is invalid. | 参数Threshold不合法 |
访问错误中心查看更多错误码。
在文档使用中是否遇到以下问题
更多建议
匿名提交