Updating a Listener_Listener_APIs (V3)_API Reference

Function

This API is used to update a listener.

Constraints

If the provisioning status of the load balancer that the listener is added to is not ACTIVE, the listener cannot be updated.

Calling Method

For details, see Calling APIs.

URI

PUT /v3/{project_id}/elb/listeners/{listener_id}

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
listener_id	Yes	String	Specifies the listener ID.
project_id	Yes	String	Definition: Specifies the project ID. For details about how to obtain a project ID, see Obtaining a Project ID. Constraints: N/A Range: The value can contain a maximum of 32 characters, including digits and lowercase letters. Default value: N/A

Request Parameters

**Table 2** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	Definition: Specifies the token used for IAM authentication. Constraints: N/A Range: N/A Default value: N/A

**Table 3** Request body parameters
Parameter	Mandatory	Type	Description
listener	Yes	UpdateListenerOption object	Definition: Specifies the request parameters for updating a listener. Constraints: N/A

**Table 4** UpdateListenerOption
Parameter	Mandatory	Type	Description
admin_state_up	No	Boolean	Definition: Specifies the administrative status of the listener. Constraints: The value can only be updated to true. Range: N/A Default value: N/A
client_ca_tls_container_ref	No	String	Definition: Specifies the ID of the CA certificate used by the listener. Constraints: This parameter is available only when type is set to client. This parameter is not available if the listener protocol is QUIC. Range: N/A Default value: N/A QUIC is not supported.
default_pool_id	No	String	Definition: Specifies the ID of the default backend server group of the listener. If there is no matched forwarding policy, requests will be routed to the default backend server group. Constraints: N/A Range: N/A Default value: N/A
default_tls_container_ref	No	String	Definition: Specifies the ID of the server certificate used by the listener. Constraints: This parameter is mandatory when the listener protocol is HTTPS, and type must be set to server. Range: N/A Default value: N/A
description	No	String	Definition: Provides supplementary information about the listener. Constraints: N/A Range: N/A Default value: N/A
http2_enable	No	Boolean	Definition: Specifies whether to allow clients to use HTTP/2 to communicate with the load balancer for higher access performance. However, the load balancer still uses HTTP/1.x to forward requests to the backend server. Constraints: This parameter is valid only for HTTPS listeners. This parameter is not available for QUIC listeners and the response is fixed at true. You can configure this parameter for listeners with other protocols, but it will not take effect. Range: N/A Default value: N/A QUIC is not supported.
insert_headers	No	ListenerInsertHeaders object	Definition: Specifies the HTTP headers that can transmit required information to backend servers. For example, you can use the X-Forwarded-ELB-IP header to transmit the load balancer EIP to backend servers. Constraints: This parameter can be configured only for HTTP, HTTPS, and QUIC listeners.
name	No	String	Definition: Specifies the name of the listener. Constraints: If you leave the listener name empty, you cannot locate it in the listener list and view its details. Range: N/A Default value: N/A
sni_container_refs	No	Array of strings	Definition: Specifies the IDs of SNI certificates (server certificates with domain names) used by the listener. Constraints: QUIC listeners support only RSA certificates. Each domain name of an SNI certificate must be unique. The total number of domain names of all SNI certificates cannot exceed 200. Range: N/A Default value: N/A QUIC is not supported.
sni_match_algo	No	String	Definition: Specifies how wildcard domain name matches with the SNI certificates used by the listener. Constraints: N/A Range: longest_suffix: indicates longest suffix match. wildcard: indicates wildcard match. Default value: wildcard
tls_ciphers_policy	No	String	Definition: Specifies the security policy used by the listener. Constraints: This parameter is available only for HTTPS listeners added to a dedicated load balancer. This parameter is not available for QUIC listeners. If both security_policy_id and tls_ciphers_policy are specified, only security_policy_id takes effect. The encryption suite priority from the highest to lowest is ECC suite, RSA suite, and finally TLS 1.3 suite (supporting both ECC and RSA). Range: tls-1-0, tls-1-1, tls-1-2, or tls-1-2-strict. The default value is tls-1-2. TLS 1.3 is not supported.
security_policy_id	No	String	Definition: Specifies the ID of the custom security policy. Constraints: This parameter is available only for HTTPS listeners added to a dedicated load balancer. If both security_policy_id and tls_ciphers_policy are specified, only security_policy_id takes effect. The encryption suite priority from the highest to lowest is ECC suite, RSA suite, and finally TLS 1.3 suite (supporting both ECC and RSA). TLS 1.3 is not supported.
enable_member_retry	No	Boolean	Definition: Specifies whether to enable health check retries for backend servers. Constraints: This parameter is available only when protocol is set to HTTP or HTTPS. Range: true indicates health check retries will be enabled. false indicates health check retries will be disabled. Default value: true QUIC is not supported.
member_timeout	No	Integer	Definition: Specifies the timeout duration for waiting for a response from a backend server, in seconds. If the backend server fails to respond after the timeout duration elapses, the load balancer will stop waiting and return HTTP 504 Gateway Timeout to the client. Constraints: This parameter is available only for HTTP and HTTPS listeners. Range: 1-300s. Default value: 60s
client_timeout	No	Integer	Definition: Specifies the timeout duration for waiting for a request from a client, in seconds. This parameter is available only for HTTP and HTTPS listeners. Constraints: This parameter is unavailable for TCP and UDP listeners. Range: 1-300s Default value: 60s
keepalive_timeout	No	Integer	Definition: Specifies the idle timeout duration, in seconds. If the load balancer receives no requests within the idle timeout duration, it will disconnect the connection with the client and establish a new connection when there is a new request. Constraints: This parameter is not supported by UDP listeners of shared load balancers. Range: For TCP and IP listeners, the value ranges from 10 to 4000. For HTTP, HTTPS, and TERMINATED_HTTPS listeners, the value ranges from 0 to 4000. Default value: 60s
ipgroup	No	UpdateListenerIpGroupOption object	Specifies the IP address group associated with the listener.
transparent_client_ip_enable	No	Boolean	Definition: Specifies whether to pass source IP addresses of the clients to backend servers. If it is enabled, the source IP addresses of the clients will be passed to the backend server. Range: TCP or UDP listeners of shared load balancers: The value can be true or false, and the default value is false if this parameter is not passed. HTTP or HTTPS listeners of shared load balancers: The value can only be true, and the default value is true if this parameter is not passed. All listeners of dedicated load balancers: The value can only be true, and the default value is true if this parameter is not passed. Default value: N/A The value can only be true, and the default value is true if this parameter is not passed.
proxy_protocol_enable	No	Boolean	Definition: Specifies whether to enable ProxyProtocol to pass the source IP addresses of the clients to backend servers. Constraints: This parameter is available only for TLS listeners and does not take effect for other types of listeners. Range: The value can be true (enable this option) or false (disable this option). Default value: false
enhance_l7policy_enable	No	Boolean	Definition: Specifies whether to enable advanced forwarding. If advanced forwarding is enabled, more flexible forwarding policies and rules are supported. The following scenarios are supported: action can be set to REDIRECT_TO_URL (requests will be redirected to another URL) or Fixed_RESPONSE (a fixed response body will be returned to clients). Parameters priority, redirect_url_config, and fixed_response_config can be specified in a forwarding policy. type can be set to METHOD, HEADER, QUERY_STRING, or SOURCE_IP for a forwarding rule. If type is set to HOST_NAME for a forwarding rule, the value of the forwarding rule supports wildcard asterisks (). Parameter conditions* can be specified for forwarding rules. Constraints: Advanced forwarding cannot be disabled once it is enabled. If advanced forwarding is enabled, forwarding policy priorities are defined by priority. The priorities are not automatically sorted. For details, see the description of the priority parameter in the forwarding policy. Range: The value can be true (enable this option) or false (disable this option). Default value: false
quic_config	No	UpdateListenerQuicConfigOption object	Definition: Specifies the QUIC configuration for the current listener. Constraints: This parameter is valid only when protocol is set to HTTPS. For a TCP, UDP, HTTP, or QUIC listener, if this parameter is not left blank, an error will be reported. NOTE: Suppose the client sends an HTTP request to the server and carries information indicating that the QUIC protocol is supported. If enable_quic_upgrade is set to true, the QUIC port and version information supported by the server will be included in the response header. When the client sends both HTTPS and QUIC requests, if the QUIC request is sent and responded, the client will use the QUIC protocol to communicate with the backend servers. QUIC is not supported.
cps	No	Integer	Definition: Specifies the maximum number of new connections that a listener can handle per second. Constraints: If the value is greater than the number defined in the load balancer flavors, the latter is used as the limit. Range: 0 to 1000000 Default value: 0, indicating that the number is not limited.
connection	No	Integer	Definition: Specifies the maximum number of concurrent connections that a listener can handle per second. Constraints: If the value is greater than the number defined in the load balancer flavors, the latter is used as the limit. Range: 0 to 1000000 Default value: 0, indicating that the number is not limited.

