Docs

Big Data File Storage

Manage TOS Bucket

DeleteNs

Call the DeleteNs API to delete a Namespace in a data lake scenario instance, which also uninstalls the TOS Bucket.

Notice

This API is only supported for data lake scenario instances.

Prerequisites

To uninstall a TOS Bucket by specifying a Namespace ID, obtain the Namespace ID in advance. For related APIs, see ListNs.

Request parameters

Parameter	Category	Required	Example value	Note
NsId	String	Yes	1801439***487040	ID of the Namespace to be deleted.

Response parameters

Parameter	Category	Example value	Note
TaskId	String	fca781e8***087c9b29079e	Returned backend task ID.

Request example

POST https://open.volcengineapi.com?Action=DeleteNs&Version=2022-02-02​
Content-Type: application/json​
Region: cn-beijing​
ServiceName: cfs​
{​
"NsId": "1801439***487040"​
}​

Response example

{​
    "Result": {​
        "TaskId": "fca781e8***087c9b29079e"​
    },​
    "ResponseMetadata": {​
        "RequestId": "20230423185214***155000CA08219B",​
        "Action": "DeleteNs",​
        "Version": "2022-02-02",​
        "Service": "cfs",​
        "Region": "cn-beijing",​
        "Error": null​
    }​
}​

Error codes

The following table lists the error codes for this API. For common error codes, refer to Common error codes.

HttpCode	Error code	Error message
400	InvalidNsId	Namespace ID is invalid and must be a string composed of digits only.
400	InvalidNsStatus	Namespace status is invalid.
404	NsIdNotFound	Namespace ID does not exist.

Last updated: 2026.02.02 11:49:55