RepositoryEvents

class aws_cdk.mixins_preview.aws_ecr.events.RepositoryEvents(*args: Any, **kwargs)

Bases: object

(experimental) EventBridge event patterns for Repository.

Stability:

experimental

ExampleMetadata:

fixture=_generated

Example:

# The code below shows an example of how to instantiate this type.
# The values are placeholders you should change.
from aws_cdk.mixins_preview.aws_ecr import events as ecr_events
from aws_cdk.interfaces import aws_ecr as interfaces_ecr

# repository_ref: interfaces_ecr.IRepositoryRef

repository_events = ecr_events.RepositoryEvents.from_repository(repository_ref)

Methods

aws_api_call_via_cloud_trail_pattern(*, aws_region=None, event_id=None, event_metadata=None, event_name=None, event_source=None, event_time=None, event_type=None, event_version=None, request_id=None, request_parameters=None, resources=None, response_elements=None, source_ip_address=None, user_agent=None, user_identity=None)

(experimental) EventBridge event pattern for Repository AWS API Call via CloudTrail.

Parameters:
  • aws_region (Optional[Sequence[str]]) – (experimental) awsRegion property. Specify an array of string values to match this event if the actual value of awsRegion is one of the values in the array. Use one of the constructors on the aws_events.Match for more advanced matching options. Default: - Do not filter on this field

  • event_id (Optional[Sequence[str]]) – (experimental) eventID property. Specify an array of string values to match this event if the actual value of eventID is one of the values in the array. Use one of the constructors on the aws_events.Match for more advanced matching options. Default: - Do not filter on this field

  • event_metadata (Union[AWSEventMetadataProps, Dict[str, Any], None]) – (experimental) EventBridge event metadata. Default: - -

  • event_name (Optional[Sequence[str]]) – (experimental) eventName property. Specify an array of string values to match this event if the actual value of eventName is one of the values in the array. Use one of the constructors on the aws_events.Match for more advanced matching options. Default: - Do not filter on this field

  • event_source (Optional[Sequence[str]]) – (experimental) eventSource property. Specify an array of string values to match this event if the actual value of eventSource is one of the values in the array. Use one of the constructors on the aws_events.Match for more advanced matching options. Default: - Do not filter on this field

  • event_time (Optional[Sequence[str]]) – (experimental) eventTime property. Specify an array of string values to match this event if the actual value of eventTime is one of the values in the array. Use one of the constructors on the aws_events.Match for more advanced matching options. Default: - Do not filter on this field

  • event_type (Optional[Sequence[str]]) – (experimental) eventType property. Specify an array of string values to match this event if the actual value of eventType is one of the values in the array. Use one of the constructors on the aws_events.Match for more advanced matching options. Default: - Do not filter on this field

  • event_version (Optional[Sequence[str]]) – (experimental) eventVersion property. Specify an array of string values to match this event if the actual value of eventVersion is one of the values in the array. Use one of the constructors on the aws_events.Match for more advanced matching options. Default: - Do not filter on this field

  • request_id (Optional[Sequence[str]]) – (experimental) requestID property. Specify an array of string values to match this event if the actual value of requestID is one of the values in the array. Use one of the constructors on the aws_events.Match for more advanced matching options. Default: - Do not filter on this field

  • request_parameters (Union[RequestParameters, Dict[str, Any], None]) – (experimental) requestParameters property. Specify an array of string values to match this event if the actual value of requestParameters is one of the values in the array. Use one of the constructors on the aws_events.Match for more advanced matching options. Default: - Do not filter on this field

  • resources (Optional[Sequence[Union[AwsapiCallViaCloudTrailItem, Dict[str, Any]]]]) – (experimental) resources property. Specify an array of string values to match this event if the actual value of resources is one of the values in the array. Use one of the constructors on the aws_events.Match for more advanced matching options. Default: - Do not filter on this field

  • response_elements (Optional[Sequence[str]]) – (experimental) responseElements property. Specify an array of string values to match this event if the actual value of responseElements is one of the values in the array. Use one of the constructors on the aws_events.Match for more advanced matching options. Default: - Do not filter on this field

  • source_ip_address (Optional[Sequence[str]]) – (experimental) sourceIPAddress property. Specify an array of string values to match this event if the actual value of sourceIPAddress is one of the values in the array. Use one of the constructors on the aws_events.Match for more advanced matching options. Default: - Do not filter on this field

  • user_agent (Optional[Sequence[str]]) – (experimental) userAgent property. Specify an array of string values to match this event if the actual value of userAgent is one of the values in the array. Use one of the constructors on the aws_events.Match for more advanced matching options. Default: - Do not filter on this field

  • user_identity (Union[UserIdentity, Dict[str, Any], None]) – (experimental) userIdentity property. Specify an array of string values to match this event if the actual value of userIdentity is one of the values in the array. Use one of the constructors on the aws_events.Match for more advanced matching options. Default: - Do not filter on this field

