Create an AgentStorage instance - Tablestore API - Tablestore

Creates an AgentStorage instance in a specified region.

Limits

Each Alibaba Cloud account can have up to 10 AgentStorage instances. Instance names must be unique within each region.

Prerequisites

Before you begin, ensure that you have:

An Alibaba Cloud account with an AccessKey pair for signing control-plane OpenAPI requests
AgentStorage management permissions, such as AliyunOTSFullAccess or an equivalent control-plane policy, granted to the Alibaba Cloud account or Resource Access Management (RAM) user

Request syntax

POST /v2/openapi/createagentstorage HTTP/1.1

Request parameters

Parameter	Type	Required	Description
`AgentStorageName`	string	Yes	The instance name. The name must be 3–16 characters in length, start with a letter, and contain only letters, digits, and hyphens (-). The name is case-insensitive and cannot end with a hyphen (-). It cannot contain `ali`, `ay`, `ots`, `taobao`, or `admin`.
`AgentStorageDescription`	string	No	The instance description. The description must be 3–256 characters in length.
`ResourceGroupId`	string	No	The resource group ID.
`NetworkTypeACL`	array<string>	No	The allowed network types. Valid values: `CLASSIC`, `INTERNET`, and `VPC`. If you leave this parameter unspecified, all network types are allowed.
`NetworkSourceACL`	array<string>	No	The allowed network sources. `TRUST_PROXY` specifies the console. If you leave this parameter unspecified, all network sources are allowed.
`Policy`	string	No	The instance access control policy in JSON format.
`Tags`	array<object>	No	The tags to add to the instance. Each tag must contain a `Key` and a `Value`. Each can be up to 64 characters in length.

Request example

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

Response elements

Parameter	Type	Description
`RequestId`	string	The request ID.
`Code`	string	The response status code.
`Message`	string	The response message.

Response example

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

After the request succeeds, poll the AgentStorage instance by calling GetAgentStorage until AgentStorageStatus is normal. You can then create knowledge bases or memory stores.