DeleteSmartCluster-对象存储(OSS)-阿里云帮助中心

调用 DeleteSmartCluster 接口删除指定 SmartCluster 及其聚类结果。Dataset 中原 Object 的元数据不受影响。

注意事项

阿里云账号默认拥有删除 SmartCluster 的权限。如需通过 RAM 用户删除,请确保 RAM 用户拥有 oss:MetaQuery 权限。
本接口仅在 OpenMetaQuery 时配置了 RouteRule 启用多 Dataset 路由的场景下可用。
删除是不可恢复操作。如需重建,请再次调用 CreateSmartCluster。
删除 SmartCluster 时会清理其聚类结果索引,不影响原 Object 及 Dataset 中其它元数据。
删除是异步的,接口返回 200 仅表示请求已被接收,实际清理由服务端在数秒到数分钟内完成。
删除 Dataset 时若使用 force=true,会级联删除该 Dataset 内全部 SmartCluster。

请求语法

POST /?metaQuery&action=deleteSmartCluster&datasetName=DatasetName&objectId=ObjectId HTTP/1.1
Host: BucketName.oss-cn-hangzhou.aliyuncs.com
Date: GMT Date
Authorization: SignatureValue

请求头

此接口仅涉及公共请求头。更多信息,请参见公共请求头(Common Request Headers)。

请求元素

名称	类型	是否必选	示例值	描述
datasetName	字符串	是	photos-2026	SmartCluster 所在的 Dataset 名。
objectId	字符串	是	cluster-abc123def456	SmartCluster 的唯一 ID。

响应头

此接口仅涉及公共响应头。更多信息,请参见公共响应头(Common Response Headers)。

响应元素

此接口无响应元素。

示例

请求示例

POST /?metaQuery&action=deleteSmartCluster&datasetName=photos-2026&objectId=cluster-abc123def456 HTTP/1.1
Host: examplebucket.oss-cn-hangzhou.aliyuncs.com
Date: Wed, 20 May 2026 13:00:00 GMT
Authorization: OSS4-HMAC-SHA256 Credential=LTAI********************/20260520/cn-hangzhou/oss/aliyun_v4_request,Signature=a7c3554c729d71929e0b84489addee6b2e8d5cb48595adfc51868c299c0c218e

返回示例

HTTP/1.1 200 OK
x-oss-request-id: 64C8B6F4E7C5A3A8B9D6E7F9
Date: Wed, 20 May 2026 13:00:01 GMT
Content-Length: 0
Connection: keep-alive
Server: AliyunOSS