software.amazon.awscdk.services.ecr

Class RepositoryBase

java.lang.Object

software.amazon.jsii.JsiiObject

software.constructs.Construct

software.amazon.awscdk.Resource

software.amazon.awscdk.services.ecr.RepositoryBase

All Implemented Interfaces:

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

Direct Known Subclasses:

Repository

@Generated(value="jsii-pacmak/1.30.0 (build adae23f)",
           date="2021-06-30T10:01:06.707Z")
 @Stability(value=Experimental)
public abstract class RepositoryBase
extends Resource
implements IRepository

(experimental) Base class for ECR repository.

Reused between imported repositories and owned repositories.

Nested Class Summary

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.ecr.IRepository

IRepository.Jsii$Default

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method and Description
abstract AddToResourcePolicyResult	addToResourcePolicy(PolicyStatement statement) (experimental) Add a policy statement to the repository's resource policy.
abstract String	getRepositoryArn() (experimental) The ARN of the repository.
abstract String	getRepositoryName() (experimental) The name of the repository.
String	getRepositoryUri() (experimental) The URI of this repository (represents the latest image):.
Grant	grant(IGrantable grantee, String... actions) (experimental) Grant the given principal identity permissions to perform the actions on this repository.
Grant	grantPull(IGrantable grantee) (experimental) Grant the given identity permissions to use the images in this repository.
Grant	grantPullPush(IGrantable grantee) (experimental) Grant the given identity permissions to pull and push images to this repository.
Rule	onCloudTrailEvent(String id) (experimental) Define a CloudWatch event that triggers when something happens to this repository.
Rule	onCloudTrailEvent(String id, OnEventOptions options) (experimental) Define a CloudWatch event that triggers when something happens to this repository.
Rule	onCloudTrailImagePushed(String id) (experimental) Defines an AWS CloudWatch event rule that can trigger a target when an image is pushed to this repository.
Rule	onCloudTrailImagePushed(String id, OnCloudTrailImagePushedOptions options) (experimental) Defines an AWS CloudWatch event rule that can trigger a target when an image is pushed to this repository.
Rule	onEvent(String id) (experimental) Defines a CloudWatch event rule which triggers for repository events.
Rule	onEvent(String id, OnEventOptions options) (experimental) Defines a CloudWatch event rule which triggers for repository events.
Rule	onImageScanCompleted(String id) (experimental) Defines an AWS CloudWatch event rule that can trigger a target when an image scan is completed.
Rule	onImageScanCompleted(String id, OnImageScanCompletedOptions options) (experimental) Defines an AWS CloudWatch event rule that can trigger a target when an image scan is completed.
String	repositoryUriForDigest() (experimental) Returns the URL of the repository.
String	repositoryUriForDigest(String digest) (experimental) Returns the URL of the repository.
String	repositoryUriForTag() (experimental) Returns the URL of the repository.
String	repositoryUriForTag(String tag) (experimental) Returns the URL of the repository.

Methods inherited from class software.amazon.awscdk.Resource

applyRemovalPolicy, generatePhysicalName, getEnv, getPhysicalName, getResourceArnAttribute, getResourceNameAttribute, getStack, 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

getEnv, getStack

Methods inherited from interface software.constructs.IConstruct

getNode

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Constructor Detail

RepositoryBase

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

RepositoryBase

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

RepositoryBase

@Stability(value=Experimental)
protected RepositoryBase(@NotNull
                                                        software.constructs.Construct scope,
                                                        @NotNull
                                                        String id,
                                                        @Nullable
                                                        ResourceProps props)

Parameters:

scope - This parameter is required.

id - This parameter is required.

props -

RepositoryBase

@Stability(value=Experimental)
protected RepositoryBase(@NotNull
                                                        software.constructs.Construct scope,
                                                        @NotNull
                                                        String id)

Parameters:

scope - This parameter is required.

id - This parameter is required.

Method Detail

addToResourcePolicy

@Stability(value=Experimental)
 @NotNull
public abstract AddToResourcePolicyResult addToResourcePolicy(@NotNull
                                                                                                       PolicyStatement statement)

(experimental) Add a policy statement to the repository's resource policy.

Specified by:

addToResourcePolicy in interface IRepository

Parameters:

statement - This parameter is required.

grant

@Stability(value=Experimental)
 @NotNull
public Grant grant(@NotNull
                                                            IGrantable grantee,
                                                            @NotNull
                                                            String... actions)

(experimental) Grant the given principal identity permissions to perform the actions on this repository.

Specified by:

grant in interface IRepository

Parameters:

grantee - This parameter is required.

actions - This parameter is required.

grantPull

@Stability(value=Experimental)
 @NotNull
public Grant grantPull(@NotNull
                                                                IGrantable grantee)

(experimental) Grant the given identity permissions to use the images in this repository.

Specified by:

grantPull in interface IRepository

Parameters:

grantee - This parameter is required.

grantPullPush

@Stability(value=Experimental)
 @NotNull
public Grant grantPullPush(@NotNull
                                                                    IGrantable grantee)

(experimental) Grant the given identity permissions to pull and push images to this repository.

Specified by:

grantPullPush in interface IRepository

Parameters:

grantee - This parameter is required.

onCloudTrailEvent

@Stability(value=Experimental)
 @NotNull
public Rule onCloudTrailEvent(@NotNull
                                                                       String id,
                                                                       @Nullable
                                                                       OnEventOptions options)

(experimental) Define a CloudWatch event that triggers when something happens to this repository.

Requires that there exists at least one CloudTrail Trail in your account that captures the event. This method will not create the Trail.

