Package software.amazon.awscdk.services.elasticloadbalancingv2

Interface CfnListener.RedirectConfigProperty

All Superinterfaces:
software.amazon.jsii.JsiiSerializable
All Known Implementing Classes:
CfnListener.RedirectConfigProperty.Jsii$Proxy
Enclosing class:
CfnListener
@Stability(Stable) public static interface CfnListener.RedirectConfigProperty extends software.amazon.jsii.JsiiSerializable
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".

Example: 

 // The code below shows an example of how to instantiate this type.
 // The values are placeholders you should change.
 import software.amazon.awscdk.services.elasticloadbalancingv2.*;
 RedirectConfigProperty redirectConfigProperty = RedirectConfigProperty.builder()
         .statusCode("statusCode")
         // the properties below are optional
         .host("host")
         .path("path")
         .port("port")
         .protocol("protocol")
         .query("query")
         .build();

  • Method Details

    • getStatusCode

      @Stability(Stable) @NotNull String getStatusCode()
      The HTTP redirect code.

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

    • getHost

      @Stability(Stable) @Nullable default String getHost()
      The hostname.

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

    • getPath

      @Stability(Stable) @Nullable default String getPath()
      The absolute path, starting with the leading "/".

      This component is not percent-encoded. The path can contain #{host}, #{path}, and #{port}.

    • getPort

      @Stability(Stable) @Nullable default String getPort()
      The port.

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

    • getProtocol

      @Stability(Stable) @Nullable default String getProtocol()
      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.

    • getQuery

      @Stability(Stable) @Nullable default String getQuery()
      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.

    • builder

      @Stability(Stable) static CfnListener.RedirectConfigProperty.Builder builder()
      Returns:
      a CfnListener.RedirectConfigProperty.Builder of CfnListener.RedirectConfigProperty