Stability:

experimental

Return type:

EventPattern

ecr_image_action_pattern(*, action_type=None, artifact_media_type=None, event_metadata=None, image_digest=None, image_tag=None, last_activated_at=None, manifest_media_type=None, repository_name=None, result=None, target_storage_class=None)

(experimental) EventBridge event pattern for Repository ECR Image Action.

Parameters:
  • action_type (Optional[Sequence[str]]) – (experimental) action-type property. Specify an array of string values to match this event if the actual value of action-type is one of the values in the array. Use one of the constructors on the aws_events.Match for more advanced matching options. Default: - Do not filter on this field

  • artifact_media_type (Optional[Sequence[str]]) – (experimental) artifact-media-type property. Specify an array of string values to match this event if the actual value of artifact-media-type is one of the values in the array. Use one of the constructors on the aws_events.Match for more advanced matching options. Default: - Do not filter on this field

  • event_metadata (Union[AWSEventMetadataProps, Dict[str, Any], None]) – (experimental) EventBridge event metadata. Default: - -

  • image_digest (Optional[Sequence[str]]) – (experimental) image-digest property. Specify an array of string values to match this event if the actual value of image-digest is one of the values in the array. Use one of the constructors on the aws_events.Match for more advanced matching options. Default: - Do not filter on this field

  • image_tag (Optional[Sequence[str]]) – (experimental) image-tag property. Specify an array of string values to match this event if the actual value of image-tag is one of the values in the array. Use one of the constructors on the aws_events.Match for more advanced matching options. Default: - Do not filter on this field

  • last_activated_at (Optional[Sequence[str]]) – (experimental) last-activated-at property. Specify an array of string values to match this event if the actual value of last-activated-at is one of the values in the array. Use one of the constructors on the aws_events.Match for more advanced matching options. Default: - Do not filter on this field

  • manifest_media_type (Optional[Sequence[str]]) – (experimental) manifest-media-type property. Specify an array of string values to match this event if the actual value of manifest-media-type is one of the values in the array. Use one of the constructors on the aws_events.Match for more advanced matching options. Default: - Do not filter on this field

  • repository_name (Optional[Sequence[str]]) – (experimental) repository-name property. Specify an array of string values to match this event if the actual value of repository-name is one of the values in the array. Use one of the constructors on the aws_events.Match for more advanced matching options. Default: - Filter with the Repository reference

  • result (Optional[Sequence[str]]) – (experimental) result property. Specify an array of string values to match this event if the actual value of result is one of the values in the array. Use one of the constructors on the aws_events.Match for more advanced matching options. Default: - Do not filter on this field

  • target_storage_class (Optional[Sequence[str]]) – (experimental) target-storage-class property. Specify an array of string values to match this event if the actual value of target-storage-class is one of the values in the array. Use one of the constructors on the aws_events.Match for more advanced matching options. Default: - Do not filter on this field

Stability:

experimental

Return type:

EventPattern

ecr_image_scan_pattern(*, event_metadata=None, finding_severity_counts=None, image_digest=None, image_tags=None, repository_name=None, scan_status=None)

(experimental) EventBridge event pattern for Repository ECR Image Scan.

