DeleteNs--大数据文件存储-火山引擎

文档中心

立即注册

导航

DeleteNs

最近更新时间：2023.05.18 15:33:39首次发布时间：2023.05.18 14:53:13

调用 DeleteNs 接口，删除数据湖场景实例中的 Namespace，也会卸载 TOS Bucket。

注意事项

仅数据湖场景实例支持该接口。

前提条件

需要通过指定 Namespace ID 卸载 TOS Bucket，请提前获取 Namespace ID。相关接口，请参见ListNs。

请求参数

参数	类型	是否必填	示例值	说明
NsId	String	是	1801439***487040	需要删除的 Namespace 的 ID。

返回参数

参数	类型	示例值	说明
TaskId	String	fca781e8***087c9b29079e	返回的后端任务 ID。

请求示例

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

返回示例

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

错误码

下表列举了本接口的错误码信息。公共错误码信息，请参考公共错误码。

HttpCode	错误码	错误信息
400	InvalidNsId	Namespace ID 不合法，应为纯数字组成的字符串。
400	InvalidNsStatus	Namespace 状态不合法。
404	NsIdNotFound	Namespace ID 不存在。