# Alibaba Cloud Tablestore API

> Alibaba Cloud Tablestore API on Apizie: 33 endpoints (Binds agent storage to a VPC, Binds an instance to a VPC, Changes the resource group to which an instance belongs, Checks the validity of an agent storage access control policy, …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://apizie.tech/v1/cloud:aliyun-tablestore/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `cloud:aliyun-tablestore`
- Category: Cloud
- Status: byok
- Source: https://api.alibabacloud.com/product/tablestore
- Page: https://apizie.tech/api/cloud/aliyun-tablestore
- OpenAPI: https://apizie.tech/api/cloud/aliyun-tablestore/openapi.json

Alibaba Cloud OpenAPI for Tablestore (tablestore, version 2020-12-09). Calls are signed with ACS3-HMAC-SHA256 using your AccessKey ID and secret.

## Endpoints

### Binds agent storage to a VPC
`POST https://apizie.tech/v1/cloud:aliyun-tablestore/bind-agent-storage2-vpc` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://tablestore.ap-southeast-1.aliyuncs.com |
| AgentStorageName | string | yes | The agent storage name |
| AgentStorageVpcName | string | yes | The VPC name |
| VirtualSwitchId | string | yes | The vSwitch ID |
| VpcId | string | yes | VPC ID |

### Binds an instance to a VPC
`POST https://apizie.tech/v1/cloud:aliyun-tablestore/bind-instance2-vpc` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://tablestore.ap-southeast-1.aliyuncs.com |
| InstanceName | string | yes | The instance name |
| InstanceVpcName | string | yes | The VPC name |
| VirtualSwitchId | string | yes | The virtual switch ID |
| VpcId | string | yes | The VPC ID |

### Changes the resource group to which an instance belongs
`POST https://apizie.tech/v1/cloud:aliyun-tablestore/change-resource-group` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://tablestore.ap-southeast-1.aliyuncs.com |
| NewResourceGroupId | string | yes | The ID of the new resource group |
| ResourceId | string | yes | The resource ID, which is the instance name |

### Checks the validity of an agent storage access control policy
`POST https://apizie.tech/v1/cloud:aliyun-tablestore/check-agent-storage-policy` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://tablestore.ap-southeast-1.aliyuncs.com |
| AgentStorageName | string | yes | The agent storage name |
| Policy | string | yes | The agent storage access control policy in JSON format |

### Checks the validity of a Resource Access Management (RAM) policy for an instance
`POST https://apizie.tech/v1/cloud:aliyun-tablestore/check-instance-policy` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://tablestore.ap-southeast-1.aliyuncs.com |
| InstanceName | string | yes | The name of the instance |
| Policy | string | yes | The instance policy in the JSON format |

### Creates an agent storage
`POST https://apizie.tech/v1/cloud:aliyun-tablestore/create-agent-storage` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://tablestore.ap-southeast-1.aliyuncs.com |
| AgentStorageDescription | string | no | The description of the agent storage. The description must be 3 to 256 characters in length |
| 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… |
| Network | string | no | (Deprecated) The network type of the agent storage. Valid values: NORMAL and VPC_CONSOLE. Default value: NORMAL |
| NetworkSourceACL | array | no | The list of allowed network sources for the agent storage. All sources are allowed by default. Valid values: TRUST_PROXY: console |
| NetworkTypeACL | array | no | The list of allowed network types for the agent storage. All types are allowed by default. Valid values: CLASSIC: classic network.… |
| Policy | string | no | The access control policy for the agent storage in JSON format. For the syntax, see… |
| ResourceGroupId | string | no | The resource group ID |
| Tags | array | no | The list of tags |

### Creates an instance
`POST https://apizie.tech/v1/cloud:aliyun-tablestore/create-instance` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://tablestore.ap-southeast-1.aliyuncs.com |
| ClusterType | string | yes | The type of the instance |
| DisableReplication | string | no | (Deprecated) Specifies whether to enable disaster recovery for the instance. Valid values: false true |
| InstanceDescription | string | no | The description of the instance. The instance description must be 3 to 256 characters in length |
| InstanceName | string | yes | The name of the instance. Instance naming conventions: The name can contain only letters, digits, and hyphens (-). The name must start… |
| Network | string | no | (Deprecated) The network type of the instance. Valid values: NORMAL and VPC_CONSOLE. Default value: NORMAL |
| NetworkSourceACL | array | no | The types of the source from which access is allowed. By default, the following source type is allowed: TRUST_PROXY: console |
| NetworkTypeACL | array | no | The types of the network from which access is allowed. By default, the following network types are allowed: INTERNET: Internet VPC:… |
| Policy | string | no | The instance policy in the JSON format |
| ResourceGroupId | string | no | The ID of the resource group to which the instance belongs |
| Tags | array | no | The tags |

### Creates a VCU instance
`POST https://apizie.tech/v1/cloud:aliyun-tablestore/create-vcuinstance` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://tablestore.ap-southeast-1.aliyuncs.com |
| AliasName | string | no | The alias of the instance |
| AutoRenewPeriodInMonth | integer | no | The auto-renewal cycle. This parameter is required if auto-renewal is enabled |
| ClusterType | string | yes | The cluster type |
| DryRun | string | no | Specifies whether to perform a dry run. If you perform a dry run, no instance is created |
| EnableAutoRenew | string | no | Specifies whether to enable auto-renewal |
| EnableElasticVCU | string | no | Specifies whether to enable instance elasticity. If you enable instance elasticity, the peak VCU usage can exceed the purchased VCU… |
| InstanceDescription | string | no | The description of the instance |
| PeriodInMonth | integer | yes | The subscription duration. Unit: month |
| ResourceGroupId | string | no | The ID of the resource group |
| Tags | array | no | The tags |
| VCU | integer | yes | The instance type: the number of VCUs |

### Deletes an agent storage
`POST https://apizie.tech/v1/cloud:aliyun-tablestore/delete-agent-storage` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://tablestore.ap-southeast-1.aliyuncs.com |
| AgentStorageName | string | yes | The name of the agent storage |

### Deletes an access control policy for agent storage
`POST https://apizie.tech/v1/cloud:aliyun-tablestore/delete-agent-storage-policy` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://tablestore.ap-southeast-1.aliyuncs.com |
| AgentStorageName | string | yes | The name of the agent storage |
| PolicyVersion | integer | yes | The version of the access control policy for agent storage |

### Deletes an instance
`POST https://apizie.tech/v1/cloud:aliyun-tablestore/delete-instance` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://tablestore.ap-southeast-1.aliyuncs.com |
| InstanceName | string | yes | The name of the instance |

### Deletes a Resource Access Management (RAM) policy of an instance
`POST https://apizie.tech/v1/cloud:aliyun-tablestore/delete-instance-policy` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://tablestore.ap-southeast-1.aliyuncs.com |
| InstanceName | string | yes | The name of the instance |
| PolicyVersion | integer | yes | The version of the instance policy |

### Deletes a VCU instance
`POST https://apizie.tech/v1/cloud:aliyun-tablestore/delete-vcuinstance` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://tablestore.ap-southeast-1.aliyuncs.com |
| InstanceName | string | yes | The name of the instance |

### Retrieves a list of available regions
`GET https://apizie.tech/v1/cloud:aliyun-tablestore/describe-regions` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://tablestore.ap-southeast-1.aliyuncs.com |
| ClientToken | string | no | A parameter to ensure idempotence. This parameter ensures that each request is processed only once. Generate a unique value on the client… |

### Retrieves agent storage
`GET https://apizie.tech/v1/cloud:aliyun-tablestore/get-agent-storage` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://tablestore.ap-southeast-1.aliyuncs.com |
| AgentStorageName | string | yes | The name of the agent storage |

### Queries instance information
`GET https://apizie.tech/v1/cloud:aliyun-tablestore/get-instance` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://tablestore.ap-southeast-1.aliyuncs.com |
| InstanceName | string | yes | The name of the instance |

### Lists agent storages
`GET https://apizie.tech/v1/cloud:aliyun-tablestore/list-agent-storages` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://tablestore.ap-southeast-1.aliyuncs.com |
| Status | string | no | The status of the agent storage |
| MaxResults | integer | no | The maximum number of tag resources to return in this request |
| NextToken | string | no | The pagination token for querying subsequent pages. This parameter has a value only when not all tag resources are returned. If the total… |
| AgentStorageName | string | no | The name of the agent storage |
| ResourceGroupId | string | no | The ID of the resource group. You can query the ID in the Resource Group console |
| AgentStorageNameList | string | no | The list of agent storage names. Use this parameter to query multiple specified agent storages in a batch (JSON-encoded) |
| Tag | string | no | The list of tags (JSON-encoded) |

### Lists the supported cluster types in the current region
`GET https://apizie.tech/v1/cloud:aliyun-tablestore/list-cluster-type` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://tablestore.ap-southeast-1.aliyuncs.com |

### Queries instances
`GET https://apizie.tech/v1/cloud:aliyun-tablestore/list-instances` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://tablestore.ap-southeast-1.aliyuncs.com |
| Status | string | no | The status of the instance |
| MaxResults | integer | no | The maximum number of instances that you want to return. Valid values: 0 to 200. If you do not configure this parameter or set this… |
| NextToken | string | no | The token that determines the start position of the query. Set this parameter to the value of the NextToken parameter that is returned… |
| InstanceName | string | no | The name of the instance. Fuzzy search is supported |
| ResourceGroupId | string | no | The resource group ID. You can query the ID on the Resource Group page in the Resource Management console |
| InstanceNameList | string | no | The names of the instances. This parameter is used to specify multiple instances that you want to query at the same time (JSON-encoded) |
| Tag | string | no | The tags of the instance (JSON-encoded) |

### Queries tagged resources
`GET https://apizie.tech/v1/cloud:aliyun-tablestore/list-tag-resources` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://tablestore.ap-southeast-1.aliyuncs.com |
| MaxResults | integer | no | The maximum number of tagged resources that you want to return. Valid values: 0 to 200. If you do not specify this parameter or set the… |
| ResourceType | string | no | The type of the resource. valid value: instance: instance |
| ResourceIds | string | no | The resource IDs, which are instance names (JSON-encoded) |
| Tags | string | no | The tags (JSON-encoded) |
| NextToken | string | no | The pagination token that is used in the next request to retrieve a new page of results. You do not need to specify this parameter for the… |

### Retrieves the list of VPC information stored in an agent storage
`GET https://apizie.tech/v1/cloud:aliyun-tablestore/list-vpc-info-by-agent-storage` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://tablestore.ap-southeast-1.aliyuncs.com |
| AgentStorageName | string | yes | The agent storage name |
| PageNum | integer | no | The page number |
| PageSize | integer | no | The number of VPCs per page for the query |

### Retrieves a list of VPC information for an instance
`GET https://apizie.tech/v1/cloud:aliyun-tablestore/list-vpc-info-by-instance` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://tablestore.ap-southeast-1.aliyuncs.com |
| InstanceName | string | yes | The name of the instance |
| PageNum | integer | no | The page number |
| PageSize | integer | no | The number of VPCs to return on each page |

### Retrieves a list of VpcInfo objects for a specified Virtual Private Cloud (VPC)
`GET https://apizie.tech/v1/cloud:aliyun-tablestore/list-vpc-info-by-vpc` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://tablestore.ap-southeast-1.aliyuncs.com |
| VpcId | string | yes | The ID of the VPC |
| PageNum | integer | no | The page number |
| PageSize | integer | no | The number of VPCs to return on each page |

### Adds tags to instances
`POST https://apizie.tech/v1/cloud:aliyun-tablestore/tag-resources` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://tablestore.ap-southeast-1.aliyuncs.com |
| ResourceIds | array | yes | The resource IDs, which are instance names |
| ResourceType | string | yes | The type of the resource. valid value: instance: instance |
| Tags | array | yes | The tags |

### Disassociates agent storage from a VPC
`POST https://apizie.tech/v1/cloud:aliyun-tablestore/unbind-agent-storage2-vpc` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://tablestore.ap-southeast-1.aliyuncs.com |
| AgentStorageName | string | yes | The agent storage name |
| AgentStorageVpcName | string | yes | The VPC name |

### Detaches an instance from a VPC
`POST https://apizie.tech/v1/cloud:aliyun-tablestore/unbind-instance2-vpc` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://tablestore.ap-southeast-1.aliyuncs.com |
| InstanceName | string | yes | The name of the instance |
| InstanceVpcName | string | yes | The name of the VPC |

### Removes tags from resources
`POST https://apizie.tech/v1/cloud:aliyun-tablestore/untag-resources` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://tablestore.ap-southeast-1.aliyuncs.com |
| All | string | no | Specifies whether to remove all tags from the resources. Default value: false |
| ResourceIds | array | no | The resource IDs, which are instance names |
| ResourceType | string | no | The type of the resource. valid value: instance: instance |
| TagKeys | array | no | The tag keys |

### Updates agent storage
`POST https://apizie.tech/v1/cloud:aliyun-tablestore/update-agent-storage` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://tablestore.ap-southeast-1.aliyuncs.com |
| AgentStorageDescription | string | no | The description of the agent storage |
| AgentStorageName | string | yes | The name of the agent storage |
| AliasName | string | no | The alias of the agent storage |
| Network | string | no | (Deprecated) The network type of the agent storage. Valid values: NORMAL and VPC_CONSOLE. Default value: NORMAL |
| NetworkSourceACL | array | no | The list of allowed network sources for the agent storage. All sources are allowed by default. Must be used with TRUST_PROXY (console) |
| NetworkTypeACL | array | no | The list of allowed network types for the agent storage. All types are allowed by default. Valid values: CLASSIC: classic network.… |

### Modifies the access control policy of agent storage
`POST https://apizie.tech/v1/cloud:aliyun-tablestore/update-agent-storage-policy` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://tablestore.ap-southeast-1.aliyuncs.com |
| AgentStorageName | string | yes | The name of the agent storage |
| Policy | string | yes | The access control policy of the agent storage in JSON format. For more information, see… |
| PolicyVersion | integer | yes | The version of the agent storage access control policy |

### Updates instance information
`POST https://apizie.tech/v1/cloud:aliyun-tablestore/update-instance` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://tablestore.ap-southeast-1.aliyuncs.com |
| AliasName | string | no | The alias of the instance |
| InstanceDescription | string | no | The description of the instance |
| InstanceName | string | yes | The name of the instance whose information you want to update |
| Network | string | no | (Deprecated) The network type of the instance. Valid values: NORMAL and VPC_CONSOLE. Default value: NORMAL |
| NetworkSourceACL | array | no | The new sources of the network from which access is allowed. By default, all sources of networks are allowed. Valid value: TRUST_PROXY:… |
| NetworkTypeACL | array | no | The new types of the network from which access is allowed. By default, all types of networks are allowed. Valid values: INTERNET: the… |

### Modifies the upper limit for the VCUs of an instance in VCU mode (formerly reserved mode)
`POST https://apizie.tech/v1/cloud:aliyun-tablestore/update-instance-elastic-vcuupper-limit` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://tablestore.ap-southeast-1.aliyuncs.com |
| ElasticVCUUpperLimit | number | yes | The upper limit for the VCUs of the instance. Valid values of the upper limit for the VCUs of an instance: Number of reserved VCUs+0.1 to… |
| InstanceName | string | yes | The name of the instance |

### Modifies a Resource Access Management (RAM) policy for an instance
`POST https://apizie.tech/v1/cloud:aliyun-tablestore/update-instance-policy` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://tablestore.ap-southeast-1.aliyuncs.com |
| InstanceName | string | yes | The name of the instance |
| Policy | string | yes | The instance policy in the JSON format |
| PolicyVersion | integer | yes | The version of the instance policy |

### version
`POST https://apizie.tech/v1/cloud:aliyun-tablestore/version` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://tablestore.ap-southeast-1.aliyuncs.com |

## Example
```
curl "https://apizie.tech/v1/cloud:aliyun-tablestore/bind-agent-storage2-vpc" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Alibaba Cloud Tablestore API?
Create a free Apizie key, then send POST https://apizie.tech/v1/cloud:aliyun-tablestore/bind-agent-storage2-vpc with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Alibaba Cloud Tablestore API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Alibaba Cloud Tablestore itself also needs your own key from aliyuncs.com.

### Can AI agents use the Alibaba Cloud Tablestore API?
Yes. Add the Apizie MCP server (https://apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key cloud:aliyun-tablestore.

### What is the status of the Alibaba Cloud Tablestore API?
Needs your own provider key (bring your own key)