Delete a package or package version

You can delete one or more package versions at a time using the delete-package-versions command. To remove a package from a repository completely, including all associated versions and configuration, use the delete-package command. A package can exist in a repository without any package versions. This can happen when all versions are deleted using the delete-package-versions command, or if the package was created without any versions using the put-package-origin-configuration API operation (see Editing package origin controls).

Deleting a package (AWS CLI)

You can delete a package, including all of its package versions and configuration, using the delete-package command. The following example deletes the PyPI package named my-package in the repo my_repo in the my_domain domain:

aws codeartifact delete-package --domain my_domain --domain-owner 111122223333 \
--repository my_repo --format pypi \
--package my-package

Sample output:

{
   "deletedPackage": { 
      "format": "pypi",
      "originConfiguration": { 
         "restrictions": { 
            "publish": "ALLOW",
            "upstream": "BLOCK"
         }
      },
      "package": "my-package"
   }
}    
   

You can confirm that the package was deleted by running describe-package for the same package name:

aws codeartifact describe-package --domain my_domain --domain-owner 111122223333 \
--repository my_repo --format pypi --package my-package

Deleting a package (console)

Deleting a package version (AWS CLI)

You can delete one or more package versions at a time using the delete-package-versions command. The following example deletes versions 4.0.0, 4.0.1, and 5.0.0 of the PyPI package named my-package in the my_repo in the my_domain domain:

aws codeartifact delete-package-versions --domain my_domain --domain-owner 111122223333 \
--repository my_repo --format pypi \
--package my-package --versions 4.0.0 4.0.1 5.0.0

Sample output:

{
   "successfulVersions": {
      "4.0.0": {
         "revision": "oxwwYC9dDeuBoCt6+PDSwL6OMZ7rXeiXy44BM32Iawo=",
            "status": "Deleted"
      },
      "4.0.1": {
         "revision": "byaaQR748wrsdBaT+PDSwL6OMZ7rXeiBKM0551aqWmo=",
            "status": "Deleted"
      },
      "5.0.0": {
         "revision": "yubm34QWeST345ts+ASeioPI354rXeiSWr734PotwRw=",
            "status": "Deleted"
      }
   },
   "failedVersions": {}
}
      
   

You can confirm that the versions were deleted by running list-package-versions for the same package name:

aws codeartifact list-package-versions --domain my_domain --domain-owner 111122223333 \
--repository my_repo --format pypi --package my-package

Deleting a package version (console)

Deleting an npm package or package version

To delete an npm package or individual package versions, set the --format option to npm. To delete a package version in a scoped npm package, use the --namespace option to specify the scope. For example, to delete the package @types/react, use --namespace types. Omit the @ symbol when using --namespace.

aws codeartifact delete-package-versions --domain my_domain --domain-owner 111122223333 \
--repository my_repo --format npm --namespace types \
--package react --versions 0.12.2

To delete the package @types/react, including all of its versions:

aws codeartifact delete-package --domain my_domain --domain-owner 111122223333 \
--repository my_repo --format npm --namespace types \
--package react

Deleting a Maven package or package version

To delete a Maven package or individual package versions, set the --format option to maven and specify the package to delete by passing the Maven group ID with the --namespace option and the Maven artifactID with the --name option. For example, the following shows how to delete a single version of com.google.guava:guava:

 aws codeartifact delete-package-versions --domain my_domain --domain-owner 111122223333 \
--repository my_repo --format maven --namespace com.google.guava \
--package guava --versions 27.1-jre

The following example shows how to delete the package com.google.guava:guava, including all of its versions:

 aws codeartifact delete-package --domain my_domain --domain-owner 111122223333 \
--repository my_repo --format maven --namespace com.google.guava \
--package guava 

Best practices for deleting packages or package versions

If you do need to a delete a package version, as a best practice it's recommended that you create a repository to store a backup copy of the package version you'd like to delete. You can do this by first calling copy-package-versions to the backup repository:

aws codeartifact copy-package-versions --domain my_domain --domain-owner 111122223333 --source-repository my_repo \
 --destination-repository repo-2 --package my-package --format npm \
 --versions 6.0.2 4.0.0

Once you've copied the package version, you can then call delete-package-versions on package or package version you'd like to delete.

aws codeartifact delete-package-versions --domain my_domain --domain-owner 111122223333 \
--repository my_repo --format pypi \
--package my-package --versions 4.0.0 4.0.1 5.0.0