Skip to Content

71 操作 · 173 模式 · 规范 v0.12.0

下载 OpenAPI YAML ↗
API docs by Redocly

Nanocl Daemon (v0.12.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 使用 Utoipa 以 OpenAPI 格式编写文档。
规范仅在开发环境运行时自动生成。
发布版本时，将生成的文件传到文档仓库。

跨源资源共享

本 API 按照 W3C 规范实现跨源资源共享（CORS）。
允许浏览器进行跨域通信。
所有响应使用通配的来源许可，因此完全公开，任何人以及任何网站上的代码都能访问。

Cargoes

列出 Cargo。

列出 Cargo。

query Parameters
filter
string or null
示例: filter={ "where": { "name": { "eq": "test" } } }

通用过滤器。

namespace
string or null

Cargo 所在的命名空间。

响应

响应示例

Content type
application/json
[
  • {
    }
]

创建新 Cargo。

创建新 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

容器入口点，指定为字符串或字符串数组。如果数组仅包含一个空字符串（[\"\"]），则重置为系统默认入口点，即没有 ENTRYPOINT 指令的 Dockerfile 所对应的 Docker 入口点。

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 使用 Shell 时所用的 Shell。

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 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

容器入口点，指定为字符串或字符串数组。如果数组仅包含一个空字符串（[\"\"]），则重置为系统默认入口点，即没有 ENTRYPOINT 指令的 Dockerfile 所对应的 Docker 入口点。

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 使用 Shell 时所用的 Shell。

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)

为 OpenApi 生成 Any 类型的辅助工具，适用于 ResourceSpec 等动态 JSON 对象。

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 确保集群至少存在 1 个副本。

判别字段： Mode.

One of
Mode
required
string
值: "Auto"
Secrets
数组元素类型 strings or null

用作环境变量的 Secret 列表。

响应

请求示例

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

响应示例

Content type
application/json
{
  • "NamespaceName": "string",
  • "CreatedAt": "2019-08-24T14:15:22Z",
  • "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

连接 exec 命令的 stderr。

AttachStdin
boolean or null

连接 exec 命令的 stdin。

AttachStdout
boolean or null

连接 exec 命令的 stdout。

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

分配伪终端。

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 规格并添加历史记录。

创建新 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

容器入口点，指定为字符串或字符串数组。如果数组仅包含一个空字符串（[\"\"]），则重置为系统默认入口点，即没有 ENTRYPOINT 指令的 Dockerfile 所对应的 Docker 入口点。

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 使用 Shell 时所用的 Shell。

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 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

容器入口点，指定为字符串或字符串数组。如果数组仅包含一个空字符串（[\"\"]），则重置为系统默认入口点，即没有 ENTRYPOINT 指令的 Dockerfile 所对应的 Docker 入口点。

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 使用 Shell 时所用的 Shell。

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)

为 OpenApi 生成 Any 类型的辅助工具，适用于 ResourceSpec 等动态 JSON 对象。

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 确保集群至少存在 1 个副本。

判别字段： Mode.

One of
Mode
required
string
值: "Auto"
Secrets
数组元素类型 strings or null

用作环境变量的 Secret 列表。

响应

请求示例

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

响应示例

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

删除 Cargo。

删除 Cargo。

path Parameters
name
required
string

Cargo 名称。

query Parameters
force
required
boolean

为 true 时强制删除。

namespace
string or null

Cargo 所属命名空间。

响应

更新 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

容器入口点，指定为字符串或字符串数组。如果数组仅包含一个空字符串（[\"\"]），则重置为系统默认入口点，即没有 ENTRYPOINT 指令的 Dockerfile 所对应的 Docker 入口点。

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 使用 Shell 时所用的 Shell。

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 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

容器入口点，指定为字符串或字符串数组。如果数组仅包含一个空字符串（[\"\"]），则重置为系统默认入口点，即没有 ENTRYPOINT 指令的 Dockerfile 所对应的 Docker 入口点。

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 使用 Shell 时所用的 Shell。

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)

为 OpenApi 生成 Any 类型的辅助工具，适用于 ResourceSpec 等动态 JSON 对象。

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 确保集群至少存在 1 个副本。

判别字段： Mode.

One of
Mode
required
string
值: "Auto"
Secrets
数组元素类型 strings or null

用作环境变量的 Secret 列表。

响应

请求示例

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

响应示例

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

列出 Cargo 历史记录。

列出 Cargo 历史记录。

path Parameters
name
required
string

Cargo 名称。

query Parameters
namespace
string or null

Cargo 所属命名空间。

响应

响应示例

Content type
application/json
[
  • {
    }
]

将 Cargo 恢复到指定历史版本。

将 Cargo 恢复到指定历史版本。

path Parameters
id
required
string

Cargo 历史记录 ID。

name
required
string

Cargo 名称。

query Parameters
namespace
string or null

Cargo 所属命名空间。

响应

响应示例

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

获取 Cargo 详细信息。

获取 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,
  • "Spec": {
    },
  • "Instances": [
    ]
}

向 Cargo 发送信号，信号为 SIGKILL 时终止 Cargo。

向 Cargo 发送信号，信号为 SIGKILL 时终止 Cargo。

path Parameters
name
required
string

Cargo 名称。

query Parameters
namespace
string or null

Cargo 所属命名空间。

Request Body schema: application/json
required
signal
required
string

发送给容器的信号，默认 SIGKILL。

响应

请求示例

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

重启 Cargo。

重启 Cargo。

path Parameters
name
required
string

Cargo 名称。

query Parameters
namespace
string or null

Cargo 所属命名空间。

响应

增加或减少实例数量。

增加或减少实例数量。

path Parameters
name
required
string

Cargo 名称。

query Parameters
namespace
string or null

Cargo 所属命名空间。

Request Body schema: application/json
required
Replicas
required
integer

扩容或缩容的副本数量，可为负数。

响应

请求示例

Content type
application/json
{
  • "Replicas": 0
}

响应示例

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

获取 Cargo 实例统计信息。

获取 Cargo 实例统计信息。

path Parameters
name
required
string

Cargo 实例名称，通常是 name 或 name-number。

query Parameters
namespace
string or null

Cargo 所属命名空间。

one_shot
boolean or null

仅返回一次统计信息。

stream
boolean or null

返回统计信息流。

响应

CargoImages

Cargo 镜像管理端点。

列出容器镜像。

列出容器镜像。

响应

响应示例

Content type
application/json
[
  • {
    }
]

下载容器镜像。

下载容器镜像。

Request Body schema: application/json
required
Name
required
string

镜像名称。

响应

请求示例

Content type
application/json
{
  • "Name": "nginx:latest"
}

响应示例

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

从 tar 压缩包导入容器镜像。

从 tar 压缩包导入容器镜像。

Request Body schema: text/plain
required
string

响应

响应示例

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

获取容器镜像详细信息。

获取容器镜像详细信息。

path Parameters
id_or_name
required
string

镜像 ID 或名称。

响应

响应示例

Content type
application/json
{
  • "Id": "string",
  • "RepoTags": [
    ],
  • "RepoDigests": [
    ],
  • "Parent": "string",
  • "Comment": "string",
  • "Created": "string",
  • "Container": "string",
  • "ContainerConfig": {
    },
  • "DockerVersion": "string",
  • "Author": "string",
  • "Config": {
    },
  • "Architecture": "string",
  • "Variant": "string",
  • "Os": "string",
  • "OsVersion": "string",
  • "Size": 0,
  • "VirtualSize": 0,
  • "GraphDriver": {
    },
  • "RootFS": {
    },
  • "Metadata": {
    }
}

删除容器镜像。

删除容器镜像。

path Parameters
id_or_name
required
string

镜像 ID 或名称。

响应

响应示例

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

Exec

检查 Cargo 中执行的命令。

检查 Cargo 中执行的命令。

path Parameters
id
required
string

要检查的 exec ID。

响应

响应示例

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 命令 ID。

Request Body schema: application/json
required
Detach
required
boolean

与命令分离。

OutputCapacity
integer or null >= 0

单行输出最大大小，默认为 8 * 1024（约 1024 个字符）。

Tty
required
boolean

分配伪终端。

响应

请求示例

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

容器入口点，指定为字符串或字符串数组。如果数组仅包含一个空字符串（[\"\"]），则重置为系统默认入口点，即没有 ENTRYPOINT 指令的 Dockerfile 所对应的 Docker 入口点。

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 使用 Shell 时所用的 Shell。

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

用户定义的元数据。

additional property
string or number or boolean or 数组元素类型 Any (any) or object (Any)

为 OpenApi 生成 Any 类型的辅助工具，适用于 ResourceSpec 等动态 JSON 对象。

Name
required
string

任务名称。

Schedule
string or null

任务调度时间（cron）。

Secrets
数组元素类型 strings or null

作为环境变量加载的 Secret。

Ttl
integer or null >= 0

执行完成 x 秒后移除任务。

响应

请求示例

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

响应示例

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

删除任务。

删除任务。

path Parameters
name
required
string

任务名称。

响应

检查任务。

检查任务。

path Parameters
name
required
string

任务名称。

响应

响应示例

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

等待任务完成。

等待任务完成。

path Parameters
name
required
string

任务实例名称，通常是 name 或 name-number。

响应

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

指标类型。

响应

请求示例

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

响应示例

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

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"
}

删除命名空间。

删除命名空间。

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 端点。

内部节点间通信的 WebSocket 端点。

响应

Processes

进程管理端点。

列出进程（Vm、Job、Cargo）。

列出进程（Vm、Job、Cargo）。

query Parameters
all
required
boolean

返回全部节点的实例。

last
integer or null

返回指定数量的最近创建容器。

namespace
string or null

仅返回此命名空间的实例。

响应

响应示例

Content type
application/json
[
  • {
    }
]

获取进程日志。

获取进程日志。

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

进程所属命名空间（必填）。

响应

停止 Cargo。

停止 Cargo。

path Parameters
kind
required
string
示例: cargo

进程类型。

name
required
string
示例: deploy-example

进程名称。

query Parameters
namespace
string or null

进程所属命名空间（必填）。

响应

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)

为 OpenApi 生成 Any 类型的辅助工具，适用于 ResourceSpec 等动态 JSON 对象。

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)

为 OpenApi 生成 Any 类型的辅助工具，适用于 ResourceSpec 等动态 JSON 对象。

Kind
required
string

资源类型。

object

资源的用户定义元数据。

additional property
string or number or boolean or 数组元素类型 Any (any) or object (Any)

为 OpenApi 生成 Any 类型的辅助工具，适用于 ResourceSpec 等动态 JSON 对象。

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)

为 OpenApi 生成 Any 类型的辅助工具，适用于 ResourceSpec 等动态 JSON 对象。

object

以 JSON 对象表示的资源元数据。

additional property
string or number or boolean or 数组元素类型 Any (any) or object (Any)

为 OpenApi 生成 Any 类型的辅助工具，适用于 ResourceSpec 等动态 JSON 对象。

响应

请求示例

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

要恢复到的资源历史记录 ID。

name
required
string

要恢复的资源名称。

响应

响应示例

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

Secrets

列出 Secret。

列出 Secret。

query Parameters
filter
string or null
示例: filter={ "where": { "kind": { "eq": "Env" } } }

通用过滤器。

响应

响应示例

Content type
application/json
[
  • {
    }
]

创建 Secret。

创建 Secret。

Request Body schema: application/json
required
required
object

Secret 数据。

additional property
string or number or boolean or 数组元素类型 Any (any) or object (Any)

为 OpenApi 生成 Any 类型的辅助工具，适用于 ResourceSpec 等动态 JSON 对象。

Immutable
boolean or null

无法更新 Secret。

Kind
required
string

Secret 类型。

object

资源的用户定义元数据。

additional property
string or number or boolean or 数组元素类型 Any (any) or object (Any)

为 OpenApi 生成 Any 类型的辅助工具，适用于 ResourceSpec 等动态 JSON 对象。

Name
required
string

Secret 名称。

响应

请求示例

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": {
    }
}

