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

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

调试

前提条件

说明

AgentStorage 管理 API 需使用 Tablestore 的 OpenAPI 域名，格式为 tablestore.<region>.aliyuncs.com，各地域完整域名请参见OpenAPI Endpoints。

拥有阿里云账号并获取 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，再创建知识库或记忆库。