Package org.cdk8s.plus22

Class Ingress

java.lang.Object

software.amazon.jsii.JsiiObject

software.constructs.Construct

org.cdk8s.plus22.Resource

org.cdk8s.plus22.Ingress

All Implemented Interfaces:

IResource, software.amazon.jsii.JsiiSerializable, software.constructs.IConstruct

@Generated(value="jsii-pacmak/1.52.1 (build 5ccc8f6)",
           date="2022-02-08T00:13:45.262Z")
@Stability(Stable)
public class Ingress
extends Resource

Ingress is a collection of rules that allow inbound connections to reach the endpoints defined by a backend.

An Ingress can be configured to give services externally-reachable urls, load balance traffic, terminate SSL, offer name based virtual hosting etc.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	Ingress.Builder	A fluent builder for Ingress.

Nested classes/interfaces inherited from class software.amazon.jsii.JsiiObject

software.amazon.jsii.JsiiObject.InitializationMode

Nested classes/interfaces inherited from interface software.constructs.IConstruct

software.constructs.IConstruct.Jsii$Default

Nested classes/interfaces inherited from interface org.cdk8s.plus22.IResource

IResource.Jsii$Default

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	Ingress(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)
protected	Ingress(software.amazon.jsii.JsiiObjectRef objRef)
	Ingress(software.constructs.Construct scope, String id)
	Ingress(software.constructs.Construct scope, String id, IngressProps props)

Method Summary

Modifier and Type	Method	Description
void	addDefaultBackend(IngressBackend backend)	Defines the default backend for this ingress.
void	addHostDefaultBackend(String host, IngressBackend backend)	Specify a default backend for a specific host name.
void	addHostRule(String host, String path, IngressBackend backend)	Adds an ingress rule applied to requests to a specific host and a specific HTTP path (the `Host` header matches this value).
void	addHostRule(String host, String path, IngressBackend backend, HttpIngressPathType pathType)	Adds an ingress rule applied to requests to a specific host and a specific HTTP path (the `Host` header matches this value).
void	addRule(String path, IngressBackend backend)	Adds an ingress rule applied to requests sent to a specific HTTP path.
void	addRule(String path, IngressBackend backend, HttpIngressPathType pathType)	Adds an ingress rule applied to requests sent to a specific HTTP path.
void	addRules(@NotNull IngressRule... rules)	Adds rules to this ingress.
void	addTls(List<IngressTls> tls)
protected org.cdk8s.ApiObject	getApiObject()	The underlying cdk8s API object.
protected List<String>	onValidate()	(deprecated) Validate the current construct.

Methods inherited from class org.cdk8s.plus22.Resource

getMetadata, getName

Methods inherited from class software.constructs.Construct

onPrepare, onSynthesize, toString

Methods inherited from class software.amazon.jsii.JsiiObject

jsiiAsyncCall, jsiiAsyncCall, jsiiCall, jsiiCall, jsiiGet, jsiiGet, jsiiSet, jsiiStaticCall, jsiiStaticCall, jsiiStaticGet, jsiiStaticGet, jsiiStaticSet, jsiiStaticSet

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Constructor Detail

Ingress

protected Ingress(software.amazon.jsii.JsiiObjectRef objRef)

Ingress

protected Ingress(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)

Ingress

@Stability(Stable)
public Ingress(@NotNull
               software.constructs.Construct scope,
               @NotNull
               String id,
               @Nullable
               IngressProps props)

Parameters:

scope - This parameter is required.

id - This parameter is required.

props -

Ingress

@Stability(Stable)
public Ingress(@NotNull
               software.constructs.Construct scope,
               @NotNull
               String id)

Parameters:

scope - This parameter is required.

id - This parameter is required.

Method Detail

addDefaultBackend

@Stability(Stable)
public void addDefaultBackend(@NotNull
                              IngressBackend backend)

Defines the default backend for this ingress.

A default backend capable of servicing requests that don't match any rule.

Parameters:

backend - The backend to use for requests that do not match any rule. This parameter is required.

addHostDefaultBackend

@Stability(Stable)
public void addHostDefaultBackend(@NotNull
                                  String host,
                                  @NotNull
                                  IngressBackend backend)

Specify a default backend for a specific host name.

This backend will be used as a catch-all for requests targeted to this host name (the Host header matches this value).

Parameters:

host - The host name to match. This parameter is required.

backend - The backend to route to. This parameter is required.

addHostRule

@Stability(Stable)
public void addHostRule(@NotNull
                        String host,
                        @NotNull
                        String path,
                        @NotNull
                        IngressBackend backend,
                        @Nullable
                        HttpIngressPathType pathType)

Adds an ingress rule applied to requests to a specific host and a specific HTTP path (the `Host` header matches this value).

Parameters:

host - The host name. This parameter is required.

path - The HTTP path. This parameter is required.

backend - The backend to route requests to. This parameter is required.

pathType - How the path is matched against request paths.

addHostRule

@Stability(Stable)
public void addHostRule(@NotNull
                        String host,
                        @NotNull
                        String path,
                        @NotNull
                        IngressBackend backend)

Adds an ingress rule applied to requests to a specific host and a specific HTTP path (the `Host` header matches this value).

Parameters:

host - The host name. This parameter is required.

path - The HTTP path. This parameter is required.

backend - The backend to route requests to. This parameter is required.

addRule

@Stability(Stable)
public void addRule(@NotNull
                    String path,
                    @NotNull
                    IngressBackend backend,
                    @Nullable
                    HttpIngressPathType pathType)

Adds an ingress rule applied to requests sent to a specific HTTP path.

Parameters:

path - The HTTP path. This parameter is required.

backend - The backend to route requests to. This parameter is required.

pathType - How the path is matched against request paths.

addRule

@Stability(Stable)
public void addRule(@NotNull
                    String path,
                    @NotNull
                    IngressBackend backend)

Adds an ingress rule applied to requests sent to a specific HTTP path.

Parameters:

path - The HTTP path. This parameter is required.

backend - The backend to route requests to. This parameter is required.

addRules

@Stability(Stable)
public void addRules(@NotNull
                     @NotNull IngressRule... rules)

Adds rules to this ingress.

Parameters:

rules - The rules to add. This parameter is required.

addTls

@Stability(Stable)
public void addTls(@NotNull
                   List<IngressTls> tls)

Parameters:

tls - This parameter is required.

onValidate

@Stability(Stable)
@NotNull
protected List<String> onValidate()

(deprecated) Validate the current construct.

This method can be implemented by derived constructs in order to perform validation logic. It is called on all constructs before synthesis.

Overrides:

onValidate in class software.constructs.Construct

getApiObject

@Stability(Stable)
@NotNull
protected org.cdk8s.ApiObject getApiObject()

The underlying cdk8s API object.

Specified by:

getApiObject in class Resource

See Also:

base.Resource.apiObject