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.

Deletes a repository. If the repository isn't empty, you must either delete the contents of the repository or use the force option to delete the repository and have Amazon ECR delete all of its contents on your behalf.

Note:

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

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

Syntax

C#
public virtual DeleteRepositoryResponse DeleteRepository(
         DeleteRepositoryRequest request
)

Parameters

request
Type: Amazon.ECR.Model.DeleteRepositoryRequest

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

Return Value


The response from the DeleteRepository 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.
RepositoryNotEmptyException The specified repository contains images. To delete a repository that contains images, you must force the deletion with the force parameter.
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.

Examples

This example force deletes a repository named ubuntu in the default registry for an account. The force parameter is required if the repository contains images.

To force delete a repository


var client = new AmazonECRClient();
var response = client.DeleteRepository(new DeleteRepositoryRequest 
{
    Force = true,
    RepositoryName = "ubuntu"
});

Repository repository = response.Repository;

            

Version Information

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

See Also