AWS SDK Version 3 for .NET
API Reference

AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

Creates or updates the image manifest and tags associated with an image.

This operation is used by the Amazon ECR proxy, and it is not intended for general use by customers for pulling and pushing images. In most cases, you should use the docker CLI to pull, tag, and push images.


For .NET Core and PCL this operation is only available in asynchronous form. Please refer to PutImageAsync.

Namespace: Amazon.ECR
Assembly: AWSSDK.ECR.dll
Version: 3.x.y.z


public abstract PutImageResponse PutImage(
         PutImageRequest request
Type: Amazon.ECR.Model.PutImageRequest

Container for the necessary parameters to execute the PutImage service method.

Return Value
The response from the PutImage service method, as returned by ECR.


ImageAlreadyExistsException The specified image has already been pushed, and there were no changes to the manifest or image tag after the last push.
InvalidParameterException The specified parameter is invalid. Review the available parameters for the API request.
LayersNotFoundException The specified layers could not be found, or the specified layer is not valid for this repository.
LimitExceededException The operation did not succeed because it would have exceeded a service limit for your account. For more information, see Amazon ECR Default Service Limits in the Amazon Elastic Container Registry User Guide.
RepositoryNotFoundException The specified repository could not be found. Check the spelling of the specified repository and ensure that you are performing operations on the correct registry.
ServerException These errors are usually caused by a server-side issue.

Version Information

.NET Framework:
Supported in: 4.5, 4.0, 3.5

Portable Class Library:
Supported in: Windows Store Apps
Supported in: Windows Phone 8.1
Supported in: Xamarin Android
Supported in: Xamarin iOS (Unified)
Supported in: Xamarin.Forms

See Also