Yunqi (ClickZetta / Singdata Lakehouse)

Yunqi (ClickZetta / Singdata Lakehouse) Virtual Cluster API

虚拟集群管理

GitHub OpenAPI

Operations 7

POST /openapi/v2/vcluster/create 创建虚拟集群 #
POST /openapi/v2/vcluster/delete 删除虚拟集群 #
POST /openapi/v2/vcluster/update 更新虚拟集群 #
POST /openapi/v2/vcluster/list 查询虚拟集群列表 #
POST /openapi/v2/vcluster/start 启动虚拟集群 #
POST /openapi/v2/vcluster/stop 停止虚拟集群 #
POST /openapi/v2/vcluster/get 查询虚拟集群详情 #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/yunqi/openapi/yunqi-virtualcluster-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/yunqi:yunqi-virtualcluster-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

yunqi-virtualcluster-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: ClickZetta Open Platform Virtual Cluster API
  description: 'ClickZetta 开放平台管理接口，覆盖调度任务、数据源、库表同步、虚拟集群、工作空间、实时任务、实例、数据质量及用户管理。接口路径使用 /openapi/v2；info.version 保留仓库原有的契约版本标记。


    使用 AK/SK 自定义请求签名认证。accessKey 是 Access Key ID，sign 是每次请求动态生成的签名；Access Key Secret 只在客户端参与签名，不随请求发送。请求头与查询参数由官方 SDK 生成。SDK 使用 HMAC-SHA1 计算签名，查询参数 SignatureMethod 为 HMAC-SHA1，请求头 signMethod 为 HMAC-SHA256；请按 SDK 的现有协议传值，不要自行统一这两个标记。普通 OpenAPI 客户端不会自动生成此签名，建议使用官方 SDK。


    HTTP 200 只表示 HTTP 请求已返回；调用方还应检查响应中的业务结果字段。不同接口的成功及错误响应以各自模型和示例为准。'
  version: 1.0.0
servers:
- url: https://api.clickzetta.com
  description: 国内生产环境（在线文档示例）
- url: https://api.singdata.com
  description: 新加坡节点（在线文档示例）
security:
- AccessKeyID: []
  RequestSignature: []
tags:
- name: VirtualCluster
  description: 虚拟集群管理
