RedirectActionConfig - Elastic Load Balancing
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

RedirectActionConfig

Information about a redirect action.

A URI consists of the following components: protocol://hostname:port/path?query. You must modify at least one of the following components to avoid a redirect loop: protocol, hostname, port, or path. Any components that you do not modify retain their original values.

You can reuse URI components using the following reserved keywords:

  • #{protocol}

  • #{host}

  • #{port}

  • #{path} (the leading "/" is removed)

  • #{query}

For example, you can change the path to "/new/#{path}", the hostname to "example.#{host}", or the query to "#{query}&value=xyz".

Contents

StatusCode

The HTTP redirect code. The redirect is either permanent (HTTP 301) or temporary (HTTP 302).

Type: String

Valid Values: HTTP_301 | HTTP_302

Required: Yes

Host

The hostname. This component is not percent-encoded. The hostname can contain #{host}.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 128.

Required: No

Path

The absolute path, starting with the leading "/". This component is not percent-encoded. The path can contain #{host}, #{path}, and #{port}.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 128.

Required: No

Port

The port. You can specify a value from 1 to 65535 or #{port}.

Type: String

Required: No

Protocol

The protocol. You can specify HTTP, HTTPS, or #{protocol}. You can redirect HTTP to HTTP, HTTP to HTTPS, and HTTPS to HTTPS. You cannot redirect HTTPS to HTTP.

Type: String

Pattern: ^(HTTPS?|#\{protocol\})$

Required: No

Query

The query parameters, URL-encoded when necessary, but not percent-encoded. Do not include the leading "?", as it is automatically added. You can specify any of the reserved keywords.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 128.

Required: No

See Also

For more information about using this API in one of the language-specific Amazon SDKs, see the following: