/* * Copyright 2018-2023 Amazon.com, Inc. or its affiliates. All Rights Reserved. * * Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with * the License. A copy of the License is located at * * http://aws.amazon.com/apache2.0 * * or in the "license" file accompanying this file. This file is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR * CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions * and limitations under the License. */ package com.amazonaws.services.ecr; import javax.annotation.Generated; import com.amazonaws.services.ecr.model.*; /** * Interface for accessing Amazon ECR asynchronously. Each asynchronous method will return a Java Future object * representing the asynchronous operation; overloads which accept an {@code AsyncHandler} can be used to receive * notification when an asynchronous operation completes. *
* Note: Do not directly implement this interface, new methods are added to it regularly. Extend from * {@link com.amazonaws.services.ecr.AbstractAmazonECRAsync} instead. *
*
*
* 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. *
*/ @Generated("com.amazonaws:aws-java-sdk-code-generator") public interface AmazonECRAsync extends AmazonECR { /** ** Checks the availability of one or more image layers in a repository. *
** When an image is pushed to a repository, each image layer is checked to verify if it has been uploaded before. If * it has been uploaded, then the image layer is skipped. *
*
* This operation is used by the Amazon ECR proxy and is not generally used by customers for pulling and pushing
* images. In most cases, you should use the docker
CLI to pull, tag, and push images.
*
* Checks the availability of one or more image layers in a repository. *
** When an image is pushed to a repository, each image layer is checked to verify if it has been uploaded before. If * it has been uploaded, then the image layer is skipped. *
*
* This operation is used by the Amazon ECR proxy and is not generally used by customers for pulling and pushing
* images. In most cases, you should use the docker
CLI to pull, tag, and push images.
*
* Deletes a list of specified images within a repository. Images are specified with either an imageTag
* or imageDigest
.
*
* You can remove a tag from an image by specifying the image's tag in your request. When you remove the last tag * from an image, the image is deleted from your repository. *
** You can completely delete an image (and all of its tags) by specifying the image's digest in your request. *
* * @param batchDeleteImageRequest * Deletes specified images within a specified repository. Images are specified with either the *imageTag
or imageDigest
.
* @return A Java Future containing the result of the BatchDeleteImage operation returned by the service.
* @sample AmazonECRAsync.BatchDeleteImage
* @see AWS API
* Documentation
*/
java.util.concurrent.Future
* Deletes a list of specified images within a repository. Images are specified with either an imageTag
* or imageDigest
.
*
* You can remove a tag from an image by specifying the image's tag in your request. When you remove the last tag * from an image, the image is deleted from your repository. *
** You can completely delete an image (and all of its tags) by specifying the image's digest in your request. *
* * @param batchDeleteImageRequest * Deletes specified images within a specified repository. Images are specified with either the *imageTag
or imageDigest
.
* @param asyncHandler
* Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
* implementation of the callback methods in this interface to receive notification of successful or
* unsuccessful completion of the operation.
* @return A Java Future containing the result of the BatchDeleteImage operation returned by the service.
* @sample AmazonECRAsyncHandler.BatchDeleteImage
* @see AWS API
* Documentation
*/
java.util.concurrent.Future
* Gets detailed information for an image. Images are specified with either an imageTag
or
* imageDigest
.
*
* When an image is pulled, the BatchGetImage API is called once to retrieve the image manifest. *
* * @param batchGetImageRequest * @return A Java Future containing the result of the BatchGetImage operation returned by the service. * @sample AmazonECRAsync.BatchGetImage * @see AWS API * Documentation */ java.util.concurrent.Future
* Gets detailed information for an image. Images are specified with either an imageTag
or
* imageDigest
.
*
* When an image is pulled, the BatchGetImage API is called once to retrieve the image manifest. *
* * @param batchGetImageRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the BatchGetImage operation returned by the service. * @sample AmazonECRAsyncHandler.BatchGetImage * @see AWS API * Documentation */ java.util.concurrent.Future* Gets the scanning configuration for one or more repositories. *
* * @param batchGetRepositoryScanningConfigurationRequest * @return A Java Future containing the result of the BatchGetRepositoryScanningConfiguration operation returned by * the service. * @sample AmazonECRAsync.BatchGetRepositoryScanningConfiguration * @see AWS API Documentation */ java.util.concurrent.Future* Gets the scanning configuration for one or more repositories. *
* * @param batchGetRepositoryScanningConfigurationRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the BatchGetRepositoryScanningConfiguration operation returned by * the service. * @sample AmazonECRAsyncHandler.BatchGetRepositoryScanningConfiguration * @see AWS API Documentation */ java.util.concurrent.Future
* Informs Amazon ECR that the image layer upload has completed for a specified registry, repository name, and
* upload ID. You can optionally provide a sha256
digest of the image layer for data validation
* purposes.
*
* When an image is pushed, the CompleteLayerUpload API is called once per each new image layer to verify that the * upload has completed. *
*
* This operation is used by the Amazon ECR proxy and is not generally used by customers for pulling and pushing
* images. In most cases, you should use the docker
CLI to pull, tag, and push images.
*
* Informs Amazon ECR that the image layer upload has completed for a specified registry, repository name, and
* upload ID. You can optionally provide a sha256
digest of the image layer for data validation
* purposes.
*
* When an image is pushed, the CompleteLayerUpload API is called once per each new image layer to verify that the * upload has completed. *
*
* This operation is used by the Amazon ECR proxy and is not generally used by customers for pulling and pushing
* images. In most cases, you should use the docker
CLI to pull, tag, and push images.
*
* Creates a pull through cache rule. A pull through cache rule provides a way to cache images from an external * public registry in your Amazon ECR private registry. *
* * @param createPullThroughCacheRuleRequest * @return A Java Future containing the result of the CreatePullThroughCacheRule operation returned by the service. * @sample AmazonECRAsync.CreatePullThroughCacheRule * @see AWS * API Documentation */ java.util.concurrent.Future* Creates a pull through cache rule. A pull through cache rule provides a way to cache images from an external * public registry in your Amazon ECR private registry. *
* * @param createPullThroughCacheRuleRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the CreatePullThroughCacheRule operation returned by the service. * @sample AmazonECRAsyncHandler.CreatePullThroughCacheRule * @see AWS * API Documentation */ java.util.concurrent.Future* Creates a repository. For more information, see Amazon ECR repositories in * the Amazon Elastic Container Registry User Guide. *
* * @param createRepositoryRequest * @return A Java Future containing the result of the CreateRepository operation returned by the service. * @sample AmazonECRAsync.CreateRepository * @see AWS API * Documentation */ java.util.concurrent.Future* Creates a repository. For more information, see Amazon ECR repositories in * the Amazon Elastic Container Registry User Guide. *
* * @param createRepositoryRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the CreateRepository operation returned by the service. * @sample AmazonECRAsyncHandler.CreateRepository * @see AWS API * Documentation */ java.util.concurrent.Future* Deletes the lifecycle policy associated with the specified repository. *
* * @param deleteLifecyclePolicyRequest * @return A Java Future containing the result of the DeleteLifecyclePolicy operation returned by the service. * @sample AmazonECRAsync.DeleteLifecyclePolicy * @see AWS API * Documentation */ java.util.concurrent.Future* Deletes the lifecycle policy associated with the specified repository. *
* * @param deleteLifecyclePolicyRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DeleteLifecyclePolicy operation returned by the service. * @sample AmazonECRAsyncHandler.DeleteLifecyclePolicy * @see AWS API * Documentation */ java.util.concurrent.Future* Deletes a pull through cache rule. *
* * @param deletePullThroughCacheRuleRequest * @return A Java Future containing the result of the DeletePullThroughCacheRule operation returned by the service. * @sample AmazonECRAsync.DeletePullThroughCacheRule * @see AWS * API Documentation */ java.util.concurrent.Future* Deletes a pull through cache rule. *
* * @param deletePullThroughCacheRuleRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DeletePullThroughCacheRule operation returned by the service. * @sample AmazonECRAsyncHandler.DeletePullThroughCacheRule * @see AWS * API Documentation */ java.util.concurrent.Future* Deletes the registry permissions policy. *
* * @param deleteRegistryPolicyRequest * @return A Java Future containing the result of the DeleteRegistryPolicy operation returned by the service. * @sample AmazonECRAsync.DeleteRegistryPolicy * @see AWS API * Documentation */ java.util.concurrent.Future* Deletes the registry permissions policy. *
* * @param deleteRegistryPolicyRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DeleteRegistryPolicy operation returned by the service. * @sample AmazonECRAsyncHandler.DeleteRegistryPolicy * @see AWS API * Documentation */ java.util.concurrent.Future
* Deletes a repository. If the repository contains images, you must either delete all images in the repository or
* use the force
option to delete the repository.
*
* Deletes a repository. If the repository contains images, you must either delete all images in the repository or
* use the force
option to delete the repository.
*
* Deletes the repository policy associated with the specified repository. *
* * @param deleteRepositoryPolicyRequest * @return A Java Future containing the result of the DeleteRepositoryPolicy operation returned by the service. * @sample AmazonECRAsync.DeleteRepositoryPolicy * @see AWS API * Documentation */ java.util.concurrent.Future* Deletes the repository policy associated with the specified repository. *
* * @param deleteRepositoryPolicyRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DeleteRepositoryPolicy operation returned by the service. * @sample AmazonECRAsyncHandler.DeleteRepositoryPolicy * @see AWS API * Documentation */ java.util.concurrent.Future* Returns the replication status for a specified image. *
* * @param describeImageReplicationStatusRequest * @return A Java Future containing the result of the DescribeImageReplicationStatus operation returned by the * service. * @sample AmazonECRAsync.DescribeImageReplicationStatus * @see AWS API Documentation */ java.util.concurrent.Future* Returns the replication status for a specified image. *
* * @param describeImageReplicationStatusRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DescribeImageReplicationStatus operation returned by the * service. * @sample AmazonECRAsyncHandler.DescribeImageReplicationStatus * @see AWS API Documentation */ java.util.concurrent.Future* Returns the scan findings for the specified image. *
* * @param describeImageScanFindingsRequest * @return A Java Future containing the result of the DescribeImageScanFindings operation returned by the service. * @sample AmazonECRAsync.DescribeImageScanFindings * @see AWS * API Documentation */ java.util.concurrent.Future* Returns the scan findings for the specified image. *
* * @param describeImageScanFindingsRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DescribeImageScanFindings operation returned by the service. * @sample AmazonECRAsyncHandler.DescribeImageScanFindings * @see AWS * API Documentation */ java.util.concurrent.Future* Returns metadata about the images in a repository. *
*
* Beginning with Docker version 1.9, the Docker client compresses image layers before pushing them to a V2 Docker
* registry. The output of the docker images
command shows the uncompressed image size, so it may
* return a larger image size than the image sizes returned by DescribeImages.
*
* Returns metadata about the images in a repository. *
*
* Beginning with Docker version 1.9, the Docker client compresses image layers before pushing them to a V2 Docker
* registry. The output of the docker images
command shows the uncompressed image size, so it may
* return a larger image size than the image sizes returned by DescribeImages.
*
* Returns the pull through cache rules for a registry. *
* * @param describePullThroughCacheRulesRequest * @return A Java Future containing the result of the DescribePullThroughCacheRules operation returned by the * service. * @sample AmazonECRAsync.DescribePullThroughCacheRules * @see AWS API Documentation */ java.util.concurrent.Future* Returns the pull through cache rules for a registry. *
* * @param describePullThroughCacheRulesRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DescribePullThroughCacheRules operation returned by the * service. * @sample AmazonECRAsyncHandler.DescribePullThroughCacheRules * @see AWS API Documentation */ java.util.concurrent.Future* Describes the settings for a registry. The replication configuration for a repository can be created or updated * with the PutReplicationConfiguration API action. *
* * @param describeRegistryRequest * @return A Java Future containing the result of the DescribeRegistry operation returned by the service. * @sample AmazonECRAsync.DescribeRegistry * @see AWS API * Documentation */ java.util.concurrent.Future* Describes the settings for a registry. The replication configuration for a repository can be created or updated * with the PutReplicationConfiguration API action. *
* * @param describeRegistryRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DescribeRegistry operation returned by the service. * @sample AmazonECRAsyncHandler.DescribeRegistry * @see AWS API * Documentation */ java.util.concurrent.Future* Describes image repositories in a registry. *
* * @param describeRepositoriesRequest * @return A Java Future containing the result of the DescribeRepositories operation returned by the service. * @sample AmazonECRAsync.DescribeRepositories * @see AWS API * Documentation */ java.util.concurrent.Future* Describes image repositories in a registry. *
* * @param describeRepositoriesRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DescribeRepositories operation returned by the service. * @sample AmazonECRAsyncHandler.DescribeRepositories * @see AWS API * Documentation */ java.util.concurrent.Future* Retrieves an authorization token. An authorization token represents your IAM authentication credentials and can * be used to access any Amazon ECR registry that your IAM principal has access to. The authorization token is valid * for 12 hours. *
*
* The authorizationToken
returned is a base64 encoded string that can be decoded and used in a
* docker login
command to authenticate to a registry. The CLI offers an
* get-login-password
command that simplifies the login process. For more information, see Registry
* authentication in the Amazon Elastic Container Registry User Guide.
*
* Retrieves an authorization token. An authorization token represents your IAM authentication credentials and can * be used to access any Amazon ECR registry that your IAM principal has access to. The authorization token is valid * for 12 hours. *
*
* The authorizationToken
returned is a base64 encoded string that can be decoded and used in a
* docker login
command to authenticate to a registry. The CLI offers an
* get-login-password
command that simplifies the login process. For more information, see Registry
* authentication in the Amazon Elastic Container Registry User Guide.
*
* Retrieves the pre-signed Amazon S3 download URL corresponding to an image layer. You can only get URLs for image * layers that are referenced in an image. *
** When an image is pulled, the GetDownloadUrlForLayer API is called once per image layer that is not already * cached. *
*
* This operation is used by the Amazon ECR proxy and is not generally used by customers for pulling and pushing
* images. In most cases, you should use the docker
CLI to pull, tag, and push images.
*
* Retrieves the pre-signed Amazon S3 download URL corresponding to an image layer. You can only get URLs for image * layers that are referenced in an image. *
** When an image is pulled, the GetDownloadUrlForLayer API is called once per image layer that is not already * cached. *
*
* This operation is used by the Amazon ECR proxy and is not generally used by customers for pulling and pushing
* images. In most cases, you should use the docker
CLI to pull, tag, and push images.
*
* Retrieves the lifecycle policy for the specified repository. *
* * @param getLifecyclePolicyRequest * @return A Java Future containing the result of the GetLifecyclePolicy operation returned by the service. * @sample AmazonECRAsync.GetLifecyclePolicy * @see AWS API * Documentation */ java.util.concurrent.Future* Retrieves the lifecycle policy for the specified repository. *
* * @param getLifecyclePolicyRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the GetLifecyclePolicy operation returned by the service. * @sample AmazonECRAsyncHandler.GetLifecyclePolicy * @see AWS API * Documentation */ java.util.concurrent.Future* Retrieves the results of the lifecycle policy preview request for the specified repository. *
* * @param getLifecyclePolicyPreviewRequest * @return A Java Future containing the result of the GetLifecyclePolicyPreview operation returned by the service. * @sample AmazonECRAsync.GetLifecyclePolicyPreview * @see AWS * API Documentation */ java.util.concurrent.Future* Retrieves the results of the lifecycle policy preview request for the specified repository. *
* * @param getLifecyclePolicyPreviewRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the GetLifecyclePolicyPreview operation returned by the service. * @sample AmazonECRAsyncHandler.GetLifecyclePolicyPreview * @see AWS * API Documentation */ java.util.concurrent.Future* Retrieves the permissions policy for a registry. *
* * @param getRegistryPolicyRequest * @return A Java Future containing the result of the GetRegistryPolicy operation returned by the service. * @sample AmazonECRAsync.GetRegistryPolicy * @see AWS API * Documentation */ java.util.concurrent.Future* Retrieves the permissions policy for a registry. *
* * @param getRegistryPolicyRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the GetRegistryPolicy operation returned by the service. * @sample AmazonECRAsyncHandler.GetRegistryPolicy * @see AWS API * Documentation */ java.util.concurrent.Future* Retrieves the scanning configuration for a registry. *
* * @param getRegistryScanningConfigurationRequest * @return A Java Future containing the result of the GetRegistryScanningConfiguration operation returned by the * service. * @sample AmazonECRAsync.GetRegistryScanningConfiguration * @see AWS API Documentation */ java.util.concurrent.Future* Retrieves the scanning configuration for a registry. *
* * @param getRegistryScanningConfigurationRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the GetRegistryScanningConfiguration operation returned by the * service. * @sample AmazonECRAsyncHandler.GetRegistryScanningConfiguration * @see AWS API Documentation */ java.util.concurrent.Future* Retrieves the repository policy for the specified repository. *
* * @param getRepositoryPolicyRequest * @return A Java Future containing the result of the GetRepositoryPolicy operation returned by the service. * @sample AmazonECRAsync.GetRepositoryPolicy * @see AWS API * Documentation */ java.util.concurrent.Future* Retrieves the repository policy for the specified repository. *
* * @param getRepositoryPolicyRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the GetRepositoryPolicy operation returned by the service. * @sample AmazonECRAsyncHandler.GetRepositoryPolicy * @see AWS API * Documentation */ java.util.concurrent.Future* Notifies Amazon ECR that you intend to upload an image layer. *
** When an image is pushed, the InitiateLayerUpload API is called once per image layer that has not already been * uploaded. Whether or not an image layer has been uploaded is determined by the BatchCheckLayerAvailability API * action. *
*
* This operation is used by the Amazon ECR proxy and is not generally used by customers for pulling and pushing
* images. In most cases, you should use the docker
CLI to pull, tag, and push images.
*
* Notifies Amazon ECR that you intend to upload an image layer. *
** When an image is pushed, the InitiateLayerUpload API is called once per image layer that has not already been * uploaded. Whether or not an image layer has been uploaded is determined by the BatchCheckLayerAvailability API * action. *
*
* This operation is used by the Amazon ECR proxy and is not generally used by customers for pulling and pushing
* images. In most cases, you should use the docker
CLI to pull, tag, and push images.
*
* Lists all the image IDs for the specified repository. *
*
* You can filter images based on whether or not they are tagged by using the tagStatus
filter and
* specifying either TAGGED
, UNTAGGED
or ANY
. For example, you can filter
* your results to return only UNTAGGED
images and then pipe that result to a BatchDeleteImage
* operation to delete them. Or, you can filter your results to return only TAGGED
images to list all
* of the tags in your repository.
*
* Lists all the image IDs for the specified repository. *
*
* You can filter images based on whether or not they are tagged by using the tagStatus
filter and
* specifying either TAGGED
, UNTAGGED
or ANY
. For example, you can filter
* your results to return only UNTAGGED
images and then pipe that result to a BatchDeleteImage
* operation to delete them. Or, you can filter your results to return only TAGGED
images to list all
* of the tags in your repository.
*
* List the tags for an Amazon ECR resource. *
* * @param listTagsForResourceRequest * @return A Java Future containing the result of the ListTagsForResource operation returned by the service. * @sample AmazonECRAsync.ListTagsForResource * @see AWS API * Documentation */ java.util.concurrent.Future* List the tags for an Amazon ECR resource. *
* * @param listTagsForResourceRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the ListTagsForResource operation returned by the service. * @sample AmazonECRAsyncHandler.ListTagsForResource * @see AWS API * Documentation */ java.util.concurrent.Future* Creates or updates the image manifest and tags associated with an image. *
** When an image is pushed and all new image layers have been uploaded, the PutImage API is called once to create or * update the image manifest and the tags associated with the image. *
*
* This operation is used by the Amazon ECR proxy and is not generally used by customers for pulling and pushing
* images. In most cases, you should use the docker
CLI to pull, tag, and push images.
*
* Creates or updates the image manifest and tags associated with an image. *
** When an image is pushed and all new image layers have been uploaded, the PutImage API is called once to create or * update the image manifest and the tags associated with the image. *
*
* This operation is used by the Amazon ECR proxy and is not generally used by customers for pulling and pushing
* images. In most cases, you should use the docker
CLI to pull, tag, and push images.
*
* The PutImageScanningConfiguration
API is being deprecated, in favor of specifying the image scanning
* configuration at the registry level. For more information, see PutRegistryScanningConfiguration.
*
* Updates the image scanning configuration for the specified repository. *
* * @param putImageScanningConfigurationRequest * @return A Java Future containing the result of the PutImageScanningConfiguration operation returned by the * service. * @sample AmazonECRAsync.PutImageScanningConfiguration * @see AWS API Documentation */ java.util.concurrent.Future
* The PutImageScanningConfiguration
API is being deprecated, in favor of specifying the image scanning
* configuration at the registry level. For more information, see PutRegistryScanningConfiguration.
*
* Updates the image scanning configuration for the specified repository. *
* * @param putImageScanningConfigurationRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the PutImageScanningConfiguration operation returned by the * service. * @sample AmazonECRAsyncHandler.PutImageScanningConfiguration * @see AWS API Documentation */ java.util.concurrent.Future* Updates the image tag mutability settings for the specified repository. For more information, see Image tag mutability * in the Amazon Elastic Container Registry User Guide. *
* * @param putImageTagMutabilityRequest * @return A Java Future containing the result of the PutImageTagMutability operation returned by the service. * @sample AmazonECRAsync.PutImageTagMutability * @see AWS API * Documentation */ java.util.concurrent.Future* Updates the image tag mutability settings for the specified repository. For more information, see Image tag mutability * in the Amazon Elastic Container Registry User Guide. *
* * @param putImageTagMutabilityRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the PutImageTagMutability operation returned by the service. * @sample AmazonECRAsyncHandler.PutImageTagMutability * @see AWS API * Documentation */ java.util.concurrent.Future* Creates or updates the lifecycle policy for the specified repository. For more information, see Lifecycle policy * template. *
* * @param putLifecyclePolicyRequest * @return A Java Future containing the result of the PutLifecyclePolicy operation returned by the service. * @sample AmazonECRAsync.PutLifecyclePolicy * @see AWS API * Documentation */ java.util.concurrent.Future* Creates or updates the lifecycle policy for the specified repository. For more information, see Lifecycle policy * template. *
* * @param putLifecyclePolicyRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the PutLifecyclePolicy operation returned by the service. * @sample AmazonECRAsyncHandler.PutLifecyclePolicy * @see AWS API * Documentation */ java.util.concurrent.Future* Creates or updates the permissions policy for your registry. *
** A registry policy is used to specify permissions for another Amazon Web Services account and is used when * configuring cross-account replication. For more information, see Registry permissions * in the Amazon Elastic Container Registry User Guide. *
* * @param putRegistryPolicyRequest * @return A Java Future containing the result of the PutRegistryPolicy operation returned by the service. * @sample AmazonECRAsync.PutRegistryPolicy * @see AWS API * Documentation */ java.util.concurrent.Future* Creates or updates the permissions policy for your registry. *
** A registry policy is used to specify permissions for another Amazon Web Services account and is used when * configuring cross-account replication. For more information, see Registry permissions * in the Amazon Elastic Container Registry User Guide. *
* * @param putRegistryPolicyRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the PutRegistryPolicy operation returned by the service. * @sample AmazonECRAsyncHandler.PutRegistryPolicy * @see AWS API * Documentation */ java.util.concurrent.Future* Creates or updates the scanning configuration for your private registry. *
* * @param putRegistryScanningConfigurationRequest * @return A Java Future containing the result of the PutRegistryScanningConfiguration operation returned by the * service. * @sample AmazonECRAsync.PutRegistryScanningConfiguration * @see AWS API Documentation */ java.util.concurrent.Future* Creates or updates the scanning configuration for your private registry. *
* * @param putRegistryScanningConfigurationRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the PutRegistryScanningConfiguration operation returned by the * service. * @sample AmazonECRAsyncHandler.PutRegistryScanningConfiguration * @see AWS API Documentation */ java.util.concurrent.Future* Creates or updates the replication configuration for a registry. The existing replication configuration for a * repository can be retrieved with the DescribeRegistry API action. The first time the * PutReplicationConfiguration API is called, a service-linked IAM role is created in your account for the * replication process. For more information, see Using * service-linked roles for Amazon ECR in the Amazon Elastic Container Registry User Guide. *
** When configuring cross-account replication, the destination account must grant the source account permission to * replicate. This permission is controlled using a registry permissions policy. For more information, see * PutRegistryPolicy. *
** Creates or updates the replication configuration for a registry. The existing replication configuration for a * repository can be retrieved with the DescribeRegistry API action. The first time the * PutReplicationConfiguration API is called, a service-linked IAM role is created in your account for the * replication process. For more information, see Using * service-linked roles for Amazon ECR in the Amazon Elastic Container Registry User Guide. *
** When configuring cross-account replication, the destination account must grant the source account permission to * replicate. This permission is controlled using a registry permissions policy. For more information, see * PutRegistryPolicy. *
** Applies a repository policy to the specified repository to control access permissions. For more information, see * Amazon ECR Repository * policies in the Amazon Elastic Container Registry User Guide. *
* * @param setRepositoryPolicyRequest * @return A Java Future containing the result of the SetRepositoryPolicy operation returned by the service. * @sample AmazonECRAsync.SetRepositoryPolicy * @see AWS API * Documentation */ java.util.concurrent.Future* Applies a repository policy to the specified repository to control access permissions. For more information, see * Amazon ECR Repository * policies in the Amazon Elastic Container Registry User Guide. *
* * @param setRepositoryPolicyRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the SetRepositoryPolicy operation returned by the service. * @sample AmazonECRAsyncHandler.SetRepositoryPolicy * @see AWS API * Documentation */ java.util.concurrent.Future* Starts an image vulnerability scan. An image scan can only be started once per 24 hours on an individual image. * This limit includes if an image was scanned on initial push. For more information, see Image scanning in the * Amazon Elastic Container Registry User Guide. *
* * @param startImageScanRequest * @return A Java Future containing the result of the StartImageScan operation returned by the service. * @sample AmazonECRAsync.StartImageScan * @see AWS API * Documentation */ java.util.concurrent.Future* Starts an image vulnerability scan. An image scan can only be started once per 24 hours on an individual image. * This limit includes if an image was scanned on initial push. For more information, see Image scanning in the * Amazon Elastic Container Registry User Guide. *
* * @param startImageScanRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the StartImageScan operation returned by the service. * @sample AmazonECRAsyncHandler.StartImageScan * @see AWS API * Documentation */ java.util.concurrent.Future* Starts a preview of a lifecycle policy for the specified repository. This allows you to see the results before * associating the lifecycle policy with the repository. *
* * @param startLifecyclePolicyPreviewRequest * @return A Java Future containing the result of the StartLifecyclePolicyPreview operation returned by the service. * @sample AmazonECRAsync.StartLifecyclePolicyPreview * @see AWS API Documentation */ java.util.concurrent.Future* Starts a preview of a lifecycle policy for the specified repository. This allows you to see the results before * associating the lifecycle policy with the repository. *
* * @param startLifecyclePolicyPreviewRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the StartLifecyclePolicyPreview operation returned by the service. * @sample AmazonECRAsyncHandler.StartLifecyclePolicyPreview * @see AWS API Documentation */ java.util.concurrent.Future* Adds specified tags to a resource with the specified ARN. Existing tags on a resource are not changed if they are * not specified in the request parameters. *
* * @param tagResourceRequest * @return A Java Future containing the result of the TagResource operation returned by the service. * @sample AmazonECRAsync.TagResource * @see AWS API * Documentation */ java.util.concurrent.Future* Adds specified tags to a resource with the specified ARN. Existing tags on a resource are not changed if they are * not specified in the request parameters. *
* * @param tagResourceRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the TagResource operation returned by the service. * @sample AmazonECRAsyncHandler.TagResource * @see AWS API * Documentation */ java.util.concurrent.Future* Deletes specified tags from a resource. *
* * @param untagResourceRequest * @return A Java Future containing the result of the UntagResource operation returned by the service. * @sample AmazonECRAsync.UntagResource * @see AWS API * Documentation */ java.util.concurrent.Future* Deletes specified tags from a resource. *
* * @param untagResourceRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the UntagResource operation returned by the service. * @sample AmazonECRAsyncHandler.UntagResource * @see AWS API * Documentation */ java.util.concurrent.Future* Uploads an image layer part to Amazon ECR. *
** When an image is pushed, each new image layer is uploaded in parts. The maximum size of each image layer part can * be 20971520 bytes (or about 20MB). The UploadLayerPart API is called once per each new image layer part. *
*
* This operation is used by the Amazon ECR proxy and is not generally used by customers for pulling and pushing
* images. In most cases, you should use the docker
CLI to pull, tag, and push images.
*
* Uploads an image layer part to Amazon ECR. *
** When an image is pushed, each new image layer is uploaded in parts. The maximum size of each image layer part can * be 20971520 bytes (or about 20MB). The UploadLayerPart API is called once per each new image layer part. *
*
* This operation is used by the Amazon ECR proxy and is not generally used by customers for pulling and pushing
* images. In most cases, you should use the docker
CLI to pull, tag, and push images.
*