GetSmartCluster-Object Storage Service(OSS)-阿里云帮助中心

Retrieves the details of a specified SmartCluster, including its clustering rules, message notification configuration, and creation and update times.

Usage notes

An Alibaba Cloud account can query SmartClusters by default. A RAM user can perform this operation only if granted the oss:MetaQuery permission.
You can use this operation only after enabling multi-dataset routing by configuring RouteRule in the OpenMetaQuery operation.
You can obtain the objectId from the response of the CreateSmartCluster operation or from the list returned by the ListSmartClusters operation.
The response nests the SmartCluster details within the SmartCluster element, which is a child of the GetSmartClusterResponse root element.

Request syntax

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

Request headers

See Common Request Headers for details.

Request parameters

Parameter	Type	Required	Example	Description
datasetName	string	Yes	photos-2026	The name of the dataset containing the SmartCluster.
objectId	string	Yes	cluster-abc123def456	The unique ID of the SmartCluster.

Response headers

See Common Response Headers for details.

Response elements

Parameter

Type

Required

Example

Description

GetSmartClusterResponse

container

Yes

N/A

The root element of the response.

Child node: SmartCluster

SmartCluster

container

Yes

N/A

A container for the SmartCluster details. For details, see SmartCluster data structure.

Parent node: GetSmartClusterResponse

Examples

Sample request

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

Sample response

HTTP/1.1 200 OK
x-oss-request-id: 64C8B6F4E7C5A3A8B9D6E7F7
Date: Wed, 20 May 2026 11:10:01 GMT
Content-Type: application/xml
Server: AliyunOSS

<?xml version="1.0" encoding="UTF-8"?>
<GetSmartClusterResponse>
  <SmartCluster>
    <ObjectId>cluster-abc123def456</ObjectId>
    <ClusterType>figure</ClusterType>
    <Name>face-cluster-alice</Name>
    <Description>Cluster faces matching Alice</Description>
    <Rules>
      <Rule>
        <RuleType>face</RuleType>
        <BaseURIs>oss://examplebucket/refs/alice.jpg</BaseURIs>
        <Sensitivity>0.7</Sensitivity>
      </Rule>
    </Rules>
    <Reason></Reason>
    <Notification>
      <MNS>
        <TopicName>imm-cluster-notification</TopicName>
      </MNS>
    </Notification>
    <CreateTime>2026-05-20T11:00:00.000+08:00</CreateTime>
    <UpdateTime>2026-05-20T11:05:00.000+08:00</UpdateTime>
  </SmartCluster>
</GetSmartClusterResponse>