**Table 5** ListenerInsertHeaders
Parameter	Mandatory	Type	Description
X-Forwarded-ELB-IP	No	Boolean	Definition: If X-Forwarded-ELB-IP is set to true, the load balancer EIP will be stored in the X-Forwarded-ELB-IP header and passed to backend servers. Constraints: N/A Range: N/A Default value: N/A
X-Forwarded-Port	No	Boolean	Definition: If X-Forwarded-Port is set to true, the listening port of the load balancer will be stored in the X-Forwarded-Port header and passed to backend servers. Constraints: N/A Range: N/A Default value: N/A
X-Forwarded-For-Port	No	Boolean	Definition: If X-Forwarded-For-Port is set to true, the source port of the client will be stored in the HTTP header and passed to backend servers. Constraints: N/A Range: N/A Default value: N/A
X-Forwarded-Host	No	Boolean	Definition: If X-Forwarded-Host is set to true, the client host can be stored in the X-Forwarded-Host header and passed to backend servers.
X-Forwarded-Proto	No	Boolean	Definition: If X-Forwarded-Proto is set to true, the listener protocol of the load balancer can be stored in the X-Forwarded-Proto header and passed to backend servers. Constraints: N/A Range: N/A Default value: N/A
X-Real-IP	No	Boolean	Definition: If X-Real-IP is set to true, the client IP address can be stored in the X-Real-IP header and passed to backend servers. Constraints: N/A Range: N/A Default value: N/A
X-Forwarded-ELB-ID	No	Boolean	Definition: If X-Forwarded-ELB-ID is set to true, the load balancer ID can be transferred to backend servers through the X-Forwarded-ELB-ID header. Constraints: N/A Range: N/A Default value: N/A
X-Forwarded-TLS-Certificate-ID	No	Boolean	Definition: If X-Forwarded-TLS-Certificate-ID is set to true, the certificate ID of the load balancer can be transferred to backend servers through the X-Forwarded-TLS-Certificate-ID header. Constraints: N/A Range: N/A Default value: N/A
X-Forwarded-TLS-Protocol	No	Boolean	Definition: If X-Forwarded-TLS-Protocol is set to true, the algorithm protocol of the load balancer can be transferred to backend servers through the X-Forwarded-TLS-Protocol header. Constraints: N/A Range: N/A Default value: N/A
X-Forwarded-TLS-Cipher	No	Boolean	Definition: If X-Forwarded-TLS-Cipher is set to true, the algorithm suite of the load balancer can be transferred to backend servers through the X-Forwarded-TLS-Cipher header. Constraints: N/A Range: N/A Default value: N/A

