c++ - Docker 远程 API JSON 架构定义

Question

我有一个使用 REST api 与 docker dameon 远程通信的程序。它以 json 格式接收有关图像、容器、存储库的信息。我想将此 REST API 输出从 json 格式转换为 C++ 结构。

JSON 格式总是采用键值对的形式，其中键是字符串，但值可以是字符串、数字、数组等。

我想知道是否有针对 docker json 对象的标准模式定义？

谢谢。

Answer 1

首先，有 official remote API documentation .但是，由于它“仅”包含示例请求并且没有权威的架构定义，因此它可能不是您要查找的内容。

似乎没有官方JSON schema用于 Docker 远程 API。但是，API 响应是直接从相应的 Go structs 生成的，您可以在 source code repository 的单个文件中找到它们。 .

例如，考虑 Container 响应类型的定义:

// GET  "/containers/json"
type Port struct {
    IP          string
    PrivatePort int
    PublicPort  int
    Type        string
}

type Container struct {
    ID         string            `json:"Id"`
    Names      []string          `json:",omitempty"`
    Image      string            `json:",omitempty"`
    Command    string            `json:",omitempty"`
    Created    int               `json:",omitempty"`
    Ports      []Port            `json:",omitempty"`
    SizeRw     int               `json:",omitempty"`
    SizeRootFs int               `json:",omitempty"`
    Labels     map[string]string `json:",omitempty"`
    Status     string            `json:",omitempty"`
}

这基本上包含了您在请求 /containers/json URI 时可能遇到的所有可能的键及其数据类型。所有其他资源表示也可以通过相同的方式找到。