aws-cdk-lib.aws_vpclattice.CfnListenerProps

interface CfnListenerProps

LanguageType name
.NETAmazon.CDK.AWS.VpcLattice.CfnListenerProps
Gogithub.com/aws/aws-cdk-go/awscdk/v2/awsvpclattice#CfnListenerProps
Javasoftware.amazon.awscdk.services.vpclattice.CfnListenerProps
Pythonaws_cdk.aws_vpclattice.CfnListenerProps
TypeScript aws-cdk-lib » aws_vpclattice » CfnListenerProps

Properties for defining a CfnListener.

Example

// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import { aws_vpclattice as vpclattice } from 'aws-cdk-lib';
const cfnListenerProps: vpclattice.CfnListenerProps = {
  defaultAction: {
    fixedResponse: {
      statusCode: 123,
    },
    forward: {
      targetGroups: [{
        targetGroupIdentifier: 'targetGroupIdentifier',

        // the properties below are optional
        weight: 123,
      }],
    },
  },
  protocol: 'protocol',

  // the properties below are optional
  name: 'name',
  port: 123,
  serviceIdentifier: 'serviceIdentifier',
  tags: [{
    key: 'key',
    value: 'value',
  }],
};

Properties

NameTypeDescription
defaultActionIResolvable | DefaultActionPropertyThe action for the default rule.
protocolstringThe listener protocol HTTP or HTTPS.
name?stringThe name of the listener.
port?numberThe listener port.
serviceIdentifier?stringThe ID or Amazon Resource Name (ARN) of the service.
tags?CfnTag[]The tags for the listener.

defaultAction

Type: IResolvable | DefaultActionProperty

The action for the default rule.

Each listener has a default rule. Each rule consists of a priority, one or more actions, and one or more conditions. The default rule is the rule that's used if no other rules match. Each rule must include exactly one of the following types of actions: forward or fixed-response , and it must be the last action to be performed.


protocol

Type: string

The listener protocol HTTP or HTTPS.


name?

Type: string (optional)

The name of the listener.

A listener name must be unique within a service. The valid characters are a-z, 0-9, and hyphens (-). You can't use a hyphen as the first or last character, or immediately after another hyphen.

If you don't specify a name, CloudFormation generates one. However, if you specify a name, and later want to replace the resource, you must specify a new name.


port?

Type: number (optional)

The listener port.

You can specify a value from 1 to 65535 . For HTTP, the default is 80 . For HTTPS, the default is 443 .


serviceIdentifier?

Type: string (optional)

The ID or Amazon Resource Name (ARN) of the service.


tags?

Type: CfnTag[] (optional)

The tags for the listener.