**Table 6** UpdateListenerIpGroupOption
Parameter	Mandatory	Type	Description
ipgroup_id	No	String	Definition: Specifies the ID of the IP address group associated with the listener. This parameter is mandatory during creation and is optional during update. Constraints: The specified IP address group must exist, and the value cannot be null. Otherwise, the IP address group conflicts with enable_ipgroup.
enable_ipgroup	No	Boolean	Definition: Specifies whether access control is enabled. A listener with access control enabled can be directly deleted. Range: true: Access control is enabled. false: Access control is disabled.
type	No	String	Definition: Specifies how access to the listener is controlled. Range: white: A whitelist will be configured. Only IP addresses in the whitelist can access the listener. black: A blacklist will be configured. IP addresses in the blacklist are not allowed to access the listener.

**Table 7** UpdateListenerQuicConfigOption
Parameter	Mandatory	Type	Description
quic_listener_id	No	String	Definition: Specifies the ID of the QUIC listener. Constraints: The listener specified by quic_listener_id must exist. The listener protocol must be QUIC and cannot be set to null. Otherwise, it will conflict with enable_quic_upgrade. QUIC is not supported.
enable_quic_upgrade	No	Boolean	Definition: Specifies whether to enable QUIC upgrade. If this option is enabled, HTTPS listeners will be upgraded to QUIC listeners. Range: True: Enable QUIC upgrade. False: Disable QUIC upgrade. QUIC is not supported.

