# Alibaba Cloud ACS API

> Alibaba Cloud ACS API on Apizie: 5 endpoints (Creates an image cache to accelerate the pulling of container images when creating ACS pods, Deletes an image cache, Queries the details of an image cache, Queries the details of image caches, …) 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-acc/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

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

Alibaba Cloud OpenAPI for ACS (acc, version 2024-04-02). Calls are signed with ACS3-HMAC-SHA256 using your AccessKey ID and secret.

## Endpoints

### Creates an image cache to accelerate the pulling of container images when creating ACS pods
`POST https://zieapi.vercel.app/v1/cloud:aliyun-acc/create-image-cache` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://acc.ap-southeast-1.aliyuncs.com |
| ClientToken | string | no | The client token used to ensure idempotence |
| RegionId | string | yes | The region ID |
| ImageCacheName | string | yes | The name of the image cache |
| Images | string | yes | The container images used to create the image cache. Only one image is supported (JSON-encoded) |
| ResourceGroupId | string | no | The ID of the resource group |
| Tags | string | no | The tags of the image cache. You can specify up to 20 tags (JSON-encoded) |
| NetworkConfig | string | yes | The network configurations for pulling images when creating the image cache (JSON-encoded) |
| ImageRegistryCredentials | string | no | The credentials of the image registry (JSON-encoded) |
| AcrRegistryInfos | string | no | The information about the ACR Enterprise instance (JSON-encoded) |
| Platform | string | no | The platform type of the image cache. Valid values: linux/amd64 and windows/amd64. Default value: linux/amd64 |

### Deletes an image cache
`POST https://zieapi.vercel.app/v1/cloud:aliyun-acc/delete-image-cache` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://acc.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| ImageCacheId | string | yes | The image cache ID |
| Force | string | no | Specifies whether to force delete the image cache. Default value: `false` |

### Queries the details of an image cache
`POST https://zieapi.vercel.app/v1/cloud:aliyun-acc/get-image-cache` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://acc.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| ImageCacheId | string | yes | The image cache ID |

### Queries the details of image caches
`POST https://zieapi.vercel.app/v1/cloud:aliyun-acc/list-image-caches` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| endpoint | string | no | Regional endpoint, for example https://acc.ap-southeast-1.aliyuncs.com |
| RegionId | string | yes | The region ID |
| ImageCacheName | string | no | The name of the image cache |
| Image | string | no | The container image |
| Status | string | no | The cache status of the image cache |
| ResourceGroupId | string | no | The ID of the resource group |
| Tags | string | no | The tags of the image cache. You can specify up to 20 tags (JSON-encoded) |
| NextToken | string | no | The query token. Set the value to the NextToken value returned in the last API call |
| MaxResults | integer | no | The maximum number of entries to return for a single query |

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

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

## Example
```
curl "https://zieapi.vercel.app/v1/cloud:aliyun-acc/create-image-cache" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

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

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

### Can AI agents use the Alibaba Cloud ACS 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-acc.

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