Skip to Content

67 операции · 183 схемы · спецификация v0.14.0

Скачать OpenAPI YAML ↗
API docs by Redocly

Nanocl Daemon (v0.14.0)

nanocl contributors: [email protected] License: MIT OR Apache-2.0

Nanocl Daemon — это HTTP REST API.
Это API, используемый Nanocl Client: все возможности Nanocl Client доступны и через API.

Большинство команд клиента напрямую соответствуют конечным точкам API; например, nanocl ps соответствует GET /processes.
Важное исключение — запуск Cargo, состоящий из нескольких вызовов API.

Спецификация OpenAPI

API документирован в формате OpenAPI с помощью Utoipa.
Спецификация создаётся автоматически только в режиме разработки.
При выпуске версии созданный файл переносится в нашу документацию.

Совместное использование ресурсов между источниками

API поддерживает Cross-Origin Resource Sharing (CORS) в соответствии со спецификацией W3C.
Это позволяет выполнять междоменные запросы из браузера.
Все ответы разрешают любые источники, поэтому они полностью публичны и доступны всем, включая код любого сайта.

Cargoes

Получить список Cargo.

query Parameters
filter
string or null
Пример: filter={ "where": { "name": { "eq": "test" } } }

Общий фильтр.

namespace
string or null

Пространство имён Cargo.

Ответы

Примеры ответов

Content type
application/json
[
  • {
    }
]

Создать Cargo.

query Parameters
namespace
string or null

Пространство имён, которому принадлежит Cargo.

Request Body schema: application/json
required
required
object (Config)

Создаваемый контейнер.

ArgsEscaped
boolean or null

Команда уже экранирована; только для Windows.

AttachStderr
boolean or null

Показывает, следует ли подключиться к stderr.

AttachStdin
boolean or null

Показывает, следует ли подключиться к stdin.

AttachStdout
boolean or null

Показывает, следует ли подключиться к stdout.

Cmd
Массив strings or null

Выполняемая команда в виде строки или массива строк.

Domainname
string or null

Доменное имя контейнера.

Entrypoint
Массив strings or null