Response Parameters

Status code: 200

**Table 8** Response body parameters
Parameter	Type	Description
request_id	String	Definition: Specifies the request ID. Range: The value is automatically generated, and can contain characters including digits, lowercase letters, and hyphens (-).
listener	Listener object	Response body for adding a listener

**Table 9** Listener
Parameter	Type	Description
admin_state_up	Boolean	Definition: Specifies the administrative status of the listener. Default value: true
client_ca_tls_container_ref	String	Definition: Specifies the ID of the CA certificate used by the listener. This parameter is available only when type is set to client. Default value: N/A
connection_limit	Integer	Definition: Specifies the maximum number of connections that the listener can establish with backend servers. Range: an integer greater than or equal to -1
created_at	String	Definition: Specifies the time when the listener was created. Range: N/A The value must be in the format of yyyy-MM-dd''T''HH:mm:ss''Z'', for example, 2021-07-30T12:03:44Z.
default_pool_id	String	Definition: Specifies the ID of the default backend server group of the listener. If there is no matched forwarding policy, requests will be routed to the default backend server group. Range: N/A
default_tls_container_ref	String	Definition: Specifies the ID of the server certificate used by the listener. Default value: N/A
description	String	Definition: Provides supplementary information about the listener. Range: N/A
http2_enable	Boolean	Definition: Specifies whether to allow clients to use HTTP/2 to communicate with the load balancer for higher access performance. However, the load balancer still uses HTTP/1.x to forward requests to the backend server. Range: N/A
id	String	Definition: Specifies the listener ID. Range: N/A
insert_headers	ListenerInsertHeaders object	Definition: Specifies the HTTP headers that can transmit required information to backend servers. For example, you can use the X-Forwarded-ELB-IP header to transmit the load balancer EIP to backend servers.
loadbalancers	Array of LoadBalancerRef objects	Definition: Specifies the ID of the load balancer that the listener is added to. A listener can be associated with only one load balancer.
name	String	Definition: Specifies the name of the listener. If you leave the listener name empty, you cannot locate it in the listener list and view its details. Range: N/A
project_id	String	Definition: Specifies the ID of the project that the listener belongs to. Range: N/A
enterprise_project_id	String	Definition: Specifies the enterprise project ID. Range: N/A
protocol	String	Definition: Specifies the protocol of the listener. Range: The value can be TCP, UDP, HTTP, HTTPS, or IP. IP is only available for listeners that will be added to gateway load balancers.
protocol_port	Integer	Definition: Specifies the port used by the listener. Default value: N/A
sni_container_refs	Array of strings	Definition: Specifies the IDs of SNI certificates (server certificates with domain names) used by the listener. Range: N/A
sni_match_algo	String	Definition: Specifies how wildcard domain name matches with the SNI certificates used by the listener. Range: longest_suffix indicates longest suffix match. wildcard indicates wildcard match.
tags	Array of Tag objects	Definition: Lists the tags.
updated_at	String	Definition: Specifies the time when the listener was updated. Range: The value must be in the format of yyyy-MM-dd''T''HH:mm:ss''Z'', for example, 2021-07-30T12:03:44Z.
tls_ciphers_policy	String	Definition: Specifies the security policy used by the listener. Range: tls-1-0, tls-1-1, tls-1-2, or tls-1-2-strict. The default value is tls-1-2. TLS 1.3 is not supported.
security_policy_id	String	Definition: Specifies the ID of the custom security policy. Range: N/A
enable_member_retry	Boolean	Definition: Specifies whether to enable health check retries for backend servers. Range: true indicates health check retries will be enabled. false indicates health check retries will be disabled.
keepalive_timeout	Integer	Definition: Specifies the idle timeout duration, in seconds. If the load balancer receives no requests within the idle timeout duration, it will disconnect the connection with the client and establish a new connection when there is a new request. Range: For TCP and IP listeners, the value ranges from 10s to 4000s. The default value is 300s. For HTTP, HTTPS, and TERMINATED_HTTPS listeners, the value ranges from 0s to 4000s. The default value is 60s.
client_timeout	Integer	Definition: Specifies the timeout duration for waiting for a response from a client, in seconds. There are two situations: If the client fails to send a request header to the load balancer within the timeout duration, the request will be interrupted. If the interval between two consecutive request bodies reaching the load balancer is greater than the timeout duration, the connection will be disconnected. Range: 1-300s
member_timeout	Integer	Definition: Specifies the timeout duration for waiting for a response from a backend server, in seconds. If the backend server fails to respond after the timeout duration elapses, the load balancer will stop waiting and return HTTP 504 Gateway Timeout to the client. Range: 1-300s
ipgroup	ListenerIpGroup object	Specifies the IP address group associated with the listener.
transparent_client_ip_enable	Boolean	Definition: Specifies whether to pass source IP addresses of the clients to backend servers. If it is enabled, the source IP addresses of the clients will be passed to the backend server. Range: TCP or UDP listeners of shared load balancers: The value can be true or false, and the default value is false if this parameter is not passed. HTTP or HTTPS listeners of shared load balancers: The value can only be true, and the default value is true if this parameter is not passed. All listeners of dedicated load balancers: The value can only be true, and the default value is true if this parameter is not passed.
proxy_protocol_enable	Boolean	Definition: Specifies whether to enable ProxyProtocol to pass the source IP addresses of the clients to backend servers. This parameter is available only for TLS listeners and does not take effect for other types of listeners. Range: The value can be true (enable this option) or false (disable this option).
enhance_l7policy_enable	Boolean	Definition: Specifies whether to enable advanced forwarding. If advanced forwarding is enabled, more flexible forwarding policies and rules are supported. The following scenarios are supported: action can be set to REDIRECT_TO_URL (requests will be redirected to another URL) or Fixed_RESPONSE (a fixed response body will be returned to clients). Parameters priority, redirect_url_config, and fixed_response_config can be specified in a forwarding policy. type can be set to METHOD, HEADER, QUERY_STRING, or SOURCE_IP for a forwarding rule. If type is set to HOST_NAME for a forwarding rule, the value of the forwarding rule supports wildcard asterisks (). Parameter conditions* can be specified for forwarding rules. Range: The value can be true (enable this option) or false (disable this option).
quic_config	ListenerQuicConfig object	Definition: Specifies the QUIC configuration for the current listener. Constraints: This parameter is valid only when protocol is set to HTTPS. For a TCP, UDP, HTTP, or QUIC listener, if this parameter is not left blank, an error will be reported. NOTE: Suppose the client sends an HTTP request to the server and carries information indicating that the QUIC protocol is supported. If enable_quic_upgrade is set to true, the QUIC port and version information supported by the server will be included in the response header. When the client sends both HTTPS and QUIC requests, if the QUIC request is sent and responded, the client will use the QUIC protocol to communicate with the backend servers. QUIC is not supported.
gzip_enable	Boolean	Definition: Specifies whether to enable gzip_enable for a load balancer. Range: The value can be true (enable this option) or false (disable this option).
port_ranges	Array of PortRange objects	Definition: Specifies one or more port ranges, including the start and end ports.
cps	Integer	Definition: Specifies the maximum number of new connections that a listener can handle per second. If the value is greater than the number defined in the load balancer flavors, the latter is used as the limit. Range: 0 to 1000000
connection	Integer	Definition: Specifies the maximum number of concurrent connections that a listener can handle per second. If the value is greater than the number defined in the load balancer flavors, the latter is used as the limit. Range: 0 to 1000000
nat64_enable	Boolean	Definition: Specifies whether to translate between IPv4 and IPv6 addresses. This option allows a client to access IPv4 or IPv6 backend servers by accessing the IPv4 or IPv6 address of a load balancer. Range: true: Enable nat64_enable. false: Disable nat64_enable.