Specified by:

onCloudTrailEvent in interface IRepository

Parameters:

id - The id of the rule. This parameter is required.

options - Options for adding the rule.

onCloudTrailEvent

@Stability(value=Experimental)
 @NotNull
public Rule onCloudTrailEvent(@NotNull
                                                                       String id)

(experimental) Define a CloudWatch event that triggers when something happens to this repository.

Requires that there exists at least one CloudTrail Trail in your account that captures the event. This method will not create the Trail.

Specified by:

onCloudTrailEvent in interface IRepository

Parameters:

id - The id of the rule. This parameter is required.

onCloudTrailImagePushed

@Stability(value=Experimental)
 @NotNull
public Rule onCloudTrailImagePushed(@NotNull
                                                                             String id,
                                                                             @Nullable
                                                                             OnCloudTrailImagePushedOptions options)

(experimental) Defines an AWS CloudWatch event rule that can trigger a target when an image is pushed to this repository.

Requires that there exists at least one CloudTrail Trail in your account that captures the event. This method will not create the Trail.

Specified by:

onCloudTrailImagePushed in interface IRepository

Parameters:

id - The id of the rule. This parameter is required.

options - Options for adding the rule.

onCloudTrailImagePushed

@Stability(value=Experimental)
 @NotNull
public Rule onCloudTrailImagePushed(@NotNull
                                                                             String id)

(experimental) Defines an AWS CloudWatch event rule that can trigger a target when an image is pushed to this repository.

Requires that there exists at least one CloudTrail Trail in your account that captures the event. This method will not create the Trail.

Specified by:

onCloudTrailImagePushed in interface IRepository

Parameters:

id - The id of the rule. This parameter is required.

onEvent

@Stability(value=Experimental)
 @NotNull
public Rule onEvent(@NotNull
                                                             String id,
                                                             @Nullable
                                                             OnEventOptions options)

(experimental) Defines a CloudWatch event rule which triggers for repository events.

Use rule.addEventPattern(pattern) to specify a filter.

Specified by:

onEvent in interface IRepository

Parameters:

id - This parameter is required.

options -

onEvent

@Stability(value=Experimental)
 @NotNull
public Rule onEvent(@NotNull
                                                             String id)

(experimental) Defines a CloudWatch event rule which triggers for repository events.

Use rule.addEventPattern(pattern) to specify a filter.

Specified by:

onEvent in interface IRepository

Parameters:

id - This parameter is required.

onImageScanCompleted

@Stability(value=Experimental)
 @NotNull
public Rule onImageScanCompleted(@NotNull
                                                                          String id,
                                                                          @Nullable
                                                                          OnImageScanCompletedOptions options)

(experimental) Defines an AWS CloudWatch event rule that can trigger a target when an image scan is completed.

Specified by:

onImageScanCompleted in interface IRepository

Parameters:

id - The id of the rule. This parameter is required.

options - Options for adding the rule.

onImageScanCompleted

@Stability(value=Experimental)
 @NotNull
public Rule onImageScanCompleted(@NotNull
                                                                          String id)

(experimental) Defines an AWS CloudWatch event rule that can trigger a target when an image scan is completed.

Specified by:

onImageScanCompleted in interface IRepository

Parameters:

id - The id of the rule. This parameter is required.

repositoryUriForDigest

@Stability(value=Experimental)
 @NotNull
public String repositoryUriForDigest(@Nullable
                                                                              String digest)

(experimental) Returns the URL of the repository. Can be used in `docker push/pull`.

ACCOUNT.dkr.ecr.REGION.amazonaws.com/REPOSITORY[@DIGEST]

Specified by:

repositoryUriForDigest in interface IRepository

Parameters:

digest - Optional image digest.

repositoryUriForDigest

@Stability(value=Experimental)
 @NotNull
public String repositoryUriForDigest()

(experimental) Returns the URL of the repository. Can be used in `docker push/pull`.

ACCOUNT.dkr.ecr.REGION.amazonaws.com/REPOSITORY[@DIGEST]

Specified by:

repositoryUriForDigest in interface IRepository

repositoryUriForTag

@Stability(value=Experimental)
 @NotNull
public String repositoryUriForTag(@Nullable
                                                                           String tag)

(experimental) Returns the URL of the repository. Can be used in `docker push/pull`.

ACCOUNT.dkr.ecr.REGION.amazonaws.com/REPOSITORY[:TAG]

Specified by:

repositoryUriForTag in interface IRepository

Parameters:

tag - Optional image tag.

repositoryUriForTag

@Stability(value=Experimental)
 @NotNull
public String repositoryUriForTag()

(experimental) Returns the URL of the repository. Can be used in `docker push/pull`.

ACCOUNT.dkr.ecr.REGION.amazonaws.com/REPOSITORY[:TAG]

Specified by:

repositoryUriForTag in interface IRepository

getRepositoryArn

@Stability(value=Experimental)
 @NotNull
public abstract String getRepositoryArn()

(experimental) The ARN of the repository.

Specified by:

getRepositoryArn in interface IRepository

getRepositoryName

@Stability(value=Experimental)
 @NotNull
public abstract String getRepositoryName()

(experimental) The name of the repository.

Specified by:

getRepositoryName in interface IRepository

getRepositoryUri

@Stability(value=Experimental)
 @NotNull
public String getRepositoryUri()

(experimental) The URI of this repository (represents the latest image):.

ACCOUNT.dkr.ecr.REGION.amazonaws.com/REPOSITORY

Specified by:

getRepositoryUri in interface IRepository