Parameters:
  • event_metadata (Union[AWSEventMetadataProps, Dict[str, Any], None]) – (experimental) EventBridge event metadata. Default: - -

  • finding_severity_counts (Union[FindingSeverityCounts, Dict[str, Any], None]) – (experimental) finding-severity-counts property. Specify an array of string values to match this event if the actual value of finding-severity-counts is one of the values in the array. Use one of the constructors on the aws_events.Match for more advanced matching options. Default: - Do not filter on this field

  • image_digest (Optional[Sequence[str]]) – (experimental) image-digest property. Specify an array of string values to match this event if the actual value of image-digest is one of the values in the array. Use one of the constructors on the aws_events.Match for more advanced matching options. Default: - Do not filter on this field

  • image_tags (Optional[Sequence[str]]) – (experimental) image-tags property. Specify an array of string values to match this event if the actual value of image-tags is one of the values in the array. Use one of the constructors on the aws_events.Match for more advanced matching options. Default: - Do not filter on this field

  • repository_name (Optional[Sequence[str]]) – (experimental) repository-name property. Specify an array of string values to match this event if the actual value of repository-name is one of the values in the array. Use one of the constructors on the aws_events.Match for more advanced matching options. Default: - Filter with the Repository reference

  • scan_status (Optional[Sequence[str]]) – (experimental) scan-status property. Specify an array of string values to match this event if the actual value of scan-status is one of the values in the array. Use one of the constructors on the aws_events.Match for more advanced matching options. Default: - Do not filter on this field

Stability:

experimental

Return type:

EventPattern

ecr_pull_through_cache_action_pattern(*, ecr_repository_prefix=None, event_metadata=None, failure_code=None, failure_reason=None, image_digest=None, image_tag=None, repository_name=None, sync_status=None, upstream_registry_url=None)

(experimental) EventBridge event pattern for Repository ECR Pull Through Cache Action.

Parameters:
  • ecr_repository_prefix (Optional[Sequence[str]]) – (experimental) ecr-repository-prefix property. Specify an array of string values to match this event if the actual value of ecr-repository-prefix is one of the values in the array. Use one of the constructors on the aws_events.Match for more advanced matching options. Default: - Do not filter on this field

  • event_metadata (Union[AWSEventMetadataProps, Dict[str, Any], None]) – (experimental) EventBridge event metadata. Default: - -

  • failure_code (Optional[Sequence[str]]) – (experimental) failure-code property. Specify an array of string values to match this event if the actual value of failure-code is one of the values in the array. Use one of the constructors on the aws_events.Match for more advanced matching options. Default: - Do not filter on this field

  • failure_reason (Optional[Sequence[str]]) – (experimental) failure-reason property. Specify an array of string values to match this event if the actual value of failure-reason is one of the values in the array. Use one of the constructors on the aws_events.Match for more advanced matching options. Default: - Do not filter on this field

  • image_digest (Optional[Sequence[str]]) – (experimental) image-digest property. Specify an array of string values to match this event if the actual value of image-digest is one of the values in the array. Use one of the constructors on the aws_events.Match for more advanced matching options. Default: - Do not filter on this field

  • image_tag (Optional[Sequence[str]]) – (experimental) image-tag property. Specify an array of string values to match this event if the actual value of image-tag is one of the values in the array. Use one of the constructors on the aws_events.Match for more advanced matching options. Default: - Do not filter on this field

  • repository_name (Optional[Sequence[str]]) – (experimental) repository-name property. Specify an array of string values to match this event if the actual value of repository-name is one of the values in the array. Use one of the constructors on the aws_events.Match for more advanced matching options. Default: - Filter with the Repository reference

  • sync_status (Optional[Sequence[str]]) – (experimental) sync-status property. Specify an array of string values to match this event if the actual value of sync-status is one of the values in the array. Use one of the constructors on the aws_events.Match for more advanced matching options. Default: - Do not filter on this field

  • upstream_registry_url (Optional[Sequence[str]]) – (experimental) upstream-registry-url property. Specify an array of string values to match this event if the actual value of upstream-registry-url is one of the values in the array. Use one of the constructors on the aws_events.Match for more advanced matching options. Default: - Do not filter on this field

Stability:

experimental

Return type:

EventPattern

ecr_referrer_action_pattern(*, action_type=None, artifact_media_type=None, event_metadata=None, image_digest=None, image_tag=None, last_activated_at=None, manifest_media_type=None, repository_name=None, result=None, target_storage_class=None)

(experimental) EventBridge event pattern for Repository ECR Referrer Action.