**Table 10** ListenerInsertHeaders
Parameter	Type	Description
X-Forwarded-ELB-IP	Boolean	Definition: If X-Forwarded-ELB-IP is set to true, the load balancer EIP will be stored in the X-Forwarded-ELB-IP header and passed to backend servers. Constraints: N/A Range: N/A Default value: N/A
X-Forwarded-Port	Boolean	Definition: If X-Forwarded-Port is set to true, the listening port of the load balancer will be stored in the X-Forwarded-Port header and passed to backend servers. Constraints: N/A Range: N/A Default value: N/A
X-Forwarded-For-Port	Boolean	Definition: If X-Forwarded-For-Port is set to true, the source port of the client will be stored in the HTTP header and passed to backend servers. Constraints: N/A Range: N/A Default value: N/A
X-Forwarded-Host	Boolean	Definition: If X-Forwarded-Host is set to true, the client host can be stored in the X-Forwarded-Host header and passed to backend servers.
X-Forwarded-Proto	Boolean	Definition: If X-Forwarded-Proto is set to true, the listener protocol of the load balancer can be stored in the X-Forwarded-Proto header and passed to backend servers. Constraints: N/A Range: N/A Default value: N/A
X-Real-IP	Boolean	Definition: If X-Real-IP is set to true, the client IP address can be stored in the X-Real-IP header and passed to backend servers. Constraints: N/A Range: N/A Default value: N/A
X-Forwarded-ELB-ID	Boolean	Definition: If X-Forwarded-ELB-ID is set to true, the load balancer ID can be transferred to backend servers through the X-Forwarded-ELB-ID header. Constraints: N/A Range: N/A Default value: N/A
X-Forwarded-TLS-Certificate-ID	Boolean	Definition: If X-Forwarded-TLS-Certificate-ID is set to true, the certificate ID of the load balancer can be transferred to backend servers through the X-Forwarded-TLS-Certificate-ID header. Constraints: N/A Range: N/A Default value: N/A
X-Forwarded-TLS-Protocol	Boolean	Definition: If X-Forwarded-TLS-Protocol is set to true, the algorithm protocol of the load balancer can be transferred to backend servers through the X-Forwarded-TLS-Protocol header. Constraints: N/A Range: N/A Default value: N/A
X-Forwarded-TLS-Cipher	Boolean	Definition: If X-Forwarded-TLS-Cipher is set to true, the algorithm suite of the load balancer can be transferred to backend servers through the X-Forwarded-TLS-Cipher header. Constraints: N/A Range: N/A Default value: N/A

