Server Load Balancer:UpdateRuleAttribute

The key-value pairs of the cookie.

The header key. The header key must be 1 to 40 characters in length, and can contain letters, digits, hyphens (-), and underscores (_). Cookie and Host are not supported.

The header values.

The hostnames.

The request methods.

The forwarding URLs.

The query strings. You can specify at most 20 query strings.

The response status codes.

The key of the response header.

• The key must be 1 to 40 characters in length.
• It can contain letters, digits, hyphens (-), and underscores (_).
• Cookie and Host are not supported.

The values of the header.

You can add one or more IP addresses, including CIDR blocks.

The content of the response. The content can be up to 1 KB in size, and can contain only ASCII characters.

The content type.

Valid values: text/plain, text/css, text/html, application/javascript, and application/json.

The HTTP status code in responses. Valid values: 2xx, 4xx, 5xx. The value must be a numeric string. x must be a digit.

The server groups to which requests are forwarded.

The configuration of session persistence.

Specifies whether to overwrite the request header values. Valid values:

• true
• false

The key of the header. The key must be 1 to 40 characters in length, and can contain letters, digits, underscores (_), and hyphens (-). The header keys specified by InsertHeaderConfig must be unique.

The value of the header to be inserted.

• If ValueType is set to SystemDefined, you can set the Value parameter to one of the following values:

  • ClientSrcPort: the client port.
  • ClientSrcIp: the IP address of the client.
  • Protocol: the request protocol (HTTP or HTTPS).
  • SLBId: the ID of the ALB instance.
  • SLBPort: the listener port.

• If ValueType is set to UserDefined, you can specify a custom value. The value must be 1 to 128 characters in length, and can contain asterisks (*), question marks (?), and printable characters whose ASCII values are larger than or equal to 32 and smaller than 127. It cannot start or end with a space character.

• If ValueType is set to ReferenceHeader, you can reference a value from request headers. The value must be 1 to 128 characters in length, and can contain lowercase letters, digits, hyphens (-), and underscores (_).

The type of the header. Valid values:

• UserDefined: a custom header.
• ReferenceHeader: a header that references one of the request headers.
• SystemDefined: a system-defined header value.

The hostname to which requests are redirected. Valid values:

• ${host} (default): If ${host} is returned, no other character is appended.

• A custom value that meets the following requirements:

  • The hostname must be 3 to 128 characters in length, and can contain lowercase letters, digits, hyphens (-), periods (.), asterisks (*), and question marks (?).
  • The hostname must contain at least one period (.) but cannot start or end with a period (.).
  • The rightmost domain label can contain only letters and wildcard characters. It cannot contain digits or hyphens (-).
  • The domain labels cannot start or end with hyphens (-).
  • You can use asterisks (*) and question marks (?) anywhere in a domain label as wildcard characters.

The forwarding method. Valid values: 301, 302, 303, 307, and 308.

The URL to which requests are redirected. Valid values:

• Default value: ${path}. **${host}**, ${protocol}, and **${port}** are also supported. Each variable can be specified only once. The preceding variables can be used at the same time or combined with a custom value.

• A custom value that meets the following requirements:

  • The URL must be 1 to 128 characters in length,
  • It must start with a forward slash (/) and can contain letters, digits, and the following special characters: $ - _ .+ / & ~ @ :. It does not contain the following special characters: " % # ; ! ( ) [ ] ^ , ". You can use asterisks (*) and question marks (?) as wildcard characters.

The port to which requests are redirected. Valid values:

• ${port} (default): If you set the value to ${port}, you cannot append other characters.
• Other valid values: 1 to 63335.

The redirect protocol. Valid values:

• ${protocol} (default): If ${protocol} is returned, no other character is appended.
• HTTP or HTTPS.

The query string to which requests are redirected. Valid values:

• Default value: ${query}. **${host}**, ${protocol}, and **${port}** are also supported. Each variable can be specified only once. The preceding variables can be used at the same time or combined with a custom value.

• A custom value that meets the following requirements:

  • The query string must be 1 to 128 characters in length.
  • It cannot contain space characters or the following special characters: # [ ] { } \ | < > &. It can contain printable characters and uppercase letters.

The hostname to which requests are rewritten. Valid values:

• ${host} (default): If you set the value to ${host}, you cannot append other characters.

• A custom value that meets the following requirements:

  • The hostname must be 3 to 128 characters in length, and can contain lowercase letters, digits, hyphens (-), periods (.), asterisks (*), and question marks (?).
  • The hostname must contain at least one period (.) but cannot start or end with a period (.).
  • The rightmost domain label can contain only letters and wildcard characters. It cannot contain digits or hyphens (-).
  • The domain labels cannot start or end with hyphens (-). You can use asterisks (*) and question marks (?) anywhere in a domain label as wildcard characters.

The URL to which requests are redirected. Valid values:

• Default value: ${path}. **${host}**, ${protocol}, and **${port}** are also supported. Each variable can be specified only once. The preceding variables can be used at the same time or combined with a custom value.

• A custom value that meets the following requirements:

  • The URL must be 1 to 128 characters in length.
  • It must start with a forward slash (/) and can contain letters, digits, and the following special characters: $ - _ .+ / & ~ @ :. It cannot contain the following special characters: " % # ; ! ( ) [ ]^ , ". You can use asterisks (*) and question marks (?) as wildcards.

The query string to which requests are redirected. Valid values:

• Default value: ${query}. **${host}**, ${protocol}, and **${port}** are also supported. Each variable can be specified only once. The preceding variables can be used at the same time or combined with a custom value.

• A custom value that meets the following requirements:

  • The query string must be 1 to 128 characters in length.
  • It cannot contain space characters or the following special characters: # [ ] { } \ | < > &. It can contain printable characters and uppercase letters.

The number of queries per second (QPS). Value range: 1 to 1000000.

The number of requests per IP address. Value range: 1 to 1000000.

The type of destination to which network traffic is mirrored. Valid values:

• ForwardGroupMirror: a server group.

The server group to which network traffic is mirrored.

The key of the header to be removed. The header key must be 1 to 40 characters in length, and can contain letters, digits, underscores (_), and hyphens (-). The header keys specified in RemoveHeader must be unique.

• If Direction is set to Request, the following header keys are not supported: slb-id, slb-ip, x-forwarded-for, x-forwarded-proto, x-forwarded-eip, x-forwarded-port, x-forwarded-client-srcport, connection, upgrade, content-length, transfer-encoding, keep-alive, te, host, cookie, remoteip, and authority. The header keys are not case-sensitive.
• If Direction is set to Response, the following header keys are not supported: connection, upgrade, content-length, and transfer-encoding. The header keys are not case-sensitive.

The trusted origins of CORS requests. One or more values are supported. Asterisks (*) can be used as wildcard characters.

• Each value must start with http:// or https://, which must be followed by a valid domain name, including top-level domain names. Example: http://*.test.abc.example.com.
• You can specify a port in each value or leave the port empty. Valid values: 1 to 65535.

The trusted HTTP methods of CORS requests.

The trusted headers of CORS requests.

The headers that can be exposed.

Specifies whether to allow credentials to be carried in CORS requests. Valid values:

• on
• off

The maximum cache time of dry run requests in the browser. Unit: seconds.

Valid values: -1 to 172800.