DeleteSmartCluster

Usage notes

• By default, your Alibaba Cloud account has permission to delete a SmartCluster. If you use a RAM user, grant the RAM user the oss:MetaQuery permission.

• This API is available only when multi-Dataset routing is enabled by configuring RouteRule in the OpenMetaQuery API.

• Deletion is an irreversible operation. To recreate the SmartCluster, you must call the CreateSmartCluster API.

• When you delete a SmartCluster, the system clears the index for its clustering results. This operation does not affect the original Objects or other metadata in the Dataset.

• Deletion is an asynchronous process. A 200 OK response indicates that the request has been accepted, but the actual server-side cleanup can take several seconds to a few minutes to complete.

• Using the force=true parameter when deleting a Dataset triggers a cascading delete of all SmartClusters within it.

Request syntax

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

Request headers

This operation uses only common request headers. For more information, see Common request headers.

Request parameters

Response headers

This operation uses only common response headers. For more information, see Common response headers.

Response elements

There are no response elements.

Examples

Request example

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

Response example

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