---
title: "Create virtual cluster"
method: POST
path: "/api/v1/virtual-cluster/create"
tags: ["Virtual Cluster"]
---

# Create virtual cluster

`POST /api/v1/virtual-cluster/create`

## Request body

- CreateVirtualClusterCommand
  - `cloudId` integer, nullable
  - `projectId` integer
  - `name` string
  - `expiredAt` string, date-time, nullable
  - `deleteOnExpiration` boolean
  - `alertingProfileId` integer, nullable
  - `exposeHostname` string
  - `workloadResources` CreateVirtualClusterWorkloadResources
    - `maxPods` integer, required
    - `maxPvcs` integer, required
    - `maxTotalPvcSize` integer, required
    - `maxIngresses` integer, required
    - `maxLoadBalancers` integer, required
  - `cpuLimits` CreateVirtualClusterResourceLimits
    - `resourceUnit` 'Cores' | 'Bytes', required
    - `maxClusterRequests` number, double, required
    - `maxClusterLimits` number, double, required
    - `defaultContainerLimit` number, double, required
    - `defaultContainerRequest` number, double, required
  - `ramLimits` CreateVirtualClusterResourceLimits
    - `resourceUnit` 'Cores' | 'Bytes', required
    - `maxClusterRequests` number, double, required
    - `maxClusterLimits` number, double, required
    - `defaultContainerLimit` number, double, required
    - `defaultContainerRequest` number, double, required
  - `ephemeralStorageLimits` CreateVirtualClusterResourceLimits
    - `resourceUnit` 'Cores' | 'Bytes', required
    - `maxClusterRequests` number, double, required
    - `maxClusterLimits` number, double, required
    - `defaultContainerLimit` number, double, required
    - `defaultContainerRequest` number, double, required

## Response `200`

OK

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict
- `500` — Internal Server Error

---

[API](https://skmtc.dev/taikun/apis/taikun-webapi.md) · [All operations](https://skmtc.dev/taikun/apis/taikun-webapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/taikun/taikun-webapi/revisions/09395964d191/schema)