Skip to main content

repositories_list_only

Lists repositories in a region or regions, for all properties use repositories

Overview

Namerepositories_list_only
TypeResource
DescriptionThe AWS::ECR::Repository resource specifies an Amazon Elastic Container Registry (Amazon ECR) repository, where users can push and pull Docker images, Open Container Initiative (OCI) images, and OCI compatible artifacts. For more information, see [Amazon ECR private repositories](https://docs.aws.amazon.com/AmazonECR/latest/userguide/Repositories.html) in the *Amazon ECR User Guide*.
Idaws.ecr.repositories_list_only

Fields

NameDatatypeDescription
empty_on_deletebooleanIf true, deleting the repository force deletes the contents of the repository. If false, the repository must be empty before attempting to delete it.
lifecycle_policyobjectCreates or updates a lifecycle policy. For information about lifecycle policy syntax, see [Lifecycle policy template](https://docs.aws.amazon.com/AmazonECR/latest/userguide/LifecyclePolicies.html).
repository_namestringThe name to use for the repository. The repository name may be specified on its own (such as nginx-web-app) or it can be prepended with a namespace to group the repository into a category (such as project-a/nginx-web-app). If you don't specify a name, CFNlong generates a unique physical ID and uses that ID for the repository name. For more information, see [Name type](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-name.html).
The repository name must start with a letter and can only contain lowercase letters, numbers, hyphens, underscores, and forward slashes.
If you specify a name, you cannot perform updates that require replacement of this resource. You can perform updates that require no or some interruption. If you must replace the resource, specify a new name.
repository_policy_textobjectThe JSON repository policy text to apply to the repository. For more information, see [Amazon ECR repository policies](https://docs.aws.amazon.com/AmazonECR/latest/userguide/repository-policy-examples.html) in the *Amazon Elastic Container Registry User Guide*.
tagsarrayAn array of key-value pairs to apply to this resource.
arnstring
repository_uristring
image_tag_mutabilitystringThe tag mutability setting for the repository. If this parameter is omitted, the default setting of MUTABLE will be used which will allow image tags to be overwritten. If IMMUTABLE is specified, all image tags within the repository will be immutable which will prevent them from being overwritten.
image_scanning_configurationobjectThe image scanning configuration for the repository. This determines whether images are scanned for known vulnerabilities after being pushed to the repository.
encryption_configurationobjectThe encryption configuration for the repository. This determines how the contents of your repository are encrypted at rest.
regionstringAWS region.

Methods

NameAccessible byRequired Params
list_resourcesSELECTregion

SELECT examples

Lists all repositories in a region.

SELECT
region,
repository_name
FROM aws.ecr.repositories_list_only
WHERE region = 'us-east-1';

Permissions

For permissions required to operate on the repositories_list_only resource, see repositories