paths:
  /openapi/v2/vcluster/create:
    post:
      summary: 创建虚拟集群
      deprecated: false
      description: 创建新的虚拟计算集群
      operationId: createVirtualCluster
      tags:
      - VirtualCluster
      parameters:
      - $ref: '#/components/parameters/AuthHeaderMethod'
      - $ref: '#/components/parameters/AuthHeaderT'
      - $ref: '#/components/parameters/AuthHeaderSignMethod'
      - $ref: '#/components/parameters/AuthHeaderSignVersion'
      - $ref: '#/components/parameters/AuthHeaderNonce'
      - $ref: '#/components/parameters/AuthQueryFormat'
      - $ref: '#/components/parameters/AuthQueryTimestamp'
      - $ref: '#/components/parameters/AuthQuerySignatureMethod'
      - $ref: '#/components/parameters/AuthQuerySignatureVersion'
      - $ref: '#/components/parameters/AuthQuerySignatureNonce'
      - $ref: '#/components/parameters/AuthQuerySignature'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/VirtualClusterCreateRequest'
      responses:
        '200':
          description: 接口响应。请结合业务结果字段判断是否成功。
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BooleanDataResponse'
          headers: {}
  /openapi/v2/vcluster/delete:
    post:
      summary: 删除虚拟集群
      deprecated: false
      description: 删除指定虚拟集群
      operationId: deleteVirtualCluster
      tags:
      - VirtualCluster
      parameters:
      - $ref: '#/components/parameters/AuthHeaderMethod'
      - $ref: '#/components/parameters/AuthHeaderT'
      - $ref: '#/components/parameters/AuthHeaderSignMethod'
      - $ref: '#/components/parameters/AuthHeaderSignVersion'
      - $ref: '#/components/parameters/AuthHeaderNonce'
      - $ref: '#/components/parameters/AuthQueryFormat'
      - $ref: '#/components/parameters/AuthQueryTimestamp'
      - $ref: '#/components/parameters/AuthQuerySignatureMethod'
      - $ref: '#/components/parameters/AuthQuerySignatureVersion'
      - $ref: '#/components/parameters/AuthQuerySignatureNonce'
      - $ref: '#/components/parameters/AuthQuerySignature'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/VirtualClusterDeleteRequest'
      responses:
        '200':
          description: 接口响应。请结合业务结果字段判断是否成功。
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BooleanDataResponse'
          headers: {}
  /openapi/v2/vcluster/update:
    post:
      summary: 更新虚拟集群
      deprecated: false
      description: 修改虚拟集群的配置信息
      operationId: updateVirtualCluster
      tags:
      - VirtualCluster
      parameters:
      - $ref: '#/components/parameters/AuthHeaderMethod'
      - $ref: '#/components/parameters/AuthHeaderT'
      - $ref: '#/components/parameters/AuthHeaderSignMethod'
      - $ref: '#/components/parameters/AuthHeaderSignVersion'
      - $ref: '#/components/parameters/AuthHeaderNonce'
      - $ref: '#/components/parameters/AuthQueryFormat'
      - $ref: '#/components/parameters/AuthQueryTimestamp'
      - $ref: '#/components/parameters/AuthQuerySignatureMethod'
      - $ref: '#/components/parameters/AuthQuerySignatureVersion'
      - $ref: '#/components/parameters/AuthQuerySignatureNonce'
      - $ref: '#/components/parameters/AuthQuerySignature'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/VirtualClusterUpdateRequest'
      responses:
        '200':
          description: 接口响应。请结合业务结果字段判断是否成功。
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BooleanDataResponse'
          headers: {}
  /openapi/v2/vcluster/list:
    post:
      summary: 查询虚拟集群列表
      deprecated: false
      description: 分页查询工作空间下的虚拟集群
      operationId: listVirtualCluster
      tags:
      - VirtualCluster
      parameters:
      - $ref: '#/components/parameters/AuthHeaderMethod'
      - $ref: '#/components/parameters/AuthHeaderT'
      - $ref: '#/components/parameters/AuthHeaderSignMethod'
      - $ref: '#/components/parameters/AuthHeaderSignVersion'
      - $ref: '#/components/parameters/AuthHeaderNonce'
      - $ref: '#/components/parameters/AuthQueryFormat'
      - $ref: '#/components/parameters/AuthQueryTimestamp'
      - $ref: '#/components/parameters/AuthQuerySignatureMethod'
      - $ref: '#/components/parameters/AuthQuerySignatureVersion'
      - $ref: '#/components/parameters/AuthQuerySignatureNonce'
      - $ref: '#/components/parameters/AuthQuerySignature'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/VirtualClusterListRequest'
      responses:
        '200':
          description: 接口响应。请结合业务结果字段判断是否成功。
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VirtualClusterListResponse'
          headers: {}
  /openapi/v2/vcluster/start:
    post:
      summary: 启动虚拟集群
      deprecated: false
      description: 启动已停止的虚拟集群
      operationId: startVirtualCluster
      tags:
      - VirtualCluster
      parameters:
      - $ref: '#/components/parameters/AuthHeaderMethod'
      - $ref: '#/components/parameters/AuthHeaderT'
      - $ref: '#/components/parameters/AuthHeaderSignMethod'
      - $ref: '#/components/parameters/AuthHeaderSignVersion'
      - $ref: '#/components/parameters/AuthHeaderNonce'
      - $ref: '#/components/parameters/AuthQueryFormat'
      - $ref: '#/components/parameters/AuthQueryTimestamp'
      - $ref: '#/components/parameters/AuthQuerySignatureMethod'
      - $ref: '#/components/parameters/AuthQuerySignatureVersion'
      - $ref: '#/components/parameters/AuthQuerySignatureNonce'
      - $ref: '#/components/parameters/AuthQuerySignature'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/VirtualClusterStartRequest'
      responses:
        '200':
          description: 接口响应。请结合业务结果字段判断是否成功。
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BooleanDataResponse'
          headers: {}
  /openapi/v2/vcluster/stop:
    post:
      summary: 停止虚拟集群
      deprecated: false
      description: 停止正在运行的虚拟集群
      operationId: stopVirtualCluster
      tags:
      - VirtualCluster
      parameters:
      - $ref: '#/components/parameters/AuthHeaderMethod'
      - $ref: '#/components/parameters/AuthHeaderT'
      - $ref: '#/components/parameters/AuthHeaderSignMethod'
      - $ref: '#/components/parameters/AuthHeaderSignVersion'
      - $ref: '#/components/parameters/AuthHeaderNonce'
      - $ref: '#/components/parameters/AuthQueryFormat'
      - $ref: '#/components/parameters/AuthQueryTimestamp'
      - $ref: '#/components/parameters/AuthQuerySignatureMethod'
      - $ref: '#/components/parameters/AuthQuerySignatureVersion'
      - $ref: '#/components/parameters/AuthQuerySignatureNonce'
      - $ref: '#/components/parameters/AuthQuerySignature'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/VirtualClusterStopRequest'
      responses:
        '200':
          description: 接口响应。请结合业务结果字段判断是否成功。
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BooleanDataResponse'
          headers: {}
  /openapi/v2/vcluster/get:
    post:
      summary: 查询虚拟集群详情
      deprecated: false
      description: 获取虚拟集群的详细配置与状态
      operationId: getVirtualCluster
      tags:
      - VirtualCluster
      parameters:
      - $ref: '#/components/parameters/AuthHeaderMethod'
      - $ref: '#/components/parameters/AuthHeaderT'
      - $ref: '#/components/parameters/AuthHeaderSignMethod'
      - $ref: '#/components/parameters/AuthHeaderSignVersion'
      - $ref: '#/components/parameters/AuthHeaderNonce'
      - $ref: '#/components/parameters/AuthQueryFormat'
      - $ref: '#/components/parameters/AuthQueryTimestamp'
      - $ref: '#/components/parameters/AuthQuerySignatureMethod'
      - $ref: '#/components/parameters/AuthQuerySignatureVersion'
      - $ref: '#/components/parameters/AuthQuerySignatureNonce'
      - $ref: '#/components/parameters/AuthQuerySignature'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/VirtualClusterGetRequest'
      responses:
        '200':
          description: 接口响应。请结合业务结果字段判断是否成功。
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VirtualClusterGetResponse'
          headers: {}
