# Alibaba Cloud KVCacheStore API

> Alibaba Cloud KVCacheStore API on Apizie: 13 endpoints (Mounts KVCacheInstance resources to the virtualization side in batches, Creates a KVCacheInstance instance, Deletes a KVCacheInstance instance, Queries the list of regions where KVCacheStore is activated, …) 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://zieapi.vercel.app/v1/cloud:aliyun-kvcachestore/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `cloud:aliyun-kvcachestore`
- Category: Cloud
- Status: byok
- Source: https://api.alibabacloud.com/product/kvcachestore
- Page: https://zieapi.vercel.app/api/cloud/aliyun-kvcachestore
- OpenAPI: https://zieapi.vercel.app/api/cloud/aliyun-kvcachestore/openapi.json

Alibaba Cloud OpenAPI for KVCacheStore (kvcachestore, version 2026-06-17). Calls are signed with ACS3-HMAC-SHA256 using your AccessKey ID and secret.

## Endpoints

### Mounts KVCacheInstance resources to the virtualization side in batches
`POST https://zieapi.vercel.app/v1/cloud:aliyun-kvcachestore/attach-kvcache-store` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://kvcachestore.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID, such as cn-hangzhou |
| InstanceType | string | no | The VSC instance type. Valid values: EFLO, ECS, and INNER_ECS. Default value: EFLO |
| ResourceIds | string | yes | The list of resources to mount. A maximum of 100 resources can be specified (JSON-encoded) |
| Arns | string | no | The cross-account authorization role chain used for cross-account VSC resource verification (JSON-encoded) |
| ClientToken | string | no | A string generated by the server that serves as a unique identifier for the client request |

### Creates a KVCacheInstance instance
`POST https://zieapi.vercel.app/v1/cloud:aliyun-kvcachestore/create-kvcache-store` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://kvcachestore.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID in which to create the KVCacheStore. You can call DescribeRegions to query the list of available regions |
| ZoneId | string | yes | The zone ID. You can call DescribeZones to query the list of zones in the specified region |
| Name | string | no | The KVCacheStore name. The name must be 2 to 128 characters in length and can contain characters from the Unicode letter category… |
| Capacity | integer | yes | The storage capacity in GiB. The minimum capacity is 300 TiB (307200 GiB), and the capacity is scaled out in increments of 300 TiB |
| HpnZone | string | yes | The HPN cluster ID, which is used to create an affinity scheduling relationship between the KVCacheStore and the specified HPN cluster.… |
| Description | string | no | The KVCacheStore description. The description must be 2 to 256 characters in length and can contain English and Chinese characters. The… |
| PaymentType | string | no | The billing method. Valid values: POSTPAY (pay-as-you-go). Default value: POSTPAY |
| Tag | string | no | The list of resource tag key-value pairs. A maximum of 20 tags are supported. This overrides the parent TagDTO type and uses the same Tag… |
| ResourceGroupId | string | no | The resource group ID |
| ClientToken | string | no | The client token that is used to ensure the idempotency of the request. The token can be up to 64 characters in length. We recommend that… |

### Deletes a KVCacheInstance instance
`POST https://zieapi.vercel.app/v1/cloud:aliyun-kvcachestore/delete-kvcache-store` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://kvcachestore.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID, such as cn-hangzhou |
| KvcsId | string | yes | The KvCacheStore instance ID. Only instances in the following states can be deleted: Available and Stopped. Instances in other states… |

### Queries the list of regions where KVCacheStore is activated
`POST https://zieapi.vercel.app/v1/cloud:aliyun-kvcachestore/describe-regions` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://kvcachestore.ap-southeast-1.aliyuncs.com |
| RegionId | string | no | The region ID, such as cn-hangzhou |

### Queries the available zones for KVCacheStore in a specified region
`POST https://zieapi.vercel.app/v1/cloud:aliyun-kvcachestore/describe-zones` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://kvcachestore.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID, such as cn-hangzhou |

### Detaches multiple KVCache instances from the virtualization side
`POST https://zieapi.vercel.app/v1/cloud:aliyun-kvcachestore/detach-kvcache-store` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://kvcachestore.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID, such as cn-hangzhou |
| ResourceIds | string | yes | The list of resources to detach. You can specify up to 100 resources (JSON-encoded) |
| ClientToken | string | no | The client token that is generated by the server to uniquely identify the request |

### Queries the details of a KvCacheStore instance
`POST https://zieapi.vercel.app/v1/cloud:aliyun-kvcachestore/get-kvcache-store` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://kvcachestore.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID, such as cn-hangzhou |
| KvcsId | string | yes | The KvCacheStore instance ID |

