SmartCluster 是在某个 Dataset 内对文件做自动聚类分组的能力，例如对人脸进行聚类（figure）、对关键词进行语义聚类（knowledge）。本文介绍 SmartCluster 的结构，该结构出现在 CreateSmartCluster、GetSmartCluster、ListSmartClusters 等接口的请求或响应中。
名称 | 类型 | 是否必选 | 示例值 | 描述 |
SmartCluster | 容器 | 是 | 不涉及 | SmartCluster 详情容器。 子节点:ObjectId、ClusterType、Name、Description、Rules、Reason、Notification、CreateTime、UpdateTime |
ObjectId | 字符串 | 是 | cluster-abc123def456 | SmartCluster 的唯一 ID,由系统在创建时分配,后续的查询、更新、删除均使用此 ID。 父节点:SmartCluster |
ClusterType | 字符串 | 是 | figure | 聚类类型。取值如下:
父节点:SmartCluster |
Name | 字符串 | 是 | face-cluster-alice | SmartCluster 名,Dataset 内唯一,长度最长 128 字符。 父节点:SmartCluster |
Description | 字符串 | 否 | Cluster faces matching Alice | 描述文本,长度最长 128 字符。 父节点:SmartCluster |
Rules | 容器 | 是 | 不涉及 | 聚类规则列表容器。 子节点:Rule 父节点:SmartCluster |
Rule | 容器 | 是 | 不涉及 | 单条聚类规则的容器。 子节点:RuleType、BaseURIs、Keywords、Sensitivity 父节点:Rules |
RuleType | 字符串 | 是 | face | 聚类规则类型。取值如下:
父节点:Rule |
BaseURIs | 字符串 | 否 | oss://examplebucket/refs/alice.jpg | 参考素材 OSS URI,格式 父节点:Rule |
Keywords | 字符串 | 否 | car | 聚类关键词,RuleType 为 keywords 时必填,多个时本元素出现多次。 父节点:Rule |
Sensitivity | 浮点型 | 否 | 0.7 | 聚类灵敏度,取值范围 [0, 1],值越大匹配越严格。 父节点:Rule |
Reason | 字符串 | 否 | 不涉及 | 聚类任务失败或异常时的原因描述,正常状态下为空。 父节点:SmartCluster |
Notification | 容器 | 否 | 不涉及 | 聚类任务完成消息通知配置容器。 子节点:MNS 父节点:SmartCluster |
MNS | 容器 | 否 | 不涉及 | MNS 消息通知配置容器。 子节点:TopicName 父节点:Notification |
TopicName | 字符串 | 否 | imm-cluster-notification | MNS 主题名称。 父节点:MNS |
CreateTime | 字符串 | 是 | 2026-05-20T11:00:00.000+08:00 | SmartCluster 创建时间,RFC 3339 格式。 父节点:SmartCluster |
UpdateTime | 字符串 | 是 | 2026-05-20T11:05:00.000+08:00 | SmartCluster 上次更新时间,RFC 3339 格式。 父节点:SmartCluster |