components:
  schemas:
    VirtualClusterUpdateRequest:
      type: object
      properties:
        workspace:
          type: string
        instance:
          type: string
        id:
          type: integer
          format: int64
        size:
          type: string
        minReplicas:
          type: integer
        maxReplicas:
          type: integer
        maxConcurrency:
          type: integer
        autoStopMinutes:
          type: integer
        autoStartEnabled:
          type: boolean
        comment:
          type: string
      required:
      - id
      - workspace
      - instance
    VirtualClusterStopRequest:
      type: object
      properties:
        workspace:
          type: string
        instance:
          type: string
        id:
          type: integer
          format: int64
      required:
      - workspace
      - instance
      - id
    VirtualClusterGetResponse:
      type: object
      properties:
        requestId:
          type: string
        success:
          type: boolean
        code:
          type: string
        message:
          type: string
        data:
          $ref: '#/components/schemas/VCInfo'
      required:
      - data
      - requestId
      - success
      - code
      - message
    VirtualClusterListRequest:
      type: object
      properties:
        workspace:
          type: string
        instance:
          type: string
        name:
          type: string
        state:
          type: string
          enum:
          - RUNNING
          - SUSPENDED
          - RESUMING
        size:
          type: string
          enum:
          - XSMALL
          - SMALL
          - MEDIUM
          - LARGE
          - XLARGE
          - 2XLARGE
          - 3XLARGE
          - 4XLARGE
          - 5XLARGE
          - 6XLARGE
      required:
      - workspace
      - instance
    VirtualClusterListResponse:
      type: object
      properties:
        requestId:
          type: string
        success:
          type: boolean
        code:
          type: string
        message:
          type: string
        data:
          type:
          - object
          - 'null'
          properties:
            list:
              type: array
              items:
                $ref: '#/components/schemas/VCInfo'
            pageNum:
              type: integer
            pageSize:
              type: integer
            pageCount:
              type: integer
            total:
              type: integer
              format: int64
          required:
          - list
          - pageNum
          - pageSize
          - pageCount
          - total
      required:
      - requestId
      - success
      - code
      - message
    VirtualClusterStartRequest:
      type: object
      properties:
        workspace:
          type: string
        instance:
          type: string
        id:
          type: integer
          format: int64
      required:
      - workspace
      - instance
      - id
    BooleanDataResponse:
      type: object
      properties:
        requestId:
          type: string
        success:
          type: boolean
        code:
          type: string
        message:
          type: string
        data:
          type:
          - boolean
          - 'null'
          default: false
      required:
      - requestId
      - success
      - code
      - message
    VirtualClusterCreateRequest:
      type: object
      properties:
        workspace:
          type: string
        instance:
          type: string
        name:
          type: string
        type:
          type: string
          enum:
          - GENERAL
          - ANALYTICS
          - INTEGRATION
        size:
          type: string
        minReplicas:
          type:
          - integer
          - 'null'
        maxReplicas:
          type:
          - integer
          - 'null'
        maxConcurrency:
          type:
          - integer
          - 'null'
        autoStopMinutes:
          type: integer
          default: 1
        autoStartEnabled:
          type: boolean
          default: true
        comment:
          type: string
      required:
      - name
      - autoStopMinutes
      - autoStartEnabled
      - workspace
      - instance
      - type
      - size
    VCInfo:
      type: object
      properties:
        id:
          type: integer
          format: int64
        name:
          type: string
        currentReplicas:
          type:
          - integer
          - 'null'
        maxReplicas:
          type:
          - integer
          - 'null'
        queuedJobs:
          type:
          - integer
          - 'null'
        minReplicas:
          type:
          - integer
          - 'null'
        maxConcurrency:
          type:
          - integer
          - 'null'
        autoSuspendInSecond:
          type: integer
        runningJobs:
          type:
          - integer
          - 'null'
        errorMessage:
          type:
          - string
          - 'null'
        load:
          type: number
          format: double
        size:
          type: string
        state:
          type: string
          enum:
          - RUNNING
          - SUSPENDED
          - RESUMING
        type:
          type: string
          enum:
          - GENERAL
          - ANALYTICS
          - INTEGRATION
      required:
      - id
      - name
      - size
      - type
    VirtualClusterGetRequest:
      type: object
      properties:
        workspace:
          type: string
        instance:
          type: string
        id:
          type: integer
          format: int64
      required:
      - workspace
      - instance
      - id
    VirtualClusterDeleteRequest:
      type: object
      properties:
        workspace:
          type: string
        instance:
          type: string
        id:
          type: integer
          format: int64
        force:
          type: boolean
          default: true
      required:
      - id
      - force
      - workspace
      - instance
  parameters:
    AuthQuerySignature:
      name: Signature
      in: query
      required: false
      description: SDK 计算的 Base64 签名，同请求头 sign。 官方 SDK 自动注入；这里记录 SDK 发送的参数，不额外推断服务端是否逐项强制要求。
      schema:
        type: string
      x-sdk-injected: true
    AuthHeaderSignMethod:
      name: signMethod
      in: header
      required: false
      description: SDK 请求头协议标记，固定为 HMAC-SHA256；实际签名计算及查询参数按 SDK 使用 HMAC-SHA1。 官方 SDK 自动注入；这里记录 SDK 发送的参数，不额外推断服务端是否逐项强制要求。
      schema:
        type: string
        enum:
        - HMAC-SHA256
      x-sdk-injected: true
    AuthHeaderSignVersion:
      name: signVersion
      in: header
      required: false
      description: SDK 写入签名版本。 官方 SDK 自动注入；这里记录 SDK 发送的参数，不额外推断服务端是否逐项强制要求。
      schema:
        type: string
        enum:
        - v1.0
      x-sdk-injected: true
    AuthQueryTimestamp:
      name: Timestamp
      in: query
      required: false
      description: SDK 生成 UTC 时间戳；签名和 URL 序列化包含百分号编码，具体规则以附件 SDK 为准。 官方 SDK 自动注入；这里记录 SDK 发送的参数，不额外推断服务端是否逐项强制要求。
      schema:
        type: string
      x-sdk-injected: true
    AuthHeaderNonce:
      name: nonce
      in: header
      required: false
      description: SDK 生成的随机数字串，与 SignatureNonce 一致。 官方 SDK 自动注入；这里记录 SDK 发送的参数，不额外推断服务端是否逐项强制要求。
      schema:
        type: string
      x-sdk-injected: true
    AuthQuerySignatureNonce:
      name: SignatureNonce
      in: query
      required: false
      description: SDK 生成的随机数字串。 官方 SDK 自动注入；这里记录 SDK 发送的参数，不额外推断服务端是否逐项强制要求。
      schema:
        type: string
      x-sdk-injected: true
    AuthQueryFormat:
      name: Format
      in: query
      required: false
      description: SDK 固定输出 JSON。 官方 SDK 自动注入；这里记录 SDK 发送的参数，不额外推断服务端是否逐项强制要求。
      schema:
        type: string
        enum:
        - JSON
      x-sdk-injected: true
    AuthQuerySignatureMethod:
      name: SignatureMethod
      in: query
      required: false
      description: SDK 查询参数声明使用 HMAC-SHA1。 官方 SDK 自动注入；这里记录 SDK 发送的参数，不额外推断服务端是否逐项强制要求。
      schema:
        type: string
        enum:
        - HMAC-SHA1
      x-sdk-injected: true
    AuthHeaderT:
      name: t
      in: header
      required: false
      description: SDK 写入当前 Unix 毫秒时间戳的十进制字符串。 官方 SDK 自动注入；这里记录 SDK 发送的参数，不额外推断服务端是否逐项强制要求。
      schema:
        type: string
      x-sdk-injected: true
    AuthHeaderMethod:
      name: method
      in: header
      required: false
      description: SDK 写入 HTTP 方法。 官方 SDK 自动注入；这里记录 SDK 发送的参数，不额外推断服务端是否逐项强制要求。
      schema:
        type: string
        enum:
        - POST
      x-sdk-injected: true
    AuthQuerySignatureVersion:
      name: SignatureVersion
      in: query
      required: false
      description: SDK 查询参数签名版本。 官方 SDK 自动注入；这里记录 SDK 发送的参数，不额外推断服务端是否逐项强制要求。
      schema:
        type: string
        enum:
        - '1.0'
      x-sdk-injected: true
  securitySchemes:
    AccessKeyID:
      type: apiKey
      in: header
      name: accessKey
      description: Access Key ID。与 RequestSignature 同时使用；不要填写 Access Key Secret。
    RequestSignature:
      type: apiKey
      in: header
      name: sign
      description: 使用 AK/SK 自定义请求签名认证。accessKey 是 Access Key ID，sign 是每次请求动态生成的签名；Access Key Secret 只在客户端参与签名，不随请求发送。请求头与查询参数由官方 SDK 生成。SDK 使用 HMAC-SHA1 计算签名，查询参数 SignatureMethod 为 HMAC-SHA1，请求头 signMethod 为 HMAC-SHA256；请按 SDK 的现有协议传值，不要自行统一这两个标记。普通 OpenAPI 客户端不会自动生成此签名，建议使用官方 SDK。
externalDocs:
  description: ClickZetta 官方文档
  url: https://yunqi.tech/documents