aws-cdk-lib.aws_elasticloadbalancingv2.CfnListenerRule.RedirectConfigProperty

interface RedirectConfigProperty

LanguageType name
.NETAmazon.CDK.AWS.ElasticLoadBalancingV2.CfnListenerRule.RedirectConfigProperty
Gogithub.com/aws/aws-cdk-go/awscdk/v2/awselasticloadbalancingv2#CfnListenerRule_RedirectConfigProperty
Javasoftware.amazon.awscdk.services.elasticloadbalancingv2.CfnListenerRule.RedirectConfigProperty
Pythonaws_cdk.aws_elasticloadbalancingv2.CfnListenerRule.RedirectConfigProperty
TypeScript aws-cdk-lib » aws_elasticloadbalancingv2 » CfnListenerRule » RedirectConfigProperty

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 { aws_elasticloadbalancingv2 as elbv2 } from 'aws-cdk-lib';
const redirectConfigProperty: elbv2.CfnListenerRule.RedirectConfigProperty = {
  statusCode: 'statusCode',

  // the properties below are optional
  host: 'host',
  path: 'path',
  port: 'port',
  protocol: 'protocol',
  query: 'query',
};

Properties

NameTypeDescription
statusCodestringThe HTTP redirect code.
host?stringThe hostname.
path?stringThe absolute path, starting with the leading "/".
port?stringThe port.
protocol?stringThe protocol.
query?stringThe query parameters, URL-encoded when necessary, but not percent-encoded.

statusCode

Type: string

The HTTP redirect code.

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


host?

Type: string (optional)

The hostname.

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


path?

Type: string (optional)

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

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


port?

Type: string (optional)

The port.

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


protocol?

Type: string (optional)

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.


query?

Type: string (optional)

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.