All Products
Search
Document Center

Tablestore:CreateAgentStorage

Last Updated:Jul 06, 2026

Creates an agent storage.

Operation description

  • Before you use this operation, make sure that you fully understand the billing of Tablestore. For more information, see Billing overview.

  • You can create up to 10 agent storages for a single Alibaba Cloud account. Agent storage names must be unique within the same region.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request syntax

POST /v2/openapi/createagentstorage HTTP/1.1

Request parameters

Parameter

Type

Required

Description

Example

body

object

No

The request body parameters.

AgentStorageName

string

Yes

The name of the agent storage. The naming conventions are as follows:

  • The name can contain only letters, digits, and hyphens (-).

  • The name must start with a letter.

  • The name cannot end with a hyphen (-).

  • The name is case-insensitive.

  • The name must be 3 to 16 characters in length.

  • The name cannot contain the following words: ali, ay, ots, taobao, or admin.

first-agent

AgentStorageDescription

string

No

The description of the agent storage. The description must be 3 to 256 characters in length.

description for agent storage

ResourceGroupId

string

No

The resource group ID.

rg-acfmxh4em5jnbcd

Network

string

No

(Deprecated) The network type of the agent storage. Valid values: NORMAL and VPC_CONSOLE. Default value: NORMAL.

VPC

NetworkTypeACL

array

No

The list of allowed network types for the agent storage. All types are allowed by default. Valid values:

  • CLASSIC: classic network.

  • INTERNET: public network.

  • VPC: VPC network.

string

No

The allowed network type for the agent storage.

INTERNET

NetworkSourceACL

array

No

The list of allowed network sources for the agent storage. All sources are allowed by default. Valid values:

  • TRUST_PROXY: console.

string

No

The allowed network source for the agent storage.

TRUST_PROXY

Policy

string

No

The access control policy for the agent storage in JSON format. For the syntax, see https://www.alibabacloud.com/help/en/ram/user-guide/policy-structure-and-syntax.

{ "Version": "1", "Statement": [ { "Action": [ "ots:*" ], "Resource": [ "acs:ots:*:13791xxxxxxxxxxx:agentstorage/myagentstorage*" ], "Principal": [ "*" ], "Effect": "Allow", "Condition": { "StringEquals": { "ots:TLSVersion": [ "1.2" ] }, "IpAddress": { "acs:SourceIp": [ "192.168.0.1", "198.51.100.1" ] } } } ] }

Tags

array<object>

No

The list of tags.

object

No

The tag key-value pair.

Key

string

Yes

The key of the tag. The key can be up to 64 characters in length.

created

Value

string

Yes

The value of the tag. The value can be up to 64 characters in length.

0woauavextilfqr61

Response elements

Element

Type

Description

Example

object

The response struct.

RequestId

string

The request ID, which can be used for troubleshooting.

18DD77BF-F967-576D-80D1-79121399AB53

Code

string

The response status code.

200

Message

string

The response message.

success

Examples

Success response

JSON format

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

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.