使用CreateRecallManagementTable创建召回管理表-人工智能平台 PAI-阿里云

用于创建一个新的召回管理表，支持多种数据源和配置选项。

接口说明

InstanceId、Name、Description、Type 和 DataSource 是必填项。
RecallType 可选，但若指定则必须符合枚举值要求。
Fields 中的每个字段需要定义其名称（Name）、类型（Type）以及属性（Attributes），其中至少一个字段需被标记为 Primary。
如果使用 Maxcompute 作为数据源，则 MaxcomputeProjectName 和 MaxcomputeTableName 必须提供；MaxcomputeSchema 是可选项。
对于向量类型的字段，如果设置了 VectorDimension 和 VectorMetricType，请确保这些值与实际数据匹配。
Config 字段允许用户添加额外的配置信息，格式为 JSON 字符串。
波动阈值相关参数（如 EnableRowCountFluctuationThreshold 等）提供了对表内数据条目或大小变化的监控能力，可根据需求启用并设置合理的阈值范围。

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作	访问级别	资源类型	条件关键字	关联操作
pairec:CreateRecallManagementTable	create	全部资源 ``	无	无

POST /api/v1/recallmanagementtables HTTP/1.1

名称	类型	必填	描述	示例值
body	object	否	请求 body。
InstanceId	string	是	实例 ID	pairec-cn-test123
Name	string	否	表名称。	table-123
Description	string	否	表备注。	this is a test table
Type	string	否	表类型。	Recall
RecallType	string	否	表的召回类型。	X2I
DataSource	string	否	数据来源。	MaxcomputeAndApiApi
MaxcomputeProjectName	string	否	maxcompute 项目。	test
MaxcomputeTableName	string	否	maxcompute 中表名。	table-1
Fields	array<object>	否	字段列表。
	object	否	字段详情。
Name	string	否	字段名称。	age
Type	string	否	字段类型。	STRING(全大写)
Attributes	array	否	枚举值： Primary：主键字段 Item：物品字段 Score：召回分字段 Vector：向量字段 Index：索引字段字段属性。
	string	否	字段属性。	Primary
VectorDimension	integer	否	向量维度。	32
VectorMetricType	string	否	向量指标类型。	L2
Config	string	否	表的一些额外配置	{"":""}
EnableRowCountFluctuationThreshold	boolean	否	是否启动表数据条目波动阈值	true
MinRowCountFluctuationThreshold	long	否	表数据条目波动阈值最小值	10
MaxRowCountFluctuationThreshold	long	否	表数据条目波动阈值最大值	100
EnableDataSizeFluctuationThreshold	boolean	否	是否启动表大小波动阈值	true
MinDataSizeFluctuationThreshold	long	否	表大小波动阈值最小值	10
MaxDataSizeFluctuationThreshold	long	否	表大小波动阈值最大值。	100
MaxcomputeSchema	string	否	maxcompute 的 schema	default

正常返回示例

JSON格式

{
  "RequestId": "728C5E01-ABF6-5AA8-B9FC-B3BA05DECC77",
  "RecallManagementTableId": 3
}

访问错误中心查看更多错误码。

变更时间	变更内容概要	操作
2026-01-13	新增 OpenAPI	查看变更详情