diff --git a/content/manuals/docker-hub/repos/manage/hub-images/manage.md b/content/manuals/docker-hub/repos/manage/hub-images/manage.md index f69c1cca9362..b0744339dcf3 100644 --- a/content/manuals/docker-hub/repos/manage/hub-images/manage.md +++ b/content/manuals/docker-hub/repos/manage/hub-images/manage.md @@ -26,6 +26,10 @@ The following objects are shown in the diagram. ## Manage repository images and image indexes +Use the following steps to delete one or more items via the graphical user +interface. To delete in bulk, see the [deletion API +endpoint](/reference/api/registry/latest/#tag/delete). + 1. Sign in to [Docker Hub](https://hub.docker.com). 2. Select **My Hub** > **Repositories**. 3. In the list, select a repository. @@ -51,7 +55,9 @@ The following objects are shown in the diagram. amount of storage you will reclaim. 4. Select **Delete forever**. - > [!NOTE] > - > If you would like to delete in bulk, you can use the [deletion API endpoint](/reference/api/registry/latest/#tag/delete). + > Deletion operations may take some time to complete. Timeout errors may + > occur during the deletion process. The system automatically retries the + > deletion in the background, and the items will be removed without requiring + > any action from you. \ No newline at end of file diff --git a/content/reference/api/registry/latest.yaml b/content/reference/api/registry/latest.yaml index c38c9ffd718a..445cc7f98f95 100644 --- a/content/reference/api/registry/latest.yaml +++ b/content/reference/api/registry/latest.yaml @@ -200,6 +200,10 @@ tags: Only untagged manifests (or those not referenced by other tags or images) can be deleted. If a manifest is still referenced, the registry returns `403 Forbidden`. + > **Note** + > + > Manifest deletion operations may experience latency and could return a `500 Internal Server Error` during deletion. The system automatically retries the deletion in the background, so the manifest will eventually be removed. You do not need to manually retry the request. + This section outlines the basic steps to delete an image using the registry API. 1. [Get a bearer token for the repository](https://docs.docker.com/reference/api/registry/auth/). @@ -657,6 +661,10 @@ paths: Only untagged or unreferenced manifests can be deleted. If the manifest is still referenced by a tag or another image, the registry will return `403 Forbidden`. This operation requires `delete` access to the repository. + + > **Note** + > + > Manifest deletion operations may take some time and could return a `500 Internal Server Error`. The system automatically retries the deletion in the background. Manual intervention is not required. parameters: - name: name in: path