You need to enable JavaScript to run this app.
Container Registry

Container Registry

Copy page
Download PDF
Namespace Management
DeleteNamespace
Copy page
Download PDF
DeleteNamespace
Deletes a namespace under a specified Container Registry instance.​
API description​
Before deleting a namespace, call DeleteRepository to delete the OCI artifact repositories under the target namespace.​
Request description​
To achieve low latency, it is recommended that you select the corresponding service address based on the region where your resources are located. For details, refer to service address.​
  • Request method: POST​
  • Request URL: https://cr.cn-beijing.volcengineapi.com?Action=DeleteNamespace&Version=2022-05-12​
Debugging​
API Explorer
You can initiate calls online through API Explorer without paying attention to the signature generation process and quickly obtain the call results.
​
Request parameters​
When calling this API, in addition to the following request parameters, you also need to provide the public request parameters. See Public parameters for details.​
​
Parameter​
Type​
Required​
Sample value​
Description​
Action​
String​
Yes​
DeleteNamespace​
The API name. The current API's name is DeleteNamespace.​
Version​
String​
Yes​
2022-05-12​
The API version. The current version of the API is 2022-05-12.​
Registry​
String​
Yes​
registrya​
The name of the Container Registry instance to which the namespace to be deleted belongs. On the Container Registry Console Instance List page, obtain the instance name.​
Name​
String​
Yes​
library​
The name of the namespace to be deleted. On the Container Registry Console namespace page of the target instance, obtain the namespace name.​
​
Sample requests​
​
POST https://cr.cn-beijing.volcengineapi.com?Action=DeleteNamespace&Version=2022-05-12​
{​
"Registry": "registrya",​
"Name": "library"​
}​
​
Response parameters​
None​
Sample responses​
​
{​
"ResponseMetadata": {​
"RequestId": "540CFF28-407A-40B5-B6A5-74Bxxxxxxxxx",​
"Action": "DeleteNamespace",​
"Version": "2022-05-12",​
"Service": "cr",​
"Region": "cn-beijing"​
},​
"Result": {}​
}​
​
Error code​
The error codes for this interface are listed in the following table. For additional public error codes, refer to public error code.​
​
HTTP Status Code​
Error code​
Error Message​
Descriptions​
400​
OperationDenied.RegistryStatus​
The action has been denied due to wrong status %s.​
The specified operation is not allowed under the current instance status. Please wait for the status transition to complete and try again.​
400​
NotEmpty.Namespace​
Delete namespace is forbidden due to repository exist.​
There are uncleaned OCI artifacts under the namespace. Please delete all OCI artifacts under the namespace first and then try again.​
​
Last updated: 2025.09.02 11:38:34