删除 Secret。

删除 Secret。

path Parameters
key
required
string

Secret 键。

响应

响应示例

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

更新 Secret。

更新 Secret。

path Parameters
key
required
string

Secret 键。

Request Body schema: application/json
required
required
object

以 JSON 对象表示的 Secret 数据。

additional property
string or number or boolean or 数组元素类型 Any (any) or object (Any)

为 OpenApi 生成 Any 类型的辅助工具，适用于 ResourceSpec 等动态 JSON 对象。

object

Secret 的用户定义元数据。

additional property
string or number or boolean or 数组元素类型 Any (any) or object (Any)

为 OpenApi 生成 Any 类型的辅助工具，适用于 ResourceSpec 等动态 JSON 对象。

响应

请求示例

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": {
    }
}

获取 Secret 详细信息。

获取 Secret 详细信息。

path Parameters
key
required
string

Secret 键。

响应

响应示例

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

通用系统端点。

获取版本信息。

获取版本信息。

响应

通过 Server-Sent Events / EventSource 监听事件。

通过 Server-Sent Events / EventSource 监听事件。

响应

获取主机或节点系统信息。

获取主机或节点系统信息。

响应

响应示例

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",
  • "ClusterStore": "string",
  • "ClusterAdvertise": "string",
  • "Runtimes": {
    },
  • "DefaultRuntime": "string",
  • "Swarm": {
    },
  • "LiveRestoreEnabled": true,
  • "Isolation": "EMPTY",
  • "InitBinary": "string",
  • "ContainerdCommit": {
    },
  • "RuncCommit": {
    },
  • "InitCommit": {
    },
  • "SecurityOptions": [
    ],
  • "ProductLicense": "string",
  • "DefaultAddressPools": [
    ],
  • "Warnings": [
    ],
  • "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

允许的磁盘虚拟大小，单位 GB（默认：20）。

object or null

VM 的资源（CPU、内存、网络）。

Cpu
required
integer <int64> >= 0

VM 的 CPU 数量（默认：1）。

Dns
数组元素类型 strings or null

VM 使用的 DNS 服务器列表。

HostTun
boolean or null

使用主机 TUN 设备。

Kvm
boolean or null

启用 KVM 加速（默认：false）。

LinkNetIface
string or null

连接 VM 的网络接口（默认：eth0）。

Memory
required
integer <int64> >= 0

VM 内存，单位 MB（默认：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

VM 的 MAC 地址（默认自动生成）。

object

用户定义的元数据。

additional property
string or number or boolean or 数组元素类型 Any (any) or object (Any)

为 OpenApi 生成 Any 类型的辅助工具，适用于 ResourceSpec 等动态 JSON 对象。

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",
  • "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、内存、网络）。

Cpu
required
integer <int64> >= 0

VM 的 CPU 数量（默认：1）。

Dns
数组元素类型 strings or null

VM 使用的 DNS 服务器列表。

HostTun
boolean or null

使用主机 TUN 设备。

Kvm
boolean or null

启用 KVM 加速（默认：false）。

LinkNetIface
string or null

连接 VM 的网络接口（默认：eth0）。

Memory
required
integer <int64> >= 0

VM 内存，单位 MB（默认：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)

为 OpenApi 生成 Any 类型的辅助工具，适用于 ResourceSpec 等动态 JSON 对象。

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",
  • "Spec": {
    }
}

通过 WebSocket 连接虚拟机。

通过 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,
  • "Spec": {
    },
  • "Instances": [
    ]
}

模式

Address

Addr
string or null

IP 地址。

PrefixLen
integer or null <int64>

IP 地址掩码长度。

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

Any

One of
string

为 OpenApi 生成 Any 类型的辅助工具，适用于 ResourceSpec 等动态 JSON 对象。

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

ApiError

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

BinaryInfo

Arch
required
string

Arch 是当前二进制文件的架构。

Channel
required
string

Channel 是当前二进制文件的发布通道。

CommitId
required
string

CommitID 是当前二进制文件的提交 ID。

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 spec 是 Cargo 的规格，用于了解 Cargo 状态，并在更新现有 Cargo 时跟踪历史记录。

CargoKey
required
string

Cargo 键。

required
object (Config)

要创建的容器。

CreatedAt
required
string <date-time>

Cargo 规格创建时间。

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 确保集群至少存在 1 个副本。

判别字段： Mode.

Secrets
数组元素类型 strings or null

用作环境变量的 Secret 列表。

Version
required
string

规格版本。

{
  • "NamespaceName": "string",
  • "CreatedAt": "2019-08-24T14:15:22Z",
  • "Spec": {
    }
}

CargoImagePartial

Name
required
string

镜像名称。

{
  • "Name": "nginx:latest"
}

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"
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 spec 是 Cargo 的规格，用于了解 Cargo 状态，并在更新现有 Cargo 时跟踪历史记录。

CargoKey
required
string

Cargo 键。

required
object (Config)

要创建的容器。

CreatedAt
required
string <date-time>

Cargo 规格创建时间。

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 确保集群至少存在 1 个副本。

判别字段： Mode.

Secrets
数组元素类型 strings or null

用作环境变量的 Secret 列表。

Version
required
string

规格版本。

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

CargoKillOptions

signal
required
string

发送给容器的信号，默认 SIGKILL。

{
  • "signal": "string"
}

CargoScale

Replicas
required
integer

扩容或缩容的副本数量，可为负数。

{
  • "Replicas": 0
}

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