Parameters:
  • action_type (Optional[Sequence[str]]) – (experimental) action-type property. Specify an array of string values to match this event if the actual value of action-type is one of the values in the array. Use one of the constructors on the aws_events.Match for more advanced matching options. Default: - Do not filter on this field

  • artifact_media_type (Optional[Sequence[str]]) – (experimental) artifact-media-type property. Specify an array of string values to match this event if the actual value of artifact-media-type is one of the values in the array. Use one of the constructors on the aws_events.Match for more advanced matching options. Default: - Do not filter on this field

  • event_metadata (Union[AWSEventMetadataProps, Dict[str, Any], None]) – (experimental) EventBridge event metadata. Default: - -

  • image_digest (Optional[Sequence[str]]) – (experimental) image-digest property. Specify an array of string values to match this event if the actual value of image-digest is one of the values in the array. Use one of the constructors on the aws_events.Match for more advanced matching options. Default: - Do not filter on this field

  • image_tag (Optional[Sequence[str]]) – (experimental) image-tag property. Specify an array of string values to match this event if the actual value of image-tag is one of the values in the array. Use one of the constructors on the aws_events.Match for more advanced matching options. Default: - Do not filter on this field

  • last_activated_at (Optional[Sequence[str]]) – (experimental) last-activated-at property. Specify an array of string values to match this event if the actual value of last-activated-at is one of the values in the array. Use one of the constructors on the aws_events.Match for more advanced matching options. Default: - Do not filter on this field

  • manifest_media_type (Optional[Sequence[str]]) – (experimental) manifest-media-type property. Specify an array of string values to match this event if the actual value of manifest-media-type is one of the values in the array. Use one of the constructors on the aws_events.Match for more advanced matching options. Default: - Do not filter on this field

  • repository_name (Optional[Sequence[str]]) – (experimental) repository-name property. Specify an array of string values to match this event if the actual value of repository-name is one of the values in the array. Use one of the constructors on the aws_events.Match for more advanced matching options. Default: - Filter with the Repository reference

  • result (Optional[Sequence[str]]) – (experimental) result property. Specify an array of string values to match this event if the actual value of result is one of the values in the array. Use one of the constructors on the aws_events.Match for more advanced matching options. Default: - Do not filter on this field

  • target_storage_class (Optional[Sequence[str]]) – (experimental) target-storage-class property. Specify an array of string values to match this event if the actual value of target-storage-class is one of the values in the array. Use one of the constructors on the aws_events.Match for more advanced matching options. Default: - Do not filter on this field

Stability:

experimental

Return type:

EventPattern

ecr_replication_action_pattern(*, action_type=None, event_metadata=None, image_digest=None, image_tag=None, repository_name=None, result=None, source_account=None, source_region=None)

(experimental) EventBridge event pattern for Repository ECR Replication Action.

Parameters:
  • action_type (Optional[Sequence[str]]) – (experimental) action-type property. Specify an array of string values to match this event if the actual value of action-type is one of the values in the array. Use one of the constructors on the aws_events.Match for more advanced matching options. Default: - Do not filter on this field

  • event_metadata (Union[AWSEventMetadataProps, Dict[str, Any], None]) – (experimental) EventBridge event metadata. Default: - -

  • image_digest (Optional[Sequence[str]]) – (experimental) image-digest property. Specify an array of string values to match this event if the actual value of image-digest is one of the values in the array. Use one of the constructors on the aws_events.Match for more advanced matching options. Default: - Do not filter on this field

  • image_tag (Optional[Sequence[str]]) – (experimental) image-tag property. Specify an array of string values to match this event if the actual value of image-tag is one of the values in the array. Use one of the constructors on the aws_events.Match for more advanced matching options. Default: - Do not filter on this field

  • repository_name (Optional[Sequence[str]]) – (experimental) repository-name property. Specify an array of string values to match this event if the actual value of repository-name is one of the values in the array. Use one of the constructors on the aws_events.Match for more advanced matching options. Default: - Filter with the Repository reference

  • result (Optional[Sequence[str]]) – (experimental) result property. Specify an array of string values to match this event if the actual value of result is one of the values in the array. Use one of the constructors on the aws_events.Match for more advanced matching options. Default: - Do not filter on this field

  • source_account (Optional[Sequence[str]]) – (experimental) source-account property. Specify an array of string values to match this event if the actual value of source-account is one of the values in the array. Use one of the constructors on the aws_events.Match for more advanced matching options. Default: - Do not filter on this field

  • source_region (Optional[Sequence[str]]) – (experimental) source-region property. Specify an array of string values to match this event if the actual value of source-region is one of the values in the array. Use one of the constructors on the aws_events.Match for more advanced matching options. Default: - Do not filter on this field

Stability:

experimental

Return type:

EventPattern

Static Methods

classmethod from_repository(repository_ref)

(experimental) Create RepositoryEvents from a Repository reference.

Parameters:

repository_ref (IRepositoryRef)

Stability:

experimental

Return type:

RepositoryEvents