调用ModifyFlowRule接口修改流控规则。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | ModifyFlowRule |
系统规定参数。取值:ModifyFlowRule。 |
Namespace | String | 是 | default |
命名空间。 |
RuleId | Long | 是 | 123 |
规则ID。 |
RelationStrategy | Integer | 否 | 0 |
统计维度。0表示当前接口,1表示关联接口,2表示链路入口。 |
Threshold | Float | 否 | 50 |
流控阈值。 |
LimitOrigin | String | 否 | default |
来源应用。 |
RefResource | String | 否 | handleServiceB |
关联接口名、入口资源名。当统计维度relationStrategy值为1(关联接口)或2(链路入口)时,需要设置该字段。 |
ControlBehavior | String | 否 | 0 |
流控效果。0表示快速失败,1表示预热启动,2表示排队等待。 |
WarmUpPeriodSec | Integer | 否 | 30 |
预热时间。当controlBehavior值为1(预热启动)时,需要设置该字段。 |
MaxQueueingTimeMs | Integer | 否 | 2000 |
超时时间。当controlBehavior值为2(排队等待)时,需要设置该字段。 |
AhasRegionId | String | 否 | cn-hangzhou |
地域。 |
ThresholdMode | Integer | 否 | 2 |
流控阈值模式。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
Message | String | null |
错误信息。 |
RequestId | String | 3FEEAD12-CE22-4EDE-A729-CE94E*****10 |
请求ID。 |
Data | Object |
返回数据。 |
|
RefResource | String | handleServiceB |
关联接口名、入口资源名。 |
ClusterFallbackThreshold | Integer | 0 |
退化单机阈值,当退化策略为退化到单机(ClusterFallbackStrategy=0)时返回。 |
Namespace | String | default |
命名空间。 |
LimitOrigin | String | default |
来源应用。 |
StatDurationMs | Integer | 0 |
集群模式下统计窗口时长。 |
ClusterThresholdType | Integer | 0 |
阈值模式,0表示单机均摊阈值,1表示集群阈值。 |
RuleId | Long | 123 |
规则ID。 |
RelationStrategy | Integer | 0 |
统计维度。 |
AppName | String | ahas-demo |
应用名,若为EDAS应用,则AppName为EDAS中的App ID,可在EDAS控制台“应用管理>基本信息”中查看对应的ID。 |
Resource | String | handleServiceA |
接口资源名。 |
MaxQueueingTimeMs | Integer | 2000 |
超时时间。 |
ClusterEstimatedMaxQps | Float | 0 |
集群接口预估最大QPS。 |
ControlBehavior | Integer | 0 |
流控效果。0表示快速失败,1表示预热启动,2表示排队等待。 |
WarmUpPeriodSec | Integer | 30 |
预热时间。 |
ClusterFallbackStrategy | Integer | 0 |
集群流控通信失败退化策略,0表示退化到单机,1表示直接通过。 |
Threshold | Float | 50 |
流控阈值。 |
ThresholdMode | Integer | 2 |
流控阈值模式。 |
ClusterMode | Boolean | false |
是否为集群模式。 |
Enable | Boolean | true |
规则是否开启。 |
Code | String | 200 |
返回码。 |
Success | Boolean | true |
是否成功。 |
示例
请求示例
http(s)://[Endpoint]/?Action=ModifyFlowRule
&Namespace=default
&RuleId=123
&RelationStrategy=0
&Threshold=50.0
&LimitOrigin=default
&RefResource=handleServiceB
&ControlBehavior=0
&WarmUpPeriodSec=30
&MaxQueueingTimeMs=2000
&AhasRegionId=cn-hangzhou
&ThresholdMode=2
&公共请求参数
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<ModifyFlowRuleResponse>
<Message>null</Message>
<RequestId>3FEEAD12-CE22-4EDE-A729-CE94E*****10</RequestId>
<Data>
<RefResource>handleServiceB</RefResource>
<ClusterFallbackThreshold>0</ClusterFallbackThreshold>
<Namespace>default</Namespace>
<LimitOrigin>default</LimitOrigin>
<StatDurationMs>0</StatDurationMs>
<ClusterThresholdType>0</ClusterThresholdType>
<RuleId>123</RuleId>
<RelationStrategy>0</RelationStrategy>
<AppName>ahas-demo</AppName>
<Resource>handleServiceA</Resource>
<MaxQueueingTimeMs>2000</MaxQueueingTimeMs>
<ClusterEstimatedMaxQps>0</ClusterEstimatedMaxQps>
<ControlBehavior>0</ControlBehavior>
<WarmUpPeriodSec>30</WarmUpPeriodSec>
<ClusterFallbackStrategy>0</ClusterFallbackStrategy>
<Threshold>50</Threshold>
<ThresholdMode>2</ThresholdMode>
<ClusterMode>false</ClusterMode>
<Enable>true</Enable>
</Data>
<Code>200</Code>
<Success>true</Success>
</ModifyFlowRuleResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"Message" : "null",
"RequestId" : "3FEEAD12-CE22-4EDE-A729-CE94E*****10",
"Data" : {
"RefResource" : "handleServiceB",
"ClusterFallbackThreshold" : 0,
"Namespace" : "default",
"LimitOrigin" : "default",
"StatDurationMs" : 0,
"ClusterThresholdType" : 0,
"RuleId" : 123,
"RelationStrategy" : 0,
"AppName" : "ahas-demo",
"Resource" : "handleServiceA",
"MaxQueueingTimeMs" : 2000,
"ClusterEstimatedMaxQps" : 0,
"ControlBehavior" : 0,
"WarmUpPeriodSec" : 30,
"ClusterFallbackStrategy" : 0,
"Threshold" : 50,
"ThresholdMode" : 2,
"ClusterMode" : false,
"Enable" : true
},
"Code" : 200,
"Success" : true
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | IllegalArgument.AppName | The specified AppName is invalid. | 参数AppName不合法 |
400 | IllegalArgument.ControlBehavior | The specified ControlBehavior is invalid. | 参数ControlBehavior不合法 |
400 | IllegalArgument.Namespace | The specified Namespace is invalid. | 参数Namespace不合法 |
400 | IllegalArgument.RefResource | The specified RefResource is invalid. | 参数RefResource不合法 |
400 | IllegalArgument.RelationStrategy | The specified RelationStrategy is invalid. | 参数RelationStrategy不合法 |
400 | IllegalArgument.Resource | The specified Resource is invalid. | 参数Resource不合法 |
400 | IllegalArgument.RuleId | The specified RuleId is invalid. | 参数RuleId不合法 |
400 | IllegalArgument.Threshold | The specified Threshold is invalid. | 参数Threshold不合法 |
400 | IllegalArgument.WarmUpPeriodSec | The specified WarmUpPeriodSec is invalid. | 参数WarmUpPeriodSec不合法 |
访问错误中心查看更多错误码。