調用ModifyHotParamRule接口修改熱點規則。

調試

您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。

請求參數

名稱 類型 是否必選 示例值 描述
Action String 是 ModifyHotParamRule

系統規定參數。取值：ModifyHotParamRule。

MetricType Integer 否 1

統計維度，0表示并發數，1表示通過請求數。
Threshold Float 否 20

熱點規則中針對每個熱點參數的閾值，取值范圍為≥0的整數。
Enable Boolean 否 false

規則是否開啟。
RuleId Long 是 123

規則ID。
ParamIdx Integer 否 1

參數位置索引，埋點傳入參數的索引位置。對應SphU.entry(xxx,args)中的參數索引位置。

例如：SphU.entry(resourceName,Entry Type.IN,1,paramA,paramB)埋點中，paramA的參數索引是0，paramB的參數索引是1。

StatDurationSec Long 否 1

統計周期時間，單位秒。
ControlBehavior Integer 否 0

流控效果，0表示快速失敗，2表示排隊等待。
BurstCount Integer 否 2

緩沖請求數，流控效果為快速失敗時需要設置。
MaxQueueingTimeMs Integer 否 3000

超時時間，單位秒。流控效果為排隊等待時需要設置。
AhasRegionId String 否 cn-hangzhou

地域。

返回數據

名稱 類型 示例值 描述
Message String null

錯誤信息。
RequestId String 3FEEAD12-CE22-4EDE-A729-CE94EC070610

請求ID。
Data Object

返回數據。
ParamIdx Integer 1

熱點參數索引。
Namespace String default

命名空間。
ParamFlowItemList Array of ParamFlowItemList

熱點參數例外項。
ItemValue String apple

例外項參數值。
ItemType String String

例外項類型。
Threshold Float 20

例外項閾值。
StatDurationSec Long 1

統計周期時間，單位秒。
BurstCount Integer 2

緩沖請求數。
RuleId Long 123

熱點規則ID
Resource String handleService

資源名。
AppName String ahas-demo

應用名，若為EDAS應用，則AppName為EDAS中的App ID，可在EDAS控制臺“應用管理>基本信息”中查看對應的ID。
MaxQueueingTimeMs Integer 3000

流控效果為排隊等待時對應的超時時間，單位毫秒。
ControlBehavior Integer 0

流控效果，0表示快速失敗，2表示排隊等待。
MetricType Integer 1

統計維度，0表示并發數，1表示通過請求數。
Threshold Float 20

單機閾值。
Enable Boolean false

規則是否開啟。
Code String 200

返回碼。
Success Boolean true

是否成功。

示例

請求示例

http(s)://[Endpoint]/?Action=ModifyHotParamRule
&MetricType=1
&Threshold=20.0
&Enable=false
&RuleId=123
&ParamIdx=1
&StatDurationSec=1
&ControlBehavior=0
&BurstCount=2
&MaxQueueingTimeMs=3000
&AhasRegionId=cn-hangzhou
&公共請求參數

正常返回示例

XML格式 

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

<ModifyHotParamRuleResponse>
    <Message>null</Message>
    <RequestId>3FEEAD12-CE22-4EDE-A729-CE94EC070610</RequestId>
    <Data>
        <ParamIdx>1</ParamIdx>
        <Namespace>default</Namespace>
        <ParamFlowItemList>
            <ItemValue>apple</ItemValue>
            <ItemType>String</ItemType>
            <Threshold>20</Threshold>
        </ParamFlowItemList>
        <StatDurationSec>1</StatDurationSec>
        <BurstCount>2</BurstCount>
        <RuleId>123</RuleId>
        <Resource>handleService</Resource>
        <AppName>ahas-demo</AppName>
        <MaxQueueingTimeMs>3000</MaxQueueingTimeMs>
        <ControlBehavior>0</ControlBehavior>
        <MetricType>1</MetricType>
        <Threshold>20</Threshold>
        <Enable>false</Enable>
    </Data>
    <Code>200</Code>
    <Success>true</Success>
</ModifyHotParamRuleResponse>

JSON格式 

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

{
  "Message" : "null",
  "RequestId" : "3FEEAD12-CE22-4EDE-A729-CE94EC070610",
  "Data" : {
    "ParamIdx" : 1,
    "Namespace" : "default",
    "ParamFlowItemList" : {
      "ItemValue" : "apple",
      "ItemType" : "String",
      "Threshold" : 20
    },
    "StatDurationSec" : 1,
    "BurstCount" : 2,
    "RuleId" : 123,
    "Resource" : "handleService",
    "AppName" : "ahas-demo",
    "MaxQueueingTimeMs" : 3000,
    "ControlBehavior" : 0,
    "MetricType" : 1,
    "Threshold" : 20,
    "Enable" : false
  },
  "Code" : 200,
  "Success" : true
}

錯誤碼

HttpCode 錯誤碼 錯誤信息 描述
400 IllegalArgument.RuleId The specified RuleId is invalid. 參數RuleId不合法
400 IllegalArgument.MetricType The specified MetricType is invalid. 參數MetricType不合法
400 IllegalArgument.Threshold The specified Threshold is invalid. 參數Threshold不合法
400 IllegalArgument.ParamIdx The specified ParamIdx is invalid. 參數ParamIdx不合法
400 IllegalArgument.ControlBehavior The specified ControlBehavior is invalid. 參數ControlBehavior不合法
400 IllegalArgument.MaxQueueingTimeM The specified MaxQueueingTimeMs is invalid. 參數MaxQueueingTimeMs不合法
400 IllegalArgument.BurstCount The specified BurstCount is invalid. 參數BurstCount不合法

訪問錯誤中心查看更多錯誤碼。