software.amazon.awscdk.services.cloudfront

Class OriginRequestCookieBehavior

java.lang.Object

software.amazon.jsii.JsiiObject

software.amazon.awscdk.services.cloudfront.OriginRequestCookieBehavior

All Implemented Interfaces:

software.amazon.jsii.JsiiSerializable

@Generated(value="jsii-pacmak/1.50.0 (build d1830a4)",
           date="2022-01-11T17:58:48.828Z")
 @Stability(value=Stable)
public class OriginRequestCookieBehavior
extends software.amazon.jsii.JsiiObject

Determines whether any cookies in viewer requests (and if so, which cookies) are included in requests that CloudFront sends to the origin.

Example:

 // Creating a custom origin request policy for a Distribution -- all parameters optional
 S3Origin bucketOrigin;
 OriginRequestPolicy myOriginRequestPolicy = OriginRequestPolicy.Builder.create(this, "OriginRequestPolicy")
         .originRequestPolicyName("MyPolicy")
         .comment("A default policy")
         .cookieBehavior(OriginRequestCookieBehavior.none())
         .headerBehavior(OriginRequestHeaderBehavior.all("CloudFront-Is-Android-Viewer"))
         .queryStringBehavior(OriginRequestQueryStringBehavior.allowList("username"))
         .build();
 Distribution.Builder.create(this, "myDistCustomPolicy")
         .defaultBehavior(BehaviorOptions.builder()
                 .origin(bucketOrigin)
                 .originRequestPolicy(myOriginRequestPolicy)
                 .build())
         .build();
 

Nested Class Summary

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

software.amazon.jsii.JsiiObject.InitializationMode

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	OriginRequestCookieBehavior(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)
protected	OriginRequestCookieBehavior(software.amazon.jsii.JsiiObjectRef objRef)

Method Summary

Modifier and Type	Method and Description
static OriginRequestCookieBehavior	all() All cookies in viewer requests are included in requests that CloudFront sends to the origin.
static OriginRequestCookieBehavior	allowList(String... cookies) Only the provided `cookies` are included in requests that CloudFront sends to the origin.
String	getBehavior() The behavior of cookies: allow all, none or an allow list.
List<String>	getCookies() The cookies to allow, if the behavior is an allow list.
static OriginRequestCookieBehavior	none() Cookies in viewer requests are not included in requests that CloudFront sends to the origin.

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, toString, wait, wait, wait

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Constructor Detail

OriginRequestCookieBehavior

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

OriginRequestCookieBehavior

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

Method Detail

all

@Stability(value=Stable)
 @NotNull
public static OriginRequestCookieBehavior all()

All cookies in viewer requests are included in requests that CloudFront sends to the origin.

allowList

@Stability(value=Stable)
 @NotNull
public static OriginRequestCookieBehavior allowList(@NotNull
                                                                                       String... cookies)

Only the provided `cookies` are included in requests that CloudFront sends to the origin.

Parameters:

cookies - This parameter is required.

none

@Stability(value=Stable)
 @NotNull
public static OriginRequestCookieBehavior none()

Cookies in viewer requests are not included in requests that CloudFront sends to the origin.

Any cookies that are listed in a CachePolicy are still included in origin requests.

getBehavior

@Stability(value=Stable)
 @NotNull
public String getBehavior()

The behavior of cookies: allow all, none or an allow list.

getCookies

@Stability(value=Stable)
 @Nullable
public List<String> getCookies()

The cookies to allow, if the behavior is an allow list.