Sign in

v32

latestOpenAPI 3.1.0raw.githubusercontent.com2026-05-151,1412,2144.5 MB
Container as a Service

Create container

Create a new container with the specified configuration.

post/cloud/v1/caas/{project_id}/{region_id}/containers

Path parameters

project_idinteger required

Project id

Example:1

Project id

region_idinteger required

Region id

Example:1

Region id

Request body

commandsstring nullable

Container's commands

descriptionstring

Container description

envsobject

Container environment variables

flavorstring required

Container flavor

imagestring required

Container image

is_api_key_authboolean

Enable/Disable api key authentication. Enable api key is temporarily disabled. As a result, using CaaS with authorization is currently not supported.

is_disabledboolean

Set to true if container is disabled

listening_portinteger required

Container listening port

namestring required

Container name

pull_secretstring nullable

Image pull secret

timeoutinteger nullable

Container timeout in seconds

Example request

{
  "commands": "python3 app.py -m test",
  "description": "My first container",
  "envs": {
    "ENVIRONMENT_VARIABLE": "value 2",
    "ENV_VAR": "value 1"
  },
  "flavor": "250mCPU-512MiB",
  "image": "nginx:latest",
  "listening_port": 80,
  "logging": {
    "destination_region_id": 1,
    "enabled": true,
    "retention_policy": {
      "period": 45
    },
    "topic_name": "my-log-name"
  },
  "name": "nginx",
  "pull_secret": "my-secret",
  "timeout": 5
}

Response

OK

tasksstring[] required

List of task IDs representing asynchronous operations. Use these IDs to monitor operation progress:

  • GET /v1/tasks/{task_id} - Check individual task status and details Poll task status until completion (FINISHED/ERROR) before proceeding with dependent operations.
idstring required

Example response

{
  "tasks": [
    "d478ae29-dedc-4869-82f0-96104425f565"
  ]
}