容器入口点，指定为字符串或字符串数组。如果数组仅包含一个空字符串（[\"\"]），则重置为系统默认入口点，即没有 ENTRYPOINT 指令的 Dockerfile 所对应的 Docker 入口点。

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 使用 Shell 时所用的 Shell。

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 规格创建时间。

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

容器入口点，指定为字符串或字符串数组。如果数组仅包含一个空字符串（[\"\"]），则重置为系统默认入口点，即没有 ENTRYPOINT 指令的 Dockerfile 所对应的 Docker 入口点。

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 使用 Shell 时所用的 Shell。

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)

为 OpenApi 生成 Any 类型的辅助工具，适用于 ResourceSpec 等动态 JSON 对象。

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 确保集群至少存在 1 个副本。

判别字段： Mode.

One of
Mode
required
string
值: "Auto"
Secrets
数组元素类型 strings or null

用作环境变量的 Secret 列表。

Version
required
string

规格版本。

{
  • "Key": "5eb041b0-19c9-4022-bd51-0e723885f5dd",
  • "CargoKey": "string",
  • "Version": "string",
  • "CreatedAt": "2019-08-24T14:15:22Z",
  • "Name": "string",
  • "Metadata": {
    },
  • "InitContainer": {
    },
  • "Secrets": [
    ],
  • "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

容器入口点，指定为字符串或字符串数组。如果数组仅包含一个空字符串（[\"\"]），则重置为系统默认入口点，即没有 ENTRYPOINT 指令的 Dockerfile 所对应的 Docker 入口点。

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 使用 Shell 时所用的 Shell。

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 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

容器入口点，指定为字符串或字符串数组。如果数组仅包含一个空字符串（[\"\"]），则重置为系统默认入口点，即没有 ENTRYPOINT 指令的 Dockerfile 所对应的 Docker 入口点。

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 使用 Shell 时所用的 Shell。

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)

为 OpenApi 生成 Any 类型的辅助工具，适用于 ResourceSpec 等动态 JSON 对象。

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 确保集群至少存在 1 个副本。

判别字段： Mode.

One of
Mode
required
string
值: "Auto"
Secrets
数组元素类型 strings or null

用作环境变量的 Secret 列表。

{
  • "Name": "string",
  • "Metadata": {
    },
  • "InitContainer": {
    },
  • "Secrets": [
    ],
  • "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

容器入口点，指定为字符串或字符串数组。如果数组仅包含一个空字符串（[\"\"]），则重置为系统默认入口点，即没有 ENTRYPOINT 指令的 Dockerfile 所对应的 Docker 入口点。

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 使用 Shell 时所用的 Shell。

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 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

容器入口点，指定为字符串或字符串数组。如果数组仅包含一个空字符串（[\"\"]），则重置为系统默认入口点，即没有 ENTRYPOINT 指令的 Dockerfile 所对应的 Docker 入口点。

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 使用 Shell 时所用的 Shell。

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)

为 OpenApi 生成 Any 类型的辅助工具，适用于 ResourceSpec 等动态 JSON 对象。

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 确保集群至少存在 1 个副本。

判别字段： Mode.

One of
Mode
required
string
值: "Auto"
Secrets
数组元素类型 strings or null

用作环境变量的 Secret 列表。

{
  • "Name": "string",
  • "Metadata": {
    },
  • "InitContainer": {
    },
  • "Secrets": [
    ],
  • "Container": {
    },
  • "Replication": {
    }
}

CargoSummary

CreatedAt
required
string <date-time>

Cargo 创建时间。

InstanceRunning
required
integer >= 0

运行实例数。

InstanceTotal
required
integer >= 0

实例数量。

NamespaceName
required
string

命名空间名称。

required
object (CargoSpec)

Cargo spec 是 Cargo 的规格，用于了解 Cargo 状态，并在更新现有 Cargo 时跟踪历史记录。

CargoKey
required
string

Cargo 键。

required
object (Config)

要创建的容器。

CreatedAt
required
string <date-time>

Cargo 规格创建时间。

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 确保集群至少存在 1 个副本。

判别字段： Mode.

Secrets
数组元素类型 strings or null

用作环境变量的 Secret 列表。

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 ID。

RootRotationInProgress
boolean or null

Swarm 是否正在轮换根 CA。

object or null

用户可修改的 Swarm 配置。

object or null

CA 配置。

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 证书颁发者及可信根 CA 证书的信息。

CertIssuerPublicKey
string or null

颁发者的原始公钥字节，使用 URL 安全 Base64 编码。

CertIssuerSubject
string or null

颁发者的原始 subject 字节，使用 URL 安全 Base64 编码。

TrustRoot
string or null

验证叶 TLS 证书的根 CA 证书。

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。

ID
string or null

外部工具的实际提交 ID。

{
  • "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

容器入口点，指定为字符串或字符串数组。如果数组仅包含一个空字符串（[\"\"]），则重置为系统默认入口点，即没有 ENTRYPOINT 指令的 Dockerfile 所对应的 Docker 入口点。

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 表示继承。

StartPeriod
integer or null <int64>

容器初始化的启动宽限期，在此期间不开始健康检查重试倒计时，单位纳秒。应为 0 或至少 1000000（1 毫秒），0 表示继承。

Test
数组元素类型 strings or null

要执行的测试，可选值：[] 继承镜像或父镜像的健康检查；[\"NONE\"] 禁用健康检查；[\"CMD\", args...] 直接执行参数；[\"CMD-SHELL\", command] 用系统默认 Shell 运行命令。

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)

限制设备读取速率（每秒 IO 次数），格式为：[{\"Path\": \"device_path\", \"Rate\": rate}]

数组元素类型 objects or null (ThrottleDevice)

限制设备写入速率（每秒字节数），格式为：[{\"Path\": \"device_path\", \"Rate\": rate}]

数组元素类型 objects or null (ThrottleDevice)

限制设备写入速率（每秒 IO 次数），格式为：[{\"Path\": \"device_path\", \"Rate\": rate}]

BlkioWeight
integer or null <int32> >= 0

块 IO 权重（相对权重）。

数组元素类型 objects or null (ResourcesBlkioWeightDevice)

块 IO 权重（相对设备权重），格式为：[{\"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 路径。不存在时会创建 cgroup。

ConsoleSize
数组元素类型 integers or null <int32> [ items <int32 > ]

初始控制台大小，以 [height, width] 数组表示。

ContainerIDFile
string or null

写入容器 ID 的文件路径。

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 周期内可获得的 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

允许执行的内存节点 MEM（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

添加到容器 /etc/hosts 文件的主机名与 IP 映射列表，格式为 [\"hostname:IP\"]。

GroupAdd
数组元素类型 strings or null

容器进程运行时所属的附加用户组列表。

Init
boolean or null

在容器内运行初始化进程，转发信号并回收进程。为空时省略字段，使用守护进程配置的默认值。

IOMaximumBandwidth
integer or null <int64>

容器系统盘的最大每秒 IO 字节数（仅限 Windows）。

IOMaximumIOps
integer or null <int64>

容器系统盘的最大每秒 IO 次数（仅限 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>

内存总限制（内存加交换空间）。设为 -1 可启用无限交换空间。

MemorySwappiness
integer or null <int64>

调整容器内存交换倾向，接受 0 到 100 的整数。

数组元素类型 objects or null (Mount)

要添加到容器的挂载规格。

NanoCpus
integer or null <int64>

CPU 配额，以 10-9 个 CPU 为单位。

NetworkMode
string or null

容器使用的网络模式。支持标准值 bridge、host、none 和 container:<name|id>。其他值视为容器要连接的自定义网络名称。

OomKillDisable
boolean or null

禁用容器的 OOM killer。

OomScoreAdj
integer or null <int64>

整数值，表示容器的 OOM 分数，用于调整 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

用于自定义 SELinux 等 MLS 系统标签的字符串值列表。

ShmSize
integer or null <int64>

/dev/shm 大小，单位字节。省略时使用 64 MB。

object or null

容器存储驱动选项，格式为 {\"size\": \"120G\"}。

object or null

要在容器中设置的内核参数（sysctl）列表。例如：{\"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 使用 Shell 时所用的 Shell。

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 表示驱动，如网络、日志或 Secret 驱动。

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

容器入口点，指定为字符串或字符串数组。如果数组仅包含一个空字符串（[\"\"]），则重置为系统默认入口点，即没有 ENTRYPOINT 指令的 Dockerfile 所对应的 Docker 入口点。

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 表示继承。

StartPeriod
integer or null <int64>

容器初始化的启动宽限期，在此期间不开始健康检查重试倒计时，单位纳秒。应为 0 或至少 1000000（1 毫秒），0 表示继承。

Test
数组元素类型 strings or null

要执行的测试，可选值：[] 继承镜像或父镜像的健康检查；[\"NONE\"] 禁用健康检查；[\"CMD\", args...] 直接执行参数；[\"CMD-SHELL\", command] 用系统默认 Shell 运行命令。

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 地址。

NetworkDisabled
boolean or null

禁用容器网络。

OnBuild
数组元素类型 strings or null

ONBUILD 元数据，定义于镜像的 Dockerfile。

OpenStdin
boolean or null

打开 stdin。

Shell
数组元素类型 strings or null

RUN、CMD 和 ENTRYPOINT 使用 Shell 时所用的 Shell。

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 字段时，ContainerConfig 是可选字段，保存创建镜像时最后提交的容器配置。旧版 Docker 构建器曾用它保存构建缓存，现在已不再使用。

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

容器入口点，指定为字符串或字符串数组。如果数组仅包含一个空字符串（[\"\"]），则重置为系统默认入口点，即没有 ENTRYPOINT 指令的 Dockerfile 所对应的 Docker 入口点。

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 地址。

NetworkDisabled
boolean or null

禁用容器网络。

OnBuild
数组元素类型 strings or null

ONBUILD 元数据，定义于镜像的 Dockerfile。

OpenStdin
boolean or null

打开 stdin。

Shell
数组元素类型 strings or null

RUN、CMD 和 ENTRYPOINT 使用 Shell 时所用的 Shell。

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 实例 ID。

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)

限制设备读取速率（每秒 IO 次数），格式为：[{\"Path\": \"device_path\", \"Rate\": rate}]

数组元素类型 objects or null (ThrottleDevice)

限制设备写入速率（每秒字节数），格式为：[{\"Path\": \"device_path\", \"Rate\": rate}]

数组元素类型 objects or null (ThrottleDevice)

限制设备写入速率（每秒 IO 次数），格式为：[{\"Path\": \"device_path\", \"Rate\": rate}]

BlkioWeight
integer or null <int32> >= 0

块 IO 权重（相对权重）。

数组元素类型 objects or null (ResourcesBlkioWeightDevice)

块 IO 权重（相对设备权重），格式为：[{\"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 路径。不存在时会创建 cgroup。

ConsoleSize
数组元素类型 integers or null <int32> [ items <int32 > ]

初始控制台大小，以 [height, width] 数组表示。

ContainerIDFile
string or null

写入容器 ID 的文件路径。

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 周期内可获得的 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

允许执行的内存节点 MEM（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

添加到容器 /etc/hosts 文件的主机名与 IP 映射列表，格式为 [\"hostname:IP\"]。

GroupAdd
数组元素类型 strings or null

容器进程运行时所属的附加用户组列表。

Init
boolean or null

在容器内运行初始化进程，转发信号并回收进程。为空时省略字段，使用守护进程配置的默认值。

IOMaximumBandwidth
integer or null <int64>

容器系统盘的最大每秒 IO 字节数（仅限 Windows）。

IOMaximumIOps
integer or null <int64>

容器系统盘的最大每秒 IO 次数（仅限 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>

内存总限制（内存加交换空间）。设为 -1 可启用无限交换空间。

MemorySwappiness
integer or null <int64>

调整容器内存交换倾向，接受 0 到 100 的整数。

数组元素类型 objects or null (Mount)

要添加到容器的挂载规格。

NanoCpus
integer or null <int64>

CPU 配额，以 10-9 个 CPU 为单位。

NetworkMode
string or null

容器使用的网络模式。支持标准值 bridge、host、none 和 container:<name|id>。其他值视为容器要连接的自定义网络名称。

OomKillDisable
boolean or null

禁用容器的 OOM killer。

OomScoreAdj
integer or null <int64>

整数值，表示容器的 OOM 分数，用于调整 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

用于自定义 SELinux 等 MLS 系统标签的字符串值列表。

ShmSize
integer or null <int64>

/dev/shm 大小，单位字节。省略时使用 64 MB。

object or null

容器存储驱动选项，格式为 {\"size\": \"120G\"}。

object or null

要在容器中设置的内核参数（sysctl）列表。例如：{\"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

容器 ID。

Image
string or null

容器镜像 ID。

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 是创建绑定挂载或卷挂载时用户提供的逗号分隔选项。默认值因平台而异（Linux 为 \"z\"，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

网络桥接接口名称，例如 docker0。

EndpointID
string or null

EndpointID 唯一标识沙箱中的服务端点。


> 已弃用：仅在连接默认 "bridge" 网络时传递此字段。请改用 Networks 映射中的 "bridge" 网络信息，它包含相同信息。此字段在 Docker 1.9 弃用，计划在 Docker 17.12.0 移除。

Gateway
string or null

默认 "bridge" 网络的网关地址。


> 已弃用：仅在连接默认 "bridge" 网络时传递此字段。请改用 Networks 映射中的 "bridge" 网络信息，它包含相同信息。此字段在 Docker 1.9 弃用，计划在 Docker 17.12.0 移除。

GlobalIPv6Address
string or null

默认 "bridge" 网络的全局 IPv6 地址。


> 已弃用：仅在连接默认 "bridge" 网络时传递此字段。请改用 Networks 映射中的 "bridge" 网络信息，它包含相同信息。此字段在 Docker 1.9 弃用，计划在 Docker 17.12.0 移除。

GlobalIPv6PrefixLen
integer or null <int64>

全局 IPv6 地址掩码长度。


> 已弃用：仅在连接默认 "bridge" 网络时传递此字段。请改用 Networks 映射中的 "bridge" 网络信息，它包含相同信息。此字段在 Docker 1.9 弃用，计划在 Docker 17.12.0 移除。

HairpinMode
boolean or null

表示虚拟接口是否启用 hairpin NAT。

IPAddress
string or null

默认 "bridge" 网络的 IPv4 地址。


> 已弃用：仅在连接默认 "bridge" 网络时传递此字段。请改用 Networks 映射中的 "bridge" 网络信息，它包含相同信息。此字段在 Docker 1.9 弃用，计划在 Docker 17.12.0 移除。

IPPrefixLen
integer or null <int64>

IPv4 地址掩码长度。


> 已弃用：仅在连接默认 "bridge" 网络时传递此字段。请改用 Networks 映射中的 "bridge" 网络信息，它包含相同信息。此字段在 Docker 1.9 弃用，计划在 Docker 17.12.0 移除。

IPv6Gateway
string or null

此网络的 IPv6 网关地址。


> 已弃用：仅在连接默认 "bridge" 网络时传递此字段。请改用 Networks 映射中的 "bridge" 网络信息，它包含相同信息。此字段在 Docker 1.9 弃用，计划在 Docker 17.12.0 移除。

LinkLocalIPv6Address
string or null

使用链路本地前缀的 IPv6 单播地址。

LinkLocalIPv6PrefixLen
integer or null <int64>

IPv6 单播地址的前缀长度。

MacAddress
string or null

默认 "bridge" 网络上容器的 MAC 地址。


> 已弃用：仅在连接默认 "bridge" 网络时传递此字段。请改用 Networks 映射中的 "bridge" 网络信息，它包含相同信息。此字段在 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 标识沙箱。

数组元素类型 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>

容器进程 ID。

Restarting
boolean or null

容器是否正在重启。

Running
boolean or null

容器是否运行。注意运行容器也可_暂停_，Running 和 Paused 布尔值不互斥。在 Linux 上暂停容器时，使用 freezer cgroup 挂起全部进程。冻结要求进程正在运行，因此暂停容器同时为 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>

容器进程 ID。

Restarting
boolean or null

容器是否正在重启。

Running
boolean or null

容器是否运行。注意运行容器也可_暂停_，Running 和 Paused 布尔值不互斥。在 Linux 上暂停容器时，使用 freezer cgroup 挂起全部进程。冻结要求进程正在运行，因此暂停容器同时为 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

此容器的 ID。

Image
string or null

创建此容器时使用的镜像名称。

ImageID
string or null

创建此容器所用镜像的 ID。

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 是创建绑定挂载或卷挂载时用户提供的逗号分隔选项。默认值因平台而异（Linux 为 \"z\"，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

连接 exec 命令的 stderr。

AttachStdin
boolean or null

连接 exec 命令的 stdin。

AttachStdout
boolean or null

连接 exec 命令的 stdout。

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

分配伪终端。

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

用户组 ID。

hostname
required
string

节点使用的主机名，未设置时自动检测。

hosts
required
数组元素类型 strings

监听地址列表。

nodes
required
数组元素类型 strings

要加入的节点列表。

state_dir
required
string

状态目录路径。

{
  • "hosts": [
    ],
  • "state_dir": "string",
  • "docker_host": "string",
  • "gateway": "string",
  • "hostname": "string",
  • "nodes": [
    ],
  • "advertise_addr": "string",
  • "conf_dir": "string",
  • "gid": 0
}

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 ]

权限能力列表，由多个“与”能力列表以“或”关系组成。

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
object or null

DriverOpts 是驱动选项和值的映射，直接传递给驱动，内容由具体驱动决定。

property name*
additional property
string
EndpointID
string or null

沙箱中服务端点的唯一 ID。

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

网络唯一 ID。

{
  • "IPAMConfig": {
    },
  • "Links": [
    ],
  • "Aliases": [
    ],
  • "NetworkID": "string",
  • "EndpointID": "string",
  • "Gateway": "string",
  • "IPAddress": "string",
  • "IPPrefixLen": 0,
  • "IPv6Gateway": "string",
  • "GlobalIPv6Address": "string",
  • "GlobalIPv6PrefixLen": 0,
  • "MacAddress": "string",
  • "DriverOpts": {
    }
}

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 进程的系统进程 ID。

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 表示继承。

StartPeriod
integer or null <int64>

容器初始化的启动宽限期，在此期间不开始健康检查重试倒计时，单位纳秒。应为 0 或至少 1000000（1 毫秒），0 表示继承。

Test
数组元素类型 strings or null

要执行的测试，可选值：[] 继承镜像或父镜像的健康检查；[\"NONE\"] 禁用健康检查；[\"CMD\", args...] 直接执行参数；[\"CMD-SHELL\", command] 用系统默认 Shell 运行命令。

Timeout
integer or null <int64>

判定检查卡住之前的等待时间，应为 0 或至少 1000000（1 毫秒），0 表示继承。

{
  • "Test": [
    ],
  • "Interval": 0,
  • "Timeout": 0,
  • "Retries": 0,
  • "StartPeriod": 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)

限制设备读取速率（每秒 IO 次数），格式为：[{\"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)

限制设备写入速率（每秒 IO 次数），格式为：[{\"Path\": \"device_path\", \"Rate\": rate}]

Array
Path
string or null

设备路径。

Rate
integer or null <int64>

速率。

BlkioWeight
integer or null <int32> >= 0

块 IO 权重（相对权重）。

数组元素类型 objects or null (ResourcesBlkioWeightDevice)

块 IO 权重（相对设备权重），格式为：[{\"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 路径。不存在时会创建 cgroup。

ConsoleSize
数组元素类型 integers or null <int32> [ items <int32 > ]

初始控制台大小，以 [height, width] 数组表示。

ContainerIDFile
string or null

写入容器 ID 的文件路径。

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 周期内可获得的 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

允许执行的内存节点 MEM（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 ]

权限能力列表，由多个“与”能力列表以“或”关系组成。

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

添加到容器 /etc/hosts 文件的主机名与 IP 映射列表，格式为 [\"hostname:IP\"]。

GroupAdd
数组元素类型 strings or null

容器进程运行时所属的附加用户组列表。

Init
boolean or null

在容器内运行初始化进程，转发信号并回收进程。为空时省略字段，使用守护进程配置的默认值。

IOMaximumBandwidth
integer or null <int64>

容器系统盘的最大每秒 IO 字节数（仅限 Windows）。

IOMaximumIOps
integer or null <int64>

容器系统盘的最大每秒 IO 次数（仅限 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>

内存总限制（内存加交换空间）。设为 -1 可启用无限交换空间。

MemorySwappiness
integer or null <int64>

调整容器内存交换倾向，接受 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 个 CPU 为单位。

NetworkMode
string or null

容器使用的网络模式。支持标准值 bridge、host、none 和 container:<name|id>。其他值视为容器要连接的自定义网络名称。

OomKillDisable
boolean or null

禁用容器的 OOM killer。

OomScoreAdj
integer or null <int64>

整数值，表示容器的 OOM 分数，用于调整 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

用于自定义 SELinux 等 MLS 系统标签的字符串值列表。

ShmSize
integer or null <int64>

/dev/shm 大小，单位字节。省略时使用 64 MB。

object or null

容器存储驱动选项，格式为 {\"size\": \"120G\"}。

property name*
additional property
string
object or null

要在容器中设置的内核参数（sysctl）列表。例如：{\"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。

CgroupDriver
string or null
枚举值: "EMPTY" "cgroupfs" "systemd" "none"
CgroupVersion
string or null
枚举值: "EMPTY" "1" "2"
ClusterAdvertise
string or null

Engine 公布用于节点发现的网络端点。ClusterAdvertise 是其他主机可访问守护进程的 host:port 组合。


> 已弃用：仅独立 Swarm 模式及使用外部键值存储的覆盖网络传递此字段。启用 Swarm 模式的覆盖网络使用内置 Raft 存储，此字段为空。

ClusterStore
string or null

分布式存储后端 URL，用于多主机网络保存网络和端点信息，也用于节点发现。


> 已弃用：仅独立 Swarm 模式及使用外部键值存储的覆盖网络传递此字段。启用 Swarm 模式的覆盖网络使用内置 Raft 存储，此字段为空。

required
object (DaemonConfig)

守护进程配置，用于配置守护进程。

advertise_addr
required
string

向其他节点公布的地址。

conf_dir
required
string

配置目录。

docker_host
string

使用的 Docker 主机。

gateway
required
string

主机网关，未设置时自动检测默认网关。

gid
required
integer <int32> >= 0

用户组 ID。

hostname
required
string

节点使用的主机名，未设置时自动检测。

hosts
required
数组元素类型 strings

监听地址列表。

nodes
required
数组元素类型 strings

要加入的节点列表。

state_dir
required
string

状态目录路径。

object or null

Commit 保存构建二进制文件所用的 Git 提交（SHA1），由 containerd、runC 等外部工具的版本字符串报告。

Expected
string or null

dockerd 在构建时设置的预期外部工具提交 ID。

ID
string or null

外部工具的实际提交 ID。

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（完全公平调度器）周期。

CpuCfsQuota
boolean or null

表示主机是否支持 CPU CFS（完全公平调度器）配额。

CPUSet
boolean or null

表示主机是否支持 CPUset（cpuset.cpus、cpuset.mems）。参见 cpuset(7)。

CPUShares
boolean or null

表示主机是否支持 CPU Shares 限制。

Debug
boolean or null

表示守护进程是否在调试模式运行，或启用了调试级日志。

数组元素类型 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 持久化状态根目录。Linux 默认为 /var/lib/docker，Windows 默认为 C:\\ProgramData\\docker。

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 环境变量。API 响应会遮蔽代理 URL 中的凭据（用户信息部分）。容器不会自动继承此配置。

HttpsProxy
string or null

守护进程的 HTTPS 代理配置，来自 HTTPS_PROXY 环境变量。API 响应会遮蔽代理 URL 中的凭据（用户信息部分）。容器不会自动继承此配置。

ID
string or null

守护进程唯一标识。


> 注意：ID 格式本身不属于 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。

ID
string or null

外部工具的实际提交 ID。

IPv4Forwarding
boolean or null

表示是否启用 IPv4 转发。

Isolation
string or null
枚举值: "EMPTY" "default" "hyperv" "process"
KernelMemoryTCP
boolean or null

表示主机是否启用内核 TCP 内存限制，不支持时省略。cgroup v2 不支持内核 TCP 内存限制及对应的 memory.kmem.tcp.limit_in_bytes cgroup。

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) 端点获取。

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>

当前 goroutine 数量，仅在启用调试模式时返回。

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（未知 CA 证书）通信。默认本地仓库（127.0.0.0/8）为不安全，其余仓库为安全。如果守护进程认为仓库安全，则无法进行不安全通信。此配置覆盖该行为，允许对解析 IP 位于指定 CIDR 子网内的仓库进行不安全通信。也可按主机名标记不安全仓库，列在 IndexConfigs 中，Secure 为 false。> 警告：本地仓库测试时此选项可能有用，但存在安全漏洞，只应用于测试。应将 CA 加入系统可信 CA 列表，而不是启用此选项。

Mirrors
数组元素类型 strings or null

作为官方 docker.io 仓库镜像源的仓库 URL 列表。

object or null

Commit 保存构建二进制文件所用的 Git 提交（SHA1），由 containerd、runC 等外部工具的版本字符串报告。

Expected
string or null

dockerd 在构建时设置的预期外部工具提交 ID。

ID
string or null

外部工具的实际提交 ID。

object or null

守护进程配置的 OCI 兼容运行时列表，键保存引用运行时的名称。Docker 守护进程依靠经 containerd 调用的 OCI 运行时连接 Linux 内核命名空间、cgroup 和 SELinux。默认运行时是自动配置的 runc；用户可配置额外运行时，并在此列出。

additional property
object (Runtime)

Runtime 描述 OCI 兼容运行时。守护进程通过 containerd 调用运行时，连接 Linux 内核命名空间、cgroup 和 SELinux。

SecurityOptions
数组元素类型 strings or null

守护进程启用的安全功能列表，如 apparmor、seccomp、SELinux、用户命名空间 userns、rootless 和 no-new-privileges。各功能可能包含额外配置，以逗号分隔的键值对列出。

ServerVersion
string or null

守护进程版本字符串。> 注意：独立 Swarm API 返回 Swarm 版本，而不是守护进程版本，例如 swarm/1.2.8。

SwapLimit
boolean or null

表示主机是否支持交换内存限制。

object or null

表示 Swarm 通用信息。

object or null

ClusterInfo 表示 "/info" 端点返回的 Swarm 信息，不包含加入令牌。

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

Swarm 中其他节点访问此节点的 IP 地址。

NodeID
string or null

节点在 Swarm 中的唯一标识。

Nodes
integer or null <int64>

Swarm 节点总数。

数组元素类型 objects or null (PeerNode)

Swarm 中其他管理节点的 ID 和地址列表。

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",
  • "ClusterStore": "string",
  • "ClusterAdvertise": "string",
  • "Runtimes": {
    },
  • "DefaultRuntime": "string",
  • "Swarm": {
    },
  • "LiveRestoreEnabled": true,
  • "Isolation": "EMPTY",
  • "InitBinary": "string",
  • "ContainerdCommit": {
    },
  • "RuncCommit": {
    },
  • "InitCommit": {
    },
  • "SecurityOptions": [
    ],
  • "ProductLicense": "string",
  • "DefaultAddressPools": [
    ],
  • "Warnings": [
    ],
  • "HostGateway": "string",
  • "Config": {
    }
}

HttpTarget

Redirect
string or null
枚举值: "MovedPermanently" "Permanent" "Temporary"
Url
required
string

目标 URL。

{
  • "Url": "string",
  • "Redirect": "MovedPermanently"
}

ImageInspect

Architecture
string or null

镜像运行的硬件 CPU 架构。

Author
string or null

提交镜像时指定的作者，或 Dockerfile 中已弃用的 MAINTAINER 指令指定的作者。

Comment
string or null

提交或导入镜像时设置的可选消息。

object or null

可在主机间移植的容器配置。用作镜像的 ContainerConfig 字段时，ContainerConfig 是可选字段，保存创建镜像时最后提交的容器配置。旧版 Docker 构建器曾用它保存构建缓存，现在已不再使用。

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

容器入口点，指定为字符串或字符串数组。如果数组仅包含一个空字符串（[\"\"]），则重置为系统默认入口点，即没有 ENTRYPOINT 指令的 Dockerfile 所对应的 Docker 入口点。

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 地址。

NetworkDisabled
boolean or null

禁用容器网络。

OnBuild
数组元素类型 strings or null

ONBUILD 元数据，定义于镜像的 Dockerfile。

OpenStdin
boolean or null

打开 stdin。

Shell
数组元素类型 strings or null

RUN、CMD 和 ENTRYPOINT 使用 Shell 时所用的 Shell。

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

命令运行的工作目录。

Container
string or null

创建镜像所用容器的 ID，根据镜像创建方式可能为空。

object or null

可在主机间移植的容器配置。用作镜像的 ContainerConfig 字段时，ContainerConfig 是可选字段，保存创建镜像时最后提交的容器配置。旧版 Docker 构建器曾用它保存构建缓存，现在已不再使用。

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

容器入口点，指定为字符串或字符串数组。如果数组仅包含一个空字符串（[\"\"]），则重置为系统默认入口点，即没有 ENTRYPOINT 指令的 Dockerfile 所对应的 Docker 入口点。

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 地址。

NetworkDisabled
boolean or null

禁用容器网络。

OnBuild
数组元素类型 strings or null

ONBUILD 元数据，定义于镜像的 Dockerfile。

OpenStdin
boolean or null

打开 stdin。

Shell
数组元素类型 strings or null

RUN、CMD 和 ENTRYPOINT 使用 Shell 时所用的 Shell。

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

镜像创建日期和时间，使用纳秒精度的 RFC 3339 格式。

DockerVersion
string or null

构建镜像使用的 Docker 版本，根据镜像创建方式可能为空。

object or null

用于保存容器和镜像文件系统的存储驱动信息。

required
object

底层存储元数据，以键值对提供。信息由所用存储驱动决定，仅供参考。

Name
required
string

存储驱动名称。

Id
string or null

ID 是镜像的内容寻址标识。它是根据镜像配置计算的内容摘要，配置包含镜像各层摘要。注意它不同于下方的 RepoDigests，后者保存引用此镜像的镜像清单摘要。

object or null

本地缓存中的附加镜像元数据。这些信息仅属于守护进程，不是镜像本身的一部分。

LastTagTime
string or null (BollardDate)

BollardDate

Os
string or null

镜像构建所针对的操作系统。

OsVersion
string or null

镜像构建所针对的操作系统版本，尤其适用于 Windows。

Parent
string or null

父镜像 ID。根据镜像创建方式，该字段可能为空，仅本地构建或创建的镜像会设置。从镜像仓库拉取的镜像不设置此字段。

RepoDigests
数组元素类型 strings or null

本地可用镜像清单的内容寻址摘要列表，这些清单引用此镜像。多个清单可指向同一镜像。通常只有镜像从仓库拉取或推送到仓库后才有摘要，因为此时才生成清单并计算摘要。

RepoTags
数组元素类型 strings or null

本地镜像缓存中引用此镜像的名称或标签列表。多个标签可引用同一镜像；没有标签时列表可为空，镜像处于无标签状态，但仍能用 ID 引用。

object or null

镜像 RootFS 信息，包括层 ID。

Layers
数组元素类型 strings or null
Type
required
string
Size
integer or null <int64>

镜像总大小，包括全部组成层。

Variant
string or null

CPU 架构变体（目前仅适用于 ARM）。

VirtualSize
integer or null <int64>

镜像总大小，包括全部组成层。Docker v1.10 之前根据镜像及其全部父镜像计算。现在镜像独立保存，不再使用父链，此字段等价于 Size。> 已弃用：为兼容旧版本保留，将在 API v1.44 移除。

{
  • "Id": "string",
  • "RepoTags": [
    ],
  • "RepoDigests": [
    ],
  • "Parent": "string",
  • "Comment": "string",
  • "Created": "string",
  • "Container": "string",
  • "ContainerConfig": {
    },
  • "DockerVersion": "string",
  • "Author": "string",
  • "Config": {
    },
  • "Architecture": "string",
  • "Variant": "string",
  • "Os": "string",
  • "OsVersion": "string",
  • "Size": 0,
  • "VirtualSize": 0,
  • "GraphDriver": {
    },
  • "RootFS": {
    },
  • "Metadata": {
    }
}

ImageInspectMetadata

LastTagTime
string or null (BollardDate)

BollardDate

{
  • "LastTagTime": "2021-01-01T00:00:00.000000000Z"
}

ImageInspectRootFs

Layers
数组元素类型 strings or null
Type
required
string
{
  • "Type": "string",
  • "Layers": [
    ]
}

ImageSummary

Containers
required
integer <int64>

使用此镜像的容器数量，包括停止和运行中的容器。默认不计算，取决于所用 API 端点。-1 表示未设置或计算。

Created
required
integer <int64>

镜像创建日期和时间，使用 Unix 时间戳（自 EPOCH 起的秒数）。

Id
required
string

ID 是镜像的内容寻址标识。它是根据镜像配置计算的内容摘要，配置包含镜像各层摘要。注意它不同于下方的 RepoDigests，后者保存引用此镜像的镜像清单摘要。

required
object

用户定义的键值元数据。

property name*
additional property
string
ParentId
required
string

父镜像 ID。根据镜像创建方式，该字段可能为空，仅本地构建或创建的镜像会设置。从镜像仓库拉取的镜像不设置此字段。

RepoDigests
required
数组元素类型 strings

本地可用镜像清单的内容寻址摘要列表，这些清单引用此镜像。多个清单可指向同一镜像。通常只有镜像从仓库拉取或推送到仓库后才有摘要，因为此时才生成清单并计算摘要。

RepoTags
required
数组元素类型 strings

本地镜像缓存中引用此镜像的名称或标签列表。多个标签可引用同一镜像；没有标签时列表可为空，镜像处于无标签状态，但仍能用 ID 引用。

SharedSize
required
integer <int64>

此镜像与其他镜像共享层的总大小。默认不计算；-1 表示未设置或计算。

Size
required
integer <int64>

镜像总大小，包括全部组成层。

VirtualSize
integer or null <int64>

镜像总大小，包括全部组成层。Docker v1.10 之前根据镜像及其全部父镜像计算。现在镜像独立保存，不再使用父链，此字段等价于 Size。已弃用：为兼容旧版本保留，将在 API v1.44 移除。

{
  • "Id": "string",
  • "ParentId": "string",
  • "RepoTags": [
    ],
  • "RepoDigests": [
    ],
  • "Created": 0,
  • "Size": 0,
  • "SharedSize": 0,
  • "VirtualSize": 0,
  • "Labels": {
    },
  • "Containers": 0
}

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（使用未知 CA 证书）通信。> 警告：不安全仓库有助于本地测试，但存在安全漏洞，只应在测试时启用。为了提高安全性，应将 CA 加入系统可信 CA 列表，而不是启用此选项。

{
  • "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

容器入口点，指定为字符串或字符串数组。如果数组仅包含一个空字符串（[\"\"]），则重置为系统默认入口点，即没有 ENTRYPOINT 指令的 Dockerfile 所对应的 Docker 入口点。

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 使用 Shell 时所用的 Shell。

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>

任务创建时间。

object

用户定义的元数据。

additional property
string or number or boolean or 数组元素类型 Any (any) or object (Any)

为 OpenApi 生成 Any 类型的辅助工具，适用于 ResourceSpec 等动态 JSON 对象。

Name
required
string

任务名称。

Schedule
string or null

任务调度时间（cron）。

Secrets
数组元素类型 strings or null

作为环境变量加载的 Secret。

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",
  • "Secrets": [
    ],
  • "Metadata": {
    },
  • "Schedule": "string",
  • "Ttl": 0,
  • "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"
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>

任务创建时间。

object

用户定义的元数据。

Name
required
string

任务名称。

Schedule
string or null

任务调度时间（cron）。

Secrets
数组元素类型 strings or null

作为环境变量加载的 Secret。

Ttl
integer or null >= 0

执行完成 x 秒后移除任务。

UpdatedAt
required
string <date-time>

任务更新时间。

{
  • "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

容器入口点，指定为字符串或字符串数组。如果数组仅包含一个空字符串（[\"\"]），则重置为系统默认入口点，即没有 ENTRYPOINT 指令的 Dockerfile 所对应的 Docker 入口点。

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 使用 Shell 时所用的 Shell。

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

用户定义的元数据。

additional property
string or number or boolean or 数组元素类型 Any (any) or object (Any)

为 OpenApi 生成 Any 类型的辅助工具，适用于 ResourceSpec 等动态 JSON 对象。

Name
required
string

任务名称。

Schedule
string or null

任务调度时间（cron）。

Secrets
数组元素类型 strings or null

作为环境变量加载的 Secret。

Ttl
integer or null >= 0

执行完成 x 秒后移除任务。

{
  • "Name": "string",
  • "Secrets": [
    ],
  • "Metadata": {
    },
  • "Schedule": "string",
  • "Ttl": 0,
  • "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>

任务创建时间。

object

用户定义的元数据。

Name
required
string

任务名称。

Schedule
string or null

任务调度时间（cron）。

Secrets
数组元素类型 strings or null

作为环境变量加载的 Secret。

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 时的目标路径。

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

指标数据。

ExpireAt
required
string <date-time>

指标到期时间。

Key
required
string <uuid>

数据库中指标的键，类型为 UUID。

Kind
required
string

指标类型。

NodeName
required
string

指标来源节点。

{
  • "Key": "5eb041b0-19c9-4022-bd51-0e723885f5dd",
  • "CreatedAt": "2019-08-24T14:15:22Z",
  • "ExpireAt": "2019-08-24T14:15:22Z",
  • "NodeName": "string",
  • "Kind": "string",
  • "Data": null
}

MetricPartial

Data
required
any

指标数据。

Kind
required
string

指标类型。

{
  • "Kind": "string",
  • "Data": null
}

Mount

object or null

bind 类型的可选配置。

CreateMountpoint
boolean or null

主机挂载点缺失时创建。

NonRecursive
boolean or null

禁用递归绑定挂载。

Propagation
string or null
枚举值: "EMPTY" "private" "rprivate" "shared" "rshared" "slave" "rslave"
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"
{
  • "Propagation": "EMPTY",
  • "NonRecursive": true,
  • "CreateMountpoint": 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 是创建绑定挂载或卷挂载时用户提供的逗号分隔选项。默认值因平台而异（Linux 为 \"z\"，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

Name
required
string

命名空间名称。

{
  • "Name": "string"
}

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 spec 是 Cargo 的规格，用于了解 Cargo 状态，并在更新现有 Cargo 时跟踪历史记录。

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 <int64>

Cargo 数量。

Gateway
required
string

命名空间网关。

Instances
required
integer <int64>

实例数量。

Name
required
string

命名空间名称。

{
  • "Name": "string",
  • "Cargoes": 0,
  • "Instances": 0,
  • "Gateway": "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

网络桥接接口名称，例如 docker0。

EndpointID
string or null

EndpointID 唯一标识沙箱中的服务端点。


> 已弃用：仅在连接默认 "bridge" 网络时传递此字段。请改用 Networks 映射中的 "bridge" 网络信息，它包含相同信息。此字段在 Docker 1.9 弃用，计划在 Docker 17.12.0 移除。

Gateway
string or null

默认 "bridge" 网络的网关地址。


> 已弃用：仅在连接默认 "bridge" 网络时传递此字段。请改用 Networks 映射中的 "bridge" 网络信息，它包含相同信息。此字段在 Docker 1.9 弃用，计划在 Docker 17.12.0 移除。

GlobalIPv6Address
string or null

默认 "bridge" 网络的全局 IPv6 地址。


> 已弃用：仅在连接默认 "bridge" 网络时传递此字段。请改用 Networks 映射中的 "bridge" 网络信息，它包含相同信息。此字段在 Docker 1.9 弃用，计划在 Docker 17.12.0 移除。

GlobalIPv6PrefixLen
integer or null <int64>

全局 IPv6 地址掩码长度。


> 已弃用：仅在连接默认 "bridge" 网络时传递此字段。请改用 Networks 映射中的 "bridge" 网络信息，它包含相同信息。此字段在 Docker 1.9 弃用，计划在 Docker 17.12.0 移除。

HairpinMode
boolean or null

表示虚拟接口是否启用 hairpin NAT。

IPAddress
string or null

默认 "bridge" 网络的 IPv4 地址。


> 已弃用：仅在连接默认 "bridge" 网络时传递此字段。请改用 Networks 映射中的 "bridge" 网络信息，它包含相同信息。此字段在 Docker 1.9 弃用，计划在 Docker 17.12.0 移除。

IPPrefixLen
integer or null <int64>

IPv4 地址掩码长度。


> 已弃用：仅在连接默认 "bridge" 网络时传递此字段。请改用 Networks 映射中的 "bridge" 网络信息，它包含相同信息。此字段在 Docker 1.9 弃用，计划在 Docker 17.12.0 移除。

IPv6Gateway
string or null

此网络的 IPv6 网关地址。


> 已弃用：仅在连接默认 "bridge" 网络时传递此字段。请改用 Networks 映射中的 "bridge" 网络信息，它包含相同信息。此字段在 Docker 1.9 弃用，计划在 Docker 17.12.0 移除。

LinkLocalIPv6Address
string or null

使用链路本地前缀的 IPv6 单播地址。

LinkLocalIPv6PrefixLen
integer or null <int64>

IPv6 单播地址的前缀长度。

MacAddress
string or null

默认 "bridge" 网络上容器的 MAC 地址。


> 已弃用：仅在连接默认 "bridge" 网络时传递此字段。请改用 Networks 映射中的 "bridge" 网络信息，它包含相同信息。此字段在 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 标识沙箱。

数组元素类型 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"
}

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 字段时，ContainerConfig 是可选字段，保存创建镜像时最后提交的容器配置。旧版 Docker 构建器曾用它保存构建缓存，现在已不再使用。

Created
string or null

容器创建时间。

Driver
string or null
ExecIDs
数组元素类型 strings or null

容器中运行的 exec 实例 ID。

object or null

用于保存容器和镜像文件系统的存储驱动信息。

object or null

依赖当前主机的容器配置。

HostnamePath
string or null
HostsPath
string or null
Id
string or null

容器 ID。

Image
string or null

容器镜像 ID。

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"
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"

ProxyHttpLocation

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 时的目标路径。

Port
required
integer <int32> >= 0

目标 Cargo 或 VM 的端口。

Version
number or null <double>

使用的 HTTP 版本。

{
  • "Path": "string",
  • "Target": {
    },
  • "Headers": [
    ],
  • "Version": 0.1
}

ProxyRule

One of
Domain
string or null

域名。

Includes
数组元素类型 strings or null

要包含的额外配置文件路径。

required
数组元素类型 objects (ProxyHttpLocation)

处理多个路径的 location。

Array
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

DH 参数文件路径。

VerifyClient
boolean or null

启用或禁用客户端验证。

Example
{
  • "Domain": "string",
  • "Network": "string",
  • "Locations": [
    ],
  • "Ssl": {
    },
  • "Includes": [
    ]
}

ProxyRuleHttp

Domain
string or null

域名。

Includes
数组元素类型 strings or null

要包含的额外配置文件路径。

required
数组元素类型 objects (ProxyHttpLocation)

处理多个路径的 location。

Array
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

DH 参数文件路径。

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

DH 参数文件路径。

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 时的目标路径。

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

DH 参数文件路径。

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

DH 参数文件路径。

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（未知 CA 证书）通信。默认本地仓库（127.0.0.0/8）为不安全，其余仓库为安全。如果守护进程认为仓库安全，则无法进行不安全通信。此配置覆盖该行为，允许对解析 IP 位于指定 CIDR 子网内的仓库进行不安全通信。也可按主机名标记不安全仓库，列在 IndexConfigs 中，Secure 为 false。> 警告：本地仓库测试时此选项可能有用，但存在安全漏洞，只应用于测试。应将 CA 加入系统可信 CA 列表，而不是启用此选项。

Mirrors
数组元素类型 strings or null

作为官方 docker.io 仓库镜像源的仓库 URL 列表。

{
  • "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)

为 OpenApi 生成 Any 类型的辅助工具，适用于 ResourceSpec 等动态 JSON 对象。

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)

为 OpenApi 生成 Any 类型的辅助工具，适用于 ResourceSpec 等动态 JSON 对象。

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)

为 OpenApi 生成 Any 类型的辅助工具，适用于 ResourceSpec 等动态 JSON 对象。

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)

为 OpenApi 生成 Any 类型的辅助工具，适用于 ResourceSpec 等动态 JSON 对象。

Kind
required
string

资源类型。

object

资源的用户定义元数据。

additional property
string or number or boolean or 数组元素类型 Any (any) or object (Any)

为 OpenApi 生成 Any 类型的辅助工具，适用于 ResourceSpec 等动态 JSON 对象。

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)

处理多个路径的 location。

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)

为 OpenApi 生成 Any 类型的辅助工具，适用于 ResourceSpec 等动态 JSON 对象。

Key
required
string <uuid>

资源键。

object

资源的用户定义元数据。

additional property
string or number or boolean or 数组元素类型 Any (any) or object (Any)

为 OpenApi 生成 Any 类型的辅助工具，适用于 ResourceSpec 等动态 JSON 对象。

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)

为 OpenApi 生成 Any 类型的辅助工具，适用于 ResourceSpec 等动态 JSON 对象。

object

以 JSON 对象表示的资源元数据。

additional property
string or number or boolean or 数组元素类型 Any (any) or object (Any)

为 OpenApi 生成 Any 类型的辅助工具，适用于 ResourceSpec 等动态 JSON 对象。

{
  • "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

调用运行时时传入的命令行参数列表。

{
  • "path": "string",
  • "runtimeArgs": [
    ]
}

Secret

CreatedAt
required
string <date-time>

创建时间。

required
object

Secret 数据。

additional property
string or number or boolean or 数组元素类型 Any (any) or object (Any)

为 OpenApi 生成 Any 类型的辅助工具，适用于 ResourceSpec 等动态 JSON 对象。

Immutable
required
boolean

无法更新 Secret。

Kind
required
string

Secret 类型。

object
additional property
string or number or boolean or 数组元素类型 Any (any) or object (Any)

为 OpenApi 生成 Any 类型的辅助工具，适用于 ResourceSpec 等动态 JSON 对象。

Name
required
string

Secret 名称。

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

Secret 数据。

additional property
string or number or boolean or 数组元素类型 Any (any) or object (Any)

为 OpenApi 生成 Any 类型的辅助工具，适用于 ResourceSpec 等动态 JSON 对象。

Immutable
boolean or null

无法更新 Secret。

Kind
required
string

Secret 类型。

object

资源的用户定义元数据。

additional property
string or number or boolean or 数组元素类型 Any (any) or object (Any)

为 OpenApi 生成 Any 类型的辅助工具，适用于 ResourceSpec 等动态 JSON 对象。

Name
required
string

Secret 名称。

{
  • "Name": "string",
  • "Kind": "string",
  • "Immutable": true,
  • "Metadata": {
    },
  • "Data": {
    }
}

SecretUpdate

required
object

以 JSON 对象表示的 Secret 数据。

additional property
string or number or boolean or 数组元素类型 Any (any) or object (Any)

为 OpenApi 生成 Any 类型的辅助工具，适用于 ResourceSpec 等动态 JSON 对象。

object

Secret 的用户定义元数据。

additional property
string or number or boolean or 数组元素类型 Any (any) or object (Any)

为 OpenApi 生成 Any 类型的辅助工具，适用于 ResourceSpec 等动态 JSON 对象。

{
  • "Metadata": {
    },
  • "Data": {
    }
}

StartExecOptions

Detach
required
boolean

与命令分离。

OutputCapacity
integer or null >= 0

单行输出最大大小，默认为 8 * 1024（约 1024 个字符）。

Tty
required
boolean

分配伪终端。

{
  • "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

构建参数类型。

Name
required
string

构建参数名称。

数组元素类型 objects or null (CargoSpecPartial)

要创建并运行的 Cargo 列表。

Array
required
object (Config)

要创建的容器。

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 确保集群至少存在 1 个副本。

判别字段： Mode.

Secrets
数组元素类型 strings or null

用作环境变量的 Secret 列表。

Group
string or null

设置定义对象的组，默认为 {name_of_directory}.{name_of_file}。

数组元素类型 objects or null (JobPartial)

要创建并运行的任务列表。

Array
required
数组元素类型 objects (Config)

要运行的容器列表。

object

用户定义的元数据。

Name
required
string

任务名称。

Schedule
string or null

任务调度时间（cron）。

Secrets
数组元素类型 strings or null

作为环境变量加载的 Secret。

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)

要创建的 Secret 列表。

Array
required
object

Secret 数据。

Immutable
boolean or null

无法更新 Secret。

Kind
required
string

Secret 类型。

object

资源的用户定义元数据。

Name
required
string

Secret 名称。

数组元素类型 objects or null (VmSpecPartial)

要创建并运行的虚拟机列表。

Array
required
object (VmDisk)

VM 的磁盘表示。

object or null

VM 的资源（CPU、内存、网络）。

Hostname
string or null

VM 主机名（默认：根据名称生成）。

object or null

用户定义的键值元数据。

MacAddress
string or null

VM 的 MAC 地址（默认自动生成）。

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": [
    ],
  • "Group": "string",
  • "Namespace": "string",
  • "Secrets": [
    ],
  • "Resources": [
    ],
  • "Cargoes": [
    ],
  • "VirtualMachines": [
    ],
  • "Jobs": [
    ]
}

StatefileArg

Default
string or null

构建参数默认值。

Kind
required
string

构建参数类型。

Name
required
string

构建参数名称。

{
  • "Name": "string",
  • "Kind": "string",
  • "Default": "string"
}

Stats

required
object (BlkioStats)

容器 I/O 统计。

数组元素类型 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
required
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
required
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)

容器进程 ID 统计。

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)

容器文件 I/O 统计。

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 时的目标路径。

Port
required
integer <int32> >= 0

目标 Cargo 或 VM 的端口。

Example
{
  • "Key": "string",
  • "Port": 0,
  • "Path": "string",
  • "DisableLogging": true
}

SwarmInfo

object or null

ClusterInfo 表示 "/info" 端点返回的 Swarm 信息，不包含加入令牌。

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 ID。

RootRotationInProgress
boolean or null

Swarm 是否正在轮换根 CA。

object or null

用户可修改的 Swarm 配置。

SubnetSize
integer or null <int32> >= 0

SubnetSize 指定从默认子网池创建网络时的子网大小。

object or null

叶 TLS 证书颁发者及可信根 CA 证书的信息。

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

Swarm 中其他节点访问此节点的 IP 地址。

NodeID
string or null

节点在 Swarm 中的唯一标识。

Nodes
integer or null <int64>

Swarm 节点总数。

数组元素类型 objects or null (PeerNode)

Swarm 中其他管理节点的 ID 和地址列表。

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

CA 配置。

数组元素类型 objects or null (SwarmSpecCaConfigExternalCas)

将签名请求转发给外部证书颁发机构的配置。

ForceRotate
integer or null <int64> >= 0

用于强制 Swarm 生成新签名 CA 证书和密钥的整数；仅在未指定 SigningCACert 和 SigningCAKey 时生效。

NodeCertExpiry
integer or null <int64>

节点证书的签发有效期。

SigningCACert
string or null

为全部 Swarm 节点 TLS 叶证书签名的目标 CA 证书，PEM 格式。

SigningCAKey
string or null

为全部 Swarm 节点 TLS 叶证书签名的目标 CA 私钥，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>

跟随节点等待领导节点消息的 tick 数，超过后成为候选并启动选举。ElectionTick 必须大于 HeartbeatTick。目前 tick 默认为一秒，所以当前可直接对应秒数，但不保证始终如此。

HeartbeatTick
integer or null <int64>

心跳之间的 tick 数。每经过 HeartbeatTick 个 tick，领导节点向跟随节点发送心跳。目前 tick 默认为一秒，所以当前可直接对应秒数，但不保证始终如此。

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

外部 CA 签发 TLS 证书使用的根 CA 证书，PEM 格式。未提供时假定使用当前 Swarm 根 CA 证书。

object or null

包含键值对的对象，作为外部 CA 驱动的协议专属选项解释。

Protocol
string or null
枚举值: "EMPTY" "cfssl"
URL
string or null

证书签名请求发送的 URL。

ForceRotate
integer or null <int64> >= 0

用于强制 Swarm 生成新签名 CA 证书和密钥的整数；仅在未指定 SigningCACert 和 SigningCAKey 时生效。

NodeCertExpiry
integer or null <int64>

节点证书的签发有效期。

SigningCACert
string or null

为全部 Swarm 节点 TLS 叶证书签名的目标 CA 证书，PEM 格式。

SigningCAKey
string or null

为全部 Swarm 节点 TLS 叶证书签名的目标 CA 私钥，PEM 格式。

{
  • "NodeCertExpiry": 0,
  • "ExternalCAs": [
    ],
  • "SigningCACert": "string",
  • "SigningCAKey": "string",
  • "ForceRotate": 0
}

SwarmSpecCaConfigExternalCas

CACert
string or null

外部 CA 签发 TLS 证书使用的根 CA 证书，PEM 格式。未提供时假定使用当前 Swarm 根 CA 证书。

object or null

包含键值对的对象，作为外部 CA 驱动的协议专属选项解释。

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>

跟随节点等待领导节点消息的 tick 数，超过后成为候选并启动选举。ElectionTick 必须大于 HeartbeatTick。目前 tick 默认为一秒，所以当前可直接对应秒数，但不保证始终如此。

HeartbeatTick
integer or null <int64>

心跳之间的 tick 数。每经过 HeartbeatTick 个 tick，领导节点向跟随节点发送心跳。目前 tick 默认为一秒，所以当前可直接对应秒数，但不保证始终如此。

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。

CgroupDriver
string or null
枚举值: "EMPTY" "cgroupfs" "systemd" "none"
CgroupVersion
string or null
枚举值: "EMPTY" "1" "2"
ClusterAdvertise
string or null

Engine 公布用于节点发现的网络端点。ClusterAdvertise 是其他主机可访问守护进程的 host:port 组合。


> 已弃用：仅独立 Swarm 模式及使用外部键值存储的覆盖网络传递此字段。启用 Swarm 模式的覆盖网络使用内置 Raft 存储，此字段为空。

ClusterStore
string or null

分布式存储后端 URL，用于多主机网络保存网络和端点信息，也用于节点发现。


> 已弃用：仅独立 Swarm 模式及使用外部键值存储的覆盖网络传递此字段。启用 Swarm 模式的覆盖网络使用内置 Raft 存储，此字段为空。

object or null

Commit 保存构建二进制文件所用的 Git 提交（SHA1），由 containerd、runC 等外部工具的版本字符串报告。

Expected
string or null

dockerd 在构建时设置的预期外部工具提交 ID。

ID
string or null

外部工具的实际提交 ID。

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（完全公平调度器）周期。

CpuCfsQuota
boolean or null

表示主机是否支持 CPU CFS（完全公平调度器）配额。

CPUSet
boolean or null

表示主机是否支持 CPUset（cpuset.cpus、cpuset.mems）。参见 cpuset(7)。

CPUShares
boolean or null

表示主机是否支持 CPU Shares 限制。

Debug
boolean or null

表示守护进程是否在调试模式运行，或启用了调试级日志。

数组元素类型 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 持久化状态根目录。Linux 默认为 /var/lib/docker，Windows 默认为 C:\\ProgramData\\docker。

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 环境变量。API 响应会遮蔽代理 URL 中的凭据（用户信息部分）。容器不会自动继承此配置。

HttpsProxy
string or null

守护进程的 HTTPS 代理配置，来自 HTTPS_PROXY 环境变量。API 响应会遮蔽代理 URL 中的凭据（用户信息部分）。容器不会自动继承此配置。

ID
string or null

守护进程唯一标识。


> 注意：ID 格式本身不属于 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。

ID
string or null

外部工具的实际提交 ID。

IPv4Forwarding
boolean or null

表示是否启用 IPv4 转发。

Isolation
string or null
枚举值: "EMPTY" "default" "hyperv" "process"
KernelMemoryTCP
boolean or null

表示主机是否启用内核 TCP 内存限制，不支持时省略。cgroup v2 不支持内核 TCP 内存限制及对应的 memory.kmem.tcp.limit_in_bytes cgroup。

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) 端点获取。

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>

当前 goroutine 数量，仅在启用调试模式时返回。

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（未知 CA 证书）通信。默认本地仓库（127.0.0.0/8）为不安全，其余仓库为安全。如果守护进程认为仓库安全，则无法进行不安全通信。此配置覆盖该行为，允许对解析 IP 位于指定 CIDR 子网内的仓库进行不安全通信。也可按主机名标记不安全仓库，列在 IndexConfigs 中，Secure 为 false。> 警告：本地仓库测试时此选项可能有用，但存在安全漏洞，只应用于测试。应将 CA 加入系统可信 CA 列表，而不是启用此选项。

Mirrors
数组元素类型 strings or null

作为官方 docker.io 仓库镜像源的仓库 URL 列表。

object or null

Commit 保存构建二进制文件所用的 Git 提交（SHA1），由 containerd、runC 等外部工具的版本字符串报告。

Expected
string or null

dockerd 在构建时设置的预期外部工具提交 ID。

ID
string or null

外部工具的实际提交 ID。

object or null

守护进程配置的 OCI 兼容运行时列表，键保存引用运行时的名称。Docker 守护进程依靠经 containerd 调用的 OCI 运行时连接 Linux 内核命名空间、cgroup 和 SELinux。默认运行时是自动配置的 runc；用户可配置额外运行时，并在此列出。

additional property
object (Runtime)

Runtime 描述 OCI 兼容运行时。守护进程通过 containerd 调用运行时，连接 Linux 内核命名空间、cgroup 和 SELinux。

SecurityOptions
数组元素类型 strings or null

守护进程启用的安全功能列表，如 apparmor、seccomp、SELinux、用户命名空间 userns、rootless 和 no-new-privileges。各功能可能包含额外配置，以逗号分隔的键值对列出。

ServerVersion
string or null

守护进程版本字符串。> 注意：独立 Swarm API 返回 Swarm 版本，而不是守护进程版本，例如 swarm/1.2.8。

SwapLimit
boolean or null

表示主机是否支持交换内存限制。

object or null

表示 Swarm 通用信息。

object or null

ClusterInfo 表示 "/info" 端点返回的 Swarm 信息，不包含加入令牌。

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

Swarm 中其他节点访问此节点的 IP 地址。

NodeID
string or null

节点在 Swarm 中的唯一标识。

Nodes
integer or null <int64>

Swarm 节点总数。

数组元素类型 objects or null (PeerNode)

Swarm 中其他管理节点的 ID 和地址列表。

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",
  • "ClusterStore": "string",
  • "ClusterAdvertise": "string",
  • "Runtimes": {
    },
  • "DefaultRuntime": "string",
  • "Swarm": {
    },
  • "LiveRestoreEnabled": true,
  • "Isolation": "EMPTY",
  • "InitBinary": "string",
  • "ContainerdCommit": {
    },
  • "RuncCommit": {
    },
  • "InitCommit": {
    },
  • "SecurityOptions": [
    ],
  • "ProductLicense": "string",
  • "DefaultAddressPools": [
    ],
  • "Warnings": [
    ]
}

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

颁发者的原始 subject 字节，使用 URL 安全 Base64 编码。

TrustRoot
string or null

验证叶 TLS 证书的根 CA 证书。

{
  • "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 时的目标路径。

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 spec 是 VM 的规格，用于了解 VM 状态，并在更新现有 VM 时跟踪历史记录。

CreatedAt
required
string <date-time>

VM 规格创建时间。

required
object (VmDisk)

VM 的磁盘表示。

required
object (VmHostConfig)

VM 的资源（CPU、内存、网络）。

Hostname
string or null

VM 主机名。

Key
required
string <uuid>

VM 规格唯一标识。

object or null

用户定义的键值元数据。

MacAddress
string or null

VM 的 MAC 地址。

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",
  • "Spec": {
    }
}

VmDisk

Image
required
string

使用的镜像名称。

Size
integer or null <int64> >= 0

允许的磁盘虚拟大小，单位 GB（默认：20）。

{
  • "Image": "string",
  • "Size": 0
}

VmHostConfig

Cpu
required
integer <int64> >= 0

VM 的 CPU 数量（默认：1）。

Dns
数组元素类型 strings or null

VM 使用的 DNS 服务器列表。

HostTun
boolean or null

使用主机 TUN 设备。

Kvm
boolean or null

启用 KVM 加速（默认：false）。

LinkNetIface
string or null

连接 VM 的网络接口（默认：eth0）。

Memory
required
integer <int64> >= 0

VM 内存，单位 MB（默认：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"
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 spec 是 VM 的规格，用于了解 VM 状态，并在更新现有 VM 时跟踪历史记录。

CreatedAt
required
string <date-time>

VM 规格创建时间。

required
object (VmDisk)

VM 的磁盘表示。

required
object (VmHostConfig)

VM 的资源（CPU、内存、网络）。

Hostname
string or null

VM 主机名。

Key
required
string <uuid>

VM 规格唯一标识。

object or null

用户定义的键值元数据。

MacAddress
string or null

VM 的 MAC 地址。

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": {
    },
  • "Instances": [
    ]
}

VmSpec

CreatedAt
required
string <date-time>

VM 规格创建时间。

required
object (VmDisk)

VM 的磁盘表示。

Image
required
string

使用的镜像名称。

Size
integer or null <int64> >= 0

允许的磁盘虚拟大小，单位 GB（默认：20）。

required
object (VmHostConfig)

VM 的资源（CPU、内存、网络）。

Cpu
required
integer <int64> >= 0

VM 的 CPU 数量（默认：1）。

Dns
数组元素类型 strings or null

VM 使用的 DNS 服务器列表。

HostTun
boolean or null

使用主机 TUN 设备。

Kvm
boolean or null

启用 KVM 加速（默认：false）。

LinkNetIface
string or null

连接 VM 的网络接口（默认：eth0）。

Memory
required
integer <int64> >= 0

VM 内存，单位 MB（默认：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

VM 的 MAC 地址。

object

用户定义的元数据。

additional property
string or number or boolean or 数组元素类型 Any (any) or object (Any)

为 OpenApi 生成 Any 类型的辅助工具，适用于 ResourceSpec 等动态 JSON 对象。

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

允许的磁盘虚拟大小，单位 GB（默认：20）。

object or null

VM 的资源（CPU、内存、网络）。

Cpu
required
integer <int64> >= 0

VM 的 CPU 数量（默认：1）。

Dns
数组元素类型 strings or null

VM 使用的 DNS 服务器列表。

HostTun
boolean or null

使用主机 TUN 设备。

Kvm
boolean or null

启用 KVM 加速（默认：false）。

LinkNetIface
string or null

连接 VM 的网络接口（默认：eth0）。

Memory
required
integer <int64> >= 0

VM 内存，单位 MB（默认：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

VM 的 MAC 地址（默认自动生成）。

object

用户定义的元数据。

additional property
string or number or boolean or 数组元素类型 Any (any) or object (Any)

为 OpenApi 生成 Any 类型的辅助工具，适用于 ResourceSpec 等动态 JSON 对象。

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、内存、网络）。

Cpu
required
integer <int64> >= 0

VM 的 CPU 数量（默认：1）。

Dns
数组元素类型 strings or null

VM 使用的 DNS 服务器列表。

HostTun
boolean or null

使用主机 TUN 设备。

Kvm
boolean or null

启用 KVM 加速（默认：false）。

LinkNetIface
string or null

连接 VM 的网络接口（默认：eth0）。

Memory
required
integer <int64> >= 0

VM 内存，单位 MB（默认：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)

为 OpenApi 生成 Any 类型的辅助工具，适用于 ResourceSpec 等动态 JSON 对象。

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 spec 是 VM 的规格，用于了解 VM 状态，并在更新现有 VM 时跟踪历史记录。

CreatedAt
required
string <date-time>

VM 规格创建时间。

required
object (VmDisk)

VM 的磁盘表示。

required
object (VmHostConfig)

VM 的资源（CPU、内存、网络）。

Hostname
string or null

VM 主机名。

Key
required
string <uuid>

VM 规格唯一标识。

object or null

用户定义的键值元数据。

MacAddress
string or null

VM 的 MAC 地址。

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": {
    }
}