software.amazon.awscdk.services.elasticloadbalancingv2

Interface RedirectOptions

All Known Implementing Classes:

RedirectOptions.Jsii$Proxy

@Generated(value="jsii-pacmak/1.74.0 (build 6d08790)",
           date="2023-03-22T19:35:47.161Z")
public interface RedirectOptions

Options for `ListenerAction.redirect()`.

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.*;
 RedirectOptions redirectOptions = RedirectOptions.builder()
         .host("host")
         .path("path")
         .permanent(false)
         .port("port")
         .protocol("protocol")
         .query("query")
         .build();
 

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	RedirectOptions.Builder A builder for RedirectOptions
static class	RedirectOptions.Jsii$Proxy An implementation for RedirectOptions

Method Summary

Modifier and Type	Method and Description
static RedirectOptions.Builder	builder()
default java.lang.String	getHost() The hostname.
default java.lang.String	getPath() The absolute path, starting with the leading "/".
default java.lang.Boolean	getPermanent() The HTTP redirect code.
default java.lang.String	getPort() The port.
default java.lang.String	getProtocol() The protocol.
default java.lang.String	getQuery() The query parameters, URL-encoded when necessary, but not percent-encoded.

Method Detail

getHost

default java.lang.String getHost()

The hostname.

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

Default: - No change

getPath

default java.lang.String getPath()

The absolute path, starting with the leading "/".

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

Default: - No change

getPermanent

default java.lang.Boolean getPermanent()

The HTTP redirect code.

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

Default: false

getPort

default java.lang.String getPort()

The port.

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

Default: - No change

getProtocol

default java.lang.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.

Default: - No change

getQuery

default java.lang.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.

Default: - No change

builder

static RedirectOptions.Builder builder()

Returns:

a RedirectOptions.Builder of RedirectOptions