**Table 11** LoadBalancerRef
Parameter	Type	Description
id	String	Definition: Specifies the load balancer ID.

**Table 12** Tag
Parameter	Type	Description
key	String	Definition: Specifies the tag key. Range: N/A
value	String	Definition: Specifies the tag value. Range: N/A

**Table 13** ListenerIpGroup
Parameter	Type	Description
ipgroup_id	String	Definition: Specifies the ID of the IP address group associated with the listener. This parameter is mandatory during creation and is optional during update. Constraints: The specified IP address group must exist, and the value cannot be null. Otherwise, the IP address group conflicts with enable_ipgroup.
enable_ipgroup	Boolean	Definition: Specifies whether access control is enabled. A listener with access control enabled can be directly deleted. Range: true: Access control is enabled. false: Access control is disabled.
type	String	Definition: Specifies how access to the listener is controlled. Range: white: A whitelist will be configured. Only IP addresses in the whitelist can access the listener. black: A blacklist will be configured. IP addresses in the blacklist are not allowed to access the listener.

**Table 14** ListenerQuicConfig
Parameter	Type	Description
quic_listener_id	String	Definition: Specifies the ID of the QUIC listener. Constraints: The listener specified by quic_listener_id must exist. The listener protocol must be QUIC and cannot be set to null. Otherwise, it will conflict with enable_quic_upgrade. QUIC is not supported.
enable_quic_upgrade	Boolean	Definition: Specifies whether to enable QUIC upgrade. If this option is enabled, HTTPS listeners will be upgraded to QUIC listeners. Range: True: Enable QUIC upgrade. False: Disable QUIC upgrade. QUIC is not supported.