### Queries the mount information of KVCache instances in batches
`POST https://zieapi.vercel.app/v1/cloud:aliyun-kvcachestore/list-kvcache-store-attach-info` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://kvcachestore.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID, such as cn-hangzhou |
| KvcsIds | string | yes | The list of KvcsIds of the KVCacheStores to query. You can specify up to 100 KvcsIds (JSON-encoded) |
| MaxResults | integer | no | The maximum number of entries to return in a single call. Valid values: 1 to 500. Default value: 10 |
| NextToken | string | no | The query token. Set the value to the NextToken value returned from the last call to this operation. You do not need to specify this… |
| PageNumber | integer | no | The page number for a paging query. This parameter is used together with PageSize. If the specified page number exceeds the total number… |
| PageSize | integer | no | The number of entries per page for a paging query |
| VscId | string | no | The ID of the compute-side VSC. If you specify this parameter, the mount records are filtered by the specified VSC |

### Queries the available HpnZones for a specified KVCacheStore instance
`POST https://zieapi.vercel.app/v1/cloud:aliyun-kvcachestore/list-kvcache-store-available-hpn-zones` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://kvcachestore.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID, such as cn-hangzhou |
| KvcsIds | string | yes | The IDs of the KVCacheStore instances. Separate multiple IDs with commas. You can specify 1 to 100 IDs (JSON-encoded) |

### Queries the list of available VSC resources associated with a specified KVCacheStore instance
`POST https://zieapi.vercel.app/v1/cloud:aliyun-kvcachestore/list-kvcache-store-available-vscs` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://kvcachestore.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID, such as cn-hangzhou |
| KvcsId | string | yes | The KVCacheStore instance ID |
| InstanceId | string | yes | The compute instance ID |
| InstanceType | string | yes | The compute instance type. Valid values: ECS EFLO |
| Arns | string | no | The cross-account authorization role chain, used for cross-account VSC queries in ECS or EFLO scenarios (JSON-encoded) |

### Queries a list of KVCacheInstance instances
`POST https://zieapi.vercel.app/v1/cloud:aliyun-kvcachestore/list-kvcache-stores` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://kvcachestore.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID, such as cn-hangzhou |
| ZoneId | string | no | The zone ID, such as cn-hangzhou-a |
| Name | string | no | The instance name used for filtering. Prefix matching is supported |
| KvcsIds | string | no | The list of KvcsId values. Separate multiple IDs with commas (,). A maximum of 100 IDs can be specified |
| Status | string | no | The instance status used for filtering. Valid values: Creating, Available, InUse, Stopping, Stopped, and Deleting |
| PageNumber | integer | no | The page number. Default value: 1. This parameter and NextToken are mutually exclusive. If both are specified, PageNumber takes precedence |
| PageSize | integer | no | The number of entries per page. Default value: 10. Maximum value: 100. This parameter is used together with PageNumber |
| NextToken | string | no | The pagination token. Do not specify this parameter for the first request. For subsequent requests, use the NextToken value returned in… |
| MaxResults | integer | no | The maximum number of entries per page for cursor-based pagination. Default value: 10. Maximum value: 100. This parameter is used together… |

### Modifies the attributes of a KVCacheStore
`POST https://zieapi.vercel.app/v1/cloud:aliyun-kvcachestore/update-kvcache-store` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://kvcachestore.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID, such as cn-hangzhou |
| KvcsId | string | yes | The KVCacheStore instance ID |
| Name | string | no | The new KVCacheStore name. The name must be 2 to 128 characters in length and can contain characters that are categorized as letter in… |
| Capacity | integer | no | The new storage capacity in GiB. The value must be a multiple of 300 TiB and greater than the current capacity |
| Description | string | no | The new KVCacheStore description. The description must be 2 to 256 characters in length and can contain English and Chinese characters.… |
| Tag | string | no | The list of resource tag key-value pairs. A maximum of 20 tags are supported (JSON-encoded) |
| ClientToken | string | no | The client token that is used to ensure the idempotence of the request. You can use the client to generate the token, but you must make… |

### version
`POST https://zieapi.vercel.app/v1/cloud:aliyun-kvcachestore/version` (byok)

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

## Example
```
curl "https://zieapi.vercel.app/v1/cloud:aliyun-kvcachestore/attach-kvcache-store" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Alibaba Cloud KVCacheStore API?
Create a free Apizie key, then send POST https://zieapi.vercel.app/v1/cloud:aliyun-kvcachestore/attach-kvcache-store with the header x-api-key. Every endpoint returns { project, data, timestamp }.

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

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

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