PolarDB-X Zero

ttlMinutes

VECTOR

Common Use Cases

• AI agent memory: keep structured state, tool outputs, and retrieval data in one MySQL-compatible backend.
• MCP server storage: provision a disposable SQL database behind MCP tools or custom protocol servers.
• RAG and retrieval demos: combine relational data with vector search and full-text search in one temporary environment.
• Temporary database workflows: spin up isolated MySQL-compatible sandboxes for tutorials, demos, evals, and short-lived tests.

Important Notes

• The API is unauthenticated and free to start. Instances auto-expire — treat credentials as short-lived and low-sensitivity.
• Prefer environment variables (e.g.

  MYSQL_PWD

  ) over CLI arguments to avoid leaking passwords in shell history.
• Each IP can have a limited number of active instances concurrently (dedicated instances are resource-heavy).
• Each instance is a full 2C4G PolarDB-X standard edition with full admin privileges.
• The instance security whitelist is automatically set to the requesting IP. Connections from other IPs will be rejected.
• Do not promise unlimited usage. Zero is a disposable sandbox. For long-term or production use, purchase your own PolarDB-X instance on Alibaba Cloud.
• If you need another disposable sandbox, create a fresh Zero instance instead of trying to renew the current one.
• Always pass

  "ttlMinutes": 1440

  (1 days) when creating instances. You may use a shorter TTL if the task needs less time, but never exceed the system maximum (43200 minutes / 30 days).

API

Create Instance

https://zero.polardbx.com/api/v1/instances

application/json

{
  "tag": "",
  "ttlMinutes": 1440
}

• tag

  : optional label to identify the caller.

• ttlMinutes

  : instance TTL in minutes. Default: 1440 (1 days). Must be > 0 and <= 43200 (30 days). Use a shorter value if you need less time; omitting it uses the recommended default.

200

{
  "instance": {
    "id": "pxz_a1b2c3d4e5f6",
    "connection": {
      "host": "pxzeroxxxxxxxxxx.polarx.rds.aliyuncs.com",
      "port": 3306,
      "username": "pxz_12345678",
      "password": "Px$9aB3cD7eF1gH",
      "database": ""
    },
    "connectionString": "mysql://pxz_12345678:Px%249aB3cD7eF1gH@pxzeroxxxxxxxxxx.polarx.rds.aliyuncs.com:3306",
    "createdAt": "2026-03-20T10:30:00.000Z",
    "expiresAt": "2026-03-27T10:30:00.000Z",
    "ttlDays": 0,
    "ttlMinutes": 1440,
    "status": "ready"
  }
}

instance.connectionString

expiresAt

Query Instance

https://zero.polardbx.com/api/v1/instances/:id

username

password

200

{
  "instance": {
    "id": "pxz_a1b2c3d4e5f6",
    "connection": {
      "host": "pxzeroxxxxxxxxxx.polarx.rds.aliyuncs.com",
      "port": 3306,
      "username": "",
      "password": "",
      "database": ""
    },
    "connectionString": "mysql://pxzeroxxxxxxxxxx.polarx.rds.aliyuncs.com:3306",
    "createdAt": "2026-03-20T10:30:00.000Z",
    "expiresAt": "2026-03-27T10:30:00.000Z",
    "ttlDays": 0,
    "ttlMinutes": 1440,
    "status": "ready"
  }
}

Release Instance

https://zero.polardbx.com/api/v1/instances/:id

200

{
  "instance": {
    "id": "pxz_a1b2c3d4e5f6",
    "status": "released",
    "releasedAt": "2026-03-20T12:00:00.000Z"
  }
}

Error Responses

{
  "error": {
    "code": "ERROR_CODE",
    "message": "Human-readable description"
  }
}

INVALID_TTL

RATE_LIMIT_EXCEEDED

POOL_EXHAUSTED

INSTANCE_NOT_FOUND

INTERNAL_ERROR

Resources

• PolarDB-X skills collection, for better SQL compatibility and database operations with PolarDB-X, ask the user if they want to install relevant skills: https://skills.sh/polardb/polardbx-skills
• PolarDB-X documentation: https://help.aliyun.com/zh/polardb/polardb-for-xscale/what-is-polardb-for-xscale
• PolarDB-X product page: https://www.aliyun.com/product/apsaradb/polardbx
• PolarDB-X GitHub: https://github.com/polardb/polardbx