ecr: Amazon EC2 Container Registry

In paws: Amazon Web Services Software Development Kit

Amazon EC2 Container Registry

Description

Amazon Elastic Container Registry

Amazon Elastic Container Registry (Amazon ECR) is a managed container image registry service. Customers can use the familiar Docker CLI, or their preferred client, to push, pull, and manage images. Amazon ECR provides a secure, scalable, and reliable registry for your Docker or Open Container Initiative (OCI) images. Amazon ECR supports private repositories with resource-based permissions using IAM so that specific users or Amazon EC2 instances can access repositories and images.

Amazon ECR has service endpoints in each supported Region. For more information, see Amazon ECR endpoints in the Amazon Web Services General Reference.

Usage

ecr(config = list(), credentials = list(), endpoint = NULL, region = NULL)

Arguments

config	Optional configuration of credentials, endpoint, and/or region. credentials: creds: access_key_id: AWS access key ID secret_access_key: AWS secret access key session_token: AWS temporary session token profile: The name of a profile to use. If not given, then the default profile is used. anonymous: Set anonymous credentials. endpoint: The complete URL to use for the constructed client. region: The AWS Region used in instantiating the client. close_connection: Immediately close all HTTP connections. timeout: The time in seconds till a timeout exception is thrown when attempting to make a connection. The default is 60 seconds. s3_force_path_style: Set this to true to force the request to use path-style addressing, i.e. ⁠http://s3.amazonaws.com/BUCKET/KEY⁠. sts_regional_endpoint: Set sts regional endpoint resolver to regional or legacy https://docs.aws.amazon.com/sdkref/latest/guide/feature-sts-regionalized-endpoints.html
credentials	Optional credentials shorthand for the config parameter creds: access_key_id: AWS access key ID secret_access_key: AWS secret access key session_token: AWS temporary session token profile: The name of a profile to use. If not given, then the default profile is used. anonymous: Set anonymous credentials.
endpoint	Optional shorthand for complete URL to use for the constructed client.
region	Optional shorthand for AWS Region used in instantiating the client.

Value

A client for the service. You can call the service's operations using syntax like svc$operation(...), where svc is the name you've assigned to the client. The available operations are listed in the Operations section.

Service syntax

svc <- ecr(
  config = list(
    credentials = list(
      creds = list(
        access_key_id = "string",
        secret_access_key = "string",
        session_token = "string"
      ),
      profile = "string",
      anonymous = "logical"
    ),
    endpoint = "string",
    region = "string",
    close_connection = "logical",
    timeout = "numeric",
    s3_force_path_style = "logical",
    sts_regional_endpoint = "string"
  ),
  credentials = list(
    creds = list(
      access_key_id = "string",
      secret_access_key = "string",
      session_token = "string"
    ),
    profile = "string",
    anonymous = "logical"
  ),
  endpoint = "string",
  region = "string"
)

Operations

batch_check_layer_availability	Checks the availability of one or more image layers in a repository
batch_delete_image	Deletes a list of specified images within a repository
batch_get_image	Gets detailed information for an image
batch_get_repository_scanning_configuration	Gets the scanning configuration for one or more repositories
complete_layer_upload	Informs Amazon ECR that the image layer upload has completed for a specified registry, repository name, and upload ID
create_pull_through_cache_rule	Creates a pull through cache rule
create_repository	Creates a repository
create_repository_creation_template	Creates a repository creation template
delete_lifecycle_policy	Deletes the lifecycle policy associated with the specified repository
delete_pull_through_cache_rule	Deletes a pull through cache rule
delete_registry_policy	Deletes the registry permissions policy
delete_repository	Deletes a repository
delete_repository_creation_template	Deletes a repository creation template
delete_repository_policy	Deletes the repository policy associated with the specified repository
describe_image_replication_status	Returns the replication status for a specified image
describe_images	Returns metadata about the images in a repository
describe_image_scan_findings	Returns the scan findings for the specified image
describe_pull_through_cache_rules	Returns the pull through cache rules for a registry
describe_registry	Describes the settings for a registry
describe_repositories	Describes image repositories in a registry
describe_repository_creation_templates	Returns details about the repository creation templates in a registry
get_account_setting	Retrieves the basic scan type version name
get_authorization_token	Retrieves an authorization token
get_download_url_for_layer	Retrieves the pre-signed Amazon S3 download URL corresponding to an image layer
get_lifecycle_policy	Retrieves the lifecycle policy for the specified repository
get_lifecycle_policy_preview	Retrieves the results of the lifecycle policy preview request for the specified repository
get_registry_policy	Retrieves the permissions policy for a registry
get_registry_scanning_configuration	Retrieves the scanning configuration for a registry
get_repository_policy	Retrieves the repository policy for the specified repository
initiate_layer_upload	Notifies Amazon ECR that you intend to upload an image layer
list_images	Lists all the image IDs for the specified repository
list_tags_for_resource	List the tags for an Amazon ECR resource
put_account_setting	Allows you to change the basic scan type version by setting the name parameter to either CLAIR to AWS_NATIVE
put_image	Creates or updates the image manifest and tags associated with an image
put_image_scanning_configuration	The PutImageScanningConfiguration API is being deprecated, in favor of specifying the image scanning configuration at the registry level
put_image_tag_mutability	Updates the image tag mutability settings for the specified repository
put_lifecycle_policy	Creates or updates the lifecycle policy for the specified repository
put_registry_policy	Creates or updates the permissions policy for your registry
put_registry_scanning_configuration	Creates or updates the scanning configuration for your private registry
put_replication_configuration	Creates or updates the replication configuration for a registry
set_repository_policy	Applies a repository policy to the specified repository to control access permissions
start_image_scan	Starts an image vulnerability scan
start_lifecycle_policy_preview	Starts a preview of a lifecycle policy for the specified repository
tag_resource	Adds specified tags to a resource with the specified ARN
untag_resource	Deletes specified tags from a resource
update_pull_through_cache_rule	Updates an existing pull through cache rule
update_repository_creation_template	Updates an existing repository creation template
upload_layer_part	Uploads an image layer part to Amazon ECR
validate_pull_through_cache_rule	Validates an existing pull through cache rule for an upstream registry that requires authentication

Examples

## Not run: 
svc <- ecr()
# This example deletes images with the tags precise and trusty in a
# repository called ubuntu in the default registry for an account.
svc$batch_delete_image(
  imageIds = list(
    list(
      imageTag = "precise"
    )
  ),
  repositoryName = "ubuntu"
)

## End(Not run)

paws documentation built on Sept. 17, 2024, 5:07 p.m.