Delete repositories
Remove specific repositories from the private image registry.
Base path: https://<Cluster Master Host>:<Cluster Master API Port>/image-manager/api/v1/repositories/<repo>
-
The
<Cluster Master Host>
and<Cluster Master API Port>
parameters are defined in Master endpoints. -
repo
is the full name of the repository image, including the namespace. For example,default/alpine
. The private image registry creates individual repositories for images that are assigned the same name. When you remove an image repository, you remove all the images in that repository. You cannot remove a specific image within the repository.For example,
mycluster.icp:8500/default/nginx:1.9.1
is an image in themycluster.icp:8500/default/nginx
repository.
After you remove the repository, you can remove the related files from the registry storage. See Removing image files from the private registry storage.
- API version
- 3.2.0
- API URI components
-
- Scheme
HTTPS
- Host name
Cluster Master Host
- Port number
Cluster Master API Port
- Base path
/image-manager/api/v1/repositories/{namespace}/{repo}
- Command
DELETE
- Command output format
application/json
The sample curl command resembles the following code:
curl -X DELETE -H "Authorization:Bearer $ID_TOKEN" https://<Cluster Master Host>:<Cluster Master API Port>/image-manager/api/v1/repositories/<repo> --insecure
The command does not return any messages.
root@master:~# curl -X DELETE -H "Authorization: Bearer $ID_TOKEN" https://mycluster.icp:8443/image-manager/api/v1/repositories/default/alpine --insecure
Parameters
Type | Name | Description | Schema | Default | Required |
---|---|---|---|---|---|
Path | namespace | Namespace where the repository is | string | Yes | |
Path | repo:.* | Name of repository | string | Yes |
Responses
HTTP Code | Description | Schema |
---|---|---|
200 | OK | No content |