software.amazon.awscdk.services.cloudfront

Class OriginAccessIdentity

java.lang.Object

software.amazon.jsii.JsiiObject

software.constructs.Construct

software.amazon.awscdk.Resource

software.amazon.awscdk.services.cloudfront.OriginAccessIdentity

All Implemented Interfaces:

IResource, IOriginAccessIdentity, IGrantable, software.amazon.jsii.JsiiSerializable, software.constructs.IConstruct, software.constructs.IDependable

@Generated(value="jsii-pacmak/1.63.2 (build a8a8833)",
           date="2022-08-08T20:48:11.369Z")
 @Stability(value=Stable)
public class OriginAccessIdentity
extends Resource
implements IOriginAccessIdentity

An origin access identity is a special CloudFront user that you can associate with Amazon S3 origins, so that you can secure all or just some of your Amazon S3 content.

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.cloudfront.*;
 OriginAccessIdentity originAccessIdentity = OriginAccessIdentity.Builder.create(this, "MyOriginAccessIdentity")
         .comment("comment")
         .build();
 

Nested Class Summary

Nested Classes

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

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

software.amazon.jsii.JsiiObject.InitializationMode

Nested classes/interfaces inherited from interface software.amazon.awscdk.services.cloudfront.IOriginAccessIdentity

IOriginAccessIdentity.Jsii$Default, IOriginAccessIdentity.Jsii$Proxy

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method and Description
protected String	arn() The ARN to include in S3 bucket policy to allow CloudFront access.
static IOriginAccessIdentity	fromOriginAccessIdentityId(software.constructs.Construct scope, String id, String originAccessIdentityId) Creates a OriginAccessIdentity by providing the OriginAccessIdentityId.
static IOriginAccessIdentity	fromOriginAccessIdentityName(software.constructs.Construct scope, String id, String originAccessIdentityName) Deprecated. use `fromOriginAccessIdentityId`
String	getCloudFrontOriginAccessIdentityS3CanonicalUserId() The Amazon S3 canonical user ID for the origin access identity, used when giving the origin access identity read permission to an object in Amazon S3.
IPrincipal	getGrantPrincipal() Derived principal value for bucket access.
String	getOriginAccessIdentityId() The Origin Access Identity Id (physical id) This was called originAccessIdentityName before.
String	getOriginAccessIdentityName() Deprecated. use originAccessIdentityId instead

Methods inherited from class software.amazon.awscdk.Resource

applyRemovalPolicy, generatePhysicalName, getEnv, getPhysicalName, getResourceArnAttribute, getResourceNameAttribute, getStack, isOwnedResource, isResource

Methods inherited from class software.constructs.Construct

getNode, isConstruct, 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.awscdk.IResource

applyRemovalPolicy, getEnv, getStack

Methods inherited from interface software.constructs.IConstruct

getNode

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Constructor Detail

OriginAccessIdentity

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

OriginAccessIdentity

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

OriginAccessIdentity

@Stability(value=Stable)
public OriginAccessIdentity(@NotNull
                                                     software.constructs.Construct scope,
                                                     @NotNull
                                                     String id,
                                                     @Nullable
                                                     OriginAccessIdentityProps props)

Parameters:

scope - This parameter is required.

id - This parameter is required.

props -

OriginAccessIdentity

@Stability(value=Stable)
public OriginAccessIdentity(@NotNull
                                                     software.constructs.Construct scope,
                                                     @NotNull
                                                     String id)

Parameters:

scope - This parameter is required.

id - This parameter is required.

Method Detail

fromOriginAccessIdentityId

@Stability(value=Stable)
 @NotNull
public static IOriginAccessIdentity fromOriginAccessIdentityId(@NotNull
                                                                                                  software.constructs.Construct scope,
                                                                                                  @NotNull
                                                                                                  String id,
                                                                                                  @NotNull
                                                                                                  String originAccessIdentityId)

Creates a OriginAccessIdentity by providing the OriginAccessIdentityId.

Parameters:

scope - This parameter is required.

id - This parameter is required.

originAccessIdentityId - This parameter is required.

fromOriginAccessIdentityName

@Stability(value=Deprecated)
 @Deprecated
 @NotNull
public static IOriginAccessIdentity fromOriginAccessIdentityName(@NotNull
                                                                                                                     software.constructs.Construct scope,
                                                                                                                     @NotNull
                                                                                                                     String id,
                                                                                                                     @NotNull
                                                                                                                     String originAccessIdentityName)

Deprecated. use `fromOriginAccessIdentityId`

(deprecated) Creates a OriginAccessIdentity by providing the OriginAccessIdentityId.

It is misnamed and superseded by the correctly named fromOriginAccessIdentityId.

Parameters:

scope - This parameter is required.

id - This parameter is required.

originAccessIdentityName - This parameter is required.

arn

@Stability(value=Stable)
 @NotNull
protected String arn()

The ARN to include in S3 bucket policy to allow CloudFront access.

getCloudFrontOriginAccessIdentityS3CanonicalUserId

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

The Amazon S3 canonical user ID for the origin access identity, used when giving the origin access identity read permission to an object in Amazon S3.

getGrantPrincipal

@Stability(value=Stable)
 @NotNull
public IPrincipal getGrantPrincipal()

Derived principal value for bucket access.

Specified by:

getGrantPrincipal in interface IGrantable

getOriginAccessIdentityId

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

The Origin Access Identity Id (physical id) This was called originAccessIdentityName before.

Specified by:

getOriginAccessIdentityId in interface IOriginAccessIdentity

getOriginAccessIdentityName

@Stability(value=Deprecated)
 @Deprecated
 @NotNull
public String getOriginAccessIdentityName()

Deprecated. use originAccessIdentityId instead

(deprecated) The Origin Access Identity Id (physical id) It is misnamed and superseded by the correctly named originAccessIdentityId.

Specified by:

getOriginAccessIdentityName in interface IOriginAccessIdentity