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.

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.

Note:

For .NET Core this operation is only available in asynchronous form. Please refer to InitiateLayerUploadAsync.

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

Syntax

C#
public virtual InitiateLayerUploadResponse InitiateLayerUpload(
         InitiateLayerUploadRequest request
)

Parameters

request
Type: Amazon.ECR.Model.InitiateLayerUploadRequest

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

Return Value


The response from the InitiateLayerUpload service method, as returned by ECR.

Exceptions

ExceptionCondition
InvalidParameterException The specified parameter is invalid. Review the available parameters for the API request.
KmsException The operation failed due to a KMS exception.
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

See Also