@Generated(value="jsii-pacmak/1.74.0 (build 6d08790)", date="2023-03-22T19:35:47.051Z") public class CfnListenerRule extends CfnResource implements IInspectable
Specifies a listener rule. The listener must be associated with an Application Load Balancer. Each rule consists of a priority, one or more actions, and one or more conditions.
For more information, see Quotas for your Application Load Balancers in the User Guide for Application Load Balancers .
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.*; CfnListenerRule cfnListenerRule = CfnListenerRule.Builder.create(this, "MyCfnListenerRule") .actions(List.of(ActionProperty.builder() .type("type") // the properties below are optional .authenticateCognitoConfig(AuthenticateCognitoConfigProperty.builder() .userPoolArn("userPoolArn") .userPoolClientId("userPoolClientId") .userPoolDomain("userPoolDomain") // the properties below are optional .authenticationRequestExtraParams(Map.of( "authenticationRequestExtraParamsKey", "authenticationRequestExtraParams")) .onUnauthenticatedRequest("onUnauthenticatedRequest") .scope("scope") .sessionCookieName("sessionCookieName") .sessionTimeout(123) .build()) .authenticateOidcConfig(AuthenticateOidcConfigProperty.builder() .authorizationEndpoint("authorizationEndpoint") .clientId("clientId") .issuer("issuer") .tokenEndpoint("tokenEndpoint") .userInfoEndpoint("userInfoEndpoint") // the properties below are optional .authenticationRequestExtraParams(Map.of( "authenticationRequestExtraParamsKey", "authenticationRequestExtraParams")) .clientSecret("clientSecret") .onUnauthenticatedRequest("onUnauthenticatedRequest") .scope("scope") .sessionCookieName("sessionCookieName") .sessionTimeout(123) .useExistingClientSecret(false) .build()) .fixedResponseConfig(FixedResponseConfigProperty.builder() .statusCode("statusCode") // the properties below are optional .contentType("contentType") .messageBody("messageBody") .build()) .forwardConfig(ForwardConfigProperty.builder() .targetGroups(List.of(TargetGroupTupleProperty.builder() .targetGroupArn("targetGroupArn") .weight(123) .build())) .targetGroupStickinessConfig(TargetGroupStickinessConfigProperty.builder() .durationSeconds(123) .enabled(false) .build()) .build()) .order(123) .redirectConfig(RedirectConfigProperty.builder() .statusCode("statusCode") // the properties below are optional .host("host") .path("path") .port("port") .protocol("protocol") .query("query") .build()) .targetGroupArn("targetGroupArn") .build())) .conditions(List.of(RuleConditionProperty.builder() .field("field") .hostHeaderConfig(HostHeaderConfigProperty.builder() .values(List.of("values")) .build()) .httpHeaderConfig(HttpHeaderConfigProperty.builder() .httpHeaderName("httpHeaderName") .values(List.of("values")) .build()) .httpRequestMethodConfig(HttpRequestMethodConfigProperty.builder() .values(List.of("values")) .build()) .pathPatternConfig(PathPatternConfigProperty.builder() .values(List.of("values")) .build()) .queryStringConfig(QueryStringConfigProperty.builder() .values(List.of(QueryStringKeyValueProperty.builder() .key("key") .value("value") .build())) .build()) .sourceIpConfig(SourceIpConfigProperty.builder() .values(List.of("values")) .build()) .values(List.of("values")) .build())) .priority(123) // the properties below are optional .listenerArn("listenerArn") .build();
Modifier and Type | Class and Description |
---|---|
static interface |
CfnListenerRule.ActionProperty
Specifies an action for a listener rule.
|
static interface |
CfnListenerRule.AuthenticateCognitoConfigProperty
Specifies information required when integrating with Amazon Cognito to authenticate users.
|
static interface |
CfnListenerRule.AuthenticateOidcConfigProperty
Specifies information required using an identity provide (IdP) that is compliant with OpenID Connect (OIDC) to authenticate users.
|
static class |
CfnListenerRule.Builder
A fluent builder for
CfnListenerRule . |
static interface |
CfnListenerRule.FixedResponseConfigProperty
Specifies information required when returning a custom HTTP response.
|
static interface |
CfnListenerRule.ForwardConfigProperty
Information for creating an action that distributes requests among one or more target groups.
|
static interface |
CfnListenerRule.HostHeaderConfigProperty
Information about a host header condition.
|
static interface |
CfnListenerRule.HttpHeaderConfigProperty
Information about an HTTP header condition.
|
static interface |
CfnListenerRule.HttpRequestMethodConfigProperty
Information about an HTTP method condition.
|
static interface |
CfnListenerRule.PathPatternConfigProperty
Information about a path pattern condition.
|
static interface |
CfnListenerRule.QueryStringConfigProperty
Information about a query string condition.
|
static interface |
CfnListenerRule.QueryStringKeyValueProperty
Information about a key/value pair.
|
static interface |
CfnListenerRule.RedirectConfigProperty
Information about a redirect action.
|
static interface |
CfnListenerRule.RuleConditionProperty
Specifies a condition for a listener rule.
|
static interface |
CfnListenerRule.SourceIpConfigProperty
Information about a source IP condition.
|
static interface |
CfnListenerRule.TargetGroupStickinessConfigProperty
Information about the target group stickiness for a rule.
|
static interface |
CfnListenerRule.TargetGroupTupleProperty
Information about how traffic will be distributed between multiple target groups in a forward rule.
|
IInspectable.Jsii$Default, IInspectable.Jsii$Proxy
IConstruct.Jsii$Default
Modifier and Type | Field and Description |
---|---|
static java.lang.String |
CFN_RESOURCE_TYPE_NAME
The CloudFormation resource type name for this resource class.
|
Modifier | Constructor and Description |
---|---|
|
CfnListenerRule(Construct scope,
java.lang.String id,
CfnListenerRuleProps props)
Create a new `AWS::ElasticLoadBalancingV2::ListenerRule`.
|
protected |
CfnListenerRule(software.amazon.jsii.JsiiObject.InitializationMode initializationMode) |
protected |
CfnListenerRule(software.amazon.jsii.JsiiObjectRef objRef) |
Modifier and Type | Method and Description |
---|---|
java.lang.Object |
getActions()
The actions.
|
IResolvable |
getAttrIsDefault()
Indicates whether this is the default rule.
|
java.lang.String |
getAttrRuleArn()
The Amazon Resource Name (ARN) of the rule.
|
protected java.util.Map<java.lang.String,java.lang.Object> |
getCfnProperties() |
java.lang.Object |
getConditions()
The conditions.
|
java.lang.String |
getListenerArn()
The Amazon Resource Name (ARN) of the listener.
|
java.lang.Number |
getPriority()
The rule priority.
|
void |
inspect(TreeInspector inspector)
Examines the CloudFormation resource and discloses attributes.
|
protected java.util.Map<java.lang.String,java.lang.Object> |
renderProperties(java.util.Map<java.lang.String,java.lang.Object> props) |
void |
setActions(IResolvable value)
The actions.
|
void |
setActions(java.util.List<java.lang.Object> value)
The actions.
|
void |
setConditions(IResolvable value)
The conditions.
|
void |
setConditions(java.util.List<java.lang.Object> value)
The conditions.
|
void |
setListenerArn(java.lang.String value)
The Amazon Resource Name (ARN) of the listener.
|
void |
setPriority(java.lang.Number value)
The rule priority.
|
addDeletionOverride, addDependsOn, addMetadata, addOverride, addPropertyDeletionOverride, addPropertyOverride, applyRemovalPolicy, applyRemovalPolicy, applyRemovalPolicy, getAtt, getCfnOptions, getCfnResourceType, getMetadata, getUpdatedProperites, isCfnResource, shouldSynthesize, toString, validateProperties
getRef
getCreationStack, getLogicalId, getStack, isCfnElement, overrideLogicalId
getNode, isConstruct, onPrepare, onSynthesize, onValidate, prepare, synthesize, validate
public static final java.lang.String CFN_RESOURCE_TYPE_NAME
protected CfnListenerRule(software.amazon.jsii.JsiiObjectRef objRef)
protected CfnListenerRule(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)
public CfnListenerRule(Construct scope, java.lang.String id, CfnListenerRuleProps props)
scope
- - scope in which this resource is defined. This parameter is required.id
- - scoped id of the resource. This parameter is required.props
- - resource properties. This parameter is required.public void inspect(TreeInspector inspector)
inspect
in interface IInspectable
inspector
- - tree inspector to collect and process attributes. This parameter is required.protected java.util.Map<java.lang.String,java.lang.Object> renderProperties(java.util.Map<java.lang.String,java.lang.Object> props)
renderProperties
in class CfnResource
props
- This parameter is required.public IResolvable getAttrIsDefault()
public java.lang.String getAttrRuleArn()
protected java.util.Map<java.lang.String,java.lang.Object> getCfnProperties()
getCfnProperties
in class CfnResource
public java.lang.Object getActions()
The rule must include exactly one of the following types of actions: forward
, fixed-response
, or redirect
, and it must be the last action to be performed. If the rule is for an HTTPS listener, it can also optionally include an authentication action.
public void setActions(IResolvable value)
The rule must include exactly one of the following types of actions: forward
, fixed-response
, or redirect
, and it must be the last action to be performed. If the rule is for an HTTPS listener, it can also optionally include an authentication action.
public void setActions(java.util.List<java.lang.Object> value)
The rule must include exactly one of the following types of actions: forward
, fixed-response
, or redirect
, and it must be the last action to be performed. If the rule is for an HTTPS listener, it can also optionally include an authentication action.
public java.lang.Object getConditions()
The rule can optionally include up to one of each of the following conditions: http-request-method
, host-header
, path-pattern
, and source-ip
. A rule can also optionally include one or more of each of the following conditions: http-header
and query-string
.
public void setConditions(IResolvable value)
The rule can optionally include up to one of each of the following conditions: http-request-method
, host-header
, path-pattern
, and source-ip
. A rule can also optionally include one or more of each of the following conditions: http-header
and query-string
.
public void setConditions(java.util.List<java.lang.Object> value)
The rule can optionally include up to one of each of the following conditions: http-request-method
, host-header
, path-pattern
, and source-ip
. A rule can also optionally include one or more of each of the following conditions: http-header
and query-string
.
public java.lang.Number getPriority()
If you try to reorder rules by updating their priorities, do not specify a new priority if an existing rule already uses this priority, as this can cause an error. If you need to reuse a priority with a different rule, you must remove it as a priority first, and then specify it in a subsequent update.
public void setPriority(java.lang.Number value)
If you try to reorder rules by updating their priorities, do not specify a new priority if an existing rule already uses this priority, as this can cause an error. If you need to reuse a priority with a different rule, you must remove it as a priority first, and then specify it in a subsequent update.
public java.lang.String getListenerArn()
public void setListenerArn(java.lang.String value)