CreateAgentStorage 创建 AgentStorage-表格存储 Tablestore(Tablestore)-阿里云帮助中心

使用 CreateAgentStorage 接口在指定地域创建一个 AgentStorage 实例。

前提条件

拥有阿里云账号并获取 AccessKey（AccessKey ID 和 AccessKey Secret），用于管控面 OpenAPI 签名认证。
当前账号或 RAM 子账号具备 AgentStorage 管理权限（如 AliyunOTSFullAccess 或对应管控策略）。
单账号最多 10 个 AgentStorage、同地域名称唯一，创建前确认配额和命名。

请求语法

POST /v2/openapi/createagentstorage HTTP/1.1

请求参数

字段	类型	必填	说明
`AgentStorageName`	string	是	实例名称，长度 3～16 个字符。以英文字母开头，只能包含英文字母、数字和短划线，末尾不能是短划线，大小写不敏感。不能包含 `ali`、`ay`、`ots`、`taobao` 或 `admin`。
`AgentStorageDescription`	string	否	实例描述，长度 3～256 个字符。
`ResourceGroupId`	string	否	资源组 ID。
`NetworkTypeACL`	array<string>	否	允许的网络类型：`CLASSIC`、`INTERNET`、`VPC`。不传时默认全部允许。
`NetworkSourceACL`	array<string>	否	允许的网络来源；`TRUST_PROXY` 表示控制台。不传时默认全部允许。
`Policy`	string	否	JSON 格式的实例访问控制策略。
`Tags`	array<object>	否	标签列表。每项包含必填的 `Key` 和 `Value`，二者最长均为 64 个字符。

请求示例

{
  "AgentStorageName": "agent-prod",
  "AgentStorageDescription": "Production storage for AI agents",
  "ResourceGroupId": "rg-example",
  "NetworkTypeACL": ["INTERNET", "VPC"],
  "Tags": [
    {"Key": "Environment", "Value": "production"}
  ]
}

响应

字段	类型	说明
`RequestId`	string	请求 ID。
`Code`	string	响应状态码。
`Message`	string	响应消息。

{
  "RequestId": "18DD77BF-F967-576D-80D1-79121399AB53",
  "Code": "200",
  "Message": "success"
}

创建请求成功后，使用 GetAgentStorage 等待 AgentStorageStatus 变为 normal，再创建知识库或记忆库。