调用UpdateListener修改监听。

调试

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

请求参数

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

系统规定参数。取值:UpdateListener

Description String Listener

监听的描述。

ListenerId String lsr-bp1bpn0kn908w4nbw****

监听的ID。

Name String Listener

监听的名称。

名称长度为2~128个字符,以大小写字母或中文开头,可包含数字、下划线(_)和短横线(-)。

PortRanges.N.FromPort Integer 20

用来接收请求并向终端节点进行转发的起始监听端口。

PortRanges.N.ToPort Integer 20

用来接收请求并向终端节点进行转发的结束监听端口。

RegionId String cn-hangzhou

全球加速实例所在的地域,仅取值cn-hangzhou

ClientToken String 123e4567-e89b-12d3-a456-426655440000

保证请求幂等性。从您的客户端生成一个参数值,确保不同请求间该参数值唯一。ClientToken只支持ASCII字符,且不能超过64个字符。

ClientAffinity String SOURCE_IP

客户端亲和性。

  • 不传入值时:不保持客户端亲和性,即不能确保来自同一客户端的连接请求始终定向到同一终端节点。
  • 取值为SOURCE_IP时,保持客户端亲和性。即客户端访问有状态的应用程序时,可以将来自同一客户端的所有请求都定向到同一终端节点,而不考虑源端口和协议。
Protocol String tcp

监听的网络传输协议类型,取值:

  • tcp:TCP协议。
  • udp:UDP协议。

返回数据

名称 类型 示例值 描述
RequestId String 6FEA0CF3-D3B9-43E5-A304-D217037876A8

请求ID。

示例

请求示例

http(s)://[Endpoint]/?Action=UpdateListener
&Description=Listener
&ListenerId=lsr-bp1bpn0kn908w4nbw****
&Name=Listener
&PortRanges.1.FromPort=20
&PortRanges.1.ToPort=20
&RegionId=cn-hangzhou
&<公共请求参数>

正常返回示例

XML 格式

<UpdateListenerResponse>
     <RequestId>04F0F334-1335-436C-A1D7-6C044FE73368</RequestId>
</UpdateListenerResponse>

JSON 格式

{
   "RequestId":"04F0F334-1335-436C-A1D7-6C044FE73368"
}

错误码

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