Class UploadLayerPartCommandProtected

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.

Example

Use a bare-bones client and the command you need to make an API call.

import { ECRClient, UploadLayerPartCommand } from "@aws-sdk/client-ecr"; // ES Modules import
// const { ECRClient, UploadLayerPartCommand } = require("@aws-sdk/client-ecr"); // CommonJS import
const client = new ECRClient(config);
const input = { // UploadLayerPartRequest
  registryId: "STRING_VALUE",
  repositoryName: "STRING_VALUE", // required
  uploadId: "STRING_VALUE", // required
  partFirstByte: Number("long"), // required
  partLastByte: Number("long"), // required
  layerPartBlob: "BLOB_VALUE", // required
};
const command = new UploadLayerPartCommand(input);
const response = await client.send(command);

Param

UploadLayerPartCommandInput

Returns

UploadLayerPartCommandOutput

See

• UploadLayerPartCommandInput for command's input shape.
• UploadLayerPartCommandOutput for command's response shape.
• config for ECRClient's config shape.

Throws

InvalidLayerPartException (client fault)

The layer part size is not valid, or the first byte specified is not consecutive to the last byte of a previous layer part upload.

Throws

InvalidParameterException (client fault)

The specified parameter is invalid. Review the available parameters for the API request.

Throws

KmsException (client fault)

The operation failed due to a KMS exception.

Throws

LimitExceededException (client fault)

The operation did not succeed because it would have exceeded a service limit for your account. For more information, see Amazon ECR service quotas in the Amazon Elastic Container Registry User Guide.

Throws

RepositoryNotFoundException (client fault)

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.

Throws

ServerException (server fault)

These errors are usually caused by a server-side issue.

Throws

UploadNotFoundException (client fault)

The upload could not be found, or the specified upload ID is not valid for this repository.