Точка входа контейнера в виде строки или массива строк. Если массив содержит ровно одну пустую строку ([\"\"]), точка входа сбрасывается к системному значению по умолчанию, используемому Docker, когда инструкция ENTRYPOINT отсутствует в Dockerfile.

Env
Массив strings or null

Список переменных окружения, задаваемых в контейнере, в формате [\"VAR=value\", ...]. Переменная без = удаляется из окружения, а не получает пустое значение.

object or null

Объект, сопоставляющий порты с пустым объектом в формате: {\"<port>/<tcp|udp|sctp>\": {}}

object or null

Проверка работоспособности контейнера.

object or null

Конфигурация контейнера, зависящая от хоста выполнения.

Hostname
string or null

Имя хоста контейнера, соответствующее RFC 1123.

Image
string or null

Имя образа для создания контейнера.

object or null

Метаданные ключ/значение, заданные пользователем.

MacAddress
string or null

MAC-адрес контейнера.

NetworkDisabled
boolean or null

Отключить сеть для контейнера.

object or null

NetworkingConfig представляет сетевую конфигурацию каждого интерфейса контейнера. Используется для сетевых настроек, указанных в командах docker create и docker network connect.

OnBuild
Массив strings or null

Метаданные ONBUILD, определённые в Dockerfile образа.

OpenStdin
boolean or null

Открыть stdin.

Shell
Массив strings or null

Оболочка для случаев, когда RUN, CMD и ENTRYPOINT используют оболочку.

StdinOnce
boolean or null

Закрыть stdin после отключения одного подключённого клиента.

StopSignal
string or null

Сигнал остановки контейнера в виде строки или беззнакового целого числа.

StopTimeout
integer or null <int64>

Время ожидания остановки контейнера в секундах.

Tty
boolean or null

Подключить стандартные потоки к TTY, включая stdin, если он не закрыт.

User
string or null

Пользователь, от имени которого выполняются команды в контейнере.

object or null

Объект, сопоставляющий пути точек монтирования внутри контейнера с пустыми объектами.

WorkingDir
string or null

Рабочий каталог для выполнения команд.

ImagePullPolicy
string or null
Допустимые значения: "Never" "Always" "IfNotPresent"

Политика загрузки образов объектов процессов (job, cargo, vm).

ImagePullSecret
string or null

Секрет для загрузки образа.

object or null

Создаваемый контейнер.

ArgsEscaped
boolean or null

Команда уже экранирована; только для Windows.

AttachStderr
boolean or null

Показывает, следует ли подключиться к stderr.

AttachStdin
boolean or null

Показывает, следует ли подключиться к stdin.

AttachStdout
boolean or null

Показывает, следует ли подключиться к stdout.

Cmd
Массив strings or null

Выполняемая команда в виде строки или массива строк.

Domainname
string or null

Доменное имя контейнера.

Entrypoint
Массив strings or null

Точка входа контейнера в виде строки или массива строк. Если массив содержит ровно одну пустую строку ([\"\"]), точка входа сбрасывается к системному значению по умолчанию, используемому Docker, когда инструкция ENTRYPOINT отсутствует в Dockerfile.

Env
Массив strings or null

Список переменных окружения, задаваемых в контейнере, в формате [\"VAR=value\", ...]. Переменная без = удаляется из окружения, а не получает пустое значение.

object or null

Объект, сопоставляющий порты с пустым объектом в формате: {\"<port>/<tcp|udp|sctp>\": {}}

object or null

Проверка работоспособности контейнера.

object or null

Конфигурация контейнера, зависящая от хоста выполнения.

Hostname
string or null

Имя хоста контейнера, соответствующее RFC 1123.

Image
string or null

Имя образа для создания контейнера.

object or null

Метаданные ключ/значение, заданные пользователем.

MacAddress
string or null

MAC-адрес контейнера.

NetworkDisabled
boolean or null

Отключить сеть для контейнера.

object or null

NetworkingConfig представляет сетевую конфигурацию каждого интерфейса контейнера. Используется для сетевых настроек, указанных в командах docker create и docker network connect.

OnBuild
Массив strings or null

Метаданные ONBUILD, определённые в Dockerfile образа.

OpenStdin
boolean or null

Открыть stdin.

Shell
Массив strings or null

Оболочка для случаев, когда RUN, CMD и ENTRYPOINT используют оболочку.

StdinOnce
boolean or null

Закрыть stdin после отключения одного подключённого клиента.

StopSignal
string or null

Сигнал остановки контейнера в виде строки или беззнакового целого числа.

StopTimeout
integer or null <int64>

Время ожидания остановки контейнера в секундах.

Tty
boolean or null

Подключить стандартные потоки к TTY, включая stdin, если он не закрыт.

User
string or null

Пользователь, от имени которого выполняются команды в контейнере.

object or null

Объект, сопоставляющий пути точек монтирования внутри контейнера с пустыми объектами.

WorkingDir
string or null

Рабочий каталог для выполнения команд.

object

Метаданные Cargo, заданные пользователем.

additional property
string or number or boolean or Массив Any (any) or object (Any)

Вспомогательный тип Any для OpenApi, полезный для динамических объектов JSON, например ResourceSpec.

Name
required
string

Имя Cargo.

(Auto (object or null)) or (Unique (object or null)) or (UniqueByNode (object or null)) or (UniqueByNodeGroups (object or null)) or (UniqueByNodeNames (object or null)) or (Static (object or null)) or (StaticByNodes (object or null)) or (StaticByNodeGroups (object or null)) or (StaticByNodeNames (object or null))

Auto автоматически задаёт число реплик в кластере. Number позволяет задавать число реплик вручную. Примечание: auto гарантирует наличие хотя бы одной реплики в кластере.

Поле дискриминатора: Mode.

One of
Mode
required
string
Значение: "Auto"
Secrets
Массив strings or null

Список секретов, используемых как переменные окружения.

Ответы

Примеры запросов

Content type
application/json
{
  • "Name": "string",
  • "Metadata": {
    },
  • "InitContainer": {
    },
  • "Secrets": [
    ],
  • "ImagePullSecret": "string",
  • "ImagePullPolicy": "Never",
  • "Container": {
    },
  • "Replication": {
    }
}

Примеры ответов

Content type
application/json
{
  • "NamespaceName": "string",
  • "CreatedAt": "2019-08-24T14:15:22Z",
  • "Status": {
    },
  • "Spec": {
    }
}

create_exec_command

path Parameters
Name
required
string

Имя Cargo.

query Parameters
Namespace
string or null

Пространство имён Cargo.

Request Body schema: application/json
required
AttachStderr
boolean or null

Подключиться к stderr команды exec.

AttachStdin
boolean or null

Подключиться к stdin команды exec.

AttachStdout
boolean or null

Подключиться к stdout команды exec.

Cmd
Массив strings or null

Выполняемая команда в виде строки или массива строк.

DetachKeys
string or null

Переопределить последовательность клавиш для отключения от контейнера. Формат: один символ [a-Z] или ctrl-<value>, где <value> — одно из значений a-z, @, ^, [, , или _.

Env
Массив strings or null

Список переменных окружения в формате ["VAR=value", ...].

Privileged
boolean or null

Запускает процесс exec с расширенными привилегиями.

Tty
boolean or null

Выделить псевдо-TTY.

User
string or null

Пользователь и необязательная группа для процесса exec в контейнере. Возможные форматы: user, user:group, uid или uid:gid.

WorkingDir
string or null

Рабочий каталог процесса exec в контейнере.

Ответы

Примеры запросов

Content type
application/json
{
  • "AttachStdin": true,
  • "AttachStdout": true,
  • "AttachStderr": true,
  • "Tty": true,
  • "DetachKeys": "string",
  • "Env": [
    ],
  • "Cmd": [
    ],
  • "Privileged": true,
  • "User": "string",
  • "WorkingDir": "string"
}

Создать спецификацию Cargo и добавить запись истории.

path Parameters
name
required
string

Имя Cargo.

query Parameters
namespace
string or null

Пространство имён, которому принадлежит Cargo.

Request Body schema: application/json
required
required
object (Config)

Создаваемый контейнер.

ArgsEscaped
boolean or null

Команда уже экранирована; только для Windows.

AttachStderr
boolean or null

Показывает, следует ли подключиться к stderr.

AttachStdin
boolean or null

Показывает, следует ли подключиться к stdin.

AttachStdout
boolean or null

Показывает, следует ли подключиться к stdout.

Cmd
Массив strings or null

Выполняемая команда в виде строки или массива строк.

Domainname
string or null

Доменное имя контейнера.

Entrypoint
Массив strings or null

Точка входа контейнера в виде строки или массива строк. Если массив содержит ровно одну пустую строку ([\"\"]), точка входа сбрасывается к системному значению по умолчанию, используемому Docker, когда инструкция ENTRYPOINT отсутствует в Dockerfile.

Env
Массив strings or null

Список переменных окружения, задаваемых в контейнере, в формате [\"VAR=value\", ...]. Переменная без = удаляется из окружения, а не получает пустое значение.

object or null

Объект, сопоставляющий порты с пустым объектом в формате: {\"<port>/<tcp|udp|sctp>\": {}}

object or null

Проверка работоспособности контейнера.

object or null

Конфигурация контейнера, зависящая от хоста выполнения.

Hostname
string or null

Имя хоста контейнера, соответствующее RFC 1123.

Image
string or null

Имя образа для создания контейнера.

object or null

Метаданные ключ/значение, заданные пользователем.

MacAddress
string or null

MAC-адрес контейнера.

NetworkDisabled
boolean or null

Отключить сеть для контейнера.

object or null

NetworkingConfig представляет сетевую конфигурацию каждого интерфейса контейнера. Используется для сетевых настроек, указанных в командах docker create и docker network connect.

OnBuild
Массив strings or null

Метаданные ONBUILD, определённые в Dockerfile образа.

OpenStdin
boolean or null

Открыть stdin.

Shell
Массив strings or null

Оболочка для случаев, когда RUN, CMD и ENTRYPOINT используют оболочку.

StdinOnce
boolean or null

Закрыть stdin после отключения одного подключённого клиента.

StopSignal
string or null

Сигнал остановки контейнера в виде строки или беззнакового целого числа.

StopTimeout
integer or null <int64>

Время ожидания остановки контейнера в секундах.

Tty
boolean or null

Подключить стандартные потоки к TTY, включая stdin, если он не закрыт.

User
string or null

Пользователь, от имени которого выполняются команды в контейнере.

object or null

Объект, сопоставляющий пути точек монтирования внутри контейнера с пустыми объектами.

WorkingDir
string or null

Рабочий каталог для выполнения команд.

ImagePullPolicy
string or null
Допустимые значения: "Never" "Always" "IfNotPresent"

Политика загрузки образов объектов процессов (job, cargo, vm).

ImagePullSecret
string or null

Секрет для загрузки образа.

object or null

Создаваемый контейнер.

ArgsEscaped
boolean or null

Команда уже экранирована; только для Windows.

AttachStderr
boolean or null

Показывает, следует ли подключиться к stderr.

AttachStdin
boolean or null

Показывает, следует ли подключиться к stdin.

AttachStdout
boolean or null

Показывает, следует ли подключиться к stdout.

Cmd
Массив strings or null

Выполняемая команда в виде строки или массива строк.

Domainname
string or null

Доменное имя контейнера.

Entrypoint
Массив strings or null

Точка входа контейнера в виде строки или массива строк. Если массив содержит ровно одну пустую строку ([\"\"]), точка входа сбрасывается к системному значению по умолчанию, используемому Docker, когда инструкция ENTRYPOINT отсутствует в Dockerfile.

Env
Массив strings or null

Список переменных окружения, задаваемых в контейнере, в формате [\"VAR=value\", ...]. Переменная без = удаляется из окружения, а не получает пустое значение.

object or null

Объект, сопоставляющий порты с пустым объектом в формате: {\"<port>/<tcp|udp|sctp>\": {}}

object or null

Проверка работоспособности контейнера.

object or null

Конфигурация контейнера, зависящая от хоста выполнения.

Hostname
string or null

Имя хоста контейнера, соответствующее RFC 1123.

Image
string or null

Имя образа для создания контейнера.

object or null

Метаданные ключ/значение, заданные пользователем.

MacAddress
string or null

MAC-адрес контейнера.

NetworkDisabled
boolean or null

Отключить сеть для контейнера.

object or null

NetworkingConfig представляет сетевую конфигурацию каждого интерфейса контейнера. Используется для сетевых настроек, указанных в командах docker create и docker network connect.

OnBuild
Массив strings or null

Метаданные ONBUILD, определённые в Dockerfile образа.

OpenStdin
boolean or null

Открыть stdin.

Shell
Массив strings or null

Оболочка для случаев, когда RUN, CMD и ENTRYPOINT используют оболочку.

StdinOnce
boolean or null

Закрыть stdin после отключения одного подключённого клиента.

StopSignal
string or null

Сигнал остановки контейнера в виде строки или беззнакового целого числа.

StopTimeout
integer or null <int64>

Время ожидания остановки контейнера в секундах.

Tty
boolean or null

Подключить стандартные потоки к TTY, включая stdin, если он не закрыт.

User
string or null

Пользователь, от имени которого выполняются команды в контейнере.

object or null

Объект, сопоставляющий пути точек монтирования внутри контейнера с пустыми объектами.

WorkingDir
string or null

Рабочий каталог для выполнения команд.

object

Метаданные Cargo, заданные пользователем.

additional property
string or number or boolean or Массив Any (any) or object (Any)

Вспомогательный тип Any для OpenApi, полезный для динамических объектов JSON, например ResourceSpec.

Name
required
string

Имя Cargo.

(Auto (object or null)) or (Unique (object or null)) or (UniqueByNode (object or null)) or (UniqueByNodeGroups (object or null)) or (UniqueByNodeNames (object or null)) or (Static (object or null)) or (StaticByNodes (object or null)) or (StaticByNodeGroups (object or null)) or (StaticByNodeNames (object or null))

Auto автоматически задаёт число реплик в кластере. Number позволяет задавать число реплик вручную. Примечание: auto гарантирует наличие хотя бы одной реплики в кластере.

Поле дискриминатора: Mode.

One of
Mode
required
string
Значение: "Auto"
Secrets
Массив strings or null

Список секретов, используемых как переменные окружения.

Ответы

Примеры запросов

Content type
application/json
{
  • "Name": "string",
  • "Metadata": {
    },
  • "InitContainer": {
    },
  • "Secrets": [
    ],
  • "ImagePullSecret": "string",
  • "ImagePullPolicy": "Never",
  • "Container": {
    },
  • "Replication": {
    }
}

Примеры ответов

Content type
application/json
{
  • "NamespaceName": "string",
  • "CreatedAt": "2019-08-24T14:15:22Z",
  • "Status": {
    },
  • "Spec": {
    }
}

Удалить Cargo.

path Parameters
name
required
string

Имя Cargo.

query Parameters
force
required
boolean

Если true, принудительно выполнить удаление.

namespace
string or null

Пространство имён, которому принадлежит Cargo.

Ответы

Изменить спецификацию Cargo, объединив текущую спецификацию с новой, и добавить запись истории.

path Parameters
name
required
string

Имя Cargo.

query Parameters
namespace
string or null

Пространство имён, которому принадлежит Cargo.

Request Body schema: application/json
required
object or null

Создаваемый контейнер.

ArgsEscaped
boolean or null

Команда уже экранирована; только для Windows.

AttachStderr
boolean or null

Показывает, следует ли подключиться к stderr.

AttachStdin
boolean or null

Показывает, следует ли подключиться к stdin.

AttachStdout
boolean or null

Показывает, следует ли подключиться к stdout.

Cmd
Массив strings or null

Выполняемая команда в виде строки или массива строк.

Domainname
string or null

Доменное имя контейнера.

Entrypoint
Массив strings or null

Точка входа контейнера в виде строки или массива строк. Если массив содержит ровно одну пустую строку ([\"\"]), точка входа сбрасывается к системному значению по умолчанию, используемому Docker, когда инструкция ENTRYPOINT отсутствует в Dockerfile.

Env
Массив strings or null

Список переменных окружения, задаваемых в контейнере, в формате [\"VAR=value\", ...]. Переменная без = удаляется из окружения, а не получает пустое значение.

object or null

Объект, сопоставляющий порты с пустым объектом в формате: {\"<port>/<tcp|udp|sctp>\": {}}

object or null

Проверка работоспособности контейнера.

object or null

Конфигурация контейнера, зависящая от хоста выполнения.

Hostname
string or null

Имя хоста контейнера, соответствующее RFC 1123.

Image
string or null

Имя образа для создания контейнера.

object or null

Метаданные ключ/значение, заданные пользователем.

MacAddress
string or null

MAC-адрес контейнера.

NetworkDisabled
boolean or null

Отключить сеть для контейнера.

object or null

NetworkingConfig представляет сетевую конфигурацию каждого интерфейса контейнера. Используется для сетевых настроек, указанных в командах docker create и docker network connect.

OnBuild
Массив strings or null

Метаданные ONBUILD, определённые в Dockerfile образа.

OpenStdin
boolean or null

Открыть stdin.

Shell
Массив strings or null

Оболочка для случаев, когда RUN, CMD и ENTRYPOINT используют оболочку.

StdinOnce
boolean or null

Закрыть stdin после отключения одного подключённого клиента.

StopSignal
string or null

Сигнал остановки контейнера в виде строки или беззнакового целого числа.

StopTimeout
integer or null <int64>

Время ожидания остановки контейнера в секундах.

Tty
boolean or null

Подключить стандартные потоки к TTY, включая stdin, если он не закрыт.

User
string or null

Пользователь, от имени которого выполняются команды в контейнере.

object or null

Объект, сопоставляющий пути точек монтирования внутри контейнера с пустыми объектами.

WorkingDir
string or null

Рабочий каталог для выполнения команд.

ImagePullPolicy
string or null
Допустимые значения: "Never" "Always" "IfNotPresent"

Политика загрузки образов объектов процессов (job, cargo, vm).

ImagePullSecret
string or null

Секрет для загрузки образа.

object or null

Создаваемый контейнер.

ArgsEscaped
boolean or null

Команда уже экранирована; только для Windows.

AttachStderr
boolean or null

Показывает, следует ли подключиться к stderr.

AttachStdin
boolean or null

Показывает, следует ли подключиться к stdin.

AttachStdout
boolean or null

Показывает, следует ли подключиться к stdout.

Cmd
Массив strings or null

Выполняемая команда в виде строки или массива строк.

Domainname
string or null

Доменное имя контейнера.

Entrypoint
Массив strings or null

Точка входа контейнера в виде строки или массива строк. Если массив содержит ровно одну пустую строку ([\"\"]), точка входа сбрасывается к системному значению по умолчанию, используемому Docker, когда инструкция ENTRYPOINT отсутствует в Dockerfile.

Env
Массив strings or null

Список переменных окружения, задаваемых в контейнере, в формате [\"VAR=value\", ...]. Переменная без = удаляется из окружения, а не получает пустое значение.

object or null

Объект, сопоставляющий порты с пустым объектом в формате: {\"<port>/<tcp|udp|sctp>\": {}}

object or null

Проверка работоспособности контейнера.

object or null

Конфигурация контейнера, зависящая от хоста выполнения.

Hostname
string or null

Имя хоста контейнера, соответствующее RFC 1123.

Image
string or null

Имя образа для создания контейнера.

object or null

Метаданные ключ/значение, заданные пользователем.

MacAddress
string or null

MAC-адрес контейнера.

NetworkDisabled
boolean or null

Отключить сеть для контейнера.

object or null

NetworkingConfig представляет сетевую конфигурацию каждого интерфейса контейнера. Используется для сетевых настроек, указанных в командах docker create и docker network connect.

OnBuild
Массив strings or null

Метаданные ONBUILD, определённые в Dockerfile образа.

OpenStdin
boolean or null

Открыть stdin.

Shell
Массив strings or null

Оболочка для случаев, когда RUN, CMD и ENTRYPOINT используют оболочку.

StdinOnce
boolean or null

Закрыть stdin после отключения одного подключённого клиента.

StopSignal
string or null

Сигнал остановки контейнера в виде строки или беззнакового целого числа.

StopTimeout
integer or null <int64>

Время ожидания остановки контейнера в секундах.

Tty
boolean or null

Подключить стандартные потоки к TTY, включая stdin, если он не закрыт.

User
string or null

Пользователь, от имени которого выполняются команды в контейнере.

object or null

Объект, сопоставляющий пути точек монтирования внутри контейнера с пустыми объектами.

WorkingDir
string or null

Рабочий каталог для выполнения команд.

object

Новые метаданные Cargo, заданные пользователем.

additional property
string or number or boolean or Массив Any (any) or object (Any)

Вспомогательный тип Any для OpenApi, полезный для динамических объектов JSON, например ResourceSpec.

Name
string or null

Новое имя Cargo.

(Auto (object or null)) or (Unique (object or null)) or (UniqueByNode (object or null)) or (UniqueByNodeGroups (object or null)) or (UniqueByNodeNames (object or null)) or (Static (object or null)) or (StaticByNodes (object or null)) or (StaticByNodeGroups (object or null)) or (StaticByNodeNames (object or null))

Auto автоматически задаёт число реплик в кластере. Number позволяет задавать число реплик вручную. Примечание: auto гарантирует наличие хотя бы одной реплики в кластере.

Поле дискриминатора: Mode.

One of
Mode
required
string
Значение: "Auto"
Secrets
Массив strings or null

Список секретов, используемых как переменные окружения.

Ответы

Примеры запросов

Content type
application/json
{
  • "Name": "string",
  • "Metadata": {
    },
  • "InitContainer": {
    },
  • "Secrets": [
    ],
  • "ImagePullSecret": "string",
  • "ImagePullPolicy": "Never",
  • "Container": {
    },
  • "Replication": {
    }
}

Примеры ответов

Content type
application/json
{
  • "NamespaceName": "string",
  • "CreatedAt": "2019-08-24T14:15:22Z",
  • "Status": {
    },
  • "Spec": {
    }
}

Получить список историй Cargo.

path Parameters
name
required
string

Имя Cargo.

query Parameters
namespace
string or null

Пространство имён, которому принадлежит Cargo.

Ответы

Примеры ответов

Content type
application/json
[
  • {
    }
]

Откатить Cargo к определённой записи истории.

path Parameters
id
required
string

Идентификатор истории Cargo.

name
required
string

Имя Cargo.

query Parameters
namespace
string or null

Пространство имён, которому принадлежит Cargo.

Ответы

Примеры ответов

Content type
application/json
{
  • "NamespaceName": "string",
  • "CreatedAt": "2019-08-24T14:15:22Z",
  • "Status": {
    },
  • "Spec": {
    }
}

Получить подробные сведения о Cargo.

path Parameters
name
required
string

Имя Cargo.

query Parameters
namespace
string or null

Пространство имён, которому принадлежит Cargo.

Ответы

Примеры ответов

Content type
application/json
{
  • "NamespaceName": "string",
  • "CreatedAt": "2019-08-24T14:15:22Z",
  • "InstanceTotal": 0,
  • "InstanceRunning": 0,
  • "Status": {
    },
  • "Spec": {
    },
  • "Instances": [
    ]
}

Events

Конечные точки управления событиями.

Получить события всех соседних узлов.

query Parameters
filter
string or null
Пример: filter={ "where": { "kind": { "eq": "normal" } } }

Общий фильтр.

Ответы

Примеры ответов

Content type
application/json
[
  • {
    }
]

Следить за новыми событиями с помощью Server-Sent Events / EventSource.

Request Body schema: application/json
optional
Array
required
Массив strings or strings or strings or strings or strings or strings or strings or strings or strings or strings or strings or strings or strings or strings or strings or objects (NativeEventAction)
ActorKey
string or null
ActorKind
string or null
Допустимые значения: "Namespace" "Cargo" "Vm" "Job" "Resource" "Secret" "Process" "ContainerImage"

Kind — тип события, связанный с типом участника.

Kind
required
Массив strings (EventKind)
Допустимые элементы Допустимые значения: "error" "normal" "warning"
RelatedKey
string or null
RelatedKind
string or null
Допустимые значения: "Namespace" "Cargo" "Vm" "Job" "Resource" "Secret" "Process" "ContainerImage"

Kind — тип события, связанный с типом участника.

Ответы

Примеры запросов

Content type
application/json
[
  • {
    }
]

Exec

Просмотреть команду, выполняемую в Cargo.

path Parameters
id
required
string

Идентификатор exec для просмотра.

Ответы

Примеры ответов

Content type
application/json
{
  • "CanRemove": true,
  • "DetachKeys": "string",
  • "ID": "string",
  • "Running": true,
  • "ExitCode": 0,
  • "ProcessConfig": {
    },
  • "OpenStdin": true,
  • "OpenStderr": true,
  • "OpenStdout": true,
  • "ContainerID": "string",
  • "Pid": 0
}

start_exec_command

path Parameters
id
required
string

Идентификатор команды exec.

Request Body schema: application/json
required
Detach
required
boolean

Отключиться от команды.

OutputCapacity
integer or null >= 0

Максимальный размер строки вывода. По умолчанию 8 * 1024, приблизительно 1024 символа.

Tty
required
boolean

Выделить псевдо-TTY.

Ответы

Примеры запросов

Content type
application/json
{
  • "Detach": true,
  • "Tty": true,
  • "OutputCapacity": 0
}

Jobs

Конечные точки управления заданиями.

Получить список заданий.

Ответы

Примеры ответов

Content type
application/json
[
  • {
    }
]

Создать задание.

Request Body schema: application/json
required
required
Массив objects (Config)

Список запускаемых контейнеров.

Array
ArgsEscaped
boolean or null

Команда уже экранирована; только для Windows.

AttachStderr
boolean or null

Показывает, следует ли подключиться к stderr.

AttachStdin
boolean or null

Показывает, следует ли подключиться к stdin.

AttachStdout
boolean or null

Показывает, следует ли подключиться к stdout.

Cmd
Массив strings or null

Выполняемая команда в виде строки или массива строк.

Domainname
string or null

Доменное имя контейнера.

Entrypoint
Массив strings or null

Точка входа контейнера в виде строки или массива строк. Если массив содержит ровно одну пустую строку ([\"\"]), точка входа сбрасывается к системному значению по умолчанию, используемому Docker, когда инструкция ENTRYPOINT отсутствует в Dockerfile.

Env
Массив strings or null

Список переменных окружения, задаваемых в контейнере, в формате [\"VAR=value\", ...]. Переменная без = удаляется из окружения, а не получает пустое значение.

object or null

Объект, сопоставляющий порты с пустым объектом в формате: {\"<port>/<tcp|udp|sctp>\": {}}

object or null

Проверка работоспособности контейнера.

object or null

Конфигурация контейнера, зависящая от хоста выполнения.

Hostname
string or null

Имя хоста контейнера, соответствующее RFC 1123.

Image
string or null

Имя образа для создания контейнера.

object or null

Метаданные ключ/значение, заданные пользователем.

MacAddress
string or null

MAC-адрес контейнера.

NetworkDisabled
boolean or null

Отключить сеть для контейнера.

object or null

NetworkingConfig представляет сетевую конфигурацию каждого интерфейса контейнера. Используется для сетевых настроек, указанных в командах docker create и docker network connect.

OnBuild
Массив strings or null

Метаданные ONBUILD, определённые в Dockerfile образа.

OpenStdin
boolean or null

Открыть stdin.

Shell
Массив strings or null

Оболочка для случаев, когда RUN, CMD и ENTRYPOINT используют оболочку.

StdinOnce
boolean or null

Закрыть stdin после отключения одного подключённого клиента.

StopSignal
string or null

Сигнал остановки контейнера в виде строки или беззнакового целого числа.

StopTimeout
integer or null <int64>

Время ожидания остановки контейнера в секундах.

Tty
boolean or null

Подключить стандартные потоки к TTY, включая stdin, если он не закрыт.

User
string or null

Пользователь, от имени которого выполняются команды в контейнере.

object or null

Объект, сопоставляющий пути точек монтирования внутри контейнера с пустыми объектами.

WorkingDir
string or null

Рабочий каталог для выполнения команд.

ImagePullPolicy
string or null
Допустимые значения: "Never" "Always" "IfNotPresent"

Политика загрузки образов объектов процессов (job, cargo, vm).

ImagePullSecret
string or null

Секрет для загрузки образа.

object

Метаданные, заданные пользователем.

additional property
string or number or boolean or Массив Any (any) or object (Any)

Вспомогательный тип Any для OpenApi, полезный для динамических объектов JSON, например ResourceSpec.

Name
required
string

Имя задания.

Schedule
string or null

Расписание задания (cron).

Secrets
Массив strings or null

Секреты, загружаемые как переменные окружения.

Ttl
integer or null >= 0

Удалить задание через (x) секунд после выполнения.

Ответы

Примеры запросов

Content type
application/json
{
  • "Name": "string",
  • "Secrets": [
    ],
  • "Metadata": {
    },
  • "Schedule": "string",
  • "Ttl": 0,
  • "ImagePullSecret": "string",
  • "ImagePullPolicy": "Never",
  • "Containers": [
    ]
}

Примеры ответов

Content type
application/json
{
  • "Name": "string",
  • "CreatedAt": "2019-08-24T14:15:22Z",
  • "UpdatedAt": "2019-08-24T14:15:22Z",
  • "Status": {
    },
  • "Secrets": [
    ],
  • "Metadata": {
    },
  • "Schedule": "string",
  • "Ttl": 0,
  • "ImagePullSecret": "string",
  • "ImagePullPolicy": "Never",
  • "Containers": [
    ]
}

Удалить задание.

path Parameters
name
required
string

Имя задания.

Ответы

Просмотреть задание.

path Parameters
name
required
string

Имя задания.

Ответы

Примеры ответов

Content type
application/json
{
  • "Status": {
    },
  • "InstanceTotal": 0,
  • "InstanceSuccess": 0,
  • "InstanceRunning": 0,
  • "InstanceFailed": 0,
  • "Spec": {
    },
  • "Instances": [
    ]
}

Metrics

Конечные точки управления метриками.

Получить метрики всех соседних узлов.

query Parameters
filter
string or null
Пример: filter={ "where": { "kind": { "eq": "CPU" } } }

Общий фильтр.

Ответы

Примеры ответов

Content type
application/json
[
  • {
    }
]

create_metric

Request Body schema: application/json
required
Data
required
any

Данные метрики.

Kind
required
string

Тип метрики.

Note
string or null

Необязательная заметка о метрике.

Ответы

Примеры запросов

Content type
application/json
{
  • "Kind": "string",
  • "Data": null,
  • "Note": "string"
}

Примеры ответов

Content type
application/json
{
  • "Key": "5eb041b0-19c9-4022-bd51-0e723885f5dd",
  • "CreatedAt": "2019-08-24T14:15:22Z",
  • "ExpiresAt": "2019-08-24T14:15:22Z",
  • "NodeName": "string",
  • "Kind": "string",
  • "Data": null,
  • "Note": "string"
}

Namespaces

Конечные точки управления пространствами имён.

Получить список пространств имён.

query Parameters
filter
string or null
Пример: filter={ "where": { "name": { "eq": "test" } } }

Общий фильтр.

Ответы

Примеры ответов

Content type
application/json
[
  • {
    }
]

Создать пространство имён.

Request Body schema: application/json
required
Name
required
string

Имя пространства имён.

Ответы

Примеры запросов

Content type
application/json
{
  • "Name": "string"
}

Примеры ответов

Content type
application/json
{
  • "Name": "string",
  • "CreatedAt": "2019-08-24T14:15:22Z"
}

Удалить пространство имён.

path Parameters
name
required
string

Имя удаляемого пространства имён.

Ответы

Примеры ответов

Content type
application/json
{
  • "msg": "string"
}

Получить подробные сведения о пространстве имён.

path Parameters
name
required
string

Имя пространства имён для просмотра.

Ответы

Примеры ответов

Content type
application/json
[
  • {
    }
]

Nodes

Конечные точки управления узлами.

Получить список узлов.

Ответы

Примеры ответов

Content type
application/json
[
  • {
    }
]

Внутренняя конечная точка WebSocket для связи между узлами.

Ответы

Processes

Конечные точки управления процессами.

Получить список процессов (Vm, Job, Cargo).

query Parameters
filter
string or null
Пример: filter={ "where": { "name": { "eq": "test" } } }

Общий фильтр.

Ответы

Примеры ответов

Content type
application/json
[
  • {
    }
]

Отправить сигнал процессам заданного типа и имени.

path Parameters
kind
required
string
Пример: cargo

Тип процесса.

name
required
string
Пример: deploy-example

Имя процесса.

query Parameters
namespace
string or null

Пространство имён процесса обязательно.

Request Body schema: application/json
required
signal
required
string

Сигнал контейнеру; по умолчанию SIGKILL.

Ответы

Примеры запросов

Content type
application/json
{
  • "signal": "string"
}

Получить журналы процессов всех экземпляров заданного типа и имени (cargo, job, vm).

path Parameters
kind
required
string
Пример: cargo

Тип процесса.

name
required
string
Пример: deploy-example

Имя процесса.

query Parameters
follow
boolean or null

Логическое значение, определяющее, нужно ли возвращать поток.

namespace
string or null

Пространство имён процесса.

since
integer or null <int64>

Возвращать только журналы начиная с указанной временной метки.

tail
string or null

Возвращать только последние n строк журнала (целое число) или все ("all").

timestamps
boolean or null

Добавлять временную метку к каждой строке журнала.

until
integer or null <int64>

Возвращать только журналы до указанной временной метки.

Ответы

Перезапустить процессы заданного типа и имени.

path Parameters
kind
required
string
Пример: cargo

Тип процесса.

name
required
string
Пример: deploy-example

Имя процесса.

query Parameters
namespace
string or null

Пространство имён процесса обязательно.

Ответы

Запустить процессы заданного типа и имени.

path Parameters
kind
required
string
Пример: cargo

Тип процесса.

name
required
string
Пример: deploy-example

Имя процесса.

query Parameters
namespace
string or null

Пространство имён процесса обязательно.

Ответы

Получить статистику экземпляра Cargo.

path Parameters
kind
required
string
Пример: cargo

Тип процесса.

name
required
string
Пример: deploy-example

Имя группы процессов.

query Parameters
namespace
string or null

Пространство имён, которому принадлежит Cargo.

one_shot
boolean or null

Вернуть статистику только один раз.

stream
boolean or null

Вернуть поток статистики.

Ответы

Остановить процессы заданного типа и имени.

path Parameters
kind
required
string
Пример: cargo

Тип процесса.

name
required
string
Пример: deploy-example

Имя процесса.

query Parameters
namespace
string or null

Пространство имён процесса обязательно.

Ответы

Дождаться завершения задания.

path Parameters
name
required
string

Имя экземпляра задания, обычно name или name-number.

Ответы

Получить журналы одного экземпляра процесса по имени или идентификатору.

path Parameters
name
required
string
Пример: deploy-example

Имя процесса.

query Parameters
follow
boolean or null

Логическое значение, определяющее, нужно ли возвращать поток.

since
integer or null <int64>

Возвращать только журналы начиная с указанной временной метки.

tail
string or null

Возвращать только последние n строк журнала (целое число) или все ("all").

timestamps
boolean or null

Добавлять временную метку к каждой строке журнала.

until
integer or null <int64>

Возвращать только журналы до указанной временной метки.

Ответы

ResourceKinds

Получить список типов ресурсов.

Ответы

Примеры ответов

Content type
application/json
[
  • {
    }
]

Создать тип ресурса.

Request Body schema: application/json
required
required
object (ResourceKindSpec)

Спецификация типа ресурса. В зависимости от спецификации проверяется JSONSchema или вызывается служба.

object

JSONSchema ресурса данного типа и версии.

Url
string or null

Служба, вызываемая при создании, обновлении или удалении ресурса данного типа и версии.

object

Метаданные типа ресурса, заданные пользователем.

additional property
string or number or boolean or Массив Any (any) or object (Any)

Вспомогательный тип Any для OpenApi, полезный для динамических объектов JSON, например ResourceSpec.

Name
required
string

Имя типа ресурса.

Version
required
string

Версия типа ресурса.

Ответы

Примеры запросов

Content type
application/json
{
  • "Name": "string",
  • "Version": "string",
  • "Metadata": {
    },
  • "Data": {
    }
}

Примеры ответов

Content type
application/json
{
  • "Name": "string",
  • "Version": "string",
  • "CreatedAt": "2019-08-24T14:15:22Z",
  • "Metadata": null,
  • "Data": {
    }
}

Удалить тип ресурса.

path Parameters
domain
required
string

Домен типа ресурса.

name
required
string

Имя типа ресурса.

Ответы

Просмотреть тип ресурса.

path Parameters
domain
required
string

Домен типа ресурса.

name
required
string

Имя типа ресурса.

Ответы

Примеры ответов

Content type
application/json
{
  • "Name": "string",
  • "CreatedAt": "2019-08-24T14:15:22Z",
  • "Versions": [
    ]
}

Просмотреть определённую версию типа ресурса.

path Parameters
domain
required
string

Домен типа ресурса.

name
required
string

Имя типа ресурса.

Ответы

Примеры ответов

Content type
application/json
{
  • "Key": "5eb041b0-19c9-4022-bd51-0e723885f5dd",
  • "CreatedAt": "2019-08-24T14:15:22Z",
  • "KindKey": "string",
  • "Version": "string",
  • "Metadata": {
    },
  • "Data": {
    }
}

Resources

Конечные точки управления ресурсами.

Получить список ресурсов.

query Parameters
filter
string or null
Пример: filter={ "where": { "kind": { "eq": "ProxyRule" } } }

Общий фильтр.

Ответы

Примеры ответов

Content type
application/json
[
  • {
    }
]

Создать ресурс.

Request Body schema: application/json
required
required
object

Данные ресурса в виде объекта JSON.

additional property
string or number or boolean or Массив Any (any) or object (Any)

Вспомогательный тип Any для OpenApi, полезный для динамических объектов JSON, например ResourceSpec.

Kind
required
string

Тип ресурса.

object

Метаданные ресурса, заданные пользователем.

additional property
string or number or boolean or Массив Any (any) or object (Any)

Вспомогательный тип Any для OpenApi, полезный для динамических объектов JSON, например ResourceSpec.

Name
required
string

Имя ресурса.

Ответы

Примеры запросов

Content type
application/json
{
  • "Name": "string",
  • "Kind": "string",
  • "Data": {
    },
  • "Metadata": {
    }
}

Примеры ответов

Content type
application/json
{
  • "Kind": "string",
  • "CreatedAt": "2019-08-24T14:15:22Z",
  • "Spec": {
    }
}

Получить подробные сведения о ресурсе.

path Parameters
name
required
string

Имя ресурса для просмотра.

Ответы

Примеры ответов

Content type
application/json
{
  • "Kind": "string",
  • "CreatedAt": "2019-08-24T14:15:22Z",
  • "Spec": {
    }
}

Создать спецификацию ресурса и добавить запись истории.

path Parameters
name
required
string

Имя ресурса.

Request Body schema: application/json
required
required
object

Спецификация ресурса в виде объекта JSON.

additional property
string or number or boolean or Массив Any (any) or object (Any)

Вспомогательный тип Any для OpenApi, полезный для динамических объектов JSON, например ResourceSpec.

object

Метаданные ресурса в виде объекта JSON.

additional property
string or number or boolean or Массив Any (any) or object (Any)

Вспомогательный тип Any для OpenApi, полезный для динамических объектов JSON, например ResourceSpec.

Ответы

Примеры запросов

Content type
application/json
{
  • "Data": {
    },
  • "Metadata": {
    }
}

Примеры ответов

Content type
application/json
{
  • "Kind": "string",
  • "CreatedAt": "2019-08-24T14:15:22Z",
  • "Spec": {
    }
}

Удалить ресурс.

path Parameters
name
required
string

Имя удаляемого ресурса.

Ответы

Примеры ответов

Content type
application/json
{
  • "msg": "string"
}

Получить историю ресурса.

path Parameters
name
required
string

Имя ресурса для получения истории.

Ответы

Примеры ответов

Content type
application/json
[
  • {
    }
]

Откатить ресурс к определённой записи истории.

path Parameters
id
required
string

Идентификатор записи истории для отката ресурса.

name
required
string

Имя ресурса для отката.

Ответы

Примеры ответов

Content type
application/json
{
  • "Kind": "string",
  • "CreatedAt": "2019-08-24T14:15:22Z",
  • "Spec": {
    }
}

Secrets

Конечные точки управления секретами.

Получить список секретов.

query Parameters
filter
string or null
Пример: filter={ "where": { "kind": { "eq": "Env" } } }

Общий фильтр.

Ответы

Примеры ответов

Content type
application/json
[
  • {
    }
]

Создать секрет.

Request Body schema: application/json
required
required
object

Данные секрета.

additional property
string or number or boolean or Массив Any (any) or object (Any)

Вспомогательный тип Any для OpenApi, полезный для динамических объектов JSON, например ResourceSpec.

Immutable
boolean or null

Секрет нельзя обновить.

Kind
required
string

Тип секрета.

object

Метаданные ресурса, заданные пользователем.

additional property
string or number or boolean or Массив Any (any) or object (Any)

Вспомогательный тип Any для OpenApi, полезный для динамических объектов JSON, например ResourceSpec.

Name
required
string

Имя секрета.

Ответы

Примеры запросов

Content type
application/json
{
  • "Name": "string",
  • "Kind": "string",
  • "Immutable": true,
  • "Metadata": {
    },
  • "Data": {
    }
}

Примеры ответов

Content type
application/json
{
  • "Name": "string",
  • "CreatedAt": "2019-08-24T14:15:22Z",
  • "UpdatedAt": "2019-08-24T14:15:22Z",
  • "Kind": "string",
  • "Immutable": true,
  • "Metadata": {
    },
  • "Data": {
    }
}

Удалить секрет.

path Parameters
key
required
string

Ключ секрета.

Ответы

Примеры ответов

Content type
application/json
{
  • "msg": "string"
}

Обновить секрет.

path Parameters
key
required
string

Ключ секрета.

Request Body schema: application/json
required
required
object

Данные секрета в виде объекта JSON.

additional property
string or number or boolean or Массив Any (any) or object (Any)

Вспомогательный тип Any для OpenApi, полезный для динамических объектов JSON, например ResourceSpec.

object

Метаданные секрета, заданные пользователем.

additional property
string or number or boolean or Массив Any (any) or object (Any)

Вспомогательный тип Any для OpenApi, полезный для динамических объектов JSON, например ResourceSpec.

Ответы

Примеры запросов

Content type
application/json
{
  • "Metadata": {
    },
  • "Data": {
    }
}

Примеры ответов

Content type
application/json
{
  • "Name": "string",
  • "CreatedAt": "2019-08-24T14:15:22Z",
  • "UpdatedAt": "2019-08-24T14:15:22Z",
  • "Kind": "string",
  • "Immutable": true,
  • "Metadata": {
    },
  • "Data": {
    }
}

Получить подробные сведения о секрете.

path Parameters
key
required
string

Ключ секрета.

Ответы

Примеры ответов

Content type
application/json
{
  • "Name": "string",
  • "CreatedAt": "2019-08-24T14:15:22Z",
  • "UpdatedAt": "2019-08-24T14:15:22Z",
  • "Kind": "string",
  • "Immutable": true,
  • "Metadata": {
    },
  • "Data": {
    }
}

System

Общие конечные точки системы.

Получить сведения о версии.

Ответы

Получить системные сведения о хосте или узле.

Ответы

Примеры ответов

Content type
application/json
{
  • "ID": "string",
  • "Containers": 0,
  • "ContainersRunning": 0,
  • "ContainersPaused": 0,
  • "ContainersStopped": 0,
  • "Images": 0,
  • "Driver": "string",
  • "DriverStatus": [
    ],
  • "DockerRootDir": "string",
  • "Plugins": {
    },
  • "MemoryLimit": true,
  • "SwapLimit": true,
  • "KernelMemoryTCP": true,
  • "CpuCfsPeriod": true,
  • "CpuCfsQuota": true,
  • "CPUShares": true,
  • "CPUSet": true,
  • "PidsLimit": true,
  • "OomKillDisable": true,
  • "IPv4Forwarding": true,
  • "BridgeNfIptables": true,
  • "BridgeNfIp6tables": true,
  • "Debug": true,
  • "NFd": 0,
  • "NGoroutines": 0,
  • "SystemTime": "string",
  • "LoggingDriver": "string",
  • "CgroupDriver": "EMPTY",
  • "CgroupVersion": "EMPTY",
  • "NEventsListener": 0,
  • "KernelVersion": "string",
  • "OperatingSystem": "string",
  • "OSVersion": "string",
  • "OSType": "string",
  • "Architecture": "string",
  • "NCPU": 0,
  • "MemTotal": 0,
  • "IndexServerAddress": "string",
  • "RegistryConfig": {
    },
  • "GenericResources": {
    },
  • "HttpProxy": "string",
  • "HttpsProxy": "string",
  • "NoProxy": "string",
  • "Name": "string",
  • "Labels": [
    ],
  • "ExperimentalBuild": true,
  • "ServerVersion": "string",
  • "Runtimes": {
    },
  • "DefaultRuntime": "string",
  • "Swarm": {
    },
  • "LiveRestoreEnabled": true,
  • "Isolation": "EMPTY",
  • "InitBinary": "string",
  • "ContainerdCommit": {
    },
  • "RuncCommit": {
    },
  • "InitCommit": {
    },
  • "SecurityOptions": [
    ],
  • "ProductLicense": "string",
  • "DefaultAddressPools": [
    ],
  • "Warnings": [
    ],
  • "CDISpecDirs": [
    ],
  • "HostGateway": "string",
  • "Config": {
    }
}

Получить сведения о версии.

Ответы

Примеры ответов

Content type
application/json
{
  • "Arch": "string",
  • "Channel": "string",
  • "Version": "string",
  • "CommitId": "string"
}

VmImages

Конечные точки управления образами виртуальных машин.

Получить список образов виртуальных машин.

query Parameters
filter
string or null
Пример: filter={ "where": { "kind": { "eq": "Env" } } }

Общий фильтр.

Ответы

Примеры ответов

Content type
application/json
[
  • {
    }
]

Удалить образ виртуальной машины.

path Parameters
name
required
string

Имя образа VM.

Ответы

Клонировать образ виртуальной машины.

path Parameters
clone_name
required
string

Имя клона.

name
required
string

Имя образа VM.

Request Body schema: text/plain
required
string

Ответы

Примеры ответов

Content type
application/json
{
  • "Name": "string",
  • "CreatedAt": "2019-08-24T14:15:22Z",
  • "Path": "string",
  • "Kind": "string",
  • "Format": "string",
  • "SizeActual": 0,
  • "SizeVirtual": 0
}

Импортировать образ виртуальной машины из файла.

path Parameters
name
required
string

Имя образа VM.

Request Body schema: text/plain
required
string

Ответы

Изменить размер образа виртуальной машины.

path Parameters
name
required
string

Имя образа VM.

Request Body schema: application/json
required
Shrink
required
boolean

Показывает, следует ли уменьшить размер образа.

Size
required
integer <int64> >= 0

Новый размер образа в байтах.

Ответы

Примеры запросов

Content type
application/json
{
  • "Size": 0,
  • "Shrink": true
}

Примеры ответов

Content type
application/json
{
  • "Name": "string",
  • "CreatedAt": "2019-08-24T14:15:22Z",
  • "Path": "string",
  • "Kind": "string",
  • "Format": "string",
  • "SizeActual": 0,
  • "SizeVirtual": 0
}

Создать снимок образа виртуальной машины.

path Parameters
name
required
string

Имя образа VM.

snap
required
string

Имя снимка.

Request Body schema: text/plain
required
string

Ответы

Примеры ответов

Content type
application/json
{
  • "Name": "string",
  • "CreatedAt": "2019-08-24T14:15:22Z",
  • "Path": "string",
  • "Kind": "string",
  • "Format": "string",
  • "SizeActual": 0,
  • "SizeVirtual": 0
}

Vms

Конечные точки управления виртуальными машинами.

Получить список виртуальных машин.

query Parameters
namespace
string or null

Пространство имён виртуальной машины.

Ответы

Примеры ответов

Content type
application/json
[
  • {
    }
]

Создать виртуальную машину.

query Parameters
namespace
string or null

Пространство имён виртуальной машины.

Request Body schema: application/json
required
required
object (VmDisk)

Дисковое представление VM.

Image
required
string

Имя используемого образа.

Size
integer or null <int64> >= 0

Допустимый виртуальный размер диска в ГБ; по умолчанию 20.

object or null

Ресурсы VM: процессор, память и сеть.

Cpu
required
integer <int64> >= 0

Число CPU VM; по умолчанию 1.

Dns
Массив strings or null

Список DNS-серверов для VM.

HostTun
boolean or null

Использовать устройство tun хоста.

Kvm
boolean or null

Включить ускорение KVM; по умолчанию false.

LinkNetIface
string or null

Сетевой интерфейс для подключения VM; по умолчанию eth0.

Memory
required
integer <int64> >= 0

Память VM в МБ; по умолчанию 512.

NetIface
string or null

Настраиваемый сетевой интерфейс VM; по умолчанию ens3.

Runtime
string or null

Имя образа контейнера для VM; по умолчанию nanocl-qemu.

RuntimeNetwork
string or null
Hostname
string or null

Имя хоста VM; по умолчанию создаётся из имени.

object or null

Метаданные ключ/значение, заданные пользователем.

property name*
additional property
string
MacAddress
string or null

MAC-адрес VM; по умолчанию создаётся автоматически.

object

Метаданные, заданные пользователем.

additional property
string or number or boolean or Массив Any (any) or object (Any)

Вспомогательный тип Any для OpenApi, полезный для динамических объектов JSON, например ResourceSpec.

Name
required
string

Имя VM.

Password
string or null

Пароль VM по умолчанию: cloud.

SshKey
string or null

Открытый ключ SSH пользователя по умолчанию; рекомендуется.

User
string or null

Пользователь VM по умолчанию: cloud.

Ответы

Примеры запросов

Content type
application/json
{
  • "Name": "string",
  • "Metadata": {
    },
  • "Hostname": "string",
  • "User": "string",
  • "Password": "string",
  • "SshKey": "string",
  • "Disk": {
    },
  • "MacAddress": "string",
  • "Labels": {
    },
  • "HostConfig": {
    }
}

Примеры ответов

Content type
application/json
{
  • "NamespaceName": "string",
  • "CreatedAt": "2019-08-24T14:15:22Z",
  • "Status": {
    },
  • "Spec": {
    }
}

Удалить виртуальную машину.

path Parameters
name
required
string

Имя виртуальной машины.

query Parameters
namespace
string or null

Пространство имён виртуальной машины.

Ответы

Изменить конфигурацию виртуальной машины, объединив текущую конфигурацию с новой, и добавить запись истории.

path Parameters
name
required
string

Имя виртуальной машины.

query Parameters
namespace
string or null

Пространство имён виртуальной машины.

Request Body schema: application/json
required
object or null

Ресурсы VM: процессор, память и сеть.

Cpu
required
integer <int64> >= 0

Число CPU VM; по умолчанию 1.

Dns
Массив strings or null

Список DNS-серверов для VM.

HostTun
boolean or null

Использовать устройство tun хоста.

Kvm
boolean or null

Включить ускорение KVM; по умолчанию false.

LinkNetIface
string or null

Сетевой интерфейс для подключения VM; по умолчанию eth0.

Memory
required
integer <int64> >= 0

Память VM в МБ; по умолчанию 512.

NetIface
string or null

Настраиваемый сетевой интерфейс VM; по умолчанию ens3.

Runtime
string or null

Имя образа контейнера для VM; по умолчанию nanocl-qemu.

RuntimeNetwork
string or null
Hostname
string or null

Имя хоста VM.

object or null

Метаданные ключ/значение, заданные пользователем.

property name*
additional property
string
object

Метаданные, заданные пользователем.

additional property
string or number or boolean or Массив Any (any) or object (Any)

Вспомогательный тип Any для OpenApi, полезный для динамических объектов JSON, например ResourceSpec.

Name
string or null

Имя VM.

Password
string or null

Пароль VM по умолчанию (cloud).

SshKey
string or null

Ключ SSH пользователя по умолчанию.

User
string or null

Пользователь VM по умолчанию (cloud).

Ответы

Примеры запросов

Content type
application/json
{
  • "Name": "string",
  • "Metadata": {
    },
  • "Hostname": "string",
  • "User": "string",
  • "Password": "string",
  • "SshKey": "string",
  • "Labels": {
    },
  • "HostConfig": {
    }
}

Примеры ответов

Content type
application/json
{
  • "NamespaceName": "string",
  • "CreatedAt": "2019-08-24T14:15:22Z",
  • "Status": {
    },
  • "Spec": {
    }
}

Подключиться к виртуальной машине через WebSocket.

path Parameters
name
required
string

Имя виртуальной машины.

query Parameters
namespace
string or null

Пространство имён виртуальной машины.

Ответы

Получить список историй виртуальных машин.

path Parameters
name
required
string

Имя виртуальной машины.

query Parameters
namespace
string or null

Пространство имён виртуальной машины.

Ответы

Примеры ответов

Content type
application/json
[
  • {
    }
]

Просмотреть виртуальную машину.

path Parameters
name
required
string

Имя виртуальной машины.

query Parameters
namespace
string or null

Пространство имён виртуальной машины.

Ответы

Примеры ответов

Content type
application/json
{
  • "NamespaceName": "string",
  • "CreatedAt": "2019-08-24T14:15:22Z",
  • "InstanceTotal": 0,
  • "InstanceRunning": 0,
  • "Status": {
    },
  • "Spec": {
    },
  • "Instances": [
    ]
}

Схемы

Address

Addr
string or null

IP-адрес.

PrefixLen
integer or null <int64>

Длина маски IP-адреса.

{
  • "Addr": "string",
  • "PrefixLen": 0
}

Any

One of
string

Вспомогательный тип Any для OpenApi, полезный для динамических объектов JSON, например ResourceSpec.

Example
{
  • "property1": "string",
  • "property2": "string"
}

ApiError

msg
required
string
{
  • "msg": "string"
}

BinaryInfo

Arch
required
string

Arch — архитектура текущего двоичного файла.

Channel
required
string

Channel — канал текущего двоичного файла.

CommitId
required
string

CommitID — идентификатор коммита текущего двоичного файла.

Version
required
string

Version — версия текущего двоичного файла.

{
  • "Arch": "string",
  • "Channel": "string",
  • "Version": "string",
  • "CommitId": "string"
}

BlkioStats

Массив objects or null (BlkioStatsEntry)
Array
major
required
integer <int64> >= 0
minor
required
integer <int64> >= 0
op
required
string
value
required
integer <int64> >= 0
Массив objects or null (BlkioStatsEntry)
Array
major
required
integer <int64> >= 0
minor
required
integer <int64> >= 0
op
required
string
value
required
integer <int64> >= 0
Массив objects or null (BlkioStatsEntry)
Array
major
required
integer <int64> >= 0
minor
required
integer <int64> >= 0
op
required
string
value
required
integer <int64> >= 0
Массив objects or null (BlkioStatsEntry)
Array
major
required
integer <int64> >= 0
minor
required
integer <int64> >= 0
op
required
string
value
required
integer <int64> >= 0
Массив objects or null (BlkioStatsEntry)
Array
major
required
integer <int64> >= 0
minor
required
integer <int64> >= 0
op
required
string
value
required
integer <int64> >= 0
Массив objects or null (BlkioStatsEntry)
Array
major
required
integer <int64> >= 0
minor
required
integer <int64> >= 0
op
required
string
value
required
integer <int64> >= 0
Массив objects or null (BlkioStatsEntry)
Array
major
required
integer <int64> >= 0
minor
required
integer <int64> >= 0
op
required
string
value
required
integer <int64> >= 0
Массив objects or null (BlkioStatsEntry)
Array
major
required
integer <int64> >= 0
minor
required
integer <int64> >= 0
op
required
string
value
required
integer <int64> >= 0
{
  • "io_service_bytes_recursive": [
    ],
  • "io_serviced_recursive": [
    ],
  • "io_queue_recursive": [
    ],
  • "io_service_time_recursive": [
    ],
  • "io_wait_time_recursive": [
    ],
  • "io_merged_recursive": [
    ],
  • "io_time_recursive": [
    ],
  • "sectors_recursive": [
    ]
}

BlkioStatsEntry

major
required
integer <int64> >= 0
minor
required
integer <int64> >= 0
op
required
string
value
required
integer <int64> >= 0
{
  • "major": 0,
  • "minor": 0,
  • "op": "string",
  • "value": 0
}

BollardDate

string or null (BollardDate)

BollardDate

"2021-01-01T00:00:00.000000000Z"

CPUStats

required
object (CPUUsage)

Статистика использования CPU контейнером.

percpu_usage
Массив integers or null <int64> [ items <int64 > >= 0 ]
total_usage
required
integer <int64> >= 0
usage_in_kernelmode
required
integer <int64> >= 0
usage_in_usermode
required
integer <int64> >= 0
online_cpus
integer or null <int64> >= 0
system_cpu_usage
integer or null <int64> >= 0
required
object (ThrottlingData)

Статистика ограничения CPU.

periods
required
integer <int64> >= 0
throttled_periods
required
integer <int64> >= 0
throttled_time
required
integer <int64> >= 0
{
  • "cpu_usage": {
    },
  • "system_cpu_usage": 0,
  • "online_cpus": 0,
  • "throttling_data": {
    }
}

CPUUsage

percpu_usage
Массив integers or null <int64> [ items <int64 > >= 0 ]
total_usage
required
integer <int64> >= 0
usage_in_kernelmode
required
integer <int64> >= 0
usage_in_usermode
required
integer <int64> >= 0
{
  • "percpu_usage": [
    ],
  • "usage_in_usermode": 0,
  • "total_usage": 0,
  • "usage_in_kernelmode": 0
}

Cargo

CreatedAt
required
string <date-time>

Время создания Cargo.

NamespaceName
required
string

Имя пространства имён.

required
object (CargoSpec)

Спецификация Cargo описывает его состояние. Она позволяет узнать состояние Cargo и сохраняет историю изменений существующего Cargo.

CargoKey
required
string

Ключ Cargo.

required
object (Config)

Создаваемый контейнер.

CreatedAt
required
string <date-time>

Дата создания спецификации Cargo.

ImagePullPolicy
string or null
Допустимые значения: "Never" "Always" "IfNotPresent"

Политика загрузки образов объектов процессов (job, cargo, vm).

ImagePullSecret
string or null

Секрет для загрузки образа.

object or null

Создаваемый контейнер.

Key
required
string <uuid>

Уникальный идентификатор спецификации Cargo.

object

Метаданные Cargo, заданные пользователем.

Name
required
string

Имя Cargo.

(Auto (object or null)) or (Unique (object or null)) or (UniqueByNode (object or null)) or (UniqueByNodeGroups (object or null)) or (UniqueByNodeNames (object or null)) or (Static (object or null)) or (StaticByNodes (object or null)) or (StaticByNodeGroups (object or null)) or (StaticByNodeNames (object or null))

Auto автоматически задаёт число реплик в кластере. Number позволяет задавать число реплик вручную. Примечание: auto гарантирует наличие хотя бы одной реплики в кластере.

Поле дискриминатора: Mode.

Secrets
Массив strings or null

Список секретов, используемых как переменные окружения.

Version
required
string

Версия спецификации.

required
object (ObjPsStatus)
Actual
required
string (ObjPsStatusKind)
Допустимые значения: "create" "starting" "start" "updating" "update" "destroying" "destroy" "stopping" "stop" "fail" "finish" "unknown"
PrevActual
required
string (ObjPsStatusKind)
Допустимые значения: "create" "starting" "start" "updating" "update" "destroying" "destroy" "stopping" "stop" "fail" "finish" "unknown"
PrevWanted
required
string (ObjPsStatusKind)
Допустимые значения: "create" "starting" "start" "updating" "update" "destroying" "destroy" "stopping" "stop" "fail" "finish" "unknown"
UpdatedAt
required
string <date-time>
Wanted
required
string (ObjPsStatusKind)
Допустимые значения: "create" "starting" "start" "updating" "update" "destroying" "destroy" "stopping" "stop" "fail" "finish" "unknown"
{
  • "NamespaceName": "string",
  • "CreatedAt": "2019-08-24T14:15:22Z",
  • "Status": {
    },
  • "Spec": {
    }
}

CargoInspect

CreatedAt
required
string <date-time>

Время создания Cargo.

InstanceRunning
required
integer >= 0

Число работающих экземпляров.

required
Массив objects (Process)

Список экземпляров.

Array
CreatedAt
required
string <date-time>

Дата создания.

required
object (ContainerInspectResponse)
Key
required
string

Ключ процесса.

Kind
required
string (ProcessKind)
Допустимые значения: "vm" "job" "cargo"

Тип процесса (Vm, Job, Cargo).

KindKey
required
string

Ключ связанного типа.

Name
required
string

Имя процесса.

NodeKey
required
string

Ключ узла, на котором работает контейнер.

UpdatedAt
required
string <date-time>

Время последнего обновления экземпляра.

InstanceTotal
required
integer >= 0

Число экземпляров.

NamespaceName
required
string

Имя пространства имён.

required
object (CargoSpec)

Спецификация Cargo описывает его состояние. Она позволяет узнать состояние Cargo и сохраняет историю изменений существующего Cargo.

CargoKey
required
string

Ключ Cargo.

required
object (Config)

Создаваемый контейнер.

CreatedAt
required
string <date-time>

Дата создания спецификации Cargo.

ImagePullPolicy
string or null
Допустимые значения: "Never" "Always" "IfNotPresent"

Политика загрузки образов объектов процессов (job, cargo, vm).

ImagePullSecret
string or null

Секрет для загрузки образа.

object or null

Создаваемый контейнер.

Key
required
string <uuid>

Уникальный идентификатор спецификации Cargo.

object

Метаданные Cargo, заданные пользователем.

Name
required
string

Имя Cargo.

(Auto (object or null)) or (Unique (object or null)) or (UniqueByNode (object or null)) or (UniqueByNodeGroups (object or null)) or (UniqueByNodeNames (object or null)) or (Static (object or null)) or (StaticByNodes (object or null)) or (StaticByNodeGroups (object or null)) or (StaticByNodeNames (object or null))

Auto автоматически задаёт число реплик в кластере. Number позволяет задавать число реплик вручную. Примечание: auto гарантирует наличие хотя бы одной реплики в кластере.

Поле дискриминатора: Mode.

Secrets
Массив strings or null

Список секретов, используемых как переменные окружения.

Version
required
string

Версия спецификации.

required
object (ObjPsStatus)
Actual
required
string (ObjPsStatusKind)
Допустимые значения: "create" "starting" "start" "updating" "update" "destroying" "destroy" "stopping" "stop" "fail" "finish" "unknown"
PrevActual
required
string (ObjPsStatusKind)
Допустимые значения: "create" "starting" "start" "updating" "update" "destroying" "destroy" "stopping" "stop" "fail" "finish" "unknown"
PrevWanted
required
string (ObjPsStatusKind)
Допустимые значения: "create" "starting" "start" "updating" "update" "destroying" "destroy" "stopping" "stop" "fail" "finish" "unknown"
UpdatedAt
required
string <date-time>
Wanted
required
string (ObjPsStatusKind)
Допустимые значения: "create" "starting" "start" "updating" "update" "destroying" "destroy" "stopping" "stop" "fail" "finish" "unknown"
{
  • "NamespaceName": "string",
  • "CreatedAt": "2019-08-24T14:15:22Z",
  • "InstanceTotal": 0,
  • "InstanceRunning": 0,
  • "Status": {
    },
  • "Spec": {
    },
  • "Instances": [
    ]
}

CargoKillOptions

signal
required
string

Сигнал контейнеру; по умолчанию SIGKILL.

{
  • "signal": "string"
}

CargoSpec

CargoKey
required
string

Ключ Cargo.

required
object (Config)

Создаваемый контейнер.

ArgsEscaped
boolean or null

Команда уже экранирована; только для Windows.

AttachStderr
boolean or null

Показывает, следует ли подключиться к stderr.

AttachStdin
boolean or null

Показывает, следует ли подключиться к stdin.

AttachStdout
boolean or null

Показывает, следует ли подключиться к stdout.

Cmd
Массив strings or null

Выполняемая команда в виде строки или массива строк.

Domainname
string or null

Доменное имя контейнера.

Entrypoint
Массив strings or null

Точка входа контейнера в виде строки или массива строк. Если массив содержит ровно одну пустую строку ([\"\"]), точка входа сбрасывается к системному значению по умолчанию, используемому Docker, когда инструкция ENTRYPOINT отсутствует в Dockerfile.

Env
Массив strings or null

Список переменных окружения, задаваемых в контейнере, в формате [\"VAR=value\", ...]. Переменная без = удаляется из окружения, а не получает пустое значение.

object or null

Объект, сопоставляющий порты с пустым объектом в формате: {\"<port>/<tcp|udp|sctp>\": {}}

object or null

Проверка работоспособности контейнера.

object or null

Конфигурация контейнера, зависящая от хоста выполнения.

Hostname
string or null

Имя хоста контейнера, соответствующее RFC 1123.

Image
string or null

Имя образа для создания контейнера.

object or null

Метаданные ключ/значение, заданные пользователем.

MacAddress
string or null

MAC-адрес контейнера.

NetworkDisabled
boolean or null

Отключить сеть для контейнера.

object or null

NetworkingConfig представляет сетевую конфигурацию каждого интерфейса контейнера. Используется для сетевых настроек, указанных в командах docker create и docker network connect.

OnBuild
Массив strings or null

Метаданные ONBUILD, определённые в Dockerfile образа.

OpenStdin
boolean or null

Открыть stdin.

Shell
Массив strings or null

Оболочка для случаев, когда RUN, CMD и ENTRYPOINT используют оболочку.

StdinOnce
boolean or null

Закрыть stdin после отключения одного подключённого клиента.

StopSignal
string or null

Сигнал остановки контейнера в виде строки или беззнакового целого числа.

StopTimeout
integer or null <int64>

Время ожидания остановки контейнера в секундах.

Tty
boolean or null

Подключить стандартные потоки к TTY, включая stdin, если он не закрыт.

User
string or null

Пользователь, от имени которого выполняются команды в контейнере.

object or null

Объект, сопоставляющий пути точек монтирования внутри контейнера с пустыми объектами.

WorkingDir
string or null

Рабочий каталог для выполнения команд.

CreatedAt
required
string <date-time>

Дата создания спецификации Cargo.

ImagePullPolicy
string or null
Допустимые значения: "Never" "Always" "IfNotPresent"

Политика загрузки образов объектов процессов (job, cargo, vm).

ImagePullSecret
string or null

Секрет для загрузки образа.

object or null

Создаваемый контейнер.

ArgsEscaped
boolean or null

Команда уже экранирована; только для Windows.

AttachStderr
boolean or null

Показывает, следует ли подключиться к stderr.

AttachStdin
boolean or null

Показывает, следует ли подключиться к stdin.

AttachStdout
boolean or null

Показывает, следует ли подключиться к stdout.

Cmd
Массив strings or null

Выполняемая команда в виде строки или массива строк.

Domainname
string or null

Доменное имя контейнера.

Entrypoint
Массив strings or null

Точка входа контейнера в виде строки или массива строк. Если массив содержит ровно одну пустую строку ([\"\"]), точка входа сбрасывается к системному значению по умолчанию, используемому Docker, когда инструкция ENTRYPOINT отсутствует в Dockerfile.

Env
Массив strings or null

Список переменных окружения, задаваемых в контейнере, в формате [\"VAR=value\", ...]. Переменная без = удаляется из окружения, а не получает пустое значение.

object or null

Объект, сопоставляющий порты с пустым объектом в формате: {\"<port>/<tcp|udp|sctp>\": {}}

object or null

Проверка работоспособности контейнера.

object or null

Конфигурация контейнера, зависящая от хоста выполнения.

Hostname
string or null

Имя хоста контейнера, соответствующее RFC 1123.

Image
string or null

Имя образа для создания контейнера.

object or null

Метаданные ключ/значение, заданные пользователем.

MacAddress
string or null

MAC-адрес контейнера.

NetworkDisabled
boolean or null

Отключить сеть для контейнера.

object or null

NetworkingConfig представляет сетевую конфигурацию каждого интерфейса контейнера. Используется для сетевых настроек, указанных в командах docker create и docker network connect.

OnBuild
Массив strings or null

Метаданные ONBUILD, определённые в Dockerfile образа.

OpenStdin
boolean or null

Открыть stdin.

Shell
Массив strings or null

Оболочка для случаев, когда RUN, CMD и ENTRYPOINT используют оболочку.

StdinOnce
boolean or null

Закрыть stdin после отключения одного подключённого клиента.

StopSignal
string or null

Сигнал остановки контейнера в виде строки или беззнакового целого числа.

StopTimeout
integer or null <int64>

Время ожидания остановки контейнера в секундах.

Tty
boolean or null

Подключить стандартные потоки к TTY, включая stdin, если он не закрыт.

User
string or null

Пользователь, от имени которого выполняются команды в контейнере.

object or null

Объект, сопоставляющий пути точек монтирования внутри контейнера с пустыми объектами.

WorkingDir
string or null

Рабочий каталог для выполнения команд.

Key
required
string <uuid>

Уникальный идентификатор спецификации Cargo.

object

Метаданные Cargo, заданные пользователем.

additional property
string or number or boolean or Массив Any (any) or object (Any)

Вспомогательный тип Any для OpenApi, полезный для динамических объектов JSON, например ResourceSpec.

Name
required
string

Имя Cargo.

(Auto (object or null)) or (Unique (object or null)) or (UniqueByNode (object or null)) or (UniqueByNodeGroups (object or null)) or (UniqueByNodeNames (object or null)) or (Static (object or null)) or (StaticByNodes (object or null)) or (StaticByNodeGroups (object or null)) or (StaticByNodeNames (object or null))

Auto автоматически задаёт число реплик в кластере. Number позволяет задавать число реплик вручную. Примечание: auto гарантирует наличие хотя бы одной реплики в кластере.

Поле дискриминатора: Mode.

One of
Mode
required
string
Значение: "Auto"
Secrets
Массив strings or null

Список секретов, используемых как переменные окружения.

Version
required
string

Версия спецификации.

{
  • "Key": "5eb041b0-19c9-4022-bd51-0e723885f5dd",
  • "CargoKey": "string",
  • "Version": "string",
  • "CreatedAt": "2019-08-24T14:15:22Z",
  • "Name": "string",
  • "Metadata": {
    },
  • "InitContainer": {
    },
  • "Secrets": [
    ],
  • "ImagePullSecret": "string",
  • "ImagePullPolicy": "Never",
  • "Container": {
    },
  • "Replication": {
    }
}

CargoSpecPartial

required
object (Config)

Создаваемый контейнер.

ArgsEscaped
boolean or null

Команда уже экранирована; только для Windows.

AttachStderr
boolean or null

Показывает, следует ли подключиться к stderr.

AttachStdin
boolean or null

Показывает, следует ли подключиться к stdin.

AttachStdout
boolean or null

Показывает, следует ли подключиться к stdout.

Cmd
Массив strings or null

Выполняемая команда в виде строки или массива строк.

Domainname
string or null

Доменное имя контейнера.

Entrypoint
Массив strings or null

Точка входа контейнера в виде строки или массива строк. Если массив содержит ровно одну пустую строку ([\"\"]), точка входа сбрасывается к системному значению по умолчанию, используемому Docker, когда инструкция ENTRYPOINT отсутствует в Dockerfile.

Env
Массив strings or null

Список переменных окружения, задаваемых в контейнере, в формате [\"VAR=value\", ...]. Переменная без = удаляется из окружения, а не получает пустое значение.

object or null

Объект, сопоставляющий порты с пустым объектом в формате: {\"<port>/<tcp|udp|sctp>\": {}}

object or null

Проверка работоспособности контейнера.

object or null

Конфигурация контейнера, зависящая от хоста выполнения.

Hostname
string or null

Имя хоста контейнера, соответствующее RFC 1123.

Image
string or null

Имя образа для создания контейнера.

object or null

Метаданные ключ/значение, заданные пользователем.

MacAddress
string or null

MAC-адрес контейнера.

NetworkDisabled
boolean or null

Отключить сеть для контейнера.

object or null

NetworkingConfig представляет сетевую конфигурацию каждого интерфейса контейнера. Используется для сетевых настроек, указанных в командах docker create и docker network connect.

OnBuild
Массив strings or null

Метаданные ONBUILD, определённые в Dockerfile образа.

OpenStdin
boolean or null

Открыть stdin.

Shell
Массив strings or null

Оболочка для случаев, когда RUN, CMD и ENTRYPOINT используют оболочку.

StdinOnce
boolean or null

Закрыть stdin после отключения одного подключённого клиента.

StopSignal
string or null

Сигнал остановки контейнера в виде строки или беззнакового целого числа.

StopTimeout
integer or null <int64>

Время ожидания остановки контейнера в секундах.

Tty
boolean or null

Подключить стандартные потоки к TTY, включая stdin, если он не закрыт.

User
string or null

Пользователь, от имени которого выполняются команды в контейнере.

object or null

Объект, сопоставляющий пути точек монтирования внутри контейнера с пустыми объектами.

WorkingDir
string or null

Рабочий каталог для выполнения команд.

ImagePullPolicy
string or null
Допустимые значения: "Never" "Always" "IfNotPresent"

Политика загрузки образов объектов процессов (job, cargo, vm).

ImagePullSecret
string or null

Секрет для загрузки образа.

object or null

Создаваемый контейнер.

ArgsEscaped
boolean or null

Команда уже экранирована; только для Windows.

AttachStderr
boolean or null

Показывает, следует ли подключиться к stderr.

AttachStdin
boolean or null

Показывает, следует ли подключиться к stdin.

AttachStdout
boolean or null

Показывает, следует ли подключиться к stdout.

Cmd
Массив strings or null

Выполняемая команда в виде строки или массива строк.

Domainname
string or null

Доменное имя контейнера.

Entrypoint
Массив strings or null

Точка входа контейнера в виде строки или массива строк. Если массив содержит ровно одну пустую строку ([\"\"]), точка входа сбрасывается к системному значению по умолчанию, используемому Docker, когда инструкция ENTRYPOINT отсутствует в Dockerfile.

Env
Массив strings or null

Список переменных окружения, задаваемых в контейнере, в формате [\"VAR=value\", ...]. Переменная без = удаляется из окружения, а не получает пустое значение.

object or null

Объект, сопоставляющий порты с пустым объектом в формате: {\"<port>/<tcp|udp|sctp>\": {}}

object or null

Проверка работоспособности контейнера.

object or null

Конфигурация контейнера, зависящая от хоста выполнения.

Hostname
string or null

Имя хоста контейнера, соответствующее RFC 1123.

Image
string or null

Имя образа для создания контейнера.

object or null

Метаданные ключ/значение, заданные пользователем.

MacAddress
string or null

MAC-адрес контейнера.

NetworkDisabled
boolean or null

Отключить сеть для контейнера.

object or null

NetworkingConfig представляет сетевую конфигурацию каждого интерфейса контейнера. Используется для сетевых настроек, указанных в командах docker create и docker network connect.

OnBuild
Массив strings or null

Метаданные ONBUILD, определённые в Dockerfile образа.

OpenStdin
boolean or null

Открыть stdin.

Shell
Массив strings or null

Оболочка для случаев, когда RUN, CMD и ENTRYPOINT используют оболочку.

StdinOnce
boolean or null

Закрыть stdin после отключения одного подключённого клиента.

StopSignal
string or null

Сигнал остановки контейнера в виде строки или беззнакового целого числа.

StopTimeout
integer or null <int64>

Время ожидания остановки контейнера в секундах.

Tty
boolean or null

Подключить стандартные потоки к TTY, включая stdin, если он не закрыт.

User
string or null

Пользователь, от имени которого выполняются команды в контейнере.

object or null

Объект, сопоставляющий пути точек монтирования внутри контейнера с пустыми объектами.

WorkingDir
string or null

Рабочий каталог для выполнения команд.

object

Метаданные Cargo, заданные пользователем.

additional property
string or number or boolean or Массив Any (any) or object (Any)

Вспомогательный тип Any для OpenApi, полезный для динамических объектов JSON, например ResourceSpec.

Name
required
string

Имя Cargo.

(Auto (object or null)) or (Unique (object or null)) or (UniqueByNode (object or null)) or (UniqueByNodeGroups (object or null)) or (UniqueByNodeNames (object or null)) or (Static (object or null)) or (StaticByNodes (object or null)) or (StaticByNodeGroups (object or null)) or (StaticByNodeNames (object or null))

Auto автоматически задаёт число реплик в кластере. Number позволяет задавать число реплик вручную. Примечание: auto гарантирует наличие хотя бы одной реплики в кластере.

Поле дискриминатора: Mode.

One of
Mode
required
string
Значение: "Auto"
Secrets
Массив strings or null

Список секретов, используемых как переменные окружения.

{
  • "Name": "string",
  • "Metadata": {
    },
  • "InitContainer": {
    },
  • "Secrets": [
    ],
  • "ImagePullSecret": "string",
  • "ImagePullPolicy": "Never",
  • "Container": {
    },
  • "Replication": {
    }
}

CargoSpecUpdate

object or null

Создаваемый контейнер.

ArgsEscaped
boolean or null

Команда уже экранирована; только для Windows.

AttachStderr
boolean or null

Показывает, следует ли подключиться к stderr.

AttachStdin
boolean or null

Показывает, следует ли подключиться к stdin.

AttachStdout
boolean or null

Показывает, следует ли подключиться к stdout.

Cmd
Массив strings or null

Выполняемая команда в виде строки или массива строк.

Domainname
string or null

Доменное имя контейнера.

Entrypoint
Массив strings or null

Точка входа контейнера в виде строки или массива строк. Если массив содержит ровно одну пустую строку ([\"\"]), точка входа сбрасывается к системному значению по умолчанию, используемому Docker, когда инструкция ENTRYPOINT отсутствует в Dockerfile.

Env
Массив strings or null

Список переменных окружения, задаваемых в контейнере, в формате [\"VAR=value\", ...]. Переменная без = удаляется из окружения, а не получает пустое значение.

object or null

Объект, сопоставляющий порты с пустым объектом в формате: {\"<port>/<tcp|udp|sctp>\": {}}

object or null

Проверка работоспособности контейнера.

object or null

Конфигурация контейнера, зависящая от хоста выполнения.

Hostname
string or null

Имя хоста контейнера, соответствующее RFC 1123.

Image
string or null

Имя образа для создания контейнера.

object or null

Метаданные ключ/значение, заданные пользователем.

MacAddress
string or null

MAC-адрес контейнера.

NetworkDisabled
boolean or null

Отключить сеть для контейнера.

object or null

NetworkingConfig представляет сетевую конфигурацию каждого интерфейса контейнера. Используется для сетевых настроек, указанных в командах docker create и docker network connect.

OnBuild
Массив strings or null

Метаданные ONBUILD, определённые в Dockerfile образа.

OpenStdin
boolean or null

Открыть stdin.

Shell
Массив strings or null

Оболочка для случаев, когда RUN, CMD и ENTRYPOINT используют оболочку.

StdinOnce
boolean or null

Закрыть stdin после отключения одного подключённого клиента.

StopSignal
string or null

Сигнал остановки контейнера в виде строки или беззнакового целого числа.

StopTimeout
integer or null <int64>

Время ожидания остановки контейнера в секундах.

Tty
boolean or null

Подключить стандартные потоки к TTY, включая stdin, если он не закрыт.

User
string or null

Пользователь, от имени которого выполняются команды в контейнере.

object or null

Объект, сопоставляющий пути точек монтирования внутри контейнера с пустыми объектами.

WorkingDir
string or null

Рабочий каталог для выполнения команд.

ImagePullPolicy
string or null
Допустимые значения: "Never" "Always" "IfNotPresent"

Политика загрузки образов объектов процессов (job, cargo, vm).

ImagePullSecret
string or null

Секрет для загрузки образа.

object or null

Создаваемый контейнер.

ArgsEscaped
boolean or null

Команда уже экранирована; только для Windows.

AttachStderr
boolean or null

Показывает, следует ли подключиться к stderr.

AttachStdin
boolean or null

Показывает, следует ли подключиться к stdin.

AttachStdout
boolean or null

Показывает, следует ли подключиться к stdout.

Cmd
Массив strings or null

Выполняемая команда в виде строки или массива строк.

Domainname
string or null

Доменное имя контейнера.

Entrypoint
Массив strings or null

Точка входа контейнера в виде строки или массива строк. Если массив содержит ровно одну пустую строку ([\"\"]), точка входа сбрасывается к системному значению по умолчанию, используемому Docker, когда инструкция ENTRYPOINT отсутствует в Dockerfile.

Env
Массив strings or null

Список переменных окружения, задаваемых в контейнере, в формате [\"VAR=value\", ...]. Переменная без = удаляется из окружения, а не получает пустое значение.

object or null

Объект, сопоставляющий порты с пустым объектом в формате: {\"<port>/<tcp|udp|sctp>\": {}}

object or null

Проверка работоспособности контейнера.

object or null

Конфигурация контейнера, зависящая от хоста выполнения.

Hostname
string or null

Имя хоста контейнера, соответствующее RFC 1123.

Image
string or null

Имя образа для создания контейнера.

object or null

Метаданные ключ/значение, заданные пользователем.

MacAddress
string or null

MAC-адрес контейнера.

NetworkDisabled
boolean or null

Отключить сеть для контейнера.

object or null

NetworkingConfig представляет сетевую конфигурацию каждого интерфейса контейнера. Используется для сетевых настроек, указанных в командах docker create и docker network connect.

OnBuild
Массив strings or null

Метаданные ONBUILD, определённые в Dockerfile образа.

OpenStdin
boolean or null

Открыть stdin.

Shell
Массив strings or null

Оболочка для случаев, когда RUN, CMD и ENTRYPOINT используют оболочку.

StdinOnce
boolean or null

Закрыть stdin после отключения одного подключённого клиента.

StopSignal
string or null

Сигнал остановки контейнера в виде строки или беззнакового целого числа.

StopTimeout
integer or null <int64>

Время ожидания остановки контейнера в секундах.

Tty
boolean or null

Подключить стандартные потоки к TTY, включая stdin, если он не закрыт.

User
string or null

Пользователь, от имени которого выполняются команды в контейнере.

object or null

Объект, сопоставляющий пути точек монтирования внутри контейнера с пустыми объектами.

WorkingDir
string or null

Рабочий каталог для выполнения команд.

object

Новые метаданные Cargo, заданные пользователем.

additional property
string or number or boolean or Массив Any (any) or object (Any)

Вспомогательный тип Any для OpenApi, полезный для динамических объектов JSON, например ResourceSpec.

Name
string or null

Новое имя Cargo.

(Auto (object or null)) or (Unique (object or null)) or (UniqueByNode (object or null)) or (UniqueByNodeGroups (object or null)) or (UniqueByNodeNames (object or null)) or (Static (object or null)) or (StaticByNodes (object or null)) or (StaticByNodeGroups (object or null)) or (StaticByNodeNames (object or null))

Auto автоматически задаёт число реплик в кластере. Number позволяет задавать число реплик вручную. Примечание: auto гарантирует наличие хотя бы одной реплики в кластере.

Поле дискриминатора: Mode.

One of
Mode
required
string
Значение: "Auto"
Secrets
Массив strings or null

Список секретов, используемых как переменные окружения.

{
  • "Name": "string",
  • "Metadata": {
    },
  • "InitContainer": {
    },
  • "Secrets": [
    ],
  • "ImagePullSecret": "string",
  • "ImagePullPolicy": "Never",
  • "Container": {
    },
  • "Replication": {
    }
}

CargoSummary

CreatedAt
required
string <date-time>

Время создания Cargo.

InstanceRunning
required
integer >= 0

Число работающих экземпляров.

InstanceTotal
required
integer >= 0

Число экземпляров.

NamespaceName
required
string

Имя пространства имён.

required
object (CargoSpec)

Спецификация Cargo описывает его состояние. Она позволяет узнать состояние Cargo и сохраняет историю изменений существующего Cargo.

CargoKey
required
string

Ключ Cargo.

required
object (Config)

Создаваемый контейнер.

CreatedAt
required
string <date-time>

Дата создания спецификации Cargo.

ImagePullPolicy
string or null
Допустимые значения: "Never" "Always" "IfNotPresent"

Политика загрузки образов объектов процессов (job, cargo, vm).

ImagePullSecret
string or null

Секрет для загрузки образа.

object or null

Создаваемый контейнер.

Key
required
string <uuid>

Уникальный идентификатор спецификации Cargo.

object

Метаданные Cargo, заданные пользователем.

Name
required
string

Имя Cargo.

(Auto (object or null)) or (Unique (object or null)) or (UniqueByNode (object or null)) or (UniqueByNodeGroups (object or null)) or (UniqueByNodeNames (object or null)) or (Static (object or null)) or (StaticByNodes (object or null)) or (StaticByNodeGroups (object or null)) or (StaticByNodeNames (object or null))

Auto автоматически задаёт число реплик в кластере. Number позволяет задавать число реплик вручную. Примечание: auto гарантирует наличие хотя бы одной реплики в кластере.

Поле дискриминатора: Mode.

Secrets
Массив strings or null

Список секретов, используемых как переменные окружения.

Version
required
string

Версия спецификации.

{
  • "NamespaceName": "string",
  • "CreatedAt": "2019-08-24T14:15:22Z",
  • "InstanceTotal": 0,
  • "InstanceRunning": 0,
  • "Spec": {
    }
}

ClusterInfo

CreatedAt
string or null (BollardDate)

BollardDate

DataPathPort
integer or null <int32> >= 0

DataPathPort задаёт номер порта для передачи данных. Допустимый диапазон — от 1024 до 49151. Если порт не задан или равен 0, используется порт по умолчанию (4789).

DefaultAddrPool
Массив strings or null

Default Address Pool задаёт пулы подсетей по умолчанию для сетей глобальной области.

ID
string or null

Идентификатор swarm.

RootRotationInProgress
boolean or null

Показывает, выполняется ли сейчас ротация корневого центра сертификации swarm.

object or null

Конфигурация swarm, изменяемая пользователем.

object or null

Конфигурация центра сертификации.

object or null

Конфигурация диспетчера.

object or null

Параметры шифрования хранимых данных.

object or null

Метаданные ключ/значение, заданные пользователем.

Name
string or null

Имя swarm.

object or null

Конфигурация оркестрации.

object or null

Конфигурация Raft.

object or null

Настройки по умолчанию для создания задач в кластере.

SubnetSize
integer or null <int32> >= 0

SubnetSize задаёт размер подсетей, создаваемых из пула подсетей по умолчанию.

object or null

Сведения об издателе конечных сертификатов TLS и доверенном корневом сертификате центра сертификации.

CertIssuerPublicKey
string or null

Необработанные байты открытого ключа издателя в URL-безопасном Base64.

CertIssuerSubject
string or null

Необработанные байты субъекта издателя в URL-безопасном Base64.

TrustRoot
string or null

Корневые сертификаты центров сертификации для проверки конечных сертификатов TLS.

UpdatedAt
string or null (BollardDate)

BollardDate

object or null

Номер версии объекта, например узла или службы. Он необходим для предотвращения конфликтующих записей. При обновлении клиент должен передать номер версии вместе с изменённой спецификацией. Это обеспечивает безопасную и детерминированную конкурентность: изменение может не примениться, если версия изменилась с последнего чтения. Если два запроса указывают одну исходную версию, успешно выполниться может только один. Поэтому два одновременных запроса обновления не смогут непреднамеренно перезаписать друг друга.

Index
integer or null <int64> >= 0
{
  • "ID": "string",
  • "Version": {
    },
  • "CreatedAt": "2021-01-01T00:00:00.000000000Z",
  • "UpdatedAt": "2021-01-01T00:00:00.000000000Z",
  • "Spec": {
    },
  • "TLSInfo": {
    },
  • "RootRotationInProgress": true,
  • "DataPathPort": 0,
  • "DefaultAddrPool": [
    ],
  • "SubnetSize": 0
}

Commit

Expected
string or null

Идентификатор коммита внешнего инструмента, ожидаемый dockerd и заданный при сборке.

ID
string or null

Фактический идентификатор коммита внешнего инструмента.

{
  • "ID": "string",
  • "Expected": "string"
}

Config

ArgsEscaped
boolean or null

Команда уже экранирована; только для Windows.

AttachStderr
boolean or null

Показывает, следует ли подключиться к stderr.

AttachStdin
boolean or null

Показывает, следует ли подключиться к stdin.

AttachStdout
boolean or null

Показывает, следует ли подключиться к stdout.

Cmd
Массив strings or null

Выполняемая команда в виде строки или массива строк.

Domainname
string or null

Доменное имя контейнера.

Entrypoint
Массив strings or null

Точка входа контейнера в виде строки или массива строк. Если массив содержит ровно одну пустую строку ([\"\"]), точка входа сбрасывается к системному значению по умолчанию, используемому Docker, когда инструкция ENTRYPOINT отсутствует в Dockerfile.

Env
Массив strings or null

Список переменных окружения, задаваемых в контейнере, в формате [\"VAR=value\", ...]. Переменная без = удаляется из окружения, а не получает пустое значение.

object or null

Объект, сопоставляющий порты с пустым объектом в формате: {\"<port>/<tcp|udp|sctp>\": {}}

property name*
additional property
object or null (EmptyObject)

EmptyObject

object or null

Проверка работоспособности контейнера.

Interval
integer or null <int64>

Интервал между проверками в наносекундах. Должен быть равен 0 или не менее 1000000 (1 мс). 0 означает наследование значения.

Retries
integer or null <int64>

Число последовательных неудачных проверок, после которых контейнер считается неработоспособным. 0 означает наследование значения.

StartInterval
integer or null <int64>

Интервал между проверками в начальный период, в наносекундах. Должен быть равен 0 или не менее 1000000 (1 мс). 0 означает наследование значения.

StartPeriod
integer or null <int64>

Начальный период инициализации контейнера перед отсчётом повторных проверок работоспособности, в наносекундах. Должен быть равен 0 или не менее 1000000 (1 мс). 0 означает наследование значения.

Test
Массив strings or null

Выполняемая проверка. Возможные значения: - []: наследовать проверку образа или родительского образа - [\"NONE\"]: отключить проверку работоспособности - [\"CMD\", args...]: выполнить аргументы непосредственно - [\"CMD-SHELL\", command]: выполнить команду в оболочке системы по умолчанию.

Timeout
integer or null <int64>

Время ожидания до признания проверки зависшей. Должно быть равно 0 или не менее 1000000 (1 мс). 0 означает наследование значения.

object or null

Конфигурация контейнера, зависящая от хоста выполнения.

object or null

Произвольные неидентифицирующие метаданные контейнера, передаваемые среде выполнения при его запуске.

AutoRemove
boolean or null

Автоматически удалять контейнер после завершения его процесса. Не действует, если задан RestartPolicy.

Binds
Массив strings or null

Список подключений томов для контейнера. Каждое подключение задаётся строкой одного из следующих форматов: - host-src:container-dest[:options] — подключение пути хоста в контейнер. host-src и container-dest должны быть абсолютными путями. - volume-name:container-dest[:options] — подключение в контейнер тома, управляемого драйвером томов. container-dest должен быть абсолютным путём. options — необязательный список следующих параметров, разделённых запятыми: - nocopy отключает автоматическое копирование данных из пути контейнера в том. Флаг nocopy применяется только к именованным томам. - [ro|rw] подключает том только для чтения или для чтения и записи соответственно. Если параметр отсутствует или равен rw, том подключается для чтения и записи. - [z|Z] применяет метки SELinux, разрешающие или запрещающие нескольким контейнерам читать и записывать один том. - z: содержимому назначается общая метка. Она означает, что несколько контейнеров могут совместно читать и записывать содержимое тома. - Z: назначается частная, не разделяемая метка. Она означает, что частный том может использовать только текущий контейнер. Системы вроде SELinux требуют соответствующих меток для содержимого томов, подключаемых в контейнер. Без метки система безопасности может запретить процессам контейнера использовать содержимое. По умолчанию метки, заданные операционной системой хоста, не изменяются. - [[r]shared|[r]slave|[r]private] задаёт распространение монтирования. Это относится только к привязанным путям хоста, а не к внутренним или именованным томам. Для распространения исходная точка монтирования, где исходный каталог подключён в ОС хоста, должна иметь правильные свойства распространения. Для общих томов исходная точка должна быть shared. Для подчинённых томов она должна быть shared или slave.

Массив objects or null (ThrottleDevice)

Ограничить скорость чтения устройства в байтах в секунду, в формате: [{\"Path\": \"device_path\", \"Rate\": rate}]

Массив objects or null (ThrottleDevice)

Ограничить скорость чтения устройства в операциях ввода-вывода в секунду, в формате: [{\"Path\": \"device_path\", \"Rate\": rate}]

Массив objects or null (ThrottleDevice)

Ограничить скорость записи на устройство в байтах в секунду, в формате: [{\"Path\": \"device_path\", \"Rate\": rate}]

Массив objects or null (ThrottleDevice)

Ограничить скорость записи на устройство в операциях ввода-вывода в секунду, в формате: [{\"Path\": \"device_path\", \"Rate\": rate}]

BlkioWeight
integer or null <int32> >= 0

Относительный вес блочного ввода-вывода.

Массив objects or null (ResourcesBlkioWeightDevice)

Вес блочного ввода-вывода, относительный для устройства, в формате: [{\"Path\": \"device_path\", \"Weight\": weight}]

CapAdd
Массив strings or null

Список возможностей ядра, добавляемых контейнеру. Несовместим с параметром 'Capabilities'.

CapDrop
Массив strings or null

Список возможностей ядра, удаляемых у контейнера. Несовместим с параметром 'Capabilities'.

Cgroup
string or null

Cgroup для контейнера.

CgroupnsMode
string or null
Допустимые значения: "EMPTY" "private" "host"
CgroupParent
string or null

Путь cgroups, в котором создаётся cgroup контейнера. Если путь не абсолютный, он считается относительным к пути cgroups процесса init. Если cgroups отсутствуют, они создаются.

ConsoleSize
Массив integers or null <int32> [ items <int32 > ]

Исходный размер консоли в виде массива [height, width].

ContainerIDFile
string or null

Путь к файлу, в который записывается идентификатор контейнера.

CpuCount
integer or null <int64>

Число доступных CPU; только для Windows. В контейнерах Windows Server ограничения ресурсов процессора взаимоисключающие. Приоритет: сначала CPUCount, затем CPUShares, последним CPUPercent.

CpuPercent
integer or null <int64>

Доступный процент имеющихся CPU; только для Windows. В контейнерах Windows Server ограничения ресурсов процессора взаимоисключающие. Приоритет: сначала CPUCount, затем CPUShares, последним CPUPercent.

CpuPeriod
integer or null <int64>

Длительность периода CPU в микросекундах.

CpuQuota
integer or null <int64>

Микросекунды процессорного времени, доступные контейнеру за один период CPU.

CpuRealtimePeriod
integer or null <int64>

Длительность периода CPU реального времени в микросекундах. Значение 0 означает, что время задачам реального времени не выделяется.

CpuRealtimeRuntime
integer or null <int64>

Длительность выполнения CPU реального времени в микросекундах. Значение 0 означает, что время задачам реального времени не выделяется.

CpusetCpus
string or null

CPU, на которых разрешено выполнение, например 0-3 или 0,1.

CpusetMems
string or null

Узлы памяти (MEMs), на которых разрешено выполнение (0-3, 0,1). Действует только в системах NUMA.

CpuShares
integer or null <int64>

Целое число, представляющее относительный вес CPU контейнера по сравнению с другими контейнерами.

DeviceCgroupRules
Массив strings or null

Список правил cgroup для контейнера.

Массив objects or null (DeviceRequest)

Список запросов устройств, передаваемых драйверам устройств.

Массив objects or null (DeviceMapping)

Список устройств, добавляемых в контейнер.

Dns
Массив strings or null

Список DNS-серверов для контейнера.

DnsOptions
Массив strings or null

Список параметров DNS.

DnsSearch
Массив strings or null

Список доменов поиска DNS.

ExtraHosts
Массив strings or null

Список сопоставлений имён хостов и IP-адресов, добавляемых в файл /etc/hosts контейнера. Формат: [\"hostname:IP\"].

GroupAdd
Массив strings or null

Список дополнительных групп, от имени которых работает процесс контейнера.

Init
boolean or null

Запускать внутри контейнера процесс init, передающий сигналы и собирающий завершённые процессы. Пустое поле не включается в запрос; используется настройка демона по умолчанию.

IOMaximumBandwidth
integer or null <int64>

Максимальная скорость ввода-вывода системного диска контейнера в байтах в секунду; только для Windows.

IOMaximumIOps
integer or null <int64>

Максимальное число операций ввода-вывода в секунду для системного диска контейнера; только для Windows.

IpcMode
string or null

Режим общего использования IPC для контейнера. Возможные значения: - \"none\": собственное частное пространство имён IPC без подключения /dev/shm - \"private\": собственное частное пространство имён IPC - \"shareable\": собственное частное пространство имён IPC с возможностью совместного использования другими контейнерами - \"container:<name|id>\": присоединиться к разделяемому пространству имён IPC другого контейнера - \"host\": использовать пространство имён IPC хоста. Если значение не задано, используется значение по умолчанию демона: \"private\" или \"shareable\", в зависимости от его версии и конфигурации.

Isolation
string or null
Допустимые значения: "EMPTY" "default" "process" "hyperv"
KernelMemoryTCP
integer or null <int64>

Жёсткое ограничение памяти TCP-буфера ядра в байтах. Параметр может игнорироваться в зависимости от среды выполнения OCI. Он больше не поддерживается средой по умолчанию (runc). Пустое поле не включается в ответ.

Links
Массив strings or null

Список связей контейнера в формате container_name:alias.

object or null

Конфигурация журналирования контейнера.

MaskedPaths
Массив strings or null

Список путей, скрываемых внутри контейнера; переопределяет набор путей по умолчанию.

Memory
integer or null <int64>

Ограничение памяти в байтах.

MemoryReservation
integer or null <int64>

Мягкое ограничение памяти в байтах.

MemorySwap
integer or null <int64>

Общее ограничение памяти, включая память и swap. Значение -1 разрешает неограниченный swap.

MemorySwappiness
integer or null <int64>

Настроить swappiness памяти контейнера. Допускается целое число от 0 до 100.

Массив objects or null (Mount)

Спецификация подключений, добавляемых в контейнер.

NanoCpus
integer or null <int64>

Квота CPU в единицах 10-9 процессора.

NetworkMode
string or null

Сетевой режим контейнера. Поддерживаемые стандартные значения: bridge, host, none и container:<name|id>. Любое другое значение считается именем пользовательской сети, к которой должен подключиться контейнер.

OomKillDisable
boolean or null

Отключить OOM killer для контейнера.

OomScoreAdj
integer or null <int64>

Целочисленная оценка контейнера для настройки приоритетов OOM killer.

PidMode
string or null

Задать режим пространства имён PID (процессов) для контейнера. Возможные значения: - \"container:<name|id>\": присоединиться к пространству имён PID другого контейнера - \"host\": использовать пространство имён PID хоста внутри контейнера.

PidsLimit
integer or null <int64>

Настроить ограничение PID контейнера. 0 или -1 означает отсутствие ограничения, null — не изменять.

object or null (PortMap)

PortMap

Privileged
boolean or null

Предоставляет контейнеру полный доступ к хосту.

PublishAllPorts
boolean or null

Выделяет временный порт хоста для каждого открытого порта контейнера. Порты освобождаются при остановке контейнера и выделяются при запуске. При перезапуске выделенный порт может измениться. Порт выбирается из диапазона временных портов, зависящего от ядра. Например, в Linux диапазон задаётся в /proc/sys/net/ipv4/ip_local_port_range.

ReadonlyPaths
Массив strings or null

Список путей, доступных внутри контейнера только для чтения; переопределяет набор путей по умолчанию.

ReadonlyRootfs
boolean or null

Подключить корневую файловую систему контейнера только для чтения.

object or null

Поведение при завершении контейнера. По умолчанию он не перезапускается. Перед каждым перезапуском добавляется возрастающая задержка, чтобы не перегружать сервер: начиная со 100 мс, она каждый раз удваивается.

Runtime
string or null

Среда выполнения для этого контейнера.

SecurityOpt
Массив strings or null

Список строк для настройки меток в системах MLS, например SELinux.

ShmSize
integer or null <int64>

Размер /dev/shm в байтах. Если не задан, система использует 64 МБ.

object or null

Параметры драйвера хранения контейнера в формате {\"size\": \"120G\"}.

object or null

Список параметров ядра (sysctls), задаваемых в контейнере. Например: {\"net.ipv4.ip_forward\": \"1\"}

object or null

Сопоставление каталогов контейнера, заменяемых подключениями tmpfs, и соответствующих параметров монтирования. Например: { \"/run\": \"rw,noexec,nosuid,size=65536k\" }

Массив objects or null (ResourcesUlimits)

Список ограничений ресурсов контейнера. Например: {\"Name\": \"nofile\", \"Soft\": 1024, \"Hard\": 2048}

UsernsMode
string or null

Задаёт режим пространства имён пользователя контейнера, когда включено переназначение пространств имён пользователей.

UTSMode
string or null

Пространство имён UTS контейнера.

VolumeDriver
string or null

Драйвер, используемый контейнером для подключения томов.

VolumesFrom
Массив strings or null

Список томов, наследуемых от другого контейнера, в формате <container name>[:<ro|rw>].

Hostname
string or null

Имя хоста контейнера, соответствующее RFC 1123.

Image
string or null

Имя образа для создания контейнера.

object or null

Метаданные ключ/значение, заданные пользователем.

property name*
additional property
string
MacAddress
string or null

MAC-адрес контейнера.

NetworkDisabled
boolean or null

Отключить сеть для контейнера.

object or null

NetworkingConfig представляет сетевую конфигурацию каждого интерфейса контейнера. Используется для сетевых настроек, указанных в командах docker create и docker network connect.

object or null

Сопоставление имени сети и конфигурации конечной точки этой сети. Конфигурацию конечной точки можно оставить пустой, чтобы подключиться к сети без специальных настроек.

OnBuild
Массив strings or null

Метаданные ONBUILD, определённые в Dockerfile образа.

OpenStdin
boolean or null

Открыть stdin.

Shell
Массив strings or null

Оболочка для случаев, когда RUN, CMD и ENTRYPOINT используют оболочку.

StdinOnce
boolean or null

Закрыть stdin после отключения одного подключённого клиента.

StopSignal
string or null

Сигнал остановки контейнера в виде строки или беззнакового целого числа.

StopTimeout
integer or null <int64>

Время ожидания остановки контейнера в секундах.

Tty
boolean or null

Подключить стандартные потоки к TTY, включая stdin, если он не закрыт.

User
string or null

Пользователь, от имени которого выполняются команды в контейнере.

object or null

Объект, сопоставляющий пути точек монтирования внутри контейнера с пустыми объектами.

property name*
additional property
object or null (EmptyObject)

EmptyObject

WorkingDir
string or null

Рабочий каталог для выполнения команд.

{
  • "Hostname": "string",
  • "Domainname": "string",
  • "User": "string",
  • "AttachStdin": true,
  • "AttachStdout": true,
  • "AttachStderr": true,
  • "ExposedPorts": {
    },
  • "Tty": true,
  • "OpenStdin": true,
  • "StdinOnce": true,
  • "Env": [
    ],
  • "Cmd": [
    ],
  • "Healthcheck": {
    },
  • "ArgsEscaped": true,
  • "Image": "string",
  • "Volumes": {
    },
  • "WorkingDir": "string",
  • "Entrypoint": [
    ],
  • "NetworkDisabled": true,
  • "MacAddress": "string",
  • "OnBuild": [
    ],
  • "Labels": {
    },
  • "StopSignal": "string",
  • "StopTimeout": 0,
  • "Shell": [
    ],
  • "HostConfig": {
    },
  • "NetworkingConfig": {
    }
}

ConfigSpec

Data
string or null

Данные конфигурации, закодированные в URL-безопасном Base64 (RFC 4648).

object or null

Метаданные ключ/значение, заданные пользователем.

property name*
additional property
string
Name
string or null

Имя конфигурации, заданное пользователем.

object or null

Driver представляет драйвер сети, журналирования или секретов.

Name
required
string

Имя драйвера.

object or null

Отображение ключ/значение параметров драйвера.

{
  • "Name": "string",
  • "Labels": {
    },
  • "Data": "string",
  • "Templating": {
    }
}

ContainerConfig

ArgsEscaped
boolean or null

Команда уже экранирована; только для Windows.

AttachStderr
boolean or null

Показывает, следует ли подключиться к stderr.

AttachStdin
boolean or null

Показывает, следует ли подключиться к stdin.

AttachStdout
boolean or null

Показывает, следует ли подключиться к stdout.

Cmd
Массив strings or null

Выполняемая команда в виде строки или массива строк.

Domainname
string or null

Доменное имя контейнера.

Entrypoint
Массив strings or null

Точка входа контейнера в виде строки или массива строк. Если массив содержит ровно одну пустую строку ([\"\"]), точка входа сбрасывается к системному значению по умолчанию, используемому Docker, когда инструкция ENTRYPOINT отсутствует в Dockerfile.

Env
Массив strings or null

Список переменных окружения, задаваемых в контейнере, в формате [\"VAR=value\", ...]. Переменная без = удаляется из окружения, а не получает пустое значение.

object or null

Объект, сопоставляющий порты с пустым объектом в формате: {\"<port>/<tcp|udp|sctp>\": {}}

property name*
additional property
object or null (EmptyObject)

EmptyObject

object or null

Проверка работоспособности контейнера.

Interval
integer or null <int64>

Интервал между проверками в наносекундах. Должен быть равен 0 или не менее 1000000 (1 мс). 0 означает наследование значения.

Retries
integer or null <int64>

Число последовательных неудачных проверок, после которых контейнер считается неработоспособным. 0 означает наследование значения.

StartInterval
integer or null <int64>

Интервал между проверками в начальный период, в наносекундах. Должен быть равен 0 или не менее 1000000 (1 мс). 0 означает наследование значения.

StartPeriod
integer or null <int64>

Начальный период инициализации контейнера перед отсчётом повторных проверок работоспособности, в наносекундах. Должен быть равен 0 или не менее 1000000 (1 мс). 0 означает наследование значения.

Test
Массив strings or null

Выполняемая проверка. Возможные значения: - []: наследовать проверку образа или родительского образа - [\"NONE\"]: отключить проверку работоспособности - [\"CMD\", args...]: выполнить аргументы непосредственно - [\"CMD-SHELL\", command]: выполнить команду в оболочке системы по умолчанию.

Timeout
integer or null <int64>

Время ожидания до признания проверки зависшей. Должно быть равно 0 или не менее 1000000 (1 мс). 0 означает наследование значения.

Hostname
string or null

Имя хоста контейнера, соответствующее RFC 1123.

Image
string or null

Имя или ссылка на образ для создания контейнера либо образ, использованный при его создании.

object or null

Метаданные ключ/значение, заданные пользователем.

property name*
additional property
string
MacAddress
string or null

MAC-адрес контейнера. Поле устарело начиная с API v1.44; используйте EndpointSettings.MacAddress.

NetworkDisabled
boolean or null

Отключить сеть для контейнера.

OnBuild
Массив strings or null

Метаданные ONBUILD, определённые в Dockerfile образа.

OpenStdin
boolean or null

Открыть stdin.

Shell
Массив strings or null

Оболочка для случаев, когда RUN, CMD и ENTRYPOINT используют оболочку.

StdinOnce
boolean or null

Закрыть stdin после отключения одного подключённого клиента.

StopSignal
string or null

Сигнал остановки контейнера в виде строки или беззнакового целого числа.

StopTimeout
integer or null <int64>

Время ожидания остановки контейнера в секундах.

Tty
boolean or null

Подключить стандартные потоки к TTY, включая stdin, если он не закрыт.

User
string or null

Пользователь, от имени которого выполняются команды в контейнере.

object or null

Объект, сопоставляющий пути точек монтирования внутри контейнера с пустыми объектами.

property name*
additional property
object or null (EmptyObject)

EmptyObject

WorkingDir
string or null

Рабочий каталог для выполнения команд.

{
  • "Hostname": "string",
  • "Domainname": "string",
  • "User": "string",
  • "AttachStdin": true,
  • "AttachStdout": true,
  • "AttachStderr": true,
  • "ExposedPorts": {
    },
  • "Tty": true,
  • "OpenStdin": true,
  • "StdinOnce": true,
  • "Env": [
    ],
  • "Cmd": [
    ],
  • "Healthcheck": {
    },
  • "ArgsEscaped": true,
  • "Image": "string",
  • "Volumes": {
    },
  • "WorkingDir": "string",
  • "Entrypoint": [
    ],
  • "NetworkDisabled": true,
  • "MacAddress": "string",
  • "OnBuild": [
    ],
  • "Labels": {
    },
  • "StopSignal": "string",
  • "StopTimeout": 0,
  • "Shell": [
    ]
}

ContainerInspectResponse

AppArmorProfile
string or null
Args
Массив strings or null

Аргументы выполняемой команды.

object or null

Конфигурация контейнера, переносимая между хостами. В образе ContainerConfig — необязательное поле с конфигурацией последнего контейнера, зафиксированного при создании образа. Прежние версии сборщика Docker использовали поле ContainerConfig для хранения кэша сборки; сейчас оно активно не используется.

ArgsEscaped
boolean or null

Команда уже экранирована; только для Windows.

AttachStderr
boolean or null

Показывает, следует ли подключиться к stderr.

AttachStdin
boolean or null

Показывает, следует ли подключиться к stdin.

AttachStdout
boolean or null

Показывает, следует ли подключиться к stdout.

Cmd
Массив strings or null

Выполняемая команда в виде строки или массива строк.

Domainname
string or null

Доменное имя контейнера.

Entrypoint
Массив strings or null

Точка входа контейнера в виде строки или массива строк. Если массив содержит ровно одну пустую строку ([\"\"]), точка входа сбрасывается к системному значению по умолчанию, используемому Docker, когда инструкция ENTRYPOINT отсутствует в Dockerfile.

Env
Массив strings or null

Список переменных окружения, задаваемых в контейнере, в формате [\"VAR=value\", ...]. Переменная без = удаляется из окружения, а не получает пустое значение.

object or null

Объект, сопоставляющий порты с пустым объектом в формате: {\"<port>/<tcp|udp|sctp>\": {}}

object or null

Проверка работоспособности контейнера.

Hostname
string or null

Имя хоста контейнера, соответствующее RFC 1123.

Image
string or null

Имя или ссылка на образ для создания контейнера либо образ, использованный при его создании.

object or null

Метаданные ключ/значение, заданные пользователем.

MacAddress
string or null

MAC-адрес контейнера. Поле устарело начиная с API v1.44; используйте EndpointSettings.MacAddress.

NetworkDisabled
boolean or null

Отключить сеть для контейнера.

OnBuild
Массив strings or null

Метаданные ONBUILD, определённые в Dockerfile образа.

OpenStdin
boolean or null

Открыть stdin.

Shell
Массив strings or null

Оболочка для случаев, когда RUN, CMD и ENTRYPOINT используют оболочку.

StdinOnce
boolean or null

Закрыть stdin после отключения одного подключённого клиента.

StopSignal
string or null

Сигнал остановки контейнера в виде строки или беззнакового целого числа.

StopTimeout
integer or null <int64>

Время ожидания остановки контейнера в секундах.

Tty
boolean or null

Подключить стандартные потоки к TTY, включая stdin, если он не закрыт.

User
string or null

Пользователь, от имени которого выполняются команды в контейнере.

object or null

Объект, сопоставляющий пути точек монтирования внутри контейнера с пустыми объектами.

WorkingDir
string or null

Рабочий каталог для выполнения команд.

Created
string or null

Время создания контейнера.

Driver
string or null
ExecIDs
Массив strings or null

Идентификаторы экземпляров exec, работающих в контейнере.

object or null

Сведения о драйвере хранения файловой системы контейнера и образа.

required
object

Низкоуровневые метаданные хранения в виде пар ключ/значение. Они зависят от используемого драйвера хранения и предназначены только для справочной информации.

Name
required
string

Имя драйвера хранения.

object or null

Конфигурация контейнера, зависящая от хоста выполнения.

object or null

Произвольные неидентифицирующие метаданные контейнера, передаваемые среде выполнения при его запуске.

AutoRemove
boolean or null

Автоматически удалять контейнер после завершения его процесса. Не действует, если задан RestartPolicy.

Binds
Массив strings or null

Список подключений томов для контейнера. Каждое подключение задаётся строкой одного из следующих форматов: - host-src:container-dest[:options] — подключение пути хоста в контейнер. host-src и container-dest должны быть абсолютными путями. - volume-name:container-dest[:options] — подключение в контейнер тома, управляемого драйвером томов. container-dest должен быть абсолютным путём. options — необязательный список следующих параметров, разделённых запятыми: - nocopy отключает автоматическое копирование данных из пути контейнера в том. Флаг nocopy применяется только к именованным томам. - [ro|rw] подключает том только для чтения или для чтения и записи соответственно. Если параметр отсутствует или равен rw, том подключается для чтения и записи. - [z|Z] применяет метки SELinux, разрешающие или запрещающие нескольким контейнерам читать и записывать один том. - z: содержимому назначается общая метка. Она означает, что несколько контейнеров могут совместно читать и записывать содержимое тома. - Z: назначается частная, не разделяемая метка. Она означает, что частный том может использовать только текущий контейнер. Системы вроде SELinux требуют соответствующих меток для содержимого томов, подключаемых в контейнер. Без метки система безопасности может запретить процессам контейнера использовать содержимое. По умолчанию метки, заданные операционной системой хоста, не изменяются. - [[r]shared|[r]slave|[r]private] задаёт распространение монтирования. Это относится только к привязанным путям хоста, а не к внутренним или именованным томам. Для распространения исходная точка монтирования, где исходный каталог подключён в ОС хоста, должна иметь правильные свойства распространения. Для общих томов исходная точка должна быть shared. Для подчинённых томов она должна быть shared или slave.

Массив objects or null (ThrottleDevice)

Ограничить скорость чтения устройства в байтах в секунду, в формате: [{\"Path\": \"device_path\", \"Rate\": rate}]

Массив objects or null (ThrottleDevice)

Ограничить скорость чтения устройства в операциях ввода-вывода в секунду, в формате: [{\"Path\": \"device_path\", \"Rate\": rate}]

Массив objects or null (ThrottleDevice)

Ограничить скорость записи на устройство в байтах в секунду, в формате: [{\"Path\": \"device_path\", \"Rate\": rate}]

Массив objects or null (ThrottleDevice)

Ограничить скорость записи на устройство в операциях ввода-вывода в секунду, в формате: [{\"Path\": \"device_path\", \"Rate\": rate}]

BlkioWeight
integer or null <int32> >= 0

Относительный вес блочного ввода-вывода.

Массив objects or null (ResourcesBlkioWeightDevice)

Вес блочного ввода-вывода, относительный для устройства, в формате: [{\"Path\": \"device_path\", \"Weight\": weight}]

CapAdd
Массив strings or null

Список возможностей ядра, добавляемых контейнеру. Несовместим с параметром 'Capabilities'.

CapDrop
Массив strings or null

Список возможностей ядра, удаляемых у контейнера. Несовместим с параметром 'Capabilities'.

Cgroup
string or null

Cgroup для контейнера.

CgroupnsMode
string or null
Допустимые значения: "EMPTY" "private" "host"
CgroupParent
string or null

Путь cgroups, в котором создаётся cgroup контейнера. Если путь не абсолютный, он считается относительным к пути cgroups процесса init. Если cgroups отсутствуют, они создаются.

ConsoleSize
Массив integers or null <int32> [ items <int32 > ]

Исходный размер консоли в виде массива [height, width].

ContainerIDFile
string or null

Путь к файлу, в который записывается идентификатор контейнера.

CpuCount
integer or null <int64>

Число доступных CPU; только для Windows. В контейнерах Windows Server ограничения ресурсов процессора взаимоисключающие. Приоритет: сначала CPUCount, затем CPUShares, последним CPUPercent.

CpuPercent
integer or null <int64>

Доступный процент имеющихся CPU; только для Windows. В контейнерах Windows Server ограничения ресурсов процессора взаимоисключающие. Приоритет: сначала CPUCount, затем CPUShares, последним CPUPercent.

CpuPeriod
integer or null <int64>

Длительность периода CPU в микросекундах.

CpuQuota
integer or null <int64>

Микросекунды процессорного времени, доступные контейнеру за один период CPU.

CpuRealtimePeriod
integer or null <int64>

Длительность периода CPU реального времени в микросекундах. Значение 0 означает, что время задачам реального времени не выделяется.

CpuRealtimeRuntime
integer or null <int64>

Длительность выполнения CPU реального времени в микросекундах. Значение 0 означает, что время задачам реального времени не выделяется.

CpusetCpus
string or null

CPU, на которых разрешено выполнение, например 0-3 или 0,1.

CpusetMems
string or null

Узлы памяти (MEMs), на которых разрешено выполнение (0-3, 0,1). Действует только в системах NUMA.

CpuShares
integer or null <int64>

Целое число, представляющее относительный вес CPU контейнера по сравнению с другими контейнерами.

DeviceCgroupRules
Массив strings or null

Список правил cgroup для контейнера.

Массив objects or null (DeviceRequest)

Список запросов устройств, передаваемых драйверам устройств.

Массив objects or null (DeviceMapping)

Список устройств, добавляемых в контейнер.

Dns
Массив strings or null

Список DNS-серверов для контейнера.

DnsOptions
Массив strings or null

Список параметров DNS.

DnsSearch
Массив strings or null

Список доменов поиска DNS.

ExtraHosts
Массив strings or null

Список сопоставлений имён хостов и IP-адресов, добавляемых в файл /etc/hosts контейнера. Формат: [\"hostname:IP\"].

GroupAdd
Массив strings or null

Список дополнительных групп, от имени которых работает процесс контейнера.

Init
boolean or null

Запускать внутри контейнера процесс init, передающий сигналы и собирающий завершённые процессы. Пустое поле не включается в запрос; используется настройка демона по умолчанию.

IOMaximumBandwidth
integer or null <int64>

Максимальная скорость ввода-вывода системного диска контейнера в байтах в секунду; только для Windows.

IOMaximumIOps
integer or null <int64>

Максимальное число операций ввода-вывода в секунду для системного диска контейнера; только для Windows.

IpcMode
string or null

Режим общего использования IPC для контейнера. Возможные значения: - \"none\": собственное частное пространство имён IPC без подключения /dev/shm - \"private\": собственное частное пространство имён IPC - \"shareable\": собственное частное пространство имён IPC с возможностью совместного использования другими контейнерами - \"container:<name|id>\": присоединиться к разделяемому пространству имён IPC другого контейнера - \"host\": использовать пространство имён IPC хоста. Если значение не задано, используется значение по умолчанию демона: \"private\" или \"shareable\", в зависимости от его версии и конфигурации.

Isolation
string or null
Допустимые значения: "EMPTY" "default" "process" "hyperv"
KernelMemoryTCP
integer or null <int64>

Жёсткое ограничение памяти TCP-буфера ядра в байтах. Параметр может игнорироваться в зависимости от среды выполнения OCI. Он больше не поддерживается средой по умолчанию (runc). Пустое поле не включается в ответ.

Links
Массив strings or null

Список связей контейнера в формате container_name:alias.

object or null

Конфигурация журналирования контейнера.

MaskedPaths
Массив strings or null

Список путей, скрываемых внутри контейнера; переопределяет набор путей по умолчанию.

Memory
integer or null <int64>

Ограничение памяти в байтах.

MemoryReservation
integer or null <int64>

Мягкое ограничение памяти в байтах.

MemorySwap
integer or null <int64>

Общее ограничение памяти, включая память и swap. Значение -1 разрешает неограниченный swap.

MemorySwappiness
integer or null <int64>

Настроить swappiness памяти контейнера. Допускается целое число от 0 до 100.

Массив objects or null (Mount)

Спецификация подключений, добавляемых в контейнер.

NanoCpus
integer or null <int64>

Квота CPU в единицах 10-9 процессора.

NetworkMode
string or null

Сетевой режим контейнера. Поддерживаемые стандартные значения: bridge, host, none и container:<name|id>. Любое другое значение считается именем пользовательской сети, к которой должен подключиться контейнер.

OomKillDisable
boolean or null

Отключить OOM killer для контейнера.

OomScoreAdj
integer or null <int64>

Целочисленная оценка контейнера для настройки приоритетов OOM killer.

PidMode
string or null

Задать режим пространства имён PID (процессов) для контейнера. Возможные значения: - \"container:<name|id>\": присоединиться к пространству имён PID другого контейнера - \"host\": использовать пространство имён PID хоста внутри контейнера.

PidsLimit
integer or null <int64>

Настроить ограничение PID контейнера. 0 или -1 означает отсутствие ограничения, null — не изменять.

object or null (PortMap)

PortMap

Privileged
boolean or null

Предоставляет контейнеру полный доступ к хосту.

PublishAllPorts
boolean or null

Выделяет временный порт хоста для каждого открытого порта контейнера. Порты освобождаются при остановке контейнера и выделяются при запуске. При перезапуске выделенный порт может измениться. Порт выбирается из диапазона временных портов, зависящего от ядра. Например, в Linux диапазон задаётся в /proc/sys/net/ipv4/ip_local_port_range.

ReadonlyPaths
Массив strings or null

Список путей, доступных внутри контейнера только для чтения; переопределяет набор путей по умолчанию.

ReadonlyRootfs
boolean or null

Подключить корневую файловую систему контейнера только для чтения.

object or null

Поведение при завершении контейнера. По умолчанию он не перезапускается. Перед каждым перезапуском добавляется возрастающая задержка, чтобы не перегружать сервер: начиная со 100 мс, она каждый раз удваивается.

Runtime
string or null

Среда выполнения для этого контейнера.

SecurityOpt
Массив strings or null

Список строк для настройки меток в системах MLS, например SELinux.

ShmSize
integer or null <int64>

Размер /dev/shm в байтах. Если не задан, система использует 64 МБ.

object or null

Параметры драйвера хранения контейнера в формате {\"size\": \"120G\"}.

object or null

Список параметров ядра (sysctls), задаваемых в контейнере. Например: {\"net.ipv4.ip_forward\": \"1\"}

object or null

Сопоставление каталогов контейнера, заменяемых подключениями tmpfs, и соответствующих параметров монтирования. Например: { \"/run\": \"rw,noexec,nosuid,size=65536k\" }

Массив objects or null (ResourcesUlimits)

Список ограничений ресурсов контейнера. Например: {\"Name\": \"nofile\", \"Soft\": 1024, \"Hard\": 2048}

UsernsMode
string or null

Задаёт режим пространства имён пользователя контейнера, когда включено переназначение пространств имён пользователей.

UTSMode
string or null

Пространство имён UTS контейнера.

VolumeDriver
string or null

Драйвер, используемый контейнером для подключения томов.

VolumesFrom
Массив strings or null

Список томов, наследуемых от другого контейнера, в формате <container name>[:<ro|rw>].

HostnamePath
string or null
HostsPath
string or null
Id
string or null

Идентификатор контейнера.

Image
string or null

Идентификатор образа контейнера.

LogPath
string or null
MountLabel
string or null
Массив objects or null (MountPoint)
Array
Destination
string or null

Destination — путь относительно корня контейнера (/), по которому Source подключается внутри контейнера.

Driver
string or null

Driver — драйвер томов, используемый для создания тома, если это том.

Mode
string or null

Mode — разделённый запятыми список параметров, заданных пользователем при создании подключения пути хоста или тома. Значение по умолчанию зависит от платформы: \"z\" в Linux, пустое в Windows.

Name
string or null

Name — имя, ссылающееся на данные, определяемые Source, например имя тома.

Propagation
string or null

Propagation описывает распространение монтирований с хоста в точку монтирования и обратно. Подробности приведены в документации ядра Linux. Поле не используется в Windows.

RW
boolean or null

Показывает, доступно ли подключение для записи, то есть для чтения и записи.

Source
string or null

Источник монтирования. Для томов содержит место хранения тома внутри /var/lib/docker/volumes/. Для привязанных путей и npipe содержит исходную часть монтирования на хосте. Для точек tmpfs поле пустое.

Type
string or null
Допустимые значения: "EMPTY" "bind" "volume" "tmpfs" "npipe" "cluster"
Name
string or null
object or null

NetworkSettings предоставляет сетевые настройки в API.

Bridge
string or null

Имя интерфейса bridge по умолчанию, если у dockerd задан флаг --bridge.

EndpointID
string or null

EndpointID однозначно обозначает конечную точку службы в Sandbox.


> Устарело: поле передаётся только при подключении к сети "bridge" по умолчанию. Вместо него используйте сведения о сети "bridge" в отображении Networks, содержащем те же данные. Поле устарело в Docker 1.9; удаление запланировано в Docker 17.12.0.

Gateway
string or null

Адрес шлюза сети "bridge" по умолчанию.


> Устарело: поле передаётся только при подключении к сети "bridge" по умолчанию. Вместо него используйте сведения о сети "bridge" в отображении Networks, содержащем те же данные. Поле устарело в Docker 1.9; удаление запланировано в Docker 17.12.0.

GlobalIPv6Address
string or null

Глобальный адрес IPv6 сети "bridge" по умолчанию.


> Устарело: поле передаётся только при подключении к сети "bridge" по умолчанию. Вместо него используйте сведения о сети "bridge" в отображении Networks, содержащем те же данные. Поле устарело в Docker 1.9; удаление запланировано в Docker 17.12.0.

GlobalIPv6PrefixLen
integer or null <int64>

Длина маски глобального адреса IPv6.


> Устарело: поле передаётся только при подключении к сети "bridge" по умолчанию. Вместо него используйте сведения о сети "bridge" в отображении Networks, содержащем те же данные. Поле устарело в Docker 1.9; удаление запланировано в Docker 17.12.0.

HairpinMode
boolean or null

Показывает, следует ли включить hairpin NAT на виртуальном интерфейсе. Устарело: поле никогда не задаётся и будет удалено в будущем выпуске.

IPAddress
string or null

Адрес IPv4 сети "bridge" по умолчанию.


> Устарело: поле передаётся только при подключении к сети "bridge" по умолчанию. Вместо него используйте сведения о сети "bridge" в отображении Networks, содержащем те же данные. Поле устарело в Docker 1.9; удаление запланировано в Docker 17.12.0.

IPPrefixLen
integer or null <int64>

Длина маски адреса IPv4.


> Устарело: поле передаётся только при подключении к сети "bridge" по умолчанию. Вместо него используйте сведения о сети "bridge" в отображении Networks, содержащем те же данные. Поле устарело в Docker 1.9; удаление запланировано в Docker 17.12.0.

IPv6Gateway
string or null

Адрес шлюза IPv6 этой сети.


> Устарело: поле передаётся только при подключении к сети "bridge" по умолчанию. Вместо него используйте сведения о сети "bridge" в отображении Networks, содержащем те же данные. Поле устарело в Docker 1.9; удаление запланировано в Docker 17.12.0.

LinkLocalIPv6Address
string or null

Одноадресный адрес IPv6 с префиксом локального канала. Устарело: поле никогда не задаётся и будет удалено в будущем выпуске.

LinkLocalIPv6PrefixLen
integer or null <int64>

Длина префикса одноадресного адреса IPv6. Устарело: поле никогда не задаётся и будет удалено в будущем выпуске.

MacAddress
string or null

MAC-адрес контейнера в сети "bridge" по умолчанию.


> Устарело: поле передаётся только при подключении к сети "bridge" по умолчанию. Вместо него используйте сведения о сети "bridge" в отображении Networks, содержащем те же данные. Поле устарело в Docker 1.9; удаление запланировано в Docker 17.12.0.

object or null

Сведения обо всех сетях, к которым подключён контейнер.

object or null (PortMap)

PortMap

SandboxID
string or null

SandboxID однозначно обозначает сетевой стек контейнера.

SandboxKey
string or null

SandboxKey — полный путь дескриптора netns.

Массив objects or null (Address)

Устарело: это поле никогда не задаётся и будет удалено в будущем выпуске.

Массив objects or null (Address)

Устарело: это поле никогда не задаётся и будет удалено в будущем выпуске.

Path
string or null

Путь выполняемой команды.

Platform
string or null
ProcessLabel
string or null
ResolvConfPath
string or null
RestartCount
integer or null <int64>
SizeRootFs
integer or null <int64>

Общий размер всех файлов контейнера.

SizeRw
integer or null <int64>

Размер файлов, созданных или изменённых контейнером.

object or null

ContainerState хранит состояние выполнения контейнера. Он входит в ContainerJSONBase и возвращается командой "inspect".

Dead
boolean or null
Error
string or null
ExitCode
integer or null <int64>

Последний код завершения контейнера.

FinishedAt
string or null

Время последнего завершения контейнера.

object or null

Health хранит сведения о результатах проверки работоспособности контейнера.

OOMKilled
boolean or null

Показывает, был ли процесс в контейнере завершён из-за нехватки памяти с момента последнего запуска контейнера.

Paused
boolean or null

Показывает, приостановлен ли контейнер.

Pid
integer or null <int64>

Идентификатор процесса контейнера.

Restarting
boolean or null

Показывает, перезапускается ли контейнер.

Running
boolean or null

Показывает, работает ли контейнер. Работающий контейнер может быть приостановлен. Логические значения Running и Paused не взаимоисключающие: при приостановке в Linux cgroup freezer приостанавливает все процессы контейнера. Для заморозки процесс должен работать. Поэтому приостановленные контейнеры одновременно имеют Running и Paused. Для определения состояния "running" используйте поле Status.

StartedAt
string or null

Время последнего запуска контейнера.

Status
string or null
Допустимые значения: "EMPTY" "created" "running" "paused" "restarting" "removing" "exited" "dead"
{
  • "Id": "string",
  • "Created": "string",
  • "Path": "string",
  • "Args": [
    ],
  • "State": {
    },
  • "Image": "string",
  • "ResolvConfPath": "string",
  • "HostnamePath": "string",
  • "HostsPath": "string",
  • "LogPath": "string",
  • "Name": "string",
  • "RestartCount": 0,
  • "Driver": "string",
  • "Platform": "string",
  • "MountLabel": "string",
  • "ProcessLabel": "string",
  • "AppArmorProfile": "string",
  • "ExecIDs": [
    ],
  • "HostConfig": {
    },
  • "GraphDriver": {
    },
  • "SizeRw": 0,
  • "SizeRootFs": 0,
  • "Mounts": [
    ],
  • "Config": {
    },
  • "NetworkSettings": {
    }
}

ContainerState

Dead
boolean or null
Error
string or null
ExitCode
integer or null <int64>

Последний код завершения контейнера.

FinishedAt
string or null

Время последнего завершения контейнера.

object or null

Health хранит сведения о результатах проверки работоспособности контейнера.

FailingStreak
integer or null <int64>

FailingStreak — число последовательных неудачных проверок.

Массив objects or null (HealthcheckResult)

Log содержит последние результаты, начиная с самого старого.

Status
string or null
Допустимые значения: "EMPTY" "none" "starting" "healthy" "unhealthy"
OOMKilled
boolean or null

Показывает, был ли процесс в контейнере завершён из-за нехватки памяти с момента последнего запуска контейнера.

Paused
boolean or null

Показывает, приостановлен ли контейнер.

Pid
integer or null <int64>

Идентификатор процесса контейнера.

Restarting
boolean or null

Показывает, перезапускается ли контейнер.

Running
boolean or null

Показывает, работает ли контейнер. Работающий контейнер может быть приостановлен. Логические значения Running и Paused не взаимоисключающие: при приостановке в Linux cgroup freezer приостанавливает все процессы контейнера. Для заморозки процесс должен работать. Поэтому приостановленные контейнеры одновременно имеют Running и Paused. Для определения состояния "running" используйте поле Status.

StartedAt
string or null

Время последнего запуска контейнера.

Status
string or null
Допустимые значения: "EMPTY" "created" "running" "paused" "restarting" "removing" "exited" "dead"
{
  • "Status": "EMPTY",
  • "Running": true,
  • "Paused": true,
  • "Restarting": true,
  • "OOMKilled": true,
  • "Dead": true,
  • "Pid": 0,
  • "ExitCode": 0,
  • "Error": "string",
  • "StartedAt": "string",
  • "FinishedAt": "string",
  • "Health": {
    }
}

ContainerStateStatusEnum

string (ContainerStateStatusEnum)
Допустимые значения: "EMPTY" "created" "running" "paused" "restarting" "removing" "exited" "dead"
"EMPTY"

ContainerSummary

Command
string or null

Команда, выполняемая при запуске контейнера.

Created
integer or null <int64>

Время создания контейнера.

object or null
NetworkMode
string or null
Id
string or null

Идентификатор этого контейнера.

Image
string or null

Имя образа, использованного при создании контейнера.

ImageID
string or null

Идентификатор образа, из которого создан контейнер.

object or null

Метаданные ключ/значение, заданные пользователем.

property name*
additional property
string
Массив objects or null (MountPoint)
Array
Destination
string or null

Destination — путь относительно корня контейнера (/), по которому Source подключается внутри контейнера.

Driver
string or null

Driver — драйвер томов, используемый для создания тома, если это том.

Mode
string or null

Mode — разделённый запятыми список параметров, заданных пользователем при создании подключения пути хоста или тома. Значение по умолчанию зависит от платформы: \"z\" в Linux, пустое в Windows.

Name
string or null

Name — имя, ссылающееся на данные, определяемые Source, например имя тома.

Propagation
string or null

Propagation описывает распространение монтирований с хоста в точку монтирования и обратно. Подробности приведены в документации ядра Linux. Поле не используется в Windows.

RW
boolean or null

Показывает, доступно ли подключение для записи, то есть для чтения и записи.

Source
string or null

Источник монтирования. Для томов содержит место хранения тома внутри /var/lib/docker/volumes/. Для привязанных путей и npipe содержит исходную часть монтирования на хосте. Для точек tmpfs поле пустое.

Type
string or null
Допустимые значения: "EMPTY" "bind" "volume" "tmpfs" "npipe" "cluster"
Names
Массив strings or null

Имена, присвоенные контейнеру.

object or null

Краткое описание сетевых настроек контейнера.

object or null
Массив objects or null (Port)

Порты, открытые контейнером.

Array
IP
string or null

IP-адрес хоста, к которому привязан порт контейнера.

PrivatePort
required
integer <int32> >= 0

Порт контейнера.

PublicPort
integer or null <int32> >= 0

Порт, открытый на хосте.

Type
string or null
Допустимые значения: "EMPTY" "tcp" "udp" "sctp"
SizeRootFs
integer or null <int64>

Общий размер всех файлов контейнера.

SizeRw
integer or null <int64>

Размер файлов, созданных или изменённых контейнером.

State
string or null

Состояние контейнера, например Exited.

Status
string or null

Дополнительное состояние контейнера в понятном человеку виде, например Exit 0.

{
  • "Id": "string",
  • "Names": [
    ],
  • "Image": "string",
  • "ImageID": "string",
  • "Command": "string",
  • "Created": 0,
  • "Ports": [
    ],
  • "SizeRw": 0,
  • "SizeRootFs": 0,
  • "Labels": {
    },
  • "State": "string",
  • "Status": "string",
  • "HostConfig": {
    },
  • "NetworkSettings": {
    },
  • "Mounts": [
    ]
}

ContainerSummaryHostConfig

NetworkMode
string or null
{
  • "NetworkMode": "string"
}

ContainerSummaryNetworkSettings

object or null
additional property
object (EndpointSettings)

Конфигурация конечной точки сети.

{
  • "Networks": {
    }
}

CreateExecOptions

AttachStderr
boolean or null

Подключиться к stderr команды exec.

AttachStdin
boolean or null

Подключиться к stdin команды exec.

AttachStdout
boolean or null

Подключиться к stdout команды exec.

Cmd
Массив strings or null

Выполняемая команда в виде строки или массива строк.

DetachKeys
string or null

Переопределить последовательность клавиш для отключения от контейнера. Формат: один символ [a-Z] или ctrl-<value>, где <value> — одно из значений a-z, @, ^, [, , или _.

Env
Массив strings or null

Список переменных окружения в формате ["VAR=value", ...].

Privileged
boolean or null

Запускает процесс exec с расширенными привилегиями.

Tty
boolean or null

Выделить псевдо-TTY.

User
string or null

Пользователь и необязательная группа для процесса exec в контейнере. Возможные форматы: user, user:group, uid или uid:gid.

WorkingDir
string or null

Рабочий каталог процесса exec в контейнере.

{
  • "AttachStdin": true,
  • "AttachStdout": true,
  • "AttachStderr": true,
  • "Tty": true,
  • "DetachKeys": "string",
  • "Env": [
    ],
  • "Cmd": [
    ],
  • "Privileged": true,
  • "User": "string",
  • "WorkingDir": "string"
}

DaemonConfig

advertise_addr
required
string

Адрес, объявляемый другим узлам.

conf_dir
required
string

Каталог конфигурации.

docker_host
string

Используемый хост Docker.

gateway
required
string

Шлюз хоста, автоматически определяемый как шлюз хоста по умолчанию, если значение не задано.

gid
required
integer <int32> >= 0

Идентификатор группы.

hostname
required
string

Имя хоста для узла; определяется автоматически, если не задано.

hosts
required
Массив strings

Список хостов для прослушивания.

nodes
required
Массив strings

Список узлов для присоединения.

object or null
Cert
string or null
CertCa
string or null
CertKey
string or null
state_dir
required
string

Путь к каталогу состояния.

{
  • "hosts": [
    ],
  • "state_dir": "string",
  • "docker_host": "string",
  • "gateway": "string",
  • "hostname": "string",
  • "nodes": [
    ],
  • "advertise_addr": "string",
  • "conf_dir": "string",
  • "gid": 0,
  • "ssl": {
    }
}

DeviceMapping

CgroupPermissions
string or null
PathInContainer
string or null
PathOnHost
string or null
{
  • "PathOnHost": "string",
  • "PathInContainer": "string",
  • "CgroupPermissions": "string"
}

DeviceRequest

Capabilities
Массив strings or null[ items ]

Список возможностей: объединение по OR списков, внутри которых возможности объединены по AND.

Count
integer or null <int64>
DeviceIDs
Массив strings or null
Driver
string or null
object or null

Параметры драйвера в виде пар ключ/значение. Они передаются непосредственно драйверу.

property name*
additional property
string
{
  • "Driver": "string",
  • "Count": 0,
  • "DeviceIDs": [
    ],
  • "Capabilities": [
    ],
  • "Options": {
    }
}

DnsEntry

IpAddress
required
string
Name
required
string
{
  • "Name": "string",
  • "IpAddress": "string"
}

Driver

Name
required
string

Имя драйвера.

object or null

Отображение ключ/значение параметров драйвера.

property name*
additional property
string
{
  • "Name": "string",
  • "Options": {
    }
}

EmptyObject

object or null (EmptyObject)

EmptyObject

{ }

EndpointIpamConfig

IPv4Address
string or null
IPv6Address
string or null
LinkLocalIPs
Массив strings or null
{
  • "IPv4Address": "string",
  • "IPv6Address": "string",
  • "LinkLocalIPs": [
    ]
}

EndpointSettings

Aliases
Массив strings or null
DNSNames
Массив strings or null

Список всех DNS-имён конечной точки в определённой сети. Он основан на имени контейнера, сетевых псевдонимах, коротком идентификаторе контейнера и имени хоста. Эти имена не являются полностью квалифицированными, но могут содержать несколько точек. Чтобы получить полное DNS-имя, добавьте .<network-name>. Например, если контейнер называется my.ctr, а сеть — testnet, то DNSNames содержит my.ctr, а FQDN равен my.ctr.testnet.

object or null

DriverOpts сопоставляет параметры драйвера и их значения. Эти параметры относятся к конкретному драйверу и передаются ему непосредственно.

property name*
additional property
string
EndpointID
string or null

Уникальный идентификатор конечной точки службы в Sandbox.

Gateway
string or null

Адрес шлюза этой сети.

GlobalIPv6Address
string or null

Глобальный адрес IPv6.

GlobalIPv6PrefixLen
integer or null <int64>

Длина маски глобального адреса IPv6.

IPAddress
string or null

Адрес IPv4.

object or null

EndpointIPAMConfig представляет конфигурацию IPAM конечной точки.

IPv4Address
string or null
IPv6Address
string or null
LinkLocalIPs
Массив strings or null
IPPrefixLen
integer or null <int64>

Длина маски адреса IPv4.

IPv6Gateway
string or null

Адрес шлюза IPv6.

Links
Массив strings or null
MacAddress
string or null

MAC-адрес конечной точки в этой сети. Драйвер сети может игнорировать параметр.

NetworkID
string or null

Уникальный идентификатор сети.

{
  • "IPAMConfig": {
    },
  • "Links": [
    ],
  • "MacAddress": "string",
  • "Aliases": [
    ],
  • "NetworkID": "string",
  • "EndpointID": "string",
  • "Gateway": "string",
  • "IPAddress": "string",
  • "IPPrefixLen": 0,
  • "IPv6Gateway": "string",
  • "GlobalIPv6Address": "string",
  • "GlobalIPv6PrefixLen": 0,
  • "DriverOpts": {
    },
  • "DNSNames": [
    ]
}

Event

Action
required
string

Action — выполненное или неудавшееся действие в отношении соответствующего участника. Значение предназначено для машинной обработки. Для новых событий поле не может быть пустым и допускает не более 128 символов.

object or null

Actor — участник, вызвавший событие.

object
Key
string or null
Kind
required
string (EventActorKind)
Допустимые значения: "Namespace" "Cargo" "Vm" "Job" "Resource" "Secret" "Process" "ContainerImage"

Kind — тип события, связанный с типом участника.

CreatedAt
required
string <date-time>

Время создания события.

ExpiresAt
required
string <date-time>

Время истечения события.

Key
required
string <uuid>

Уникальный идентификатор события.

Kind
required
string (EventKind)
Допустимые значения: "error" "normal" "warning"

Тип события (Error, Normal, Warning); в будущем могут появиться новые типы.

object

Стандартные метаданные.

additional property
string or number or boolean or Массив Any (any) or object (Any)

Вспомогательный тип Any для OpenApi, полезный для динамических объектов JSON, например ResourceSpec.

Note
string or null

Понятное человеку описание состояния операции.

Reason
required
string

Reason — причина выполнения действия, понятная человеку. Для новых событий поле не может быть пустым и допускает не более 128 символов.

object or null

Actor — участник, вызвавший событие.

object
Key
string or null
Kind
required
string (EventActorKind)
Допустимые значения: "Namespace" "Cargo" "Vm" "Job" "Resource" "Secret" "Process" "ContainerImage"

Kind — тип события, связанный с типом участника.

ReportingController
required
string

Reporting Controller — имя контроллера, создавшего событие, например nanocl.io/core. Для новых событий поле не может быть пустым.

ReportingNode
required
string

Reporting Node — имя узла, на котором создано событие.

{
  • "Key": "5eb041b0-19c9-4022-bd51-0e723885f5dd",
  • "CreatedAt": "2019-08-24T14:15:22Z",
  • "ExpiresAt": "2019-08-24T14:15:22Z",
  • "ReportingNode": "string",
  • "ReportingController": "string",
  • "Kind": "error",
  • "Action": "string",
  • "Reason": "string",
  • "Note": "string",
  • "Actor": {
    },
  • "Related": {
    },
  • "Metadata": {
    }
}

EventActor

object
additional property
string or number or boolean or Массив Any (any) or object (Any)

Вспомогательный тип Any для OpenApi, полезный для динамических объектов JSON, например ResourceSpec.

Key
string or null
Kind
required
string (EventActorKind)
Допустимые значения: "Namespace" "Cargo" "Vm" "Job" "Resource" "Secret" "Process" "ContainerImage"

Kind — тип события, связанный с типом участника.

{
  • "Key": "string",
  • "Kind": "Namespace",
  • "Attributes": {
    }
}

EventActorKind

string (EventActorKind)
Допустимые значения: "Namespace" "Cargo" "Vm" "Job" "Resource" "Secret" "Process" "ContainerImage"

Kind — тип события, связанный с типом участника.

"Namespace"

EventCondition

required
Массив strings or strings or strings or strings or strings or strings or strings or strings or strings or strings or strings or strings or strings or strings or strings or objects (NativeEventAction)
Array
One of
string
Значение: "create"

Action — действие, вызвавшее событие.

ActorKey
string or null
ActorKind
string or null
Допустимые значения: "Namespace" "Cargo" "Vm" "Job" "Resource" "Secret" "Process" "ContainerImage"

Kind — тип события, связанный с типом участника.

Kind
required
Массив strings (EventKind)
Допустимые элементы Допустимые значения: "error" "normal" "warning"
RelatedKey
string or null
RelatedKind
string or null
Допустимые значения: "Namespace" "Cargo" "Vm" "Job" "Resource" "Secret" "Process" "ContainerImage"

Kind — тип события, связанный с типом участника.

{
  • "ActorKey": "string",
  • "ActorKind": "Namespace",
  • "RelatedKey": "string",
  • "RelatedKind": "Namespace",
  • "Kind": [
    ],
  • "Action": [
    ]
}

EventKind

string (EventKind)
Допустимые значения: "error" "normal" "warning"

Тип события (Error, Normal, Warning); в будущем могут появиться новые типы.

"error"

ExecInspectResponse

CanRemove
boolean or null
ContainerID
string or null
DetachKeys
string or null
ExitCode
integer or null <int64>
ID
string or null
OpenStderr
boolean or null
OpenStdin
boolean or null
OpenStdout
boolean or null
Pid
integer or null <int64>

Системный идентификатор процесса exec.

object or null
arguments
Массив strings or null
entrypoint
string or null
privileged
boolean or null
tty
boolean or null
user
string or null
Running
boolean or null
{
  • "CanRemove": true,
  • "DetachKeys": "string",
  • "ID": "string",
  • "Running": true,
  • "ExitCode": 0,
  • "ProcessConfig": {
    },
  • "OpenStdin": true,
  • "OpenStderr": true,
  • "OpenStdout": true,
  • "ContainerID": "string",
  • "Pid": 0
}

GenericClause

One of
eq
required
string

Равно.

{
  • "has-key": "string"
}

GenericCount

Count
required
integer <int64>

Число элементов.

{
  • "Count": 0
}

GenericFilter

limit
integer or null >= 0

Максимальное число элементов; по умолчанию 100.

offset
integer or null >= 0

Смещение для просмотра элементов.

object or null

Условие where.

additional property
object or object or object or object or object or object or object or object or object or object or string or string or object or object (GenericClause)

Общее условие where.

{
  • "where": {
    },
  • "limit": 0,
  • "offset": 0
}

GenericResources

object or null
Kind
string or null
Value
integer or null <int64>
object or null
Kind
string or null
Value
string or null
{
  • "NamedResourceSpec": {
    },
  • "DiscreteResourceSpec": {
    }
}

GenericResourcesInnerDiscreteResourceSpec

Kind
string or null
Value
integer or null <int64>
{
  • "Kind": "string",
  • "Value": 0
}

GenericResourcesInnerNamedResourceSpec

Kind
string or null
Value
string or null
{
  • "Kind": "string",
  • "Value": "string"
}

GraphDriverData

required
object

Низкоуровневые метаданные хранения в виде пар ключ/значение. Они зависят от используемого драйвера хранения и предназначены только для справочной информации.

property name*
additional property
string
Name
required
string

Имя драйвера хранения.

{
  • "Name": "string",
  • "Data": {
    }
}

Health

FailingStreak
integer or null <int64>

FailingStreak — число последовательных неудачных проверок.

Массив objects or null (HealthcheckResult)

Log содержит последние результаты, начиная с самого старого.

Array
End
string or null (BollardDate)

BollardDate

ExitCode
integer or null <int64>

Значения ExitCode: - 0 работоспособен - 1 неработоспособен - 2 зарезервировано, считается неработоспособным - остальные значения: ошибка выполнения проверки.

Output
string or null

Вывод последней проверки.

Start
string or null (BollardDate)

BollardDate

Status
string or null
Допустимые значения: "EMPTY" "none" "starting" "healthy" "unhealthy"
{
  • "Status": "EMPTY",
  • "FailingStreak": 0,
  • "Log": [
    ]
}

HealthConfig

Interval
integer or null <int64>

Интервал между проверками в наносекундах. Должен быть равен 0 или не менее 1000000 (1 мс). 0 означает наследование значения.

Retries
integer or null <int64>

Число последовательных неудачных проверок, после которых контейнер считается неработоспособным. 0 означает наследование значения.

StartInterval
integer or null <int64>

Интервал между проверками в начальный период, в наносекундах. Должен быть равен 0 или не менее 1000000 (1 мс). 0 означает наследование значения.

StartPeriod
integer or null <int64>

Начальный период инициализации контейнера перед отсчётом повторных проверок работоспособности, в наносекундах. Должен быть равен 0 или не менее 1000000 (1 мс). 0 означает наследование значения.

Test
Массив strings or null

Выполняемая проверка. Возможные значения: - []: наследовать проверку образа или родительского образа - [\"NONE\"]: отключить проверку работоспособности - [\"CMD\", args...]: выполнить аргументы непосредственно - [\"CMD-SHELL\", command]: выполнить команду в оболочке системы по умолчанию.

Timeout
integer or null <int64>

Время ожидания до признания проверки зависшей. Должно быть равно 0 или не менее 1000000 (1 мс). 0 означает наследование значения.

{
  • "Test": [
    ],
  • "Interval": 0,
  • "Timeout": 0,
  • "Retries": 0,
  • "StartPeriod": 0,
  • "StartInterval": 0
}

HealthStatusEnum

string (HealthStatusEnum)
Допустимые значения: "EMPTY" "none" "starting" "healthy" "unhealthy"
"EMPTY"

HealthcheckResult

End
string or null (BollardDate)

BollardDate

ExitCode
integer or null <int64>

Значения ExitCode: - 0 работоспособен - 1 неработоспособен - 2 зарезервировано, считается неработоспособным - остальные значения: ошибка выполнения проверки.

Output
string or null

Вывод последней проверки.

Start
string or null (BollardDate)

BollardDate

{
  • "Start": "2021-01-01T00:00:00.000000000Z",
  • "End": "2021-01-01T00:00:00.000000000Z",
  • "ExitCode": 0,
  • "Output": "string"
}

HostConfig

object or null

Произвольные неидентифицирующие метаданные контейнера, передаваемые среде выполнения при его запуске.

property name*
additional property
string
AutoRemove
boolean or null

Автоматически удалять контейнер после завершения его процесса. Не действует, если задан RestartPolicy.

Binds
Массив strings or null

Список подключений томов для контейнера. Каждое подключение задаётся строкой одного из следующих форматов: - host-src:container-dest[:options] — подключение пути хоста в контейнер. host-src и container-dest должны быть абсолютными путями. - volume-name:container-dest[:options] — подключение в контейнер тома, управляемого драйвером томов. container-dest должен быть абсолютным путём. options — необязательный список следующих параметров, разделённых запятыми: - nocopy отключает автоматическое копирование данных из пути контейнера в том. Флаг nocopy применяется только к именованным томам. - [ro|rw] подключает том только для чтения или для чтения и записи соответственно. Если параметр отсутствует или равен rw, том подключается для чтения и записи. - [z|Z] применяет метки SELinux, разрешающие или запрещающие нескольким контейнерам читать и записывать один том. - z: содержимому назначается общая метка. Она означает, что несколько контейнеров могут совместно читать и записывать содержимое тома. - Z: назначается частная, не разделяемая метка. Она означает, что частный том может использовать только текущий контейнер. Системы вроде SELinux требуют соответствующих меток для содержимого томов, подключаемых в контейнер. Без метки система безопасности может запретить процессам контейнера использовать содержимое. По умолчанию метки, заданные операционной системой хоста, не изменяются. - [[r]shared|[r]slave|[r]private] задаёт распространение монтирования. Это относится только к привязанным путям хоста, а не к внутренним или именованным томам. Для распространения исходная точка монтирования, где исходный каталог подключён в ОС хоста, должна иметь правильные свойства распространения. Для общих томов исходная точка должна быть shared. Для подчинённых томов она должна быть shared или slave.

Массив objects or null (ThrottleDevice)

Ограничить скорость чтения устройства в байтах в секунду, в формате: [{\"Path\": \"device_path\", \"Rate\": rate}]

Array
Path
string or null

Путь устройства.

Rate
integer or null <int64>

Скорость.

Массив objects or null (ThrottleDevice)

Ограничить скорость чтения устройства в операциях ввода-вывода в секунду, в формате: [{\"Path\": \"device_path\", \"Rate\": rate}]

Array
Path
string or null

Путь устройства.

Rate
integer or null <int64>

Скорость.

Массив objects or null (ThrottleDevice)

Ограничить скорость записи на устройство в байтах в секунду, в формате: [{\"Path\": \"device_path\", \"Rate\": rate}]

Array
Path
string or null

Путь устройства.

Rate
integer or null <int64>

Скорость.

Массив objects or null (ThrottleDevice)

Ограничить скорость записи на устройство в операциях ввода-вывода в секунду, в формате: [{\"Path\": \"device_path\", \"Rate\": rate}]

Array
Path
string or null

Путь устройства.

Rate
integer or null <int64>

Скорость.

BlkioWeight
integer or null <int32> >= 0

Относительный вес блочного ввода-вывода.

Массив objects or null (ResourcesBlkioWeightDevice)

Вес блочного ввода-вывода, относительный для устройства, в формате: [{\"Path\": \"device_path\", \"Weight\": weight}]

Array
Path
string or null
Weight
integer or null >= 0
CapAdd
Массив strings or null

Список возможностей ядра, добавляемых контейнеру. Несовместим с параметром 'Capabilities'.

CapDrop
Массив strings or null

Список возможностей ядра, удаляемых у контейнера. Несовместим с параметром 'Capabilities'.

Cgroup
string or null

Cgroup для контейнера.

CgroupnsMode
string or null
Допустимые значения: "EMPTY" "private" "host"
CgroupParent
string or null

Путь cgroups, в котором создаётся cgroup контейнера. Если путь не абсолютный, он считается относительным к пути cgroups процесса init. Если cgroups отсутствуют, они создаются.

ConsoleSize
Массив integers or null <int32> [ items <int32 > ]

Исходный размер консоли в виде массива [height, width].

ContainerIDFile
string or null

Путь к файлу, в который записывается идентификатор контейнера.

CpuCount
integer or null <int64>

Число доступных CPU; только для Windows. В контейнерах Windows Server ограничения ресурсов процессора взаимоисключающие. Приоритет: сначала CPUCount, затем CPUShares, последним CPUPercent.

CpuPercent
integer or null <int64>

Доступный процент имеющихся CPU; только для Windows. В контейнерах Windows Server ограничения ресурсов процессора взаимоисключающие. Приоритет: сначала CPUCount, затем CPUShares, последним CPUPercent.

CpuPeriod
integer or null <int64>

Длительность периода CPU в микросекундах.

CpuQuota
integer or null <int64>

Микросекунды процессорного времени, доступные контейнеру за один период CPU.

CpuRealtimePeriod
integer or null <int64>

Длительность периода CPU реального времени в микросекундах. Значение 0 означает, что время задачам реального времени не выделяется.

CpuRealtimeRuntime
integer or null <int64>

Длительность выполнения CPU реального времени в микросекундах. Значение 0 означает, что время задачам реального времени не выделяется.

CpusetCpus
string or null

CPU, на которых разрешено выполнение, например 0-3 или 0,1.

CpusetMems
string or null

Узлы памяти (MEMs), на которых разрешено выполнение (0-3, 0,1). Действует только в системах NUMA.

CpuShares
integer or null <int64>

Целое число, представляющее относительный вес CPU контейнера по сравнению с другими контейнерами.

DeviceCgroupRules
Массив strings or null

Список правил cgroup для контейнера.

Массив objects or null (DeviceRequest)

Список запросов устройств, передаваемых драйверам устройств.

Array
Capabilities
Массив strings or null[ items ]

Список возможностей: объединение по OR списков, внутри которых возможности объединены по AND.

Count
integer or null <int64>
DeviceIDs
Массив strings or null
Driver
string or null
object or null

Параметры драйвера в виде пар ключ/значение. Они передаются непосредственно драйверу.

Массив objects or null (DeviceMapping)

Список устройств, добавляемых в контейнер.

Array
CgroupPermissions
string or null
PathInContainer
string or null
PathOnHost
string or null
Dns
Массив strings or null

Список DNS-серверов для контейнера.

DnsOptions
Массив strings or null

Список параметров DNS.

DnsSearch
Массив strings or null

Список доменов поиска DNS.

ExtraHosts
Массив strings or null

Список сопоставлений имён хостов и IP-адресов, добавляемых в файл /etc/hosts контейнера. Формат: [\"hostname:IP\"].

GroupAdd
Массив strings or null

Список дополнительных групп, от имени которых работает процесс контейнера.

Init
boolean or null

Запускать внутри контейнера процесс init, передающий сигналы и собирающий завершённые процессы. Пустое поле не включается в запрос; используется настройка демона по умолчанию.

IOMaximumBandwidth
integer or null <int64>

Максимальная скорость ввода-вывода системного диска контейнера в байтах в секунду; только для Windows.

IOMaximumIOps
integer or null <int64>

Максимальное число операций ввода-вывода в секунду для системного диска контейнера; только для Windows.

IpcMode
string or null

Режим общего использования IPC для контейнера. Возможные значения: - \"none\": собственное частное пространство имён IPC без подключения /dev/shm - \"private\": собственное частное пространство имён IPC - \"shareable\": собственное частное пространство имён IPC с возможностью совместного использования другими контейнерами - \"container:<name|id>\": присоединиться к разделяемому пространству имён IPC другого контейнера - \"host\": использовать пространство имён IPC хоста. Если значение не задано, используется значение по умолчанию демона: \"private\" или \"shareable\", в зависимости от его версии и конфигурации.

Isolation
string or null
Допустимые значения: "EMPTY" "default" "process" "hyperv"
KernelMemoryTCP
integer or null <int64>

Жёсткое ограничение памяти TCP-буфера ядра в байтах. Параметр может игнорироваться в зависимости от среды выполнения OCI. Он больше не поддерживается средой по умолчанию (runc). Пустое поле не включается в ответ.

Links
Массив strings or null

Список связей контейнера в формате container_name:alias.

object or null

Конфигурация журналирования контейнера.

object or null
Type
string or null
MaskedPaths
Массив strings or null

Список путей, скрываемых внутри контейнера; переопределяет набор путей по умолчанию.

Memory
integer or null <int64>

Ограничение памяти в байтах.

MemoryReservation
integer or null <int64>

Мягкое ограничение памяти в байтах.

MemorySwap
integer or null <int64>

Общее ограничение памяти, включая память и swap. Значение -1 разрешает неограниченный swap.

MemorySwappiness
integer or null <int64>

Настроить swappiness памяти контейнера. Допускается целое число от 0 до 100.

Массив objects or null (Mount)

Спецификация подключений, добавляемых в контейнер.

Array
object or null

Необязательная конфигурация типа bind.

Consistency
string or null

Требование согласованности монтирования: default, consistent, cached или delegated.

ReadOnly
boolean or null

Показывает, должно ли подключение быть доступно только для чтения.

Source
string or null

Источник монтирования, например имя тома или путь хоста.

Target
string or null

Путь в контейнере.

object or null

Необязательная конфигурация типа tmpfs.

Type
string or null
Допустимые значения: "EMPTY" "bind" "volume" "tmpfs" "npipe" "cluster"
object or null

Необязательная конфигурация типа volume.

NanoCpus
integer or null <int64>

Квота CPU в единицах 10-9 процессора.

NetworkMode
string or null

Сетевой режим контейнера. Поддерживаемые стандартные значения: bridge, host, none и container:<name|id>. Любое другое значение считается именем пользовательской сети, к которой должен подключиться контейнер.

OomKillDisable
boolean or null

Отключить OOM killer для контейнера.

OomScoreAdj
integer or null <int64>

Целочисленная оценка контейнера для настройки приоритетов OOM killer.

PidMode
string or null

Задать режим пространства имён PID (процессов) для контейнера. Возможные значения: - \"container:<name|id>\": присоединиться к пространству имён PID другого контейнера - \"host\": использовать пространство имён PID хоста внутри контейнера.

PidsLimit
integer or null <int64>

Настроить ограничение PID контейнера. 0 или -1 означает отсутствие ограничения, null — не изменять.

object or null (PortMap)

PortMap

Массив objects
Privileged
boolean or null

Предоставляет контейнеру полный доступ к хосту.

PublishAllPorts
boolean or null

Выделяет временный порт хоста для каждого открытого порта контейнера. Порты освобождаются при остановке контейнера и выделяются при запуске. При перезапуске выделенный порт может измениться. Порт выбирается из диапазона временных портов, зависящего от ядра. Например, в Linux диапазон задаётся в /proc/sys/net/ipv4/ip_local_port_range.

ReadonlyPaths
Массив strings or null

Список путей, доступных внутри контейнера только для чтения; переопределяет набор путей по умолчанию.

ReadonlyRootfs
boolean or null

Подключить корневую файловую систему контейнера только для чтения.

object or null

Поведение при завершении контейнера. По умолчанию он не перезапускается. Перед каждым перезапуском добавляется возрастающая задержка, чтобы не перегружать сервер: начиная со 100 мс, она каждый раз удваивается.

MaximumRetryCount
integer or null <int64>

Если используется on-failure, число повторных попыток до отказа.

Name
string or null
Допустимые значения: "EMPTY" "no" "always" "unless-stopped" "on-failure"
Runtime
string or null

Среда выполнения для этого контейнера.

SecurityOpt
Массив strings or null

Список строк для настройки меток в системах MLS, например SELinux.

ShmSize
integer or null <int64>

Размер /dev/shm в байтах. Если не задан, система использует 64 МБ.

object or null

Параметры драйвера хранения контейнера в формате {\"size\": \"120G\"}.

property name*
additional property
string
object or null

Список параметров ядра (sysctls), задаваемых в контейнере. Например: {\"net.ipv4.ip_forward\": \"1\"}

property name*
additional property
string
object or null

Сопоставление каталогов контейнера, заменяемых подключениями tmpfs, и соответствующих параметров монтирования. Например: { \"/run\": \"rw,noexec,nosuid,size=65536k\" }

property name*
additional property
string
Массив objects or null (ResourcesUlimits)

Список ограничений ресурсов контейнера. Например: {\"Name\": \"nofile\", \"Soft\": 1024, \"Hard\": 2048}

Array
Hard
integer or null <int64>

Жёсткое ограничение.

Name
string or null

Имя ulimit.

Soft
integer or null <int64>

Мягкое ограничение.

UsernsMode
string or null

Задаёт режим пространства имён пользователя контейнера, когда включено переназначение пространств имён пользователей.

UTSMode
string or null

Пространство имён UTS контейнера.

VolumeDriver
string or null

Драйвер, используемый контейнером для подключения томов.

VolumesFrom
Массив strings or null

Список томов, наследуемых от другого контейнера, в формате <container name>[:<ro|rw>].

{
  • "CpuShares": 0,
  • "Memory": 0,
  • "CgroupParent": "string",
  • "BlkioWeight": 0,
  • "BlkioWeightDevice": [
    ],
  • "BlkioDeviceReadBps": [
    ],
  • "BlkioDeviceWriteBps": [
    ],
  • "BlkioDeviceReadIOps": [
    ],
  • "BlkioDeviceWriteIOps": [
    ],
  • "CpuPeriod": 0,
  • "CpuQuota": 0,
  • "CpuRealtimePeriod": 0,
  • "CpuRealtimeRuntime": 0,
  • "CpusetCpus": "string",
  • "CpusetMems": "string",
  • "Devices": [
    ],
  • "DeviceCgroupRules": [
    ],
  • "DeviceRequests": [
    ],
  • "KernelMemoryTCP": 0,
  • "MemoryReservation": 0,
  • "MemorySwap": 0,
  • "MemorySwappiness": 0,
  • "NanoCpus": 0,
  • "OomKillDisable": true,
  • "Init": true,
  • "PidsLimit": 0,
  • "Ulimits": [
    ],
  • "CpuCount": 0,
  • "CpuPercent": 0,
  • "IOMaximumIOps": 0,
  • "IOMaximumBandwidth": 0,
  • "Binds": [
    ],
  • "ContainerIDFile": "string",
  • "LogConfig": {
    },
  • "NetworkMode": "string",
  • "PortBindings": {
    },
  • "RestartPolicy": {
    },
  • "AutoRemove": true,
  • "VolumeDriver": "string",
  • "VolumesFrom": [
    ],
  • "Mounts": [
    ],
  • "ConsoleSize": [
    ],
  • "Annotations": {
    },
  • "CapAdd": [
    ],
  • "CapDrop": [
    ],
  • "CgroupnsMode": "EMPTY",
  • "Dns": [
    ],
  • "DnsOptions": [
    ],
  • "DnsSearch": [
    ],
  • "ExtraHosts": [
    ],
  • "GroupAdd": [
    ],
  • "IpcMode": "string",
  • "Cgroup": "string",
  • "Links": [
    ],
  • "OomScoreAdj": 0,
  • "PidMode": "string",
  • "Privileged": true,
  • "PublishAllPorts": true,
  • "ReadonlyRootfs": true,
  • "SecurityOpt": [
    ],
  • "StorageOpt": {
    },
  • "Tmpfs": {
    },
  • "UTSMode": "string",
  • "UsernsMode": "string",
  • "ShmSize": 0,
  • "Sysctls": {
    },
  • "Runtime": "string",
  • "Isolation": "EMPTY",
  • "MaskedPaths": [
    ],
  • "ReadonlyPaths": [
    ]
}

HostConfigCgroupnsModeEnum

string (HostConfigCgroupnsModeEnum)
Допустимые значения: "EMPTY" "private" "host"
"EMPTY"

HostConfigIsolationEnum

string (HostConfigIsolationEnum)
Допустимые значения: "EMPTY" "default" "process" "hyperv"
"EMPTY"

HostConfigLogConfig

object or null
property name*
additional property
string
Type
string or null
{
  • "Type": "string",
  • "Config": {
    }
}

HostInfo

Architecture
string or null

Аппаратная архитектура хоста, возвращаемая средой Go (GOARCH). Полный список значений приведён в документации Go.

BridgeNfIp6tables
boolean or null

Показывает, доступен ли bridge-nf-call-ip6tables на хосте.

BridgeNfIptables
boolean or null

Показывает, доступен ли bridge-nf-call-iptables на хосте.

CDISpecDirs
Массив strings or null

Список каталогов со спецификациями CDI (Container Device Interface). Они определяют изменения спецификации OCI создаваемого контейнера для конкретного поставщика. Пустой список означает, что внедрение устройств CDI отключено. Для него требуется экспериментальный режим демона. Неэкспериментальные демоны всегда возвращают пустой список.

CgroupDriver
string or null
Допустимые значения: "EMPTY" "cgroupfs" "systemd" "none"
CgroupVersion
string or null
Допустимые значения: "EMPTY" "1" "2"
required
object (DaemonConfig)

Конфигурация демона. Используется для настройки демона.

advertise_addr
required
string

Адрес, объявляемый другим узлам.

conf_dir
required
string

Каталог конфигурации.

docker_host
string

Используемый хост Docker.

gateway
required
string

Шлюз хоста, автоматически определяемый как шлюз хоста по умолчанию, если значение не задано.

gid
required
integer <int32> >= 0

Идентификатор группы.

hostname
required
string

Имя хоста для узла; определяется автоматически, если не задано.

hosts
required
Массив strings

Список хостов для прослушивания.

nodes
required
Массив strings

Список узлов для присоединения.

object or null
state_dir
required
string

Путь к каталогу состояния.

object or null

Commit содержит Git-коммит (SHA1), из которого собран двоичный файл, указанный в строке версии внешних инструментов, например containerd или runC.

Expected
string or null

Идентификатор коммита внешнего инструмента, ожидаемый dockerd и заданный при сборке.

ID
string or null

Фактический идентификатор коммита внешнего инструмента.

Containers
integer or null <int64>

Общее число контейнеров на хосте.

ContainersPaused
integer or null <int64>

Число контейнеров со статусом \"paused\".

ContainersRunning
integer or null <int64>

Число контейнеров со статусом \"running\".

ContainersStopped
integer or null <int64>

Число контейнеров со статусом \"stopped\".

CpuCfsPeriod
boolean or null

Показывает, поддерживает ли хост период CPU CFS (Completely Fair Scheduler).

CpuCfsQuota
boolean or null

Показывает, поддерживает ли хост квоту CPU CFS (Completely Fair Scheduler).

CPUSet
boolean or null

Показывает, поддерживает ли хост CPUsets (cpuset.cpus, cpuset.mems). См. cpuset(7).

CPUShares
boolean or null

Показывает, поддерживает ли хост ограничение долей CPU.

Debug
boolean or null

Показывает, работает ли демон в режиме отладки с уровнем журналирования debug.

Массив objects or null (SystemInfoDefaultAddressPools)

Список пользовательских пулов адресов по умолчанию для локальных сетей, задаваемых в daemon.json или параметром dockerd. Например, Base "10.10.0.0/16" с Size 24 задаёт 256 пулов адресов 10.10.[0-255].0/24.

Array
Base
string or null

Адрес сети в формате CIDR.

Size
integer or null <int64>

Размер пула сети.

DefaultRuntime
string or null

Имя среды выполнения OCI по умолчанию, используемой при запуске контейнеров. Его можно переопределить для конкретного контейнера при создании.

DockerRootDir
string or null

Корневой каталог постоянного состояния Docker. По умолчанию /var/lib/docker в Linux и C:\\ProgramData\\docker в Windows.

Driver
string or null

Имя используемого драйвера хранения.

DriverStatus
Массив strings or null[ items ]

Сведения драйвера хранения в виде пар "label" / "value". Драйвер предоставляет их в формате, согласованном с выводом docker info в командной строке.


> Примечание: сведения в этом поле, включая формат значений и меток, не следует считать стабильными; они могут измениться без уведомления.

ExperimentalBuild
boolean or null

Показывает, включены ли экспериментальные функции демона.

object or null
object or null
object or null
HostGateway
required
string

HostGateway — адрес шлюза хоста.

HttpProxy
string or null

HTTP-прокси демона. Значение берётся из переменной окружения HTTP_PROXY. Учётные данные в компоненте сведений о пользователе URL прокси маскируются в ответе API. Контейнеры не наследуют эту конфигурацию автоматически.

HttpsProxy
string or null

HTTPS-прокси демона. Значение берётся из переменной окружения HTTPS_PROXY. Учётные данные в компоненте сведений о пользователе URL прокси маскируются в ответе API. Контейнеры не наследуют эту конфигурацию автоматически.

ID
string or null

Уникальный идентификатор демона.


> Примечание: формат идентификатора не является частью API и не должен считаться стабильным.

Images
integer or null <int64>

Общее число образов на хосте. Учитываются образы с тегами и без тегов, включая висячие образы.

IndexServerAddress
string or null

Адрес или URL сервера индекса, используемого для поиска образов и по умолчанию для аутентификации пользователей в Docker Hub и Docker Cloud.

InitBinary
string or null

Имя и необязательный путь двоичного файла docker-init. Если путь отсутствует, демон ищет файл в $PATH хоста и использует первый результат.

object or null

Commit содержит Git-коммит (SHA1), из которого собран двоичный файл, указанный в строке версии внешних инструментов, например containerd или runC.

Expected
string or null

Идентификатор коммита внешнего инструмента, ожидаемый dockerd и заданный при сборке.

ID
string or null

Фактический идентификатор коммита внешнего инструмента.

IPv4Forwarding
boolean or null

Показывает, включена ли пересылка IPv4.

Isolation
string or null
Допустимые значения: "EMPTY" "default" "hyperv" "process"
KernelMemoryTCP
boolean or null

Показывает, поддерживает ли хост ограничение TCP-памяти ядра. Поле отсутствует, если ограничение не поддерживается. Ограничения TCP-памяти ядра недоступны с cgroups v2, где нет соответствующего cgroup memory.kmem.tcp.limit_in_bytes.

KernelVersion
string or null

Версия ядра хоста. В Linux сведения получаются из uname. В Windows они читаются из значения реестра HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion\\, например "10.0 14393 (14393.1198.amd64fre.rs1_release_sec.170427-1353)".

Labels
Массив strings or null

Пользовательские метки демона в виде метаданных ключ/значение.


> Примечание: в Swarm узлы могут иметь метки демона, заданные его конфигурацией, и метки узла, заданные управляющим узлом Swarm. Метки узла в это поле не включены. Их можно получить конечной точкой /nodes/(id) на управляющем узле Swarm.

LiveRestoreEnabled
boolean or null

Показывает, включён ли live restore. Если включён, контейнеры продолжают работать при остановке демона, а также при его запуске, если обнаружены работающие контейнеры.

LoggingDriver
string or null

Драйвер журналирования по умолчанию для новых контейнеров.

MemoryLimit
boolean or null

Показывает, поддерживает ли хост ограничения памяти.

MemTotal
integer or null <int64>

Общий объём физической памяти хоста в байтах.

Name
string or null

Имя хоста.

NCPU
integer or null <int64>

Число логических CPU, доступных демону. Оно определяется запросом к операционной системе при запуске демона. Изменения распределения CPU после запуска не отражаются.

NEventsListener
integer or null <int64>

Число подписанных слушателей событий.

NFd
integer or null <int64>

Общее число файловых дескрипторов, используемых процессом демона. Сведения возвращаются только в режиме отладки.

NGoroutines
integer or null <int64>

Текущее число goroutines. Сведения возвращаются только в режиме отладки.

NoProxy
string or null

Разделённый запятыми список расширений доменов, для которых прокси не используется. Значение берётся из переменной окружения NO_PROXY. Контейнеры не наследуют эту конфигурацию автоматически.

OomKillDisable
boolean or null

Показывает, поддерживается ли отключение OOM killer на хосте.

OperatingSystem
string or null

Имя операционной системы хоста, например "Ubuntu 16.04.2 LTS" или "Windows Server 2016 Datacenter".

OSType
string or null

Тип операционной системы хоста, возвращаемый средой Go (GOOS). Сейчас возвращаются значения "linux" и "windows". Полный список возможных значений приведён в документации Go.

OSVersion
string or null

Версия операционной системы хоста.


> Примечание: сведения в этом поле, включая само его наличие и формат значений, не следует считать стабильными; они могут измениться без уведомления.

PidsLimit
boolean or null

Показывает, поддерживает ли ядро хоста ограничение PID.

object or null

Доступные плагины по типам.


> Примечание: список включает только неуправляемые плагины (V1). > Плагины V1 загружаются по требованию и не отображаются здесь, > если ни один ресурс не использует плагин.

Authorization
Массив strings or null

Имена доступных плагинов авторизации.

Log
Массив strings or null

Имена доступных драйверов и плагинов журналирования.

Network
Массив strings or null

Имена доступных драйверов и плагинов сети.

Volume
Массив strings or null

Имена доступных драйверов томов и плагинов сети.

ProductLicense
string or null

Краткие сведения о лицензии продукта на демоне. Если применена коммерческая лицензия, включаются такие сведения, как число узлов и срок действия.

object or null

RegistryServiceConfig хранит конфигурацию служб реестров демона.

AllowNondistributableArtifactsCIDRs
Массив strings or null

Список диапазонов IP, в которые можно отправлять нераспространяемые артефакты, в формате CIDR RFC 4632. Некоторые образы, например базовые образы Windows, содержат артефакты, распространение которых ограничено лицензией. При отправке образа в реестр такие артефакты обычно не включаются. Эта конфигурация меняет поведение и позволяет демону отправлять их во все реестры, чьи IP-адреса, полученные при разрешении имён, входят в указанную подсеть CIDR. Параметр полезен для реестра в изолированной сети: хосты могут загрузить образы, не подключаясь к другому серверу. > Предупреждение: для нераспространяемых артефактов обычно ограничены способы и места распространения и совместного использования. Применяйте функцию только для частных реестров и соблюдайте все условия, регулирующие повторное распространение таких артефактов.

AllowNondistributableArtifactsHostnames
Массив strings or null

Список имён хостов реестров, в которые можно отправлять нераспространяемые артефакты, в формате <hostname>[:<port>] или <IP address>[:<port>]. Некоторые образы, например базовые образы Windows, содержат артефакты, распространение которых ограничено лицензией. При отправке образа в реестр такие артефакты обычно не включаются. Эта конфигурация меняет поведение для указанных реестров. Параметр полезен для реестра в изолированной сети: хосты могут загрузить образы, не подключаясь к другому серверу. > Предупреждение: для нераспространяемых артефактов обычно ограничены способы и места распространения и совместного использования. Применяйте функцию только для частных реестров и соблюдайте все условия, регулирующие повторное распространение таких артефактов.

object or null
InsecureRegistryCIDRs
Массив strings or null

Список диапазонов IP небезопасных реестров в формате CIDR (RFC 4632). Такие реестры допускают незашифрованные соединения HTTP и/или недоверенные соединения HTTPS с сертификатами неизвестных центров сертификации. По умолчанию локальные реестры (127.0.0.0/8) считаются небезопасными, а все остальные — безопасными. Если демон считает реестр безопасным, соединение с небезопасным реестром невозможно. Эта конфигурация изменяет поведение и разрешает небезопасные соединения с реестрами, чьи IP-адреса, полученные при разрешении имён, входят в указанную подсеть CIDR. Реестр также можно объявить небезопасным по имени хоста. Такие реестры перечислены в IndexConfigs, а их поле Secure имеет значение false. > Предупреждение: параметр полезен при локальном запуске реестра, но создаёт уязвимости. Используйте его ТОЛЬКО для тестирования. Для большей безопасности добавьте свой центр сертификации в список доверенных центров системы вместо включения этого параметра.

Mirrors
Массив strings or null

Список URL реестров, служащих зеркалами официального реестра (docker.io).

object or null

Commit содержит Git-коммит (SHA1), из которого собран двоичный файл, указанный в строке версии внешних инструментов, например containerd или runC.

Expected
string or null

Идентификатор коммита внешнего инструмента, ожидаемый dockerd и заданный при сборке.

ID
string or null

Фактический идентификатор коммита внешнего инструмента.

object or null

Список сред выполнения, совместимых с OCI и настроенных на демоне. Ключи содержат "name", используемое для обращения к среде. Демон Docker использует совместимую с OCI среду, вызываемую через демон containerd, как интерфейс к пространствам имён ядра Linux, cgroups и SELinux. Среда по умолчанию — runc — настраивается автоматически. Дополнительные среды, настроенные пользователем, перечисляются здесь.

additional property
object (Runtime)

Runtime описывает среду выполнения, совместимую с OCI. Демон вызывает её через демон containerd. Среды OCI служат интерфейсом к пространствам имён ядра Linux, cgroups и SELinux.

SecurityOptions
Массив strings or null

Список функций безопасности, включённых на демоне, например apparmor, seccomp, SELinux, пространства имён пользователей (userns), rootless и no-new-privileges. Дополнительные параметры каждой функции могут быть включены в виде разделённого запятыми списка пар ключ/значение.

ServerVersion
string or null

Строка версии демона.

SwapLimit
boolean or null

Показывает, поддерживает ли хост ограничения swap.

object or null

Представляет общие сведения о swarm.

object or null

ClusterInfo — сведения о swarm, возвращаемые конечной точкой "/info". Токены присоединения не включены.

ControlAvailable
boolean or null
Error
string or null
LocalNodeState
string or null
Допустимые значения: "EMPTY" "inactive" "pending" "active" "error" "locked"

Текущее локальное состояние узла. Перечисление значений. Варианты перечисления не содержат данных, поэтому их можно определить как #[repr(C)], что упрощает работу с FFI.

Managers
integer or null <int64>

Общее число управляющих узлов swarm.

NodeAddr
string or null

IP-адрес, по которому другие узлы swarm могут обратиться к этому узлу.

NodeID
string or null

Уникальный идентификатор узла в swarm.

Nodes
integer or null <int64>

Общее число узлов swarm.

Массив objects or null (PeerNode)

Список идентификаторов и адресов других управляющих узлов swarm.

SystemTime
string or null

Текущее системное время в формате RFC 3339, с наносекундами.

Warnings
Массив strings or null

Список предупреждений и информационных сообщений об отсутствующих функциях или проблемах конфигурации демона. Клиент может показать их пользователю.

{
  • "ID": "string",
  • "Containers": 0,
  • "ContainersRunning": 0,
  • "ContainersPaused": 0,
  • "ContainersStopped": 0,
  • "Images": 0,
  • "Driver": "string",
  • "DriverStatus": [
    ],
  • "DockerRootDir": "string",
  • "Plugins": {
    },
  • "MemoryLimit": true,
  • "SwapLimit": true,
  • "KernelMemoryTCP": true,
  • "CpuCfsPeriod": true,
  • "CpuCfsQuota": true,
  • "CPUShares": true,
  • "CPUSet": true,
  • "PidsLimit": true,
  • "OomKillDisable": true,
  • "IPv4Forwarding": true,
  • "BridgeNfIptables": true,
  • "BridgeNfIp6tables": true,
  • "Debug": true,
  • "NFd": 0,
  • "NGoroutines": 0,
  • "SystemTime": "string",
  • "LoggingDriver": "string",
  • "CgroupDriver": "EMPTY",
  • "CgroupVersion": "EMPTY",
  • "NEventsListener": 0,
  • "KernelVersion": "string",
  • "OperatingSystem": "string",
  • "OSVersion": "string",
  • "OSType": "string",
  • "Architecture": "string",
  • "NCPU": 0,
  • "MemTotal": 0,
  • "IndexServerAddress": "string",
  • "RegistryConfig": {
    },
  • "GenericResources": {
    },
  • "HttpProxy": "string",
  • "HttpsProxy": "string",
  • "NoProxy": "string",
  • "Name": "string",
  • "Labels": [
    ],
  • "ExperimentalBuild": true,
  • "ServerVersion": "string",
  • "Runtimes": {
    },
  • "DefaultRuntime": "string",
  • "Swarm": {
    },
  • "LiveRestoreEnabled": true,
  • "Isolation": "EMPTY",
  • "InitBinary": "string",
  • "ContainerdCommit": {
    },
  • "RuncCommit": {
    },
  • "InitCommit": {
    },
  • "SecurityOptions": [
    ],
  • "ProductLicense": "string",
  • "DefaultAddressPools": [
    ],
  • "Warnings": [
    ],
  • "CDISpecDirs": [
    ],
  • "HostGateway": "string",
  • "Config": {
    }
}

HttpTarget

Redirect
string or null
Допустимые значения: "MovedPermanently" "Permanent" "Temporary"
Url
required
string

Целевой URL.

{
  • "Url": "string",
  • "Redirect": "MovedPermanently"
}

ImagePullPolicy

string (ImagePullPolicy)
Допустимые значения: "Never" "Always" "IfNotPresent"

Политика загрузки образов объектов процессов (job, cargo, vm).

"Never"

IndexInfo

Mirrors
Массив strings or null

Список зеркал в виде URI.

Name
string or null

Имя реестра, например "docker.io".

Official
boolean or null

Показывает, является ли реестр официальным, то есть Docker Hub / docker.io.

Secure
boolean or null

Показывает, входит ли реестр в список небезопасных реестров. Если false, реестр небезопасен. Такие реестры допускают незашифрованные соединения HTTP и/или недоверенные соединения HTTPS с сертификатами неизвестных центров сертификации. > Предупреждение: небезопасные реестры полезны при локальном запуске, но создают уязвимости и должны включаться ТОЛЬКО для тестирования. Для большей безопасности добавьте свой центр сертификации в список доверенных центров системы вместо включения этого параметра.

{
  • "Name": "string",
  • "Mirrors": [
    ],
  • "Secure": true,
  • "Official": true
}

Ipam

Массив objects or null (IpamConfig)

Список параметров конфигурации IPAM в виде отображения: {\"Subnet\": <CIDR>, \"IPRange\": <CIDR>, \"Gateway\": <IP address>, \"AuxAddress\": <device_name:IP address>}

Array
object or null
Gateway
string or null
IPRange
string or null
Subnet
string or null
Driver
string or null

Имя используемого драйвера IPAM.

object or null

Параметры драйвера в виде отображения.

property name*
additional property
string
{
  • "Driver": "string",
  • "Config": [
    ],
  • "Options": {
    }
}

IpamConfig

object or null
property name*
additional property
string
Gateway
string or null
IPRange
string or null
Subnet
string or null
{
  • "Subnet": "string",
  • "IPRange": "string",
  • "Gateway": "string",
  • "AuxiliaryAddresses": {
    }
}

Job

required
Массив objects (Config)

Запускаемые контейнеры.

Array
ArgsEscaped
boolean or null

Команда уже экранирована; только для Windows.

AttachStderr
boolean or null

Показывает, следует ли подключиться к stderr.

AttachStdin
boolean or null

Показывает, следует ли подключиться к stdin.

AttachStdout
boolean or null

Показывает, следует ли подключиться к stdout.

Cmd
Массив strings or null

Выполняемая команда в виде строки или массива строк.

Domainname
string or null

Доменное имя контейнера.

Entrypoint
Массив strings or null

Точка входа контейнера в виде строки или массива строк. Если массив содержит ровно одну пустую строку ([\"\"]), точка входа сбрасывается к системному значению по умолчанию, используемому Docker, когда инструкция ENTRYPOINT отсутствует в Dockerfile.

Env
Массив strings or null

Список переменных окружения, задаваемых в контейнере, в формате [\"VAR=value\", ...]. Переменная без = удаляется из окружения, а не получает пустое значение.

object or null

Объект, сопоставляющий порты с пустым объектом в формате: {\"<port>/<tcp|udp|sctp>\": {}}

object or null

Проверка работоспособности контейнера.

object or null

Конфигурация контейнера, зависящая от хоста выполнения.

Hostname
string or null

Имя хоста контейнера, соответствующее RFC 1123.

Image
string or null

Имя образа для создания контейнера.

object or null

Метаданные ключ/значение, заданные пользователем.

MacAddress
string or null

MAC-адрес контейнера.

NetworkDisabled
boolean or null

Отключить сеть для контейнера.

object or null

NetworkingConfig представляет сетевую конфигурацию каждого интерфейса контейнера. Используется для сетевых настроек, указанных в командах docker create и docker network connect.

OnBuild
Массив strings or null

Метаданные ONBUILD, определённые в Dockerfile образа.

OpenStdin
boolean or null

Открыть stdin.

Shell
Массив strings or null

Оболочка для случаев, когда RUN, CMD и ENTRYPOINT используют оболочку.

StdinOnce
boolean or null

Закрыть stdin после отключения одного подключённого клиента.

StopSignal
string or null

Сигнал остановки контейнера в виде строки или беззнакового целого числа.

StopTimeout
integer or null <int64>

Время ожидания остановки контейнера в секундах.

Tty
boolean or null

Подключить стандартные потоки к TTY, включая stdin, если он не закрыт.

User
string or null

Пользователь, от имени которого выполняются команды в контейнере.

object or null

Объект, сопоставляющий пути точек монтирования внутри контейнера с пустыми объектами.

WorkingDir
string or null

Рабочий каталог для выполнения команд.

CreatedAt
required
string <date-time>

Время создания задания.

ImagePullPolicy
string or null
Допустимые значения: "Never" "Always" "IfNotPresent"

Политика загрузки образов объектов процессов (job, cargo, vm).

ImagePullSecret
string or null

Секрет для загрузки образа.

object

Метаданные, заданные пользователем.

additional property
string or number or boolean or Массив Any (any) or object (Any)

Вспомогательный тип Any для OpenApi, полезный для динамических объектов JSON, например ResourceSpec.

Name
required
string

Имя задания.

Schedule
string or null

Расписание задания (cron).

Secrets
Массив strings or null

Секреты, загружаемые как переменные окружения.

required
object (ObjPsStatus)
Actual
required
string (ObjPsStatusKind)
Допустимые значения: "create" "starting" "start" "updating" "update" "destroying" "destroy" "stopping" "stop" "fail" "finish" "unknown"
PrevActual
required
string (ObjPsStatusKind)
Допустимые значения: "create" "starting" "start" "updating" "update" "destroying" "destroy" "stopping" "stop" "fail" "finish" "unknown"
PrevWanted
required
string (ObjPsStatusKind)
Допустимые значения: "create" "starting" "start" "updating" "update" "destroying" "destroy" "stopping" "stop" "fail" "finish" "unknown"
UpdatedAt
required
string <date-time>
Wanted
required
string (ObjPsStatusKind)
Допустимые значения: "create" "starting" "start" "updating" "update" "destroying" "destroy" "stopping" "stop" "fail" "finish" "unknown"
Ttl
integer or null >= 0

Удалить задание через (x) секунд после выполнения.

UpdatedAt
required
string <date-time>

Время обновления задания.

{
  • "Name": "string",
  • "CreatedAt": "2019-08-24T14:15:22Z",
  • "UpdatedAt": "2019-08-24T14:15:22Z",
  • "Status": {
    },
  • "Secrets": [
    ],
  • "Metadata": {
    },
  • "Schedule": "string",
  • "Ttl": 0,
  • "ImagePullSecret": "string",
  • "ImagePullPolicy": "Never",
  • "Containers": [
    ]
}

JobInspect

InstanceFailed
required
integer >= 0

Число неудачных экземпляров.

InstanceRunning
required
integer >= 0

Число работающих экземпляров.

required
Массив objects (Process)

Список экземпляров.

Array
CreatedAt
required
string <date-time>

Дата создания.

required
object (ContainerInspectResponse)
Key
required
string

Ключ процесса.

Kind
required
string (ProcessKind)
Допустимые значения: "vm" "job" "cargo"

Тип процесса (Vm, Job, Cargo).

KindKey
required
string

Ключ связанного типа.

Name
required
string

Имя процесса.

NodeKey
required
string

Ключ узла, на котором работает контейнер.

UpdatedAt
required
string <date-time>

Время последнего обновления экземпляра.

InstanceSuccess
required
integer >= 0

Число успешно завершённых экземпляров.

InstanceTotal
required
integer >= 0

Число экземпляров.

required
object (Job)

Задание — набор контейнеров, выполняемых последовательно как единое целое, подобно команде.

required
Массив objects (Config)

Запускаемые контейнеры.

CreatedAt
required
string <date-time>

Время создания задания.

ImagePullPolicy
string or null
Допустимые значения: "Never" "Always" "IfNotPresent"

Политика загрузки образов объектов процессов (job, cargo, vm).

ImagePullSecret
string or null

Секрет для загрузки образа.

object

Метаданные, заданные пользователем.

Name
required
string

Имя задания.

Schedule
string or null

Расписание задания (cron).

Secrets
Массив strings or null

Секреты, загружаемые как переменные окружения.

required
object (ObjPsStatus)
Ttl
integer or null >= 0

Удалить задание через (x) секунд после выполнения.

UpdatedAt
required
string <date-time>

Время обновления задания.

required
object (ObjPsStatus)
Actual
required
string (ObjPsStatusKind)
Допустимые значения: "create" "starting" "start" "updating" "update" "destroying" "destroy" "stopping" "stop" "fail" "finish" "unknown"
PrevActual
required
string (ObjPsStatusKind)
Допустимые значения: "create" "starting" "start" "updating" "update" "destroying" "destroy" "stopping" "stop" "fail" "finish" "unknown"
PrevWanted
required
string (ObjPsStatusKind)
Допустимые значения: "create" "starting" "start" "updating" "update" "destroying" "destroy" "stopping" "stop" "fail" "finish" "unknown"
UpdatedAt
required
string <date-time>
Wanted
required
string (ObjPsStatusKind)
Допустимые значения: "create" "starting" "start" "updating" "update" "destroying" "destroy" "stopping" "stop" "fail" "finish" "unknown"
{
  • "Status": {
    },
  • "InstanceTotal": 0,
  • "InstanceSuccess": 0,
  • "InstanceRunning": 0,
  • "InstanceFailed": 0,
  • "Spec": {
    },
  • "Instances": [
    ]
}

JobPartial

required
Массив objects (Config)

Список запускаемых контейнеров.

Array
ArgsEscaped
boolean or null

Команда уже экранирована; только для Windows.

AttachStderr
boolean or null

Показывает, следует ли подключиться к stderr.

AttachStdin
boolean or null

Показывает, следует ли подключиться к stdin.

AttachStdout
boolean or null

Показывает, следует ли подключиться к stdout.

Cmd
Массив strings or null

Выполняемая команда в виде строки или массива строк.

Domainname
string or null

Доменное имя контейнера.

Entrypoint
Массив strings or null

Точка входа контейнера в виде строки или массива строк. Если массив содержит ровно одну пустую строку ([\"\"]), точка входа сбрасывается к системному значению по умолчанию, используемому Docker, когда инструкция ENTRYPOINT отсутствует в Dockerfile.

Env
Массив strings or null

Список переменных окружения, задаваемых в контейнере, в формате [\"VAR=value\", ...]. Переменная без = удаляется из окружения, а не получает пустое значение.

object or null

Объект, сопоставляющий порты с пустым объектом в формате: {\"<port>/<tcp|udp|sctp>\": {}}

object or null

Проверка работоспособности контейнера.

object or null

Конфигурация контейнера, зависящая от хоста выполнения.

Hostname
string or null

Имя хоста контейнера, соответствующее RFC 1123.

Image
string or null

Имя образа для создания контейнера.

object or null

Метаданные ключ/значение, заданные пользователем.

MacAddress
string or null

MAC-адрес контейнера.

NetworkDisabled
boolean or null

Отключить сеть для контейнера.

object or null

NetworkingConfig представляет сетевую конфигурацию каждого интерфейса контейнера. Используется для сетевых настроек, указанных в командах docker create и docker network connect.

OnBuild
Массив strings or null

Метаданные ONBUILD, определённые в Dockerfile образа.

OpenStdin
boolean or null

Открыть stdin.

Shell
Массив strings or null

Оболочка для случаев, когда RUN, CMD и ENTRYPOINT используют оболочку.

StdinOnce
boolean or null

Закрыть stdin после отключения одного подключённого клиента.

StopSignal
string or null

Сигнал остановки контейнера в виде строки или беззнакового целого числа.

StopTimeout
integer or null <int64>

Время ожидания остановки контейнера в секундах.

Tty
boolean or null

Подключить стандартные потоки к TTY, включая stdin, если он не закрыт.

User
string or null

Пользователь, от имени которого выполняются команды в контейнере.

object or null

Объект, сопоставляющий пути точек монтирования внутри контейнера с пустыми объектами.

WorkingDir
string or null

Рабочий каталог для выполнения команд.

ImagePullPolicy
string or null
Допустимые значения: "Never" "Always" "IfNotPresent"

Политика загрузки образов объектов процессов (job, cargo, vm).

ImagePullSecret
string or null

Секрет для загрузки образа.

object

Метаданные, заданные пользователем.

additional property
string or number or boolean or Массив Any (any) or object (Any)

Вспомогательный тип Any для OpenApi, полезный для динамических объектов JSON, например ResourceSpec.

Name
required
string

Имя задания.

Schedule
string or null

Расписание задания (cron).

Secrets
Массив strings or null

Секреты, загружаемые как переменные окружения.

Ttl
integer or null >= 0

Удалить задание через (x) секунд после выполнения.

{
  • "Name": "string",
  • "Secrets": [
    ],
  • "Metadata": {
    },
  • "Schedule": "string",
  • "Ttl": 0,
  • "ImagePullSecret": "string",
  • "ImagePullPolicy": "Never",
  • "Containers": [
    ]
}

JobSummary

InstanceFailed
required
integer >= 0

Число неудачных экземпляров.

InstanceRunning
required
integer >= 0

Число работающих экземпляров.

InstanceSuccess
required
integer >= 0

Число успешно завершённых экземпляров.

InstanceTotal
required
integer >= 0

Число экземпляров.

required
object (Job)

Задание — набор контейнеров, выполняемых последовательно как единое целое, подобно команде.

required
Массив objects (Config)

Запускаемые контейнеры.

CreatedAt
required
string <date-time>

Время создания задания.

ImagePullPolicy
string or null
Допустимые значения: "Never" "Always" "IfNotPresent"

Политика загрузки образов объектов процессов (job, cargo, vm).

ImagePullSecret
string or null

Секрет для загрузки образа.

object

Метаданные, заданные пользователем.

Name
required
string

Имя задания.

Schedule
string or null

Расписание задания (cron).

Secrets
Массив strings or null

Секреты, загружаемые как переменные окружения.

required
object (ObjPsStatus)
Ttl
integer or null >= 0

Удалить задание через (x) секунд после выполнения.

UpdatedAt
required
string <date-time>

Время обновления задания.

{
  • "InstanceTotal": 0,
  • "InstanceSuccess": 0,
  • "InstanceRunning": 0,
  • "InstanceFailed": 0,
  • "Spec": {
    }
}

LocalNodeState

string (LocalNodeState)
Допустимые значения: "EMPTY" "inactive" "pending" "active" "error" "locked"

Текущее локальное состояние узла. Перечисление значений. Варианты перечисления не содержат данных, поэтому их можно определить как #[repr(C)], что упрощает работу с FFI.

"EMPTY"

LocationTarget

One of
DisableLogging
boolean or null

Отключить журналирование для этой цели.

Key
required
string

Ключ целевого Cargo или VM.

Path
string or null

Целевой путь HTTP при использовании HTTP.

Port
required
integer <int32> >= 0

Порт целевого Cargo или VM.

Example
{
  • "Key": "string",
  • "Port": 0,
  • "Path": "string",
  • "DisableLogging": true
}

MemoryStats

commit
integer or null <int64> >= 0
commit_peak
integer or null <int64> >= 0
commitbytes
integer or null <int64> >= 0
commitpeakbytes
integer or null <int64> >= 0
failcnt
integer or null <int64> >= 0
limit
integer or null <int64> >= 0
max_usage
integer or null <int64> >= 0
privateworkingset
integer or null <int64> >= 0
(MemoryStatsStatsV1 (object or null)) or (MemoryStatsStatsV2 (object or null))

Подробная статистика памяти контейнера.

One of
active_anon
required
integer <int64> >= 0
active_file
required
integer <int64> >= 0
cache
required
integer <int64> >= 0
dirty
required
integer <int64> >= 0
hierarchical_memory_limit
required
integer <int64> >= 0
hierarchical_memsw_limit
integer or null <int64> >= 0
inactive_anon
required
integer <int64> >= 0
inactive_file
required
integer <int64> >= 0
mapped_file
required
integer <int64> >= 0
pgfault
required
integer <int64> >= 0
pgmajfault
required
integer <int64> >= 0
pgpgin
required
integer <int64> >= 0
pgpgout
required
integer <int64> >= 0
rss
required
integer <int64> >= 0
rss_huge
required
integer <int64> >= 0
shmem
integer or null <int64> >= 0
total_active_anon
required
integer <int64> >= 0
total_active_file
required
integer <int64> >= 0
total_cache
required
integer <int64> >= 0
total_dirty
required
integer <int64> >= 0
total_inactive_anon
required
integer <int64> >= 0
total_inactive_file
required
integer <int64> >= 0
total_mapped_file
required
integer <int64> >= 0
total_pgfault
required
integer <int64> >= 0
total_pgmajfault
required
integer <int64> >= 0
total_pgpgin
required
integer <int64> >= 0
total_pgpgout
required
integer <int64> >= 0
total_rss
required
integer <int64> >= 0
total_rss_huge
required
integer <int64> >= 0
total_shmem
integer or null <int64> >= 0
total_unevictable
required
integer <int64> >= 0
total_writeback
required
integer <int64> >= 0
unevictable
required
integer <int64> >= 0
writeback
required
integer <int64> >= 0
usage
integer or null <int64> >= 0
{
  • "stats": {
    },
  • "max_usage": 0,
  • "usage": 0,
  • "failcnt": 0,
  • "limit": 0,
  • "commit": 0,
  • "commit_peak": 0,
  • "commitbytes": 0,
  • "commitpeakbytes": 0,
  • "privateworkingset": 0
}

MemoryStatsStats

One of
active_anon
required
integer <int64> >= 0
active_file
required
integer <int64> >= 0
cache
required
integer <int64> >= 0
dirty
required
integer <int64> >= 0
hierarchical_memory_limit
required
integer <int64> >= 0
hierarchical_memsw_limit
integer or null <int64> >= 0
inactive_anon
required
integer <int64> >= 0
inactive_file
required
integer <int64> >= 0
mapped_file
required
integer <int64> >= 0
pgfault
required
integer <int64> >= 0
pgmajfault
required
integer <int64> >= 0
pgpgin
required
integer <int64> >= 0
pgpgout
required
integer <int64> >= 0
rss
required
integer <int64> >= 0
rss_huge
required
integer <int64> >= 0
shmem
integer or null <int64> >= 0
total_active_anon
required
integer <int64> >= 0
total_active_file
required
integer <int64> >= 0
total_cache
required
integer <int64> >= 0
total_dirty
required
integer <int64> >= 0
total_inactive_anon
required
integer <int64> >= 0
total_inactive_file
required
integer <int64> >= 0
total_mapped_file
required
integer <int64> >= 0
total_pgfault
required
integer <int64> >= 0
total_pgmajfault
required
integer <int64> >= 0
total_pgpgin
required
integer <int64> >= 0
total_pgpgout
required
integer <int64> >= 0
total_rss
required
integer <int64> >= 0
total_rss_huge
required
integer <int64> >= 0
total_shmem
integer or null <int64> >= 0
total_unevictable
required
integer <int64> >= 0
total_writeback
required
integer <int64> >= 0
unevictable
required
integer <int64> >= 0
writeback
required
integer <int64> >= 0
Example
{
  • "cache": 0,
  • "dirty": 0,
  • "mapped_file": 0,
  • "total_inactive_file": 0,
  • "pgpgout": 0,
  • "rss": 0,
  • "total_mapped_file": 0,
  • "writeback": 0,
  • "unevictable": 0,
  • "pgpgin": 0,
  • "total_unevictable": 0,
  • "pgmajfault": 0,
  • "total_rss": 0,
  • "total_rss_huge": 0,
  • "total_writeback": 0,
  • "total_inactive_anon": 0,
  • "rss_huge": 0,
  • "hierarchical_memory_limit": 0,
  • "total_pgfault": 0,
  • "total_active_file": 0,
  • "active_anon": 0,
  • "total_active_anon": 0,
  • "total_pgpgout": 0,
  • "total_cache": 0,
  • "total_dirty": 0,
  • "inactive_anon": 0,
  • "active_file": 0,
  • "pgfault": 0,
  • "inactive_file": 0,
  • "total_pgmajfault": 0,
  • "total_pgpgin": 0,
  • "hierarchical_memsw_limit": 0,
  • "shmem": 0,
  • "total_shmem": 0
}

MemoryStatsStatsV1

active_anon
required
integer <int64> >= 0
active_file
required
integer <int64> >= 0
cache
required
integer <int64> >= 0
dirty
required
integer <int64> >= 0
hierarchical_memory_limit
required
integer <int64> >= 0
hierarchical_memsw_limit
integer or null <int64> >= 0
inactive_anon
required
integer <int64> >= 0
inactive_file
required
integer <int64> >= 0
mapped_file
required
integer <int64> >= 0
pgfault
required
integer <int64> >= 0
pgmajfault
required
integer <int64> >= 0
pgpgin
required
integer <int64> >= 0
pgpgout
required
integer <int64> >= 0
rss
required
integer <int64> >= 0
rss_huge
required
integer <int64> >= 0
shmem
integer or null <int64> >= 0
total_active_anon
required
integer <int64> >= 0
total_active_file
required
integer <int64> >= 0
total_cache
required
integer <int64> >= 0
total_dirty
required
integer <int64> >= 0
total_inactive_anon
required
integer <int64> >= 0
total_inactive_file
required
integer <int64> >= 0
total_mapped_file
required
integer <int64> >= 0
total_pgfault
required
integer <int64> >= 0
total_pgmajfault
required
integer <int64> >= 0
total_pgpgin
required
integer <int64> >= 0
total_pgpgout
required
integer <int64> >= 0
total_rss
required
integer <int64> >= 0
total_rss_huge
required
integer <int64> >= 0
total_shmem
integer or null <int64> >= 0
total_unevictable
required
integer <int64> >= 0
total_writeback
required
integer <int64> >= 0
unevictable
required
integer <int64> >= 0
writeback
required
integer <int64> >= 0
{
  • "cache": 0,
  • "dirty": 0,
  • "mapped_file": 0,
  • "total_inactive_file": 0,
  • "pgpgout": 0,
  • "rss": 0,
  • "total_mapped_file": 0,
  • "writeback": 0,
  • "unevictable": 0,
  • "pgpgin": 0,
  • "total_unevictable": 0,
  • "pgmajfault": 0,
  • "total_rss": 0,
  • "total_rss_huge": 0,
  • "total_writeback": 0,
  • "total_inactive_anon": 0,
  • "rss_huge": 0,
  • "hierarchical_memory_limit": 0,
  • "total_pgfault": 0,
  • "total_active_file": 0,
  • "active_anon": 0,
  • "total_active_anon": 0,
  • "total_pgpgout": 0,
  • "total_cache": 0,
  • "total_dirty": 0,
  • "inactive_anon": 0,
  • "active_file": 0,
  • "pgfault": 0,
  • "inactive_file": 0,
  • "total_pgmajfault": 0,
  • "total_pgpgin": 0,
  • "hierarchical_memsw_limit": 0,
  • "shmem": 0,
  • "total_shmem": 0
}

MemoryStatsStatsV2

active_anon
required
integer <int64> >= 0
active_file
required
integer <int64> >= 0
anon
required
integer <int64> >= 0
anon_thp
required
integer <int64> >= 0
file
required
integer <int64> >= 0
file_dirty
required
integer <int64> >= 0
file_mapped
required
integer <int64> >= 0
file_writeback
required
integer <int64> >= 0
inactive_anon
required
integer <int64> >= 0
inactive_file
required
integer <int64> >= 0
kernel_stack
required
integer <int64> >= 0
pgactivate
required
integer <int64> >= 0
pgdeactivate
required
integer <int64> >= 0
pgfault
required
integer <int64> >= 0
pglazyfree
required
integer <int64> >= 0
pglazyfreed
required
integer <int64> >= 0
pgmajfault
required
integer <int64> >= 0
pgrefill
required
integer <int64> >= 0
pgscan
required
integer <int64> >= 0
pgsteal
required
integer <int64> >= 0
shmem
required
integer <int64> >= 0
slab
required
integer <int64> >= 0
slab_reclaimable
required
integer <int64> >= 0
slab_unreclaimable
required
integer <int64> >= 0
sock
required
integer <int64> >= 0
thp_collapse_alloc
required
integer <int64> >= 0
thp_fault_alloc
required
integer <int64> >= 0
unevictable
required
integer <int64> >= 0
workingset_activate
required
integer <int64> >= 0
workingset_nodereclaim
required
integer <int64> >= 0
workingset_refault
required
integer <int64> >= 0
{
  • "anon": 0,
  • "file": 0,
  • "kernel_stack": 0,
  • "slab": 0,
  • "sock": 0,
  • "shmem": 0,
  • "file_mapped": 0,
  • "file_dirty": 0,
  • "file_writeback": 0,
  • "anon_thp": 0,
  • "inactive_anon": 0,
  • "active_anon": 0,
  • "inactive_file": 0,
  • "active_file": 0,
  • "unevictable": 0,
  • "slab_reclaimable": 0,
  • "slab_unreclaimable": 0,
  • "pgfault": 0,
  • "pgmajfault": 0,
  • "workingset_refault": 0,
  • "workingset_activate": 0,
  • "workingset_nodereclaim": 0,
  • "pgrefill": 0,
  • "pgscan": 0,
  • "pgsteal": 0,
  • "pgactivate": 0,
  • "pgdeactivate": 0,
  • "pglazyfree": 0,
  • "pglazyfreed": 0,
  • "thp_fault_alloc": 0,
  • "thp_collapse_alloc": 0
}

Metric

CreatedAt
required
string <date-time>

Время создания метрики.

Data
required
any

Данные метрики.

ExpiresAt
required
string <date-time>

Время истечения метрики.

Key
required
string <uuid>

Ключ метрики в базе данных UUID.

Kind
required
string

Тип метрики.

NodeName
required
string

Узел, с которого получена метрика.

Note
string or null

Необязательная заметка о метрике.

{
  • "Key": "5eb041b0-19c9-4022-bd51-0e723885f5dd",
  • "CreatedAt": "2019-08-24T14:15:22Z",
  • "ExpiresAt": "2019-08-24T14:15:22Z",
  • "NodeName": "string",
  • "Kind": "string",
  • "Data": null,
  • "Note": "string"
}

MetricPartial

Data
required
any

Данные метрики.

Kind
required
string

Тип метрики.

Note
string or null

Необязательная заметка о метрике.

{
  • "Kind": "string",
  • "Data": null,
  • "Note": "string"
}

Mount

object or null

Необязательная конфигурация типа bind.

CreateMountpoint
boolean or null

Создать точку монтирования на хосте, если она отсутствует.

NonRecursive
boolean or null

Отключить рекурсивное привязанное монтирование.

Propagation
string or null
Допустимые значения: "EMPTY" "private" "rprivate" "shared" "rshared" "slave" "rslave"
ReadOnlyForceRecursive
boolean or null

Выдать ошибку, если подключение нельзя сделать рекурсивно доступным только для чтения.

ReadOnlyNonRecursive
boolean or null

Сделать само подключение доступным только для чтения, не распространяя это рекурсивно, но сохранив рекурсивное монтирование, если одновременно NonRecursive не равно true.

Consistency
string or null

Требование согласованности монтирования: default, consistent, cached или delegated.

ReadOnly
boolean or null

Показывает, должно ли подключение быть доступно только для чтения.

Source
string or null

Источник монтирования, например имя тома или путь хоста.

Target
string or null

Путь в контейнере.

object or null

Необязательная конфигурация типа tmpfs.

Mode
integer or null <int64>

Режим прав доступа к tmpfs в виде целого числа.

SizeBytes
integer or null <int64>

Размер tmpfs в байтах.

Type
string or null
Допустимые значения: "EMPTY" "bind" "volume" "tmpfs" "npipe" "cluster"
object or null

Необязательная конфигурация типа volume.

object or null

Отображение параметров драйвера.

object or null

Метаданные ключ/значение, заданные пользователем.

NoCopy
boolean or null

Заполнить том данными из целевого пути.

{
  • "Target": "string",
  • "Source": "string",
  • "Type": "EMPTY",
  • "ReadOnly": true,
  • "Consistency": "string",
  • "BindOptions": {
    },
  • "VolumeOptions": {
    },
  • "TmpfsOptions": {
    }
}

MountBindOptions

CreateMountpoint
boolean or null

Создать точку монтирования на хосте, если она отсутствует.

NonRecursive
boolean or null

Отключить рекурсивное привязанное монтирование.

Propagation
string or null
Допустимые значения: "EMPTY" "private" "rprivate" "shared" "rshared" "slave" "rslave"
ReadOnlyForceRecursive
boolean or null

Выдать ошибку, если подключение нельзя сделать рекурсивно доступным только для чтения.

ReadOnlyNonRecursive
boolean or null

Сделать само подключение доступным только для чтения, не распространяя это рекурсивно, но сохранив рекурсивное монтирование, если одновременно NonRecursive не равно true.

{
  • "Propagation": "EMPTY",
  • "NonRecursive": true,
  • "CreateMountpoint": true,
  • "ReadOnlyNonRecursive": true,
  • "ReadOnlyForceRecursive": true
}

MountBindOptionsPropagationEnum

string (MountBindOptionsPropagationEnum)
Допустимые значения: "EMPTY" "private" "rprivate" "shared" "rshared" "slave" "rslave"
"EMPTY"

MountPoint

Destination
string or null

Destination — путь относительно корня контейнера (/), по которому Source подключается внутри контейнера.

Driver
string or null

Driver — драйвер томов, используемый для создания тома, если это том.

Mode
string or null

Mode — разделённый запятыми список параметров, заданных пользователем при создании подключения пути хоста или тома. Значение по умолчанию зависит от платформы: \"z\" в Linux, пустое в Windows.

Name
string or null

Name — имя, ссылающееся на данные, определяемые Source, например имя тома.

Propagation
string or null

Propagation описывает распространение монтирований с хоста в точку монтирования и обратно. Подробности приведены в документации ядра Linux. Поле не используется в Windows.

RW
boolean or null

Показывает, доступно ли подключение для записи, то есть для чтения и записи.

Source
string or null

Источник монтирования. Для томов содержит место хранения тома внутри /var/lib/docker/volumes/. Для привязанных путей и npipe содержит исходную часть монтирования на хосте. Для точек tmpfs поле пустое.

Type
string or null
Допустимые значения: "EMPTY" "bind" "volume" "tmpfs" "npipe" "cluster"
{
  • "Type": "EMPTY",
  • "Name": "string",
  • "Source": "string",
  • "Destination": "string",
  • "Driver": "string",
  • "Mode": "string",
  • "RW": true,
  • "Propagation": "string"
}

MountPointTypeEnum

string (MountPointTypeEnum)
Допустимые значения: "EMPTY" "bind" "volume" "tmpfs" "npipe" "cluster"
"EMPTY"

MountTmpfsOptions

Mode
integer or null <int64>

Режим прав доступа к tmpfs в виде целого числа.

SizeBytes
integer or null <int64>

Размер tmpfs в байтах.

{
  • "SizeBytes": 0,
  • "Mode": 0
}

MountTypeEnum

string (MountTypeEnum)
Допустимые значения: "EMPTY" "bind" "volume" "tmpfs" "npipe" "cluster"
"EMPTY"

MountVolumeOptions

object or null

Отображение параметров драйвера.

Name
string or null

Имя драйвера для создания тома.

object or null

Отображение ключ/значение параметров драйвера.

object or null

Метаданные ключ/значение, заданные пользователем.

property name*
additional property
string
NoCopy
boolean or null

Заполнить том данными из целевого пути.

{
  • "NoCopy": true,
  • "Labels": {
    },
  • "DriverConfig": {
    }
}

MountVolumeOptionsDriverConfig

Name
string or null

Имя драйвера для создания тома.

object or null

Отображение ключ/значение параметров драйвера.

property name*
additional property
string
{
  • "Name": "string",
  • "Options": {
    }
}

Namespace

CreatedAt
required
string <date-time>

Время создания пространства имён.

Name
required
string

Имя, являющееся первичным ключом пространства имён.

{
  • "Name": "string",
  • "CreatedAt": "2019-08-24T14:15:22Z"
}

NamespaceInspect

required
Массив objects (CargoInspect)

Число Cargo.

Array
CreatedAt
required
string <date-time>

Время создания Cargo.

InstanceRunning
required
integer >= 0

Число работающих экземпляров.

required
Массив objects (Process)

Список экземпляров.

InstanceTotal
required
integer >= 0

Число экземпляров.

NamespaceName
required
string

Имя пространства имён.

required
object (CargoSpec)

Спецификация Cargo описывает его состояние. Она позволяет узнать состояние Cargo и сохраняет историю изменений существующего Cargo.

required
object (ObjPsStatus)
Name
required
string

Имя пространства имён.

required
object (Network)
Attachable
boolean or null
object or null
Created
string or null (BollardDate)

BollardDate

Driver
string or null
EnableIPv6
boolean or null
Id
string or null
Ingress
boolean or null
Internal
boolean or null
object or null
object or null
Name
string or null
object or null
Scope
string or null
{
  • "Name": "string",
  • "Cargoes": [
    ],
  • "Network": {
    }
}

NamespacePartial

Name
required
string

Имя пространства имён.

{
  • "Name": "string"
}

NamespaceSummary

Cargoes
required
integer >= 0

Число Cargo.

CreatedAt
required
string <date-time>

Время создания пространства имён.

Gateway
required
string

Шлюз пространства имён.

Instances
required
integer >= 0

Число экземпляров.

Name
required
string

Имя пространства имён.

{
  • "Name": "string",
  • "Cargoes": 0,
  • "Instances": 0,
  • "Gateway": "string",
  • "CreatedAt": "2019-08-24T14:15:22Z"
}

NativeEventAction

One of
string
Значение: "create"

Action — действие, вызвавшее событие.

{
  • "other": "string"
}

Network

Attachable
boolean or null
object or null
additional property
object (NetworkContainer)
Created
string or null (BollardDate)

BollardDate

Driver
string or null
EnableIPv6
boolean or null
Id
string or null
Ingress
boolean or null
Internal
boolean or null
object or null
Массив objects or null (IpamConfig)

Список параметров конфигурации IPAM в виде отображения: {\"Subnet\": <CIDR>, \"IPRange\": <CIDR>, \"Gateway\": <IP address>, \"AuxAddress\": <device_name:IP address>}

Driver
string or null

Имя используемого драйвера IPAM.

object or null

Параметры драйвера в виде отображения.

object or null
property name*
additional property
string
Name
string or null
object or null
property name*
additional property
string
Scope
string or null
{
  • "Name": "string",
  • "Id": "string",
  • "Created": "2021-01-01T00:00:00.000000000Z",
  • "Scope": "string",
  • "Driver": "string",
  • "EnableIPv6": true,
  • "IPAM": {
    },
  • "Internal": true,
  • "Attachable": true,
  • "Ingress": true,
  • "Containers": {
    },
  • "Options": {
    },
  • "Labels": {
    }
}

NetworkContainer

EndpointID
string or null
IPv4Address
string or null
IPv6Address
string or null
MacAddress
string or null
Name
string or null
{
  • "Name": "string",
  • "EndpointID": "string",
  • "MacAddress": "string",
  • "IPv4Address": "string",
  • "IPv6Address": "string"
}

NetworkSettings

Bridge
string or null

Имя интерфейса bridge по умолчанию, если у dockerd задан флаг --bridge.

EndpointID
string or null

EndpointID однозначно обозначает конечную точку службы в Sandbox.


> Устарело: поле передаётся только при подключении к сети "bridge" по умолчанию. Вместо него используйте сведения о сети "bridge" в отображении Networks, содержащем те же данные. Поле устарело в Docker 1.9; удаление запланировано в Docker 17.12.0.

Gateway
string or null

Адрес шлюза сети "bridge" по умолчанию.


> Устарело: поле передаётся только при подключении к сети "bridge" по умолчанию. Вместо него используйте сведения о сети "bridge" в отображении Networks, содержащем те же данные. Поле устарело в Docker 1.9; удаление запланировано в Docker 17.12.0.

GlobalIPv6Address
string or null

Глобальный адрес IPv6 сети "bridge" по умолчанию.


> Устарело: поле передаётся только при подключении к сети "bridge" по умолчанию. Вместо него используйте сведения о сети "bridge" в отображении Networks, содержащем те же данные. Поле устарело в Docker 1.9; удаление запланировано в Docker 17.12.0.

GlobalIPv6PrefixLen
integer or null <int64>

Длина маски глобального адреса IPv6.


> Устарело: поле передаётся только при подключении к сети "bridge" по умолчанию. Вместо него используйте сведения о сети "bridge" в отображении Networks, содержащем те же данные. Поле устарело в Docker 1.9; удаление запланировано в Docker 17.12.0.

HairpinMode
boolean or null

Показывает, следует ли включить hairpin NAT на виртуальном интерфейсе. Устарело: поле никогда не задаётся и будет удалено в будущем выпуске.

IPAddress
string or null

Адрес IPv4 сети "bridge" по умолчанию.


> Устарело: поле передаётся только при подключении к сети "bridge" по умолчанию. Вместо него используйте сведения о сети "bridge" в отображении Networks, содержащем те же данные. Поле устарело в Docker 1.9; удаление запланировано в Docker 17.12.0.

IPPrefixLen
integer or null <int64>

Длина маски адреса IPv4.


> Устарело: поле передаётся только при подключении к сети "bridge" по умолчанию. Вместо него используйте сведения о сети "bridge" в отображении Networks, содержащем те же данные. Поле устарело в Docker 1.9; удаление запланировано в Docker 17.12.0.

IPv6Gateway
string or null

Адрес шлюза IPv6 этой сети.


> Устарело: поле передаётся только при подключении к сети "bridge" по умолчанию. Вместо него используйте сведения о сети "bridge" в отображении Networks, содержащем те же данные. Поле устарело в Docker 1.9; удаление запланировано в Docker 17.12.0.

LinkLocalIPv6Address
string or null

Одноадресный адрес IPv6 с префиксом локального канала. Устарело: поле никогда не задаётся и будет удалено в будущем выпуске.

LinkLocalIPv6PrefixLen
integer or null <int64>

Длина префикса одноадресного адреса IPv6. Устарело: поле никогда не задаётся и будет удалено в будущем выпуске.

MacAddress
string or null

MAC-адрес контейнера в сети "bridge" по умолчанию.


> Устарело: поле передаётся только при подключении к сети "bridge" по умолчанию. Вместо него используйте сведения о сети "bridge" в отображении Networks, содержащем те же данные. Поле устарело в Docker 1.9; удаление запланировано в Docker 17.12.0.

object or null

Сведения обо всех сетях, к которым подключён контейнер.

additional property
object (EndpointSettings)

Конфигурация конечной точки сети.

object or null (PortMap)

PortMap

Массив objects
SandboxID
string or null

SandboxID однозначно обозначает сетевой стек контейнера.

SandboxKey
string or null

SandboxKey — полный путь дескриптора netns.

Массив objects or null (Address)

Устарело: это поле никогда не задаётся и будет удалено в будущем выпуске.

Array
Addr
string or null

IP-адрес.

PrefixLen
integer or null <int64>

Длина маски IP-адреса.

Массив objects or null (Address)

Устарело: это поле никогда не задаётся и будет удалено в будущем выпуске.

Array
Addr
string or null

IP-адрес.

PrefixLen
integer or null <int64>

Длина маски IP-адреса.

{
  • "Bridge": "string",
  • "SandboxID": "string",
  • "HairpinMode": true,
  • "LinkLocalIPv6Address": "string",
  • "LinkLocalIPv6PrefixLen": 0,
  • "Ports": {
    },
  • "SandboxKey": "string",
  • "SecondaryIPAddresses": [
    ],
  • "SecondaryIPv6Addresses": [
    ],
  • "EndpointID": "string",
  • "Gateway": "string",
  • "GlobalIPv6Address": "string",
  • "GlobalIPv6PrefixLen": 0,
  • "IPAddress": "string",
  • "IPPrefixLen": 0,
  • "IPv6Gateway": "string",
  • "MacAddress": "string",
  • "Networks": {
    }
}

NetworkStats

rx_bytes
required
integer <int64> >= 0
rx_dropped
required
integer <int64> >= 0
rx_errors
required
integer <int64> >= 0
rx_packets
required
integer <int64> >= 0
tx_bytes
required
integer <int64> >= 0
tx_dropped
required
integer <int64> >= 0
tx_errors
required
integer <int64> >= 0
tx_packets
required
integer <int64> >= 0
{
  • "rx_dropped": 0,
  • "rx_bytes": 0,
  • "rx_errors": 0,
  • "tx_packets": 0,
  • "tx_dropped": 0,
  • "rx_packets": 0,
  • "tx_errors": 0,
  • "tx_bytes": 0
}

NetworkingConfig

object or null

Сопоставление имени сети и конфигурации конечной точки этой сети. Конфигурацию конечной точки можно оставить пустой, чтобы подключиться к сети без специальных настроек.

additional property
object (EndpointSettings)

Конфигурация конечной точки сети.

{
  • "EndpointsConfig": {
    }
}

Node

IpAddress
required
string
Name
required
string
{
  • "Name": "string",
  • "IpAddress": "string"
}

ObjPsStatus

Actual
required
string (ObjPsStatusKind)
Допустимые значения: "create" "starting" "start" "updating" "update" "destroying" "destroy" "stopping" "stop" "fail" "finish" "unknown"
PrevActual
required
string (ObjPsStatusKind)
Допустимые значения: "create" "starting" "start" "updating" "update" "destroying" "destroy" "stopping" "stop" "fail" "finish" "unknown"
PrevWanted
required
string (ObjPsStatusKind)
Допустимые значения: "create" "starting" "start" "updating" "update" "destroying" "destroy" "stopping" "stop" "fail" "finish" "unknown"
UpdatedAt
required
string <date-time>
Wanted
required
string (ObjPsStatusKind)
Допустимые значения: "create" "starting" "start" "updating" "update" "destroying" "destroy" "stopping" "stop" "fail" "finish" "unknown"
{
  • "UpdatedAt": "2019-08-24T14:15:22Z",
  • "Wanted": "create",
  • "PrevWanted": "create",
  • "Actual": "create",
  • "PrevActual": "create"
}

ObjPsStatusKind

string (ObjPsStatusKind)
Допустимые значения: "create" "starting" "start" "updating" "update" "destroying" "destroy" "stopping" "stop" "fail" "finish" "unknown"
"create"

ObjectVersion

Index
integer or null <int64> >= 0
{
  • "Index": 0
}

PeerNode

Addr
string or null

IP-адрес и порты, по которым доступен узел.

NodeID
string or null

Уникальный идентификатор узла в swarm.

{
  • "NodeID": "string",
  • "Addr": "string"
}

PidsStats

current
integer or null <int64> >= 0
limit
integer or null <int64> >= 0
{
  • "current": 0,
  • "limit": 0
}

PluginsInfo

Authorization
Массив strings or null

Имена доступных плагинов авторизации.

Log
Массив strings or null

Имена доступных драйверов и плагинов журналирования.

Network
Массив strings or null

Имена доступных драйверов и плагинов сети.

Volume
Массив strings or null

Имена доступных драйверов томов и плагинов сети.

{
  • "Volume": [
    ],
  • "Network": [
    ],
  • "Authorization": [
    ],
  • "Log": [
    ]
}

Port

IP
string or null

IP-адрес хоста, к которому привязан порт контейнера.

PrivatePort
required
integer <int32> >= 0

Порт контейнера.

PublicPort
integer or null <int32> >= 0

Порт, открытый на хосте.

Type
string or null
Допустимые значения: "EMPTY" "tcp" "udp" "sctp"
{
  • "IP": "string",
  • "PrivatePort": 0,
  • "PublicPort": 0,
  • "Type": "EMPTY"
}

PortBinding

HostIp
string or null

IP-адрес хоста, к которому привязан порт контейнера.

HostPort
string or null

Номер порта хоста, к которому привязан порт контейнера.

{
  • "HostIp": "string",
  • "HostPort": "string"
}

PortMap

Массив objects
Array
HostIp
string
HostPort
string
{
  • "<port/tcp|udp>": [
    ]
}

PortTypeEnum

string (PortTypeEnum)
Допустимые значения: "EMPTY" "tcp" "udp" "sctp"
"EMPTY"

Process

CreatedAt
required
string <date-time>

Дата создания.

required
object (ContainerInspectResponse)
AppArmorProfile
string or null
Args
Массив strings or null

Аргументы выполняемой команды.

object or null

Конфигурация контейнера, переносимая между хостами. В образе ContainerConfig — необязательное поле с конфигурацией последнего контейнера, зафиксированного при создании образа. Прежние версии сборщика Docker использовали поле ContainerConfig для хранения кэша сборки; сейчас оно активно не используется.

Created
string or null

Время создания контейнера.

Driver
string or null
ExecIDs
Массив strings or null

Идентификаторы экземпляров exec, работающих в контейнере.

object or null

Сведения о драйвере хранения файловой системы контейнера и образа.

object or null

Конфигурация контейнера, зависящая от хоста выполнения.

HostnamePath
string or null
HostsPath
string or null
Id
string or null

Идентификатор контейнера.

Image
string or null

Идентификатор образа контейнера.

LogPath
string or null
MountLabel
string or null
Массив objects or null (MountPoint)
Name
string or null
object or null

NetworkSettings предоставляет сетевые настройки в API.

Path
string or null

Путь выполняемой команды.

Platform
string or null
ProcessLabel
string or null
ResolvConfPath
string or null
RestartCount
integer or null <int64>
SizeRootFs
integer or null <int64>

Общий размер всех файлов контейнера.

SizeRw
integer or null <int64>

Размер файлов, созданных или изменённых контейнером.

object or null

ContainerState хранит состояние выполнения контейнера. Он входит в ContainerJSONBase и возвращается командой "inspect".

Key
required
string

Ключ процесса.

Kind
required
string (ProcessKind)
Допустимые значения: "vm" "job" "cargo"

Тип процесса (Vm, Job, Cargo).

KindKey
required
string

Ключ связанного типа.

Name
required
string

Имя процесса.

NodeKey
required
string

Ключ узла, на котором работает контейнер.

UpdatedAt
required
string <date-time>

Время последнего обновления экземпляра.

{
  • "Key": "string",
  • "CreatedAt": "2019-08-24T14:15:22Z",
  • "UpdatedAt": "2019-08-24T14:15:22Z",
  • "Name": "string",
  • "Kind": "vm",
  • "NodeKey": "string",
  • "KindKey": "string",
  • "Data": {
    }
}

ProcessConfig

arguments
Массив strings or null
entrypoint
string or null
privileged
boolean or null
tty
boolean or null
user
string or null
{
  • "privileged": true,
  • "user": "string",
  • "tty": true,
  • "entrypoint": "string",
  • "arguments": [
    ]
}

ProcessKind

string (ProcessKind)
Допустимые значения: "vm" "job" "cargo"

Тип процесса (Vm, Job, Cargo).

"vm"

ProcessStats

Name
required
string
required
object (Stats)

Статистика контейнера.

required
object (BlkioStats)

Статистика ввода-вывода контейнера.

required
object (CPUStats)

Общая статистика CPU контейнера.

id
string
required
object (MemoryStats)

Общая статистика памяти контейнера.

name
string
object or null

Статистика сети контейнера.

object or null
num_procs
required
integer <int32> >= 0
required
object (PidsStats)

Статистика идентификаторов процессов контейнера.

required
object (CPUStats)

Общая статистика CPU контейнера.

preread
required
string
read
required
string
required
object (StorageStats)

Статистика файлового ввода-вывода контейнера.

{
  • "Name": "string",
  • "Stats": {
    }
}

ProxyHttpLocation

AllowedIps
Массив strings or null

Разрешённый IP-адрес.

Headers
Массив strings or null

Дополнительные заголовки.

Path
required
string

Путь.

required
UpstreamTarget (object) or HttpTarget (object) or UnixTarget (object) (LocationTarget)
One of
DisableLogging
boolean or null

Отключить журналирование для этой цели.

Key
required
string

Ключ целевого Cargo или VM.

Path
string or null

Целевой путь HTTP при использовании HTTP.

Port
required
integer <int32> >= 0

Порт целевого Cargo или VM.

Version
number or null <double>

Используемая версия HTTP.

{
  • "Path": "string",
  • "Target": {
    },
  • "AllowedIps": [
    ],
  • "Headers": [
    ],
  • "Version": 0.1
}

ProxyRule

One of
Domain
string or null

Домен.

Includes
Массив strings or null

Путь к дополнительному файлу конфигурации для включения.

required
Массив objects (ProxyHttpLocation)

Locations для обработки нескольких путей.

Array
AllowedIps
Массив strings or null

Разрешённый IP-адрес.

Headers
Массив strings or null

Дополнительные заголовки.

Path
required
string

Путь.

required
UpstreamTarget (object) or HttpTarget (object) or UnixTarget (object) (LocationTarget)
Version
number or null <double>

Используемая версия HTTP.

Network
required
string

Тип: private | public | internal | namespace:$namespace_name.

(ProxySslConfig (object or null)) or (string or null)
One of
Certificate
required
string

Путь к сертификату.

CertificateClient
string or null

Путь к клиентскому сертификату.

CertificateKey
required
string

Путь к ключу сертификата.

Dhparam
string or null

Путь к файлу dhparam.

VerifyClient
boolean or null

Включить или отключить проверку клиента.

Example
{
  • "Domain": "string",
  • "Network": "string",
  • "Locations": [
    ],
  • "Ssl": {
    },
  • "Includes": [
    ]
}

ProxyRuleHttp

Domain
string or null

Домен.

Includes
Массив strings or null

Путь к дополнительному файлу конфигурации для включения.

required
Массив objects (ProxyHttpLocation)

Locations для обработки нескольких путей.

Array
AllowedIps
Массив strings or null

Разрешённый IP-адрес.

Headers
Массив strings or null

Дополнительные заголовки.

Path
required
string

Путь.

required
UpstreamTarget (object) or HttpTarget (object) or UnixTarget (object) (LocationTarget)
Version
number or null <double>

Используемая версия HTTP.

Network
required
string

Тип: private | public | internal | namespace:$namespace_name.

(ProxySslConfig (object or null)) or (string or null)
One of
Certificate
required
string

Путь к сертификату.

CertificateClient
string or null

Путь к клиентскому сертификату.

CertificateKey
required
string

Путь к ключу сертификата.

Dhparam
string or null

Путь к файлу dhparam.

VerifyClient
boolean or null

Включить или отключить проверку клиента.

{
  • "Domain": "string",
  • "Network": "string",
  • "Locations": [
    ],
  • "Ssl": {
    },
  • "Includes": [
    ]
}

ProxyRuleStream

Network
required
string

Тип сетевой привязки: private | public | internal | namespace:$namespace_name.

Port
required
integer <int32> >= 0

Порт, открываемый на узлах.

Protocol
required
string (ProxyStreamProtocol)
Допустимые значения: "Tcp" "Udp"

Режимы правил прокси.

(ProxySslConfig (object or null)) or (string or null)
One of
Certificate
required
string

Путь к сертификату.

CertificateClient
string or null

Путь к клиентскому сертификату.

CertificateKey
required
string

Путь к ключу сертификата.

Dhparam
string or null

Путь к файлу dhparam.

VerifyClient
boolean or null

Включить или отключить проверку клиента.

required
UpstreamTarget (object) or UriTarget (object) or UnixTarget (object) (StreamTarget)
One of
DisableLogging
boolean or null

Отключить журналирование для этой цели.

Key
required
string

Ключ целевого Cargo или VM.

Path
string or null

Целевой путь HTTP при использовании HTTP.

Port
required
integer <int32> >= 0

Порт целевого Cargo или VM.

{
  • "Network": "string",
  • "Protocol": "Tcp",
  • "Port": 0,
  • "Ssl": {
    },
  • "Target": {
    }
}

ProxySsl

One of
Certificate
required
string

Путь к сертификату.

CertificateClient
string or null

Путь к клиентскому сертификату.

CertificateKey
required
string

Путь к ключу сертификата.

Dhparam
string or null

Путь к файлу dhparam.

VerifyClient
boolean or null

Включить или отключить проверку клиента.

Example
{
  • "Certificate": "string",
  • "CertificateKey": "string",
  • "CertificateClient": "string",
  • "VerifyClient": true,
  • "Dhparam": "string"
}

ProxySslConfig

Certificate
required
string

Путь к сертификату.

CertificateClient
string or null

Путь к клиентскому сертификату.

CertificateKey
required
string

Путь к ключу сертификата.

Dhparam
string or null

Путь к файлу dhparam.

VerifyClient
boolean or null

Включить или отключить проверку клиента.

{
  • "Certificate": "string",
  • "CertificateKey": "string",
  • "CertificateClient": "string",
  • "VerifyClient": true,
  • "Dhparam": "string"
}

ProxyStreamProtocol

string (ProxyStreamProtocol)
Допустимые значения: "Tcp" "Udp"

Режимы правил прокси.

"Tcp"

RegistryServiceConfig

AllowNondistributableArtifactsCIDRs
Массив strings or null

Список диапазонов IP, в которые можно отправлять нераспространяемые артефакты, в формате CIDR RFC 4632. Некоторые образы, например базовые образы Windows, содержат артефакты, распространение которых ограничено лицензией. При отправке образа в реестр такие артефакты обычно не включаются. Эта конфигурация меняет поведение и позволяет демону отправлять их во все реестры, чьи IP-адреса, полученные при разрешении имён, входят в указанную подсеть CIDR. Параметр полезен для реестра в изолированной сети: хосты могут загрузить образы, не подключаясь к другому серверу. > Предупреждение: для нераспространяемых артефактов обычно ограничены способы и места распространения и совместного использования. Применяйте функцию только для частных реестров и соблюдайте все условия, регулирующие повторное распространение таких артефактов.

AllowNondistributableArtifactsHostnames
Массив strings or null

Список имён хостов реестров, в которые можно отправлять нераспространяемые артефакты, в формате <hostname>[:<port>] или <IP address>[:<port>]. Некоторые образы, например базовые образы Windows, содержат артефакты, распространение которых ограничено лицензией. При отправке образа в реестр такие артефакты обычно не включаются. Эта конфигурация меняет поведение для указанных реестров. Параметр полезен для реестра в изолированной сети: хосты могут загрузить образы, не подключаясь к другому серверу. > Предупреждение: для нераспространяемых артефактов обычно ограничены способы и места распространения и совместного использования. Применяйте функцию только для частных реестров и соблюдайте все условия, регулирующие повторное распространение таких артефактов.

object or null
additional property
object (IndexInfo)

IndexInfo содержит сведения о реестре.

InsecureRegistryCIDRs
Массив strings or null

Список диапазонов IP небезопасных реестров в формате CIDR (RFC 4632). Такие реестры допускают незашифрованные соединения HTTP и/или недоверенные соединения HTTPS с сертификатами неизвестных центров сертификации. По умолчанию локальные реестры (127.0.0.0/8) считаются небезопасными, а все остальные — безопасными. Если демон считает реестр безопасным, соединение с небезопасным реестром невозможно. Эта конфигурация изменяет поведение и разрешает небезопасные соединения с реестрами, чьи IP-адреса, полученные при разрешении имён, входят в указанную подсеть CIDR. Реестр также можно объявить небезопасным по имени хоста. Такие реестры перечислены в IndexConfigs, а их поле Secure имеет значение false. > Предупреждение: параметр полезен при локальном запуске реестра, но создаёт уязвимости. Используйте его ТОЛЬКО для тестирования. Для большей безопасности добавьте свой центр сертификации в список доверенных центров системы вместо включения этого параметра.

Mirrors
Массив strings or null

Список URL реестров, служащих зеркалами официального реестра (docker.io).

{
  • "AllowNondistributableArtifactsCIDRs": [
    ],
  • "AllowNondistributableArtifactsHostnames": [
    ],
  • "InsecureRegistryCIDRs": [
    ],
  • "IndexConfigs": {
    },
  • "Mirrors": [
    ]
}

ReplicationMode

One of
Mode
required
string
Значение: "Auto"
Example
{
  • "Mode": "Auto"
}

ReplicationStatic

Number
required
integer >= 0
{
  • "Number": 0
}

Resource

CreatedAt
required
string <date-time>

Дата создания ресурса.

Kind
required
string

Тип ресурса.

required
object (ResourceSpec)

Спецификация ресурса после создания в системе.

CreatedAt
required
string <date-time>

Дата создания ресурса.

required
object

Данные ресурса в виде объекта JSON.

Key
required
string <uuid>

Ключ ресурса.

object

Метаданные ресурса, заданные пользователем.

ResourceKey
required
string

Ключ ресурса, связанного с данными.

Version
required
string

Версия ресурса.

{
  • "Kind": "string",
  • "CreatedAt": "2019-08-24T14:15:22Z",
  • "Spec": {
    }
}

ResourceDnsRule

required
Массив objects (DnsEntry)
Array
IpAddress
required
string
Name
required
string
Network
required
string
{
  • "Network": "string",
  • "Entries": [
    ]
}

ResourceKind

CreatedAt
required
string <date-time>

Время создания типа.

required
object (ResourceKindSpec)

Спецификация типа ресурса. В зависимости от спецификации проверяется JSONSchema или вызывается служба.

object

JSONSchema ресурса данного типа и версии.

Url
string or null

Служба, вызываемая при создании, обновлении или удалении ресурса данного типа и версии.

Metadata
any or null

Время создания типа.

Name
required
string

Имя типа.

Version
required
string

Время создания типа.

{
  • "Name": "string",
  • "Version": "string",
  • "CreatedAt": "2019-08-24T14:15:22Z",
  • "Metadata": null,
  • "Data": {
    }
}

ResourceKindInspect

CreatedAt
required
string <date-time>

Время создания типа.

Name
required
string

Имя типа.

required
Массив objects (ResourceKindVersion)

Список доступных версий.

Array
CreatedAt
required
string <date-time>

Время создания версии.

required
object (ResourceKindSpec)

Спецификация типа ресурса. В зависимости от спецификации проверяется JSONSchema или вызывается служба.

Key
required
string <uuid>

Ключ версии.

KindKey
required
string

Тип, связанный с этой версией.

object

Метаданные, заданные пользователем.

Version
required
string

Версия.

{
  • "Name": "string",
  • "CreatedAt": "2019-08-24T14:15:22Z",
  • "Versions": [
    ]
}

ResourceKindPartial

required
object (ResourceKindSpec)

Спецификация типа ресурса. В зависимости от спецификации проверяется JSONSchema или вызывается служба.

object

JSONSchema ресурса данного типа и версии.

Url
string or null

Служба, вызываемая при создании, обновлении или удалении ресурса данного типа и версии.

object

Метаданные типа ресурса, заданные пользователем.

additional property
string or number or boolean or Массив Any (any) or object (Any)

Вспомогательный тип Any для OpenApi, полезный для динамических объектов JSON, например ResourceSpec.

Name
required
string

Имя типа ресурса.

Version
required
string

Версия типа ресурса.

{
  • "Name": "string",
  • "Version": "string",
  • "Metadata": {
    },
  • "Data": {
    }
}

ResourceKindSpec

object

JSONSchema ресурса данного типа и версии.

additional property
string or number or boolean or Массив Any (any) or object (Any)

Вспомогательный тип Any для OpenApi, полезный для динамических объектов JSON, например ResourceSpec.

Url
string or null

Служба, вызываемая при создании, обновлении или удалении ресурса данного типа и версии.

{
  • "Schema": {
    },
  • "Url": "string"
}

ResourceKindVersion

CreatedAt
required
string <date-time>

Время создания версии.

required
object (ResourceKindSpec)

Спецификация типа ресурса. В зависимости от спецификации проверяется JSONSchema или вызывается служба.

object

JSONSchema ресурса данного типа и версии.

Url
string or null

Служба, вызываемая при создании, обновлении или удалении ресурса данного типа и версии.

Key
required
string <uuid>

Ключ версии.

KindKey
required
string

Тип, связанный с этой версией.

object

Метаданные, заданные пользователем.

additional property
string or number or boolean or Массив Any (any) or object (Any)

Вспомогательный тип Any для OpenApi, полезный для динамических объектов JSON, например ResourceSpec.

Version
required
string

Версия.

{
  • "Key": "5eb041b0-19c9-4022-bd51-0e723885f5dd",
  • "CreatedAt": "2019-08-24T14:15:22Z",
  • "KindKey": "string",
  • "Version": "string",
  • "Metadata": {
    },
  • "Data": {
    }
}

ResourcePartial

required
object

Данные ресурса в виде объекта JSON.

additional property
string or number or boolean or Массив Any (any) or object (Any)

Вспомогательный тип Any для OpenApi, полезный для динамических объектов JSON, например ResourceSpec.

Kind
required
string

Тип ресурса.

object

Метаданные ресурса, заданные пользователем.

additional property
string or number or boolean or Массив Any (any) or object (Any)

Вспомогательный тип Any для OpenApi, полезный для динамических объектов JSON, например ResourceSpec.

Name
required
string

Имя ресурса.

{
  • "Name": "string",
  • "Kind": "string",
  • "Data": {
    },
  • "Metadata": {
    }
}

ResourceProxyRule

required
Массив ProxyRuleHttp (object) or ProxyRuleStream (object) (ProxyRule)

Применяемые правила.

Array
One of
Domain
string or null

Домен.

Includes
Массив strings or null

Путь к дополнительному файлу конфигурации для включения.

required
Массив objects (ProxyHttpLocation)

Locations для обработки нескольких путей.

Network
required
string

Тип: private | public | internal | namespace:$namespace_name.

(ProxySslConfig (object or null)) or (string or null)
{
  • "Rules": [
    ]
}

ResourceSpec

CreatedAt
required
string <date-time>

Дата создания ресурса.

required
object

Данные ресурса в виде объекта JSON.

additional property
string or number or boolean or Массив Any (any) or object (Any)

Вспомогательный тип Any для OpenApi, полезный для динамических объектов JSON, например ResourceSpec.

Key
required
string <uuid>

Ключ ресурса.

object

Метаданные ресурса, заданные пользователем.

additional property
string or number or boolean or Массив Any (any) or object (Any)

Вспомогательный тип Any для OpenApi, полезный для динамических объектов JSON, например ResourceSpec.

ResourceKey
required
string

Ключ ресурса, связанного с данными.

Version
required
string

Версия ресурса.

{
  • "Key": "5eb041b0-19c9-4022-bd51-0e723885f5dd",
  • "Version": "string",
  • "CreatedAt": "2019-08-24T14:15:22Z",
  • "ResourceKey": "string",
  • "Data": {
    },
  • "Metadata": {
    }
}

ResourceUpdate

required
object

Спецификация ресурса в виде объекта JSON.

additional property
string or number or boolean or Массив Any (any) or object (Any)

Вспомогательный тип Any для OpenApi, полезный для динамических объектов JSON, например ResourceSpec.

object

Метаданные ресурса в виде объекта JSON.

additional property
string or number or boolean or Массив Any (any) or object (Any)

Вспомогательный тип Any для OpenApi, полезный для динамических объектов JSON, например ResourceSpec.

{
  • "Data": {
    },
  • "Metadata": {
    }
}

ResourcesBlkioWeightDevice

Path
string or null
Weight
integer or null >= 0
{
  • "Path": "string",
  • "Weight": 0
}

ResourcesUlimits

Hard
integer or null <int64>

Жёсткое ограничение.

Name
string or null

Имя ulimit.

Soft
integer or null <int64>

Мягкое ограничение.

{
  • "Name": "string",
  • "Soft": 0,
  • "Hard": 0
}

RestartPolicy

MaximumRetryCount
integer or null <int64>

Если используется on-failure, число повторных попыток до отказа.

Name
string or null
Допустимые значения: "EMPTY" "no" "always" "unless-stopped" "on-failure"
{
  • "Name": "EMPTY",
  • "MaximumRetryCount": 0
}

RestartPolicyNameEnum

string (RestartPolicyNameEnum)
Допустимые значения: "EMPTY" "no" "always" "unless-stopped" "on-failure"
"EMPTY"

Runtime

path
string or null

Имя и необязательный путь исполняемого файла OCI. Если путь отсутствует, демон ищет файл в $PATH хоста и использует первый результат.

runtimeArgs
Массив strings or null

Список аргументов командной строки, передаваемых среде выполнения при вызове.

object or null

Сведения среды выполнения. Эта спецификация API не определяет данные сред выполнения, но они могут предоставлять следующие известные свойства: org.opencontainers.runtime-spec.features — структура возможностей из спецификации OCI Runtime, представленная строкой JSON.


> Примечание: сведения в этом поле, включая формат значений и меток, не следует считать стабильными; они могут измениться без уведомления.

property name*
additional property
string
{
  • "path": "string",
  • "runtimeArgs": [
    ],
  • "status": {
    }
}

Secret

CreatedAt
required
string <date-time>

Дата создания.

required
object

Данные секрета.

additional property
string or number or boolean or Массив Any (any) or object (Any)

Вспомогательный тип Any для OpenApi, полезный для динамических объектов JSON, например ResourceSpec.

Immutable
required
boolean

Секрет нельзя обновить.

Kind
required
string

Тип секрета.

object
additional property
string or number or boolean or Массив Any (any) or object (Any)

Вспомогательный тип Any для OpenApi, полезный для динамических объектов JSON, например ResourceSpec.

Name
required
string

Имя секрета.

UpdatedAt
required
string <date-time>

Дата последнего обновления.

{
  • "Name": "string",
  • "CreatedAt": "2019-08-24T14:15:22Z",
  • "UpdatedAt": "2019-08-24T14:15:22Z",
  • "Kind": "string",
  • "Immutable": true,
  • "Metadata": {
    },
  • "Data": {
    }
}

SecretPartial

required
object

Данные секрета.

additional property
string or number or boolean or Массив Any (any) or object (Any)

Вспомогательный тип Any для OpenApi, полезный для динамических объектов JSON, например ResourceSpec.

Immutable
boolean or null

Секрет нельзя обновить.

Kind
required
string

Тип секрета.

object

Метаданные ресурса, заданные пользователем.

additional property
string or number or boolean or Массив Any (any) or object (Any)

Вспомогательный тип Any для OpenApi, полезный для динамических объектов JSON, например ResourceSpec.

Name
required
string

Имя секрета.

{
  • "Name": "string",
  • "Kind": "string",
  • "Immutable": true,
  • "Metadata": {
    },
  • "Data": {
    }
}

SecretUpdate

required
object

Данные секрета в виде объекта JSON.

additional property
string or number or boolean or Массив Any (any) or object (Any)

Вспомогательный тип Any для OpenApi, полезный для динамических объектов JSON, например ResourceSpec.

object

Метаданные секрета, заданные пользователем.

additional property
string or number or boolean or Массив Any (any) or object (Any)

Вспомогательный тип Any для OpenApi, полезный для динамических объектов JSON, например ResourceSpec.

{
  • "Metadata": {
    },
  • "Data": {
    }
}

SslConfig

Cert
string or null
CertCa
string or null
CertKey
string or null
{
  • "Cert": "string",
  • "CertKey": "string",
  • "CertCa": "string"
}

StartExecOptions

Detach
required
boolean

Отключиться от команды.

OutputCapacity
integer or null >= 0

Максимальный размер строки вывода. По умолчанию 8 * 1024, приблизительно 1024 символа.

Tty
required
boolean

Выделить псевдо-TTY.

{
  • "Detach": true,
  • "Tty": true,
  • "OutputCapacity": 0
}

Statefile

ApiVersion
required
string

Используемая версия API или удалённый URL.

Массив objects or null (StatefileArg)

Аргументы, передаваемые в Statefile.

Array
Default
string or null

Значение аргумента сборки по умолчанию.

Kind
required
string (StatefileArgKind)
Допустимые значения: "String" "Number" "Boolean"

Определение аргумента, передаваемого в Statefile.

Name
required
string

Имя аргумента сборки.

Массив objects or null (CargoSpecPartial)

Список Cargo для создания и запуска.

Array
required
object (Config)

Создаваемый контейнер.

ImagePullPolicy
string or null
Допустимые значения: "Never" "Always" "IfNotPresent"

Политика загрузки образов объектов процессов (job, cargo, vm).

ImagePullSecret
string or null

Секрет для загрузки образа.

object or null

Создаваемый контейнер.

object

Метаданные Cargo, заданные пользователем.

Name
required
string

Имя Cargo.

(Auto (object or null)) or (Unique (object or null)) or (UniqueByNode (object or null)) or (UniqueByNodeGroups (object or null)) or (UniqueByNodeNames (object or null)) or (Static (object or null)) or (StaticByNodes (object or null)) or (StaticByNodeGroups (object or null)) or (StaticByNodeNames (object or null))

Auto автоматически задаёт число реплик в кластере. Number позволяет задавать число реплик вручную. Примечание: auto гарантирует наличие хотя бы одной реплики в кластере.

Поле дискриминатора: Mode.

Secrets
Массив strings or null

Список секретов, используемых как переменные окружения.

Group
string or null

Задать группу определённых объектов; по умолчанию {name_of_directory}.{name_of_file}.

Массив objects or null (JobPartial)

Список заданий для создания и запуска.

Array
required
Массив objects (Config)

Список запускаемых контейнеров.

ImagePullPolicy
string or null
Допустимые значения: "Never" "Always" "IfNotPresent"

Политика загрузки образов объектов процессов (job, cargo, vm).

ImagePullSecret
string or null

Секрет для загрузки образа.

object

Метаданные, заданные пользователем.

Name
required
string

Имя задания.

Schedule
string or null

Расписание задания (cron).

Secrets
Массив strings or null

Секреты, загружаемые как переменные окружения.

Ttl
integer or null >= 0

Удалить задание через (x) секунд после выполнения.

Namespace
string or null

Пространство имён, в котором развёрнуты Cargo и виртуальные машины.

Массив objects or null (ResourcePartial)

Список создаваемых ресурсов.

Array
required
object

Данные ресурса в виде объекта JSON.

Kind
required
string

Тип ресурса.

object

Метаданные ресурса, заданные пользователем.

Name
required
string

Имя ресурса.

Массив objects or null (SecretPartial)

Список создаваемых секретов.

Array
required
object

Данные секрета.

Immutable
boolean or null

Секрет нельзя обновить.

Kind
required
string

Тип секрета.

object

Метаданные ресурса, заданные пользователем.

Name
required
string

Имя секрета.

Массив strings or SubStateDef (object) or null (SubState)

Включить вложенные состояния, применяемые перед текущим состоянием.

Array
One of
string
Массив objects or null (VmSpecPartial)

Список виртуальных машин для создания и запуска.

Array
required
object (VmDisk)

Дисковое представление VM.

object or null

Ресурсы VM: процессор, память и сеть.

Hostname
string or null

Имя хоста VM; по умолчанию создаётся из имени.

object or null

Метаданные ключ/значение, заданные пользователем.

MacAddress
string or null

MAC-адрес VM; по умолчанию создаётся автоматически.

object

Метаданные, заданные пользователем.

Name
required
string

Имя VM.

Password
string or null

Пароль VM по умолчанию: cloud.

SshKey
string or null

Открытый ключ SSH пользователя по умолчанию; рекомендуется.

User
string or null

Пользователь VM по умолчанию: cloud.

{
  • "ApiVersion": "string",
  • "Args": [
    ],
  • "SubStates": [
    ],
  • "Group": "string",
  • "Namespace": "string",
  • "Secrets": [
    ],
  • "Resources": [
    ],
  • "Cargoes": [
    ],
  • "VirtualMachines": [
    ],
  • "Jobs": [
    ]
}

StatefileArg

Default
string or null

Значение аргумента сборки по умолчанию.

Kind
required
string (StatefileArgKind)
Допустимые значения: "String" "Number" "Boolean"

Определение аргумента, передаваемого в Statefile.

Name
required
string

Имя аргумента сборки.

{
  • "Name": "string",
  • "Kind": "String",
  • "Default": "string"
}

StatefileArgKind

string (StatefileArgKind)
Допустимые значения: "String" "Number" "Boolean"

Определение аргумента, передаваемого в Statefile.

"String"

Stats

required
object (BlkioStats)

Статистика ввода-вывода контейнера.

Массив objects or null (BlkioStatsEntry)
Массив objects or null (BlkioStatsEntry)
Массив objects or null (BlkioStatsEntry)
Массив objects or null (BlkioStatsEntry)
Массив objects or null (BlkioStatsEntry)
Массив objects or null (BlkioStatsEntry)
Массив objects or null (BlkioStatsEntry)
Массив objects or null (BlkioStatsEntry)
required
object (CPUStats)

Общая статистика CPU контейнера.

required
object (CPUUsage)

Статистика использования CPU контейнером.

online_cpus
integer or null <int64> >= 0
system_cpu_usage
integer or null <int64> >= 0
required
object (ThrottlingData)

Статистика ограничения CPU.

id
string
required
object (MemoryStats)

Общая статистика памяти контейнера.

commit
integer or null <int64> >= 0
commit_peak
integer or null <int64> >= 0
commitbytes
integer or null <int64> >= 0
commitpeakbytes
integer or null <int64> >= 0
failcnt
integer or null <int64> >= 0
limit
integer or null <int64> >= 0
max_usage
integer or null <int64> >= 0
privateworkingset
integer or null <int64> >= 0
(MemoryStatsStatsV1 (object or null)) or (MemoryStatsStatsV2 (object or null))

Подробная статистика памяти контейнера.

usage
integer or null <int64> >= 0
name
string
object or null

Статистика сети контейнера.

rx_bytes
required
integer <int64> >= 0
rx_dropped
required
integer <int64> >= 0
rx_errors
required
integer <int64> >= 0
rx_packets
required
integer <int64> >= 0
tx_bytes
required
integer <int64> >= 0
tx_dropped
required
integer <int64> >= 0
tx_errors
required
integer <int64> >= 0
tx_packets
required
integer <int64> >= 0
object or null
additional property
object (NetworkStats)

Статистика сети контейнера.

num_procs
required
integer <int32> >= 0
required
object (PidsStats)

Статистика идентификаторов процессов контейнера.

current
integer or null <int64> >= 0
limit
integer or null <int64> >= 0
required
object (CPUStats)

Общая статистика CPU контейнера.

required
object (CPUUsage)

Статистика использования CPU контейнером.

online_cpus
integer or null <int64> >= 0
system_cpu_usage
integer or null <int64> >= 0
required
object (ThrottlingData)

Статистика ограничения CPU.

preread
required
string
read
required
string
required
object (StorageStats)

Статистика файлового ввода-вывода контейнера.

read_count_normalized
integer or null <int64> >= 0
read_size_bytes
integer or null <int64> >= 0
write_count_normalized
integer or null <int64> >= 0
write_size_bytes
integer or null <int64> >= 0
{
  • "read": "string",
  • "preread": "string",
  • "num_procs": 0,
  • "pids_stats": {
    },
  • "network": {
    },
  • "networks": {
    },
  • "memory_stats": {
    },
  • "blkio_stats": {
    },
  • "cpu_stats": {
    },
  • "precpu_stats": {
    },
  • "storage_stats": {
    },
  • "name": "string",
  • "id": "string"
}

StorageStats

read_count_normalized
integer or null <int64> >= 0
read_size_bytes
integer or null <int64> >= 0
write_count_normalized
integer or null <int64> >= 0
write_size_bytes
integer or null <int64> >= 0
{
  • "read_count_normalized": 0,
  • "read_size_bytes": 0,
  • "write_count_normalized": 0,
  • "write_size_bytes": 0
}

StreamTarget

One of
DisableLogging
boolean or null

Отключить журналирование для этой цели.

Key
required
string

Ключ целевого Cargo или VM.

Path
string or null

Целевой путь HTTP при использовании HTTP.

Port
required
integer <int32> >= 0

Порт целевого Cargo или VM.

Example
{
  • "Key": "string",
  • "Port": 0,
  • "Path": "string",
  • "DisableLogging": true
}

SubState

One of
string
Example
"string"

SubStateArg

Name
required
string

Имя аргумента.

required
number or string or boolean (SubStateValue)

Определение аргумента, передаваемого в Statefile.

One of
number <double>

Определение аргумента, передаваемого в Statefile.

{
  • "Name": "string",
  • "Value": 0.1
}

SubStateDef

Массив objects or null (SubStateArg)
Array
Name
required
string

Имя аргумента.

required
number or string or boolean (SubStateValue)

Определение аргумента, передаваемого в Statefile.

Path
required
string
{
  • "Path": "string",
  • "Args": [
    ]
}

SubStateValue

One of
number <double>

Определение аргумента, передаваемого в Statefile.

true

SwarmInfo

object or null

ClusterInfo — сведения о swarm, возвращаемые конечной точкой "/info". Токены присоединения не включены.

CreatedAt
string or null (BollardDate)

BollardDate

DataPathPort
integer or null <int32> >= 0

DataPathPort задаёт номер порта для передачи данных. Допустимый диапазон — от 1024 до 49151. Если порт не задан или равен 0, используется порт по умолчанию (4789).

DefaultAddrPool
Массив strings or null

Default Address Pool задаёт пулы подсетей по умолчанию для сетей глобальной области.

ID
string or null

Идентификатор swarm.

RootRotationInProgress
boolean or null

Показывает, выполняется ли сейчас ротация корневого центра сертификации swarm.

object or null

Конфигурация swarm, изменяемая пользователем.

SubnetSize
integer or null <int32> >= 0

SubnetSize задаёт размер подсетей, создаваемых из пула подсетей по умолчанию.

object or null

Сведения об издателе конечных сертификатов TLS и доверенном корневом сертификате центра сертификации.

UpdatedAt
string or null (BollardDate)

BollardDate

object or null

Номер версии объекта, например узла или службы. Он необходим для предотвращения конфликтующих записей. При обновлении клиент должен передать номер версии вместе с изменённой спецификацией. Это обеспечивает безопасную и детерминированную конкурентность: изменение может не примениться, если версия изменилась с последнего чтения. Если два запроса указывают одну исходную версию, успешно выполниться может только один. Поэтому два одновременных запроса обновления не смогут непреднамеренно перезаписать друг друга.

ControlAvailable
boolean or null
Error
string or null
LocalNodeState
string or null
Допустимые значения: "EMPTY" "inactive" "pending" "active" "error" "locked"

Текущее локальное состояние узла. Перечисление значений. Варианты перечисления не содержат данных, поэтому их можно определить как #[repr(C)], что упрощает работу с FFI.

Managers
integer or null <int64>

Общее число управляющих узлов swarm.

NodeAddr
string or null

IP-адрес, по которому другие узлы swarm могут обратиться к этому узлу.

NodeID
string or null

Уникальный идентификатор узла в swarm.

Nodes
integer or null <int64>

Общее число узлов swarm.

Массив objects or null (PeerNode)

Список идентификаторов и адресов других управляющих узлов swarm.

Array
Addr
string or null

IP-адрес и порты, по которым доступен узел.

NodeID
string or null

Уникальный идентификатор узла в swarm.

{
  • "NodeID": "string",
  • "NodeAddr": "string",
  • "LocalNodeState": "EMPTY",
  • "ControlAvailable": true,
  • "Error": "string",
  • "RemoteManagers": [
    ],
  • "Nodes": 0,
  • "Managers": 0,
  • "Cluster": {
    }
}

SwarmSpec

object or null

Конфигурация центра сертификации.

Массив objects or null (SwarmSpecCaConfigExternalCas)

Конфигурация передачи запросов подписи внешнему центру сертификации.

ForceRotate
integer or null <int64> >= 0

Целое число, заставляющее swarm создать новый сертификат и ключ подписывающего центра сертификации, если они не заданы в SigningCACert и SigningCAKey.

NodeCertExpiry
integer or null <int64>

Срок действия выдаваемых сертификатов узлов.

SigningCACert
string or null

Желаемый сертификат подписывающего центра сертификации для всех конечных сертификатов TLS узлов swarm, в формате PEM.

SigningCAKey
string or null

Желаемый ключ подписывающего центра сертификации для всех конечных сертификатов TLS узлов swarm, в формате PEM.

object or null

Конфигурация диспетчера.

HeartbeatPeriod
integer or null <int64>

Интервал отправки агентом сигнала присутствия диспетчеру.

object or null

Параметры шифрования хранимых данных.

AutoLockManagers
boolean or null

Если задано, создать ключ и использовать его для блокировки данных на управляющих узлах.

object or null

Метаданные ключ/значение, заданные пользователем.

property name*
additional property
string
Name
string or null

Имя swarm.

object or null

Конфигурация оркестрации.

TaskHistoryRetentionLimit
integer or null <int64>

Число исторических задач, сохраняемых для экземпляра или узла. При отрицательном значении завершённые или неудачные задачи никогда не удаляются.

object or null

Конфигурация Raft.

ElectionTick
integer or null <int64>

Число тактов, в течение которых последователь ждёт сообщения лидера, прежде чем стать кандидатом и начать выборы. ElectionTick должно быть больше HeartbeatTick. Сейчас такт по умолчанию равен одной секунде, поэтому значения соответствуют секундам, но это НЕ гарантировано.

HeartbeatTick
integer or null <int64>

Число тактов между сигналами присутствия. Лидер отправляет сигнал последователям каждые HeartbeatTick тактов. Сейчас такт по умолчанию равен одной секунде, поэтому значения соответствуют секундам, но это НЕ гарантировано.

KeepOldSnapshots
integer or null <int64> >= 0

Число снимков, сохраняемых помимо текущего.

LogEntriesForSlowFollowers
integer or null <int64> >= 0

Число записей журнала, сохраняемых для синхронизации медленных последователей после создания снимка.

SnapshotInterval
integer or null <int64> >= 0

Число записей журнала между снимками.

object or null

Настройки по умолчанию для создания задач в кластере.

object or null

Драйвер журналирования задач, создаваемых оркестратором, если служба не указала другой. Обновление влияет только на новые задачи. Существующие задачи продолжают использовать ранее настроенный драйвер до пересоздания.

{
  • "Name": "string",
  • "Labels": {
    },
  • "Orchestration": {
    },
  • "Raft": {
    },
  • "Dispatcher": {
    },
  • "CAConfig": {
    },
  • "EncryptionConfig": {
    },
  • "TaskDefaults": {
    }
}

SwarmSpecCaConfig

Массив objects or null (SwarmSpecCaConfigExternalCas)

Конфигурация передачи запросов подписи внешнему центру сертификации.

Array
CACert
string or null

Корневой сертификат центра сертификации в формате PEM, используемый этим внешним центром для выдачи сертификатов TLS. Если не задан, предполагается текущий корневой сертификат swarm.

object or null

Объект с парами ключ/значение, которые драйвер внешнего центра сертификации интерпретирует как параметры протокола.

Protocol
string or null
Допустимые значения: "EMPTY" "cfssl"
URL
string or null

URL для отправки запросов подписи сертификатов.

ForceRotate
integer or null <int64> >= 0

Целое число, заставляющее swarm создать новый сертификат и ключ подписывающего центра сертификации, если они не заданы в SigningCACert и SigningCAKey.

NodeCertExpiry
integer or null <int64>

Срок действия выдаваемых сертификатов узлов.

SigningCACert
string or null

Желаемый сертификат подписывающего центра сертификации для всех конечных сертификатов TLS узлов swarm, в формате PEM.

SigningCAKey
string or null

Желаемый ключ подписывающего центра сертификации для всех конечных сертификатов TLS узлов swarm, в формате PEM.

{
  • "NodeCertExpiry": 0,
  • "ExternalCAs": [
    ],
  • "SigningCACert": "string",
  • "SigningCAKey": "string",
  • "ForceRotate": 0
}

SwarmSpecCaConfigExternalCas

CACert
string or null

Корневой сертификат центра сертификации в формате PEM, используемый этим внешним центром для выдачи сертификатов TLS. Если не задан, предполагается текущий корневой сертификат swarm.

object or null

Объект с парами ключ/значение, которые драйвер внешнего центра сертификации интерпретирует как параметры протокола.

property name*
additional property
string
Protocol
string or null
Допустимые значения: "EMPTY" "cfssl"
URL
string or null

URL для отправки запросов подписи сертификатов.

{
  • "Protocol": "EMPTY",
  • "URL": "string",
  • "Options": {
    },
  • "CACert": "string"
}

SwarmSpecCaConfigExternalCasProtocolEnum

string (SwarmSpecCaConfigExternalCasProtocolEnum)
Допустимые значения: "EMPTY" "cfssl"
"EMPTY"

SwarmSpecDispatcher

HeartbeatPeriod
integer or null <int64>

Интервал отправки агентом сигнала присутствия диспетчеру.

{
  • "HeartbeatPeriod": 0
}

SwarmSpecEncryptionConfig

AutoLockManagers
boolean or null

Если задано, создать ключ и использовать его для блокировки данных на управляющих узлах.

{
  • "AutoLockManagers": true
}

SwarmSpecOrchestration

TaskHistoryRetentionLimit
integer or null <int64>

Число исторических задач, сохраняемых для экземпляра или узла. При отрицательном значении завершённые или неудачные задачи никогда не удаляются.

{
  • "TaskHistoryRetentionLimit": 0
}

SwarmSpecRaft

ElectionTick
integer or null <int64>

Число тактов, в течение которых последователь ждёт сообщения лидера, прежде чем стать кандидатом и начать выборы. ElectionTick должно быть больше HeartbeatTick. Сейчас такт по умолчанию равен одной секунде, поэтому значения соответствуют секундам, но это НЕ гарантировано.

HeartbeatTick
integer or null <int64>

Число тактов между сигналами присутствия. Лидер отправляет сигнал последователям каждые HeartbeatTick тактов. Сейчас такт по умолчанию равен одной секунде, поэтому значения соответствуют секундам, но это НЕ гарантировано.

KeepOldSnapshots
integer or null <int64> >= 0

Число снимков, сохраняемых помимо текущего.

LogEntriesForSlowFollowers
integer or null <int64> >= 0

Число записей журнала, сохраняемых для синхронизации медленных последователей после создания снимка.

SnapshotInterval
integer or null <int64> >= 0

Число записей журнала между снимками.

{
  • "SnapshotInterval": 0,
  • "KeepOldSnapshots": 0,
  • "LogEntriesForSlowFollowers": 0,
  • "ElectionTick": 0,
  • "HeartbeatTick": 0
}

SwarmSpecTaskDefaults

object or null

Драйвер журналирования задач, создаваемых оркестратором, если служба не указала другой. Обновление влияет только на новые задачи. Существующие задачи продолжают использовать ранее настроенный драйвер до пересоздания.

Name
string or null

Драйвер журналирования по умолчанию для новых задач.

object or null

Параметры выбранного драйвера журналирования в виде пар ключ/значение.

{
  • "LogDriver": {
    }
}

SwarmSpecTaskDefaultsLogDriver

Name
string or null

Драйвер журналирования по умолчанию для новых задач.

object or null

Параметры выбранного драйвера журналирования в виде пар ключ/значение.

property name*
additional property
string
{
  • "Name": "string",
  • "Options": {
    }
}

SystemInfo

Architecture
string or null

Аппаратная архитектура хоста, возвращаемая средой Go (GOARCH). Полный список значений приведён в документации Go.

BridgeNfIp6tables
boolean or null

Показывает, доступен ли bridge-nf-call-ip6tables на хосте.

BridgeNfIptables
boolean or null

Показывает, доступен ли bridge-nf-call-iptables на хосте.

CDISpecDirs
Массив strings or null

Список каталогов со спецификациями CDI (Container Device Interface). Они определяют изменения спецификации OCI создаваемого контейнера для конкретного поставщика. Пустой список означает, что внедрение устройств CDI отключено. Для него требуется экспериментальный режим демона. Неэкспериментальные демоны всегда возвращают пустой список.

CgroupDriver
string or null
Допустимые значения: "EMPTY" "cgroupfs" "systemd" "none"
CgroupVersion
string or null
Допустимые значения: "EMPTY" "1" "2"
object or null

Commit содержит Git-коммит (SHA1), из которого собран двоичный файл, указанный в строке версии внешних инструментов, например containerd или runC.

Expected
string or null

Идентификатор коммита внешнего инструмента, ожидаемый dockerd и заданный при сборке.

ID
string or null

Фактический идентификатор коммита внешнего инструмента.

Containers
integer or null <int64>

Общее число контейнеров на хосте.

ContainersPaused
integer or null <int64>

Число контейнеров со статусом \"paused\".

ContainersRunning
integer or null <int64>

Число контейнеров со статусом \"running\".

ContainersStopped
integer or null <int64>

Число контейнеров со статусом \"stopped\".

CpuCfsPeriod
boolean or null

Показывает, поддерживает ли хост период CPU CFS (Completely Fair Scheduler).

CpuCfsQuota
boolean or null

Показывает, поддерживает ли хост квоту CPU CFS (Completely Fair Scheduler).

CPUSet
boolean or null

Показывает, поддерживает ли хост CPUsets (cpuset.cpus, cpuset.mems). См. cpuset(7).

CPUShares
boolean or null

Показывает, поддерживает ли хост ограничение долей CPU.

Debug
boolean or null

Показывает, работает ли демон в режиме отладки с уровнем журналирования debug.

Массив objects or null (SystemInfoDefaultAddressPools)

Список пользовательских пулов адресов по умолчанию для локальных сетей, задаваемых в daemon.json или параметром dockerd. Например, Base "10.10.0.0/16" с Size 24 задаёт 256 пулов адресов 10.10.[0-255].0/24.

Array
Base
string or null

Адрес сети в формате CIDR.

Size
integer or null <int64>

Размер пула сети.

DefaultRuntime
string or null

Имя среды выполнения OCI по умолчанию, используемой при запуске контейнеров. Его можно переопределить для конкретного контейнера при создании.

DockerRootDir
string or null

Корневой каталог постоянного состояния Docker. По умолчанию /var/lib/docker в Linux и C:\\ProgramData\\docker в Windows.

Driver
string or null

Имя используемого драйвера хранения.

DriverStatus
Массив strings or null[ items ]

Сведения драйвера хранения в виде пар "label" / "value". Драйвер предоставляет их в формате, согласованном с выводом docker info в командной строке.


> Примечание: сведения в этом поле, включая формат значений и меток, не следует считать стабильными; они могут измениться без уведомления.

ExperimentalBuild
boolean or null

Показывает, включены ли экспериментальные функции демона.

object or null
object or null
object or null
HttpProxy
string or null

HTTP-прокси демона. Значение берётся из переменной окружения HTTP_PROXY. Учётные данные в компоненте сведений о пользователе URL прокси маскируются в ответе API. Контейнеры не наследуют эту конфигурацию автоматически.

HttpsProxy
string or null

HTTPS-прокси демона. Значение берётся из переменной окружения HTTPS_PROXY. Учётные данные в компоненте сведений о пользователе URL прокси маскируются в ответе API. Контейнеры не наследуют эту конфигурацию автоматически.

ID
string or null

Уникальный идентификатор демона.


> Примечание: формат идентификатора не является частью API и не должен считаться стабильным.

Images
integer or null <int64>

Общее число образов на хосте. Учитываются образы с тегами и без тегов, включая висячие образы.

IndexServerAddress
string or null

Адрес или URL сервера индекса, используемого для поиска образов и по умолчанию для аутентификации пользователей в Docker Hub и Docker Cloud.

InitBinary
string or null

Имя и необязательный путь двоичного файла docker-init. Если путь отсутствует, демон ищет файл в $PATH хоста и использует первый результат.

object or null

Commit содержит Git-коммит (SHA1), из которого собран двоичный файл, указанный в строке версии внешних инструментов, например containerd или runC.

Expected
string or null

Идентификатор коммита внешнего инструмента, ожидаемый dockerd и заданный при сборке.

ID
string or null

Фактический идентификатор коммита внешнего инструмента.

IPv4Forwarding
boolean or null

Показывает, включена ли пересылка IPv4.

Isolation
string or null
Допустимые значения: "EMPTY" "default" "hyperv" "process"
KernelMemoryTCP
boolean or null

Показывает, поддерживает ли хост ограничение TCP-памяти ядра. Поле отсутствует, если ограничение не поддерживается. Ограничения TCP-памяти ядра недоступны с cgroups v2, где нет соответствующего cgroup memory.kmem.tcp.limit_in_bytes.

KernelVersion
string or null

Версия ядра хоста. В Linux сведения получаются из uname. В Windows они читаются из значения реестра HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion\\, например "10.0 14393 (14393.1198.amd64fre.rs1_release_sec.170427-1353)".

Labels
Массив strings or null

Пользовательские метки демона в виде метаданных ключ/значение.


> Примечание: в Swarm узлы могут иметь метки демона, заданные его конфигурацией, и метки узла, заданные управляющим узлом Swarm. Метки узла в это поле не включены. Их можно получить конечной точкой /nodes/(id) на управляющем узле Swarm.

LiveRestoreEnabled
boolean or null

Показывает, включён ли live restore. Если включён, контейнеры продолжают работать при остановке демона, а также при его запуске, если обнаружены работающие контейнеры.

LoggingDriver
string or null

Драйвер журналирования по умолчанию для новых контейнеров.

MemoryLimit
boolean or null

Показывает, поддерживает ли хост ограничения памяти.

MemTotal
integer or null <int64>

Общий объём физической памяти хоста в байтах.

Name
string or null

Имя хоста.

NCPU
integer or null <int64>

Число логических CPU, доступных демону. Оно определяется запросом к операционной системе при запуске демона. Изменения распределения CPU после запуска не отражаются.

NEventsListener
integer or null <int64>

Число подписанных слушателей событий.

NFd
integer or null <int64>

Общее число файловых дескрипторов, используемых процессом демона. Сведения возвращаются только в режиме отладки.

NGoroutines
integer or null <int64>

Текущее число goroutines. Сведения возвращаются только в режиме отладки.

NoProxy
string or null

Разделённый запятыми список расширений доменов, для которых прокси не используется. Значение берётся из переменной окружения NO_PROXY. Контейнеры не наследуют эту конфигурацию автоматически.

OomKillDisable
boolean or null

Показывает, поддерживается ли отключение OOM killer на хосте.

OperatingSystem
string or null

Имя операционной системы хоста, например "Ubuntu 16.04.2 LTS" или "Windows Server 2016 Datacenter".

OSType
string or null

Тип операционной системы хоста, возвращаемый средой Go (GOOS). Сейчас возвращаются значения "linux" и "windows". Полный список возможных значений приведён в документации Go.

OSVersion
string or null

Версия операционной системы хоста.


> Примечание: сведения в этом поле, включая само его наличие и формат значений, не следует считать стабильными; они могут измениться без уведомления.

PidsLimit
boolean or null

Показывает, поддерживает ли ядро хоста ограничение PID.

object or null

Доступные плагины по типам.


> Примечание: список включает только неуправляемые плагины (V1). > Плагины V1 загружаются по требованию и не отображаются здесь, > если ни один ресурс не использует плагин.

Authorization
Массив strings or null

Имена доступных плагинов авторизации.

Log
Массив strings or null

Имена доступных драйверов и плагинов журналирования.

Network
Массив strings or null

Имена доступных драйверов и плагинов сети.

Volume
Массив strings or null

Имена доступных драйверов томов и плагинов сети.

ProductLicense
string or null

Краткие сведения о лицензии продукта на демоне. Если применена коммерческая лицензия, включаются такие сведения, как число узлов и срок действия.

object or null

RegistryServiceConfig хранит конфигурацию служб реестров демона.

AllowNondistributableArtifactsCIDRs
Массив strings or null

Список диапазонов IP, в которые можно отправлять нераспространяемые артефакты, в формате CIDR RFC 4632. Некоторые образы, например базовые образы Windows, содержат артефакты, распространение которых ограничено лицензией. При отправке образа в реестр такие артефакты обычно не включаются. Эта конфигурация меняет поведение и позволяет демону отправлять их во все реестры, чьи IP-адреса, полученные при разрешении имён, входят в указанную подсеть CIDR. Параметр полезен для реестра в изолированной сети: хосты могут загрузить образы, не подключаясь к другому серверу. > Предупреждение: для нераспространяемых артефактов обычно ограничены способы и места распространения и совместного использования. Применяйте функцию только для частных реестров и соблюдайте все условия, регулирующие повторное распространение таких артефактов.

AllowNondistributableArtifactsHostnames
Массив strings or null

Список имён хостов реестров, в которые можно отправлять нераспространяемые артефакты, в формате <hostname>[:<port>] или <IP address>[:<port>]. Некоторые образы, например базовые образы Windows, содержат артефакты, распространение которых ограничено лицензией. При отправке образа в реестр такие артефакты обычно не включаются. Эта конфигурация меняет поведение для указанных реестров. Параметр полезен для реестра в изолированной сети: хосты могут загрузить образы, не подключаясь к другому серверу. > Предупреждение: для нераспространяемых артефактов обычно ограничены способы и места распространения и совместного использования. Применяйте функцию только для частных реестров и соблюдайте все условия, регулирующие повторное распространение таких артефактов.

object or null
InsecureRegistryCIDRs
Массив strings or null

Список диапазонов IP небезопасных реестров в формате CIDR (RFC 4632). Такие реестры допускают незашифрованные соединения HTTP и/или недоверенные соединения HTTPS с сертификатами неизвестных центров сертификации. По умолчанию локальные реестры (127.0.0.0/8) считаются небезопасными, а все остальные — безопасными. Если демон считает реестр безопасным, соединение с небезопасным реестром невозможно. Эта конфигурация изменяет поведение и разрешает небезопасные соединения с реестрами, чьи IP-адреса, полученные при разрешении имён, входят в указанную подсеть CIDR. Реестр также можно объявить небезопасным по имени хоста. Такие реестры перечислены в IndexConfigs, а их поле Secure имеет значение false. > Предупреждение: параметр полезен при локальном запуске реестра, но создаёт уязвимости. Используйте его ТОЛЬКО для тестирования. Для большей безопасности добавьте свой центр сертификации в список доверенных центров системы вместо включения этого параметра.

Mirrors
Массив strings or null

Список URL реестров, служащих зеркалами официального реестра (docker.io).

object or null

Commit содержит Git-коммит (SHA1), из которого собран двоичный файл, указанный в строке версии внешних инструментов, например containerd или runC.

Expected
string or null

Идентификатор коммита внешнего инструмента, ожидаемый dockerd и заданный при сборке.

ID
string or null

Фактический идентификатор коммита внешнего инструмента.

object or null

Список сред выполнения, совместимых с OCI и настроенных на демоне. Ключи содержат "name", используемое для обращения к среде. Демон Docker использует совместимую с OCI среду, вызываемую через демон containerd, как интерфейс к пространствам имён ядра Linux, cgroups и SELinux. Среда по умолчанию — runc — настраивается автоматически. Дополнительные среды, настроенные пользователем, перечисляются здесь.

additional property
object (Runtime)

Runtime описывает среду выполнения, совместимую с OCI. Демон вызывает её через демон containerd. Среды OCI служат интерфейсом к пространствам имён ядра Linux, cgroups и SELinux.

SecurityOptions
Массив strings or null

Список функций безопасности, включённых на демоне, например apparmor, seccomp, SELinux, пространства имён пользователей (userns), rootless и no-new-privileges. Дополнительные параметры каждой функции могут быть включены в виде разделённого запятыми списка пар ключ/значение.

ServerVersion
string or null

Строка версии демона.

SwapLimit
boolean or null

Показывает, поддерживает ли хост ограничения swap.

object or null

Представляет общие сведения о swarm.

object or null

ClusterInfo — сведения о swarm, возвращаемые конечной точкой "/info". Токены присоединения не включены.

ControlAvailable
boolean or null
Error
string or null
LocalNodeState
string or null
Допустимые значения: "EMPTY" "inactive" "pending" "active" "error" "locked"

Текущее локальное состояние узла. Перечисление значений. Варианты перечисления не содержат данных, поэтому их можно определить как #[repr(C)], что упрощает работу с FFI.

Managers
integer or null <int64>

Общее число управляющих узлов swarm.

NodeAddr
string or null

IP-адрес, по которому другие узлы swarm могут обратиться к этому узлу.

NodeID
string or null

Уникальный идентификатор узла в swarm.

Nodes
integer or null <int64>

Общее число узлов swarm.

Массив objects or null (PeerNode)

Список идентификаторов и адресов других управляющих узлов swarm.

SystemTime
string or null

Текущее системное время в формате RFC 3339, с наносекундами.

Warnings
Массив strings or null

Список предупреждений и информационных сообщений об отсутствующих функциях или проблемах конфигурации демона. Клиент может показать их пользователю.

{
  • "ID": "string",
  • "Containers": 0,
  • "ContainersRunning": 0,
  • "ContainersPaused": 0,
  • "ContainersStopped": 0,
  • "Images": 0,
  • "Driver": "string",
  • "DriverStatus": [
    ],
  • "DockerRootDir": "string",
  • "Plugins": {
    },
  • "MemoryLimit": true,
  • "SwapLimit": true,
  • "KernelMemoryTCP": true,
  • "CpuCfsPeriod": true,
  • "CpuCfsQuota": true,
  • "CPUShares": true,
  • "CPUSet": true,
  • "PidsLimit": true,
  • "OomKillDisable": true,
  • "IPv4Forwarding": true,
  • "BridgeNfIptables": true,
  • "BridgeNfIp6tables": true,
  • "Debug": true,
  • "NFd": 0,
  • "NGoroutines": 0,
  • "SystemTime": "string",
  • "LoggingDriver": "string",
  • "CgroupDriver": "EMPTY",
  • "CgroupVersion": "EMPTY",
  • "NEventsListener": 0,
  • "KernelVersion": "string",
  • "OperatingSystem": "string",
  • "OSVersion": "string",
  • "OSType": "string",
  • "Architecture": "string",
  • "NCPU": 0,
  • "MemTotal": 0,
  • "IndexServerAddress": "string",
  • "RegistryConfig": {
    },
  • "GenericResources": {
    },
  • "HttpProxy": "string",
  • "HttpsProxy": "string",
  • "NoProxy": "string",
  • "Name": "string",
  • "Labels": [
    ],
  • "ExperimentalBuild": true,
  • "ServerVersion": "string",
  • "Runtimes": {
    },
  • "DefaultRuntime": "string",
  • "Swarm": {
    },
  • "LiveRestoreEnabled": true,
  • "Isolation": "EMPTY",
  • "InitBinary": "string",
  • "ContainerdCommit": {
    },
  • "RuncCommit": {
    },
  • "InitCommit": {
    },
  • "SecurityOptions": [
    ],
  • "ProductLicense": "string",
  • "DefaultAddressPools": [
    ],
  • "Warnings": [
    ],
  • "CDISpecDirs": [
    ]
}

SystemInfoCgroupDriverEnum

string (SystemInfoCgroupDriverEnum)
Допустимые значения: "EMPTY" "cgroupfs" "systemd" "none"
"EMPTY"

SystemInfoCgroupVersionEnum

string (SystemInfoCgroupVersionEnum)
Допустимые значения: "EMPTY" "1" "2"
"EMPTY"

SystemInfoDefaultAddressPools

Base
string or null

Адрес сети в формате CIDR.

Size
integer or null <int64>

Размер пула сети.

{
  • "Base": "string",
  • "Size": 0
}

SystemInfoIsolationEnum

string (SystemInfoIsolationEnum)
Допустимые значения: "EMPTY" "default" "hyperv" "process"
"EMPTY"

ThrottleDevice

Path
string or null

Путь устройства.

Rate
integer or null <int64>

Скорость.

{
  • "Path": "string",
  • "Rate": 0
}

ThrottlingData

periods
required
integer <int64> >= 0
throttled_periods
required
integer <int64> >= 0
throttled_time
required
integer <int64> >= 0
{
  • "periods": 0,
  • "throttled_periods": 0,
  • "throttled_time": 0
}

TlsInfo

CertIssuerPublicKey
string or null

Необработанные байты открытого ключа издателя в URL-безопасном Base64.

CertIssuerSubject
string or null

Необработанные байты субъекта издателя в URL-безопасном Base64.

TrustRoot
string or null

Корневые сертификаты центров сертификации для проверки конечных сертификатов TLS.

{
  • "TrustRoot": "string",
  • "CertIssuerSubject": "string",
  • "CertIssuerPublicKey": "string"
}

UnixTarget

UnixPath
required
string
{
  • "UnixPath": "string"
}

UpstreamTarget

DisableLogging
boolean or null

Отключить журналирование для этой цели.

Key
required
string

Ключ целевого Cargo или VM.

Path
string or null

Целевой путь HTTP при использовании HTTP.

Port
required
integer <int32> >= 0

Порт целевого Cargo или VM.

{
  • "Key": "string",
  • "Port": 0,
  • "Path": "string",
  • "DisableLogging": true
}

UriTarget

Uri
required
string

Целевой URI.

{
  • "Uri": "string"
}

UrlRedirect

string (UrlRedirect)
Допустимые значения: "MovedPermanently" "Permanent" "Temporary"
"MovedPermanently"

Vm

CreatedAt
required
string <date-time>

Время создания VM.

NamespaceName
required
string

Имя пространства имён.

required
object (VmSpec)

Спецификация VM описывает её состояние. Она позволяет узнать состояние VM и сохраняет историю изменений существующей VM.

CreatedAt
required
string <date-time>

Дата создания спецификации VM.

required
object (VmDisk)

Дисковое представление VM.

required
object (VmHostConfig)

Ресурсы VM: процессор, память и сеть.

Hostname
string or null

Имя хоста VM.

Key
required
string <uuid>

Уникальный идентификатор спецификации VM.

object or null

Метаданные ключ/значение, заданные пользователем.

MacAddress
string or null

MAC-адрес VM.

object

Метаданные, заданные пользователем.

Name
required
string

Имя VM.

Password
string or null

Пароль VM по умолчанию (cloud).

SshKey
string or null

Ключ SSH пользователя по умолчанию.

User
string or null

Пользователь VM по умолчанию (cloud).

Version
required
string

Версия спецификации.

VmKey
required
string

Ключ VM.

required
object (ObjPsStatus)
Actual
required
string (ObjPsStatusKind)
Допустимые значения: "create" "starting" "start" "updating" "update" "destroying" "destroy" "stopping" "stop" "fail" "finish" "unknown"
PrevActual
required
string (ObjPsStatusKind)
Допустимые значения: "create" "starting" "start" "updating" "update" "destroying" "destroy" "stopping" "stop" "fail" "finish" "unknown"
PrevWanted
required
string (ObjPsStatusKind)
Допустимые значения: "create" "starting" "start" "updating" "update" "destroying" "destroy" "stopping" "stop" "fail" "finish" "unknown"
UpdatedAt
required
string <date-time>
Wanted
required
string (ObjPsStatusKind)
Допустимые значения: "create" "starting" "start" "updating" "update" "destroying" "destroy" "stopping" "stop" "fail" "finish" "unknown"
{
  • "NamespaceName": "string",
  • "CreatedAt": "2019-08-24T14:15:22Z",
  • "Status": {
    },
  • "Spec": {
    }
}

VmDisk

Image
required
string

Имя используемого образа.

Size
integer or null <int64> >= 0

Допустимый виртуальный размер диска в ГБ; по умолчанию 20.

{
  • "Image": "string",
  • "Size": 0
}

VmHostConfig

Cpu
required
integer <int64> >= 0

Число CPU VM; по умолчанию 1.

Dns
Массив strings or null

Список DNS-серверов для VM.

HostTun
boolean or null

Использовать устройство tun хоста.

Kvm
boolean or null

Включить ускорение KVM; по умолчанию false.

LinkNetIface
string or null

Сетевой интерфейс для подключения VM; по умолчанию eth0.

Memory
required
integer <int64> >= 0

Память VM в МБ; по умолчанию 512.

NetIface
string or null

Настраиваемый сетевой интерфейс VM; по умолчанию ens3.

Runtime
string or null

Имя образа контейнера для VM; по умолчанию nanocl-qemu.

RuntimeNetwork
string or null
{
  • "Cpu": 0,
  • "Memory": 0,
  • "NetIface": "string",
  • "LinkNetIface": "string",
  • "Kvm": true,
  • "Dns": [
    ],
  • "Runtime": "string",
  • "RuntimeNetwork": "string",
  • "HostTun": true
}

VmImage

CreatedAt
required
string <date-time>

Время создания образа.

Format
required
string

Формат образа.

Kind
required
string

Тип образа.

Name
required
string

Имя образа.

Path
required
string

Путь образа.

SizeActual
required
integer <int64>

Фактический размер образа в байтах.

SizeVirtual
required
integer <int64>

Виртуальный размер образа в байтах.

{
  • "Name": "string",
  • "CreatedAt": "2019-08-24T14:15:22Z",
  • "Path": "string",
  • "Kind": "string",
  • "Format": "string",
  • "SizeActual": 0,
  • "SizeVirtual": 0
}

VmImageResizePayload

Shrink
required
boolean

Показывает, следует ли уменьшить размер образа.

Size
required
integer <int64> >= 0

Новый размер образа в байтах.

{
  • "Size": 0,
  • "Shrink": true
}

VmInspect

CreatedAt
required
string <date-time>

Дата создания VM.

InstanceRunning
required
integer >= 0

Число работающих экземпляров.

required
Массив objects (Process)

Список экземпляров.

Array
CreatedAt
required
string <date-time>

Дата создания.

required
object (ContainerInspectResponse)
Key
required
string

Ключ процесса.

Kind
required
string (ProcessKind)
Допустимые значения: "vm" "job" "cargo"

Тип процесса (Vm, Job, Cargo).

KindKey
required
string

Ключ связанного типа.

Name
required
string

Имя процесса.

NodeKey
required
string

Ключ узла, на котором работает контейнер.

UpdatedAt
required
string <date-time>

Время последнего обновления экземпляра.

InstanceTotal
required
integer >= 0

Число экземпляров.

NamespaceName
required
string

Имя пространства имён.

required
object (VmSpec)

Спецификация VM описывает её состояние. Она позволяет узнать состояние VM и сохраняет историю изменений существующей VM.

CreatedAt
required
string <date-time>

Дата создания спецификации VM.

required
object (VmDisk)

Дисковое представление VM.

required
object (VmHostConfig)

Ресурсы VM: процессор, память и сеть.

Hostname
string or null

Имя хоста VM.

Key
required
string <uuid>

Уникальный идентификатор спецификации VM.

object or null

Метаданные ключ/значение, заданные пользователем.

MacAddress
string or null

MAC-адрес VM.

object

Метаданные, заданные пользователем.

Name
required
string

Имя VM.

Password
string or null

Пароль VM по умолчанию (cloud).

SshKey
string or null

Ключ SSH пользователя по умолчанию.

User
string or null

Пользователь VM по умолчанию (cloud).

Version
required
string

Версия спецификации.

VmKey
required
string

Ключ VM.

required
object (ObjPsStatus)
Actual
required
string (ObjPsStatusKind)
Допустимые значения: "create" "starting" "start" "updating" "update" "destroying" "destroy" "stopping" "stop" "fail" "finish" "unknown"
PrevActual
required
string (ObjPsStatusKind)
Допустимые значения: "create" "starting" "start" "updating" "update" "destroying" "destroy" "stopping" "stop" "fail" "finish" "unknown"
PrevWanted
required
string (ObjPsStatusKind)
Допустимые значения: "create" "starting" "start" "updating" "update" "destroying" "destroy" "stopping" "stop" "fail" "finish" "unknown"
UpdatedAt
required
string <date-time>
Wanted
required
string (ObjPsStatusKind)
Допустимые значения: "create" "starting" "start" "updating" "update" "destroying" "destroy" "stopping" "stop" "fail" "finish" "unknown"
{
  • "NamespaceName": "string",
  • "CreatedAt": "2019-08-24T14:15:22Z",
  • "InstanceTotal": 0,
  • "InstanceRunning": 0,
  • "Status": {
    },
  • "Spec": {
    },
  • "Instances": [
    ]
}

VmSpec

CreatedAt
required
string <date-time>

Дата создания спецификации VM.

required
object (VmDisk)

Дисковое представление VM.

Image
required
string

Имя используемого образа.

Size
integer or null <int64> >= 0

Допустимый виртуальный размер диска в ГБ; по умолчанию 20.

required
object (VmHostConfig)

Ресурсы VM: процессор, память и сеть.

Cpu
required
integer <int64> >= 0

Число CPU VM; по умолчанию 1.

Dns
Массив strings or null

Список DNS-серверов для VM.

HostTun
boolean or null

Использовать устройство tun хоста.

Kvm
boolean or null

Включить ускорение KVM; по умолчанию false.

LinkNetIface
string or null

Сетевой интерфейс для подключения VM; по умолчанию eth0.

Memory
required
integer <int64> >= 0

Память VM в МБ; по умолчанию 512.

NetIface
string or null

Настраиваемый сетевой интерфейс VM; по умолчанию ens3.

Runtime
string or null

Имя образа контейнера для VM; по умолчанию nanocl-qemu.

RuntimeNetwork
string or null
Hostname
string or null

Имя хоста VM.

Key
required
string <uuid>

Уникальный идентификатор спецификации VM.

object or null

Метаданные ключ/значение, заданные пользователем.

property name*
additional property
string
MacAddress
string or null

MAC-адрес VM.

object

Метаданные, заданные пользователем.

additional property
string or number or boolean or Массив Any (any) or object (Any)

Вспомогательный тип Any для OpenApi, полезный для динамических объектов JSON, например ResourceSpec.

Name
required
string

Имя VM.

Password
string or null

Пароль VM по умолчанию (cloud).

SshKey
string or null

Ключ SSH пользователя по умолчанию.

User
string or null

Пользователь VM по умолчанию (cloud).

Version
required
string

Версия спецификации.

VmKey
required
string

Ключ VM.

{
  • "Key": "5eb041b0-19c9-4022-bd51-0e723885f5dd",
  • "CreatedAt": "2019-08-24T14:15:22Z",
  • "Name": "string",
  • "Version": "string",
  • "VmKey": "string",
  • "Metadata": {
    },
  • "Hostname": "string",
  • "Password": "string",
  • "SshKey": "string",
  • "User": "string",
  • "Disk": {
    },
  • "MacAddress": "string",
  • "Labels": {
    },
  • "HostConfig": {
    }
}

VmSpecPartial

required
object (VmDisk)

Дисковое представление VM.

Image
required
string

Имя используемого образа.

Size
integer or null <int64> >= 0

Допустимый виртуальный размер диска в ГБ; по умолчанию 20.

object or null

Ресурсы VM: процессор, память и сеть.

Cpu
required
integer <int64> >= 0

Число CPU VM; по умолчанию 1.

Dns
Массив strings or null

Список DNS-серверов для VM.

HostTun
boolean or null

Использовать устройство tun хоста.

Kvm
boolean or null

Включить ускорение KVM; по умолчанию false.

LinkNetIface
string or null

Сетевой интерфейс для подключения VM; по умолчанию eth0.

Memory
required
integer <int64> >= 0

Память VM в МБ; по умолчанию 512.

NetIface
string or null

Настраиваемый сетевой интерфейс VM; по умолчанию ens3.

Runtime
string or null

Имя образа контейнера для VM; по умолчанию nanocl-qemu.

RuntimeNetwork
string or null
Hostname
string or null

Имя хоста VM; по умолчанию создаётся из имени.

object or null

Метаданные ключ/значение, заданные пользователем.

property name*
additional property
string
MacAddress
string or null

MAC-адрес VM; по умолчанию создаётся автоматически.

object

Метаданные, заданные пользователем.

additional property
string or number or boolean or Массив Any (any) or object (Any)

Вспомогательный тип Any для OpenApi, полезный для динамических объектов JSON, например ResourceSpec.

Name
required
string

Имя VM.

Password
string or null

Пароль VM по умолчанию: cloud.

SshKey
string or null

Открытый ключ SSH пользователя по умолчанию; рекомендуется.

User
string or null

Пользователь VM по умолчанию: cloud.

{
  • "Name": "string",
  • "Metadata": {
    },
  • "Hostname": "string",
  • "User": "string",
  • "Password": "string",
  • "SshKey": "string",
  • "Disk": {
    },
  • "MacAddress": "string",
  • "Labels": {
    },
  • "HostConfig": {
    }
}

VmSpecUpdate

object or null

Ресурсы VM: процессор, память и сеть.

Cpu
required
integer <int64> >= 0

Число CPU VM; по умолчанию 1.

Dns
Массив strings or null

Список DNS-серверов для VM.

HostTun
boolean or null

Использовать устройство tun хоста.

Kvm
boolean or null

Включить ускорение KVM; по умолчанию false.

LinkNetIface
string or null

Сетевой интерфейс для подключения VM; по умолчанию eth0.

Memory
required
integer <int64> >= 0

Память VM в МБ; по умолчанию 512.

NetIface
string or null

Настраиваемый сетевой интерфейс VM; по умолчанию ens3.

Runtime
string or null

Имя образа контейнера для VM; по умолчанию nanocl-qemu.

RuntimeNetwork
string or null
Hostname
string or null

Имя хоста VM.

object or null

Метаданные ключ/значение, заданные пользователем.

property name*
additional property
string
object

Метаданные, заданные пользователем.

additional property
string or number or boolean or Массив Any (any) or object (Any)

Вспомогательный тип Any для OpenApi, полезный для динамических объектов JSON, например ResourceSpec.

Name
string or null

Имя VM.

Password
string or null

Пароль VM по умолчанию (cloud).

SshKey
string or null

Ключ SSH пользователя по умолчанию.

User
string or null

Пользователь VM по умолчанию (cloud).

{
  • "Name": "string",
  • "Metadata": {
    },
  • "Hostname": "string",
  • "User": "string",
  • "Password": "string",
  • "SshKey": "string",
  • "Labels": {
    },
  • "HostConfig": {
    }
}

VmSummary

CreatedAt
required
string <date-time>

Дата создания VM.

InstanceRunning
required
integer >= 0

Число работающих экземпляров.

InstanceTotal
required
integer >= 0

Число экземпляров.

NamespaceName
required
string

Имя пространства имён.

required
object (VmSpec)

Спецификация VM описывает её состояние. Она позволяет узнать состояние VM и сохраняет историю изменений существующей VM.

CreatedAt
required
string <date-time>

Дата создания спецификации VM.

required
object (VmDisk)

Дисковое представление VM.

required
object (VmHostConfig)

Ресурсы VM: процессор, память и сеть.

Hostname
string or null

Имя хоста VM.

Key
required
string <uuid>

Уникальный идентификатор спецификации VM.

object or null

Метаданные ключ/значение, заданные пользователем.

MacAddress
string or null

MAC-адрес VM.

object

Метаданные, заданные пользователем.

Name
required
string

Имя VM.

Password
string or null

Пароль VM по умолчанию (cloud).

SshKey
string or null

Ключ SSH пользователя по умолчанию.

User
string or null

Пользователь VM по умолчанию (cloud).

Version
required
string

Версия спецификации.

VmKey
required
string

Ключ VM.

{
  • "NamespaceName": "string",
  • "CreatedAt": "2019-08-24T14:15:22Z",
  • "InstanceTotal": 0,
  • "InstanceRunning": 0,
  • "Spec": {
    }
}