**Table 15** PortRange
Parameter	Type	Description
start_port	Integer	Specifies the start port number.
end_port	Integer	Specifies the end port number. The value must be greater than or equal to the start port number.

Example Requests

Modifying the name and description of a listener and enabling the HTTP/2 option

PUT https://{ELB_Endpoint}/v3/99a3fff0d03c428eac3678da6a7d0f24/elb/listeners/0b11747a-b139-492f-9692-2df0b1c87193

{
  "listener" : {
    "description" : "My listener update.",
    "name" : "My listener",
    "http2_enable" : true
  }
}

Example Responses

Status code: 200

Successful request.

{
  "listener" : {
    "id" : "0b11747a-b139-492f-9692-2df0b1c87193",
    "name" : "My listener",
    "protocol_port" : 80,
    "protocol" : "TCP",
    "description" : "My listener update.",
    "default_tls_container_ref" : null,
    "admin_state_up" : true,
    "loadbalancers" : [ {
      "id" : "098b2f68-af1c-41a9-8efd-69958722af62"
    } ],
    "member_timeout" : null,
    "client_timeout" : null,
    "keepalive_timeout" : 300,
    "client_ca_tls_container_ref" : null,
    "project_id" : "99a3fff0d03c428eac3678da6a7d0f24",
    "sni_container_refs" : [ ],
    "connection_limit" : -1,
    "default_pool_id" : null,
    "tls_ciphers_policy" : "tls-1-2",
    "tags" : [ ],
    "created_at" : "2019-04-02T00:12:32Z",
    "updated_at" : "2019-04-02T17:43:46Z",
    "http2_enable" : true,
    "ipgroup" : null,
    "insert_headers" : {
      "X-Forwarded-ELB-IP" : true
    },
    "transparent_client_ip_enable" : false,
    "nat64_enable" : false
  },
  "request_id" : "5d56d89a-2271-4a75-8c02-804e3bc7b671"
}

Status Codes

Status Code	Description
200	Successful request.

Error Codes

See Error Codes.

Updating a Listener