容器

在服务器上运行和管理容器。

上提供的方法 client.containers

class ContainerCollection(client=None)
run(image, command=None, **kwargs)

运行一个容器。默认情况下,它将等待容器完成并返回其日志,类似于 docker run

如果 detach 论据是 True ,它将启动容器并立即返回一个 Container 对象,类似于 docker run -d

示例

运行容器并获取其输出:

>>> import docker
>>> client = docker.from_env()
>>> client.containers.run('alpine', 'echo hello world')
b'hello world\n'

运行容器并分离:

>>> container = client.containers.run('bfirsh/reticulate-splines',
                                      detach=True)
>>> container.logs()
'Reticulating spline 1...\nReticulating spline 2...\n'
参数:
  • image (str) -- 要运行的映像。

  • command (str or list) -- 要在容器中运行的命令。

  • auto_remove (bool) -- 当容器的进程退出时,在守护程序端启用容器的自动删除。

  • blkio_weight_device -- 数据块IO权重(相对设备权重),格式为: [{"Path": "device_path", "Weight": weight}]

  • blkio_weight -- 数据块IO权重(相对权重),接受介于10和1000之间的权重值。

  • cap_add (list of str) -- 添加内核功能。例如, ["SYS_ADMIN", "MKNOD"]

  • cap_drop (list of str) -- 放弃内核功能。

  • cgroup_parent (str) -- 覆盖默认的父cgroup。

  • cgroupns (str) -- 覆盖容器的默认cgroup命名空间模式。以下其中一项: private 容器在其自己的私有cgroup命名空间中运行。- host 使用主机系统的cgroup命名空间。

  • cpu_count (int) -- 可用CPU数(仅限Windows)。

  • cpu_percent (int) -- 可用CPU的可用百分比(仅限Windows)。

  • cpu_period (int) -- 以微秒为单位的CPU周期长度。

  • cpu_quota (int) -- 容器在一个CPU周期内可以获得的微秒CPU时间。

  • cpu_rt_period (int) -- 以微秒为单位限制CPU实时周期。

  • cpu_rt_runtime (int) -- 以微秒为单位限制CPU实时运行时间。

  • cpu_shares (int) -- CPU占有率(相对权重)。

  • cpuset_cpus (str) -- 允许执行的CPU (0-30,1 )。

  • cpuset_mems (str) -- 允许执行的内存节点(MEM) (0-30,1 )。仅在NUMA系统上有效。

  • detach (bool) -- 在后台运行容器并返回一个 Container 对象。

  • device_cgroup_rules (list) -- 要应用于容器的cgroup规则列表。

  • device_read_bps -- 限制设备的读取速率(字节/秒),其形式为: [{"Path": "device_path", "Rate": rate}]

  • device_read_iops -- 限制设备的读取速率(每秒IO)。

  • device_write_bps -- 限制设备的写入速率(每秒字节数)。

  • device_write_iops -- 限制设备的写入速率(每秒IO)。

  • devices (list) -- 将主机设备作为以下形式的字符串列表公开给容器 <path_on_host>:<path_in_container>:<cgroup_permissions> 。例如, /dev/sda:/dev/xvda:rwm 允许容器对主机的 /dev/sda 通过名为的节点 /dev/xvda 在集装箱里。

  • device_requests (list) -- 将主机资源(如GPU)公开给容器,作为 docker.types.DeviceRequest 实例。

  • dns (list) -- 设置自定义的DNS服务器。

  • dns_opt (list) -- 要添加到容器的 resolv.conf 文件。

  • dns_search (list) -- 域名系统搜索域。

  • domainname (str or list) -- 设置自定义DNS搜索域。

  • entrypoint (str or list) -- 容器的入口点。

  • environment (dict or list) -- 要在容器内设置的环境变量,格式为字典或字符串列表 ["SOMEVARIABLE=xxx"]

  • extra_hosts (dict) -- 要在容器内解析的其他主机名,作为主机名到IP地址的映射。

  • group_add (list) -- 容器进程将以其身份运行的其他组名和/或ID的列表。

  • healthcheck (dict) -- 指定要执行的测试以检查容器是否正常。DICT采用以下键:-测试 (list 或str):要执行的测试以确定容器运行状况。可能的值:-空列表:从父映像继承运行状况检查- ["NONE"] :禁用健康检查- ["CMD", args...] :EXEC参数直接。- ["CMD-SHELL", command] :在系统的默认Shell中运行命令。如果提供了字符串,它将被用作 CMD-SHELL 指挥部。-Interval(Int):两次检查之间的等待时间,单位为纳秒。它应为0或至少为1000000(1毫秒)。-Timeout(Int):在认为支票挂起之前等待的时间。它应为0或至少为1000000(1毫秒)。-重试次数(Int):容器被认为不健康所需的连续失败次数。-START_PERIOD(Int):容器启动健康前初始化的开始周期-重试倒计时,单位为纳秒。它应为0或至少为1000000(1毫秒)。

  • hostname (str) -- 容器的可选主机名。

  • init (bool) -- 在转发信号和获取进程的容器内运行init

  • init_path (str) -- Docker-init二进制文件的路径

  • ipc_mode (str) -- 设置容器的IPC模式。

  • isolation (str) -- 使用隔离技术。默认: None

  • kernel_memory (int or str) -- 内核内存限制

  • labels (dict or list) -- 名称-值标签的词典(例如 {"label1": "value1", "label2": "value2"} )或要用空值设置的标签名称列表(例如 ["label1", "label2"] )

  • links (dict) -- 链接的映射使用 {'container': 'alias'} 格式化。别名是可选的。此DICT中声明的容器将使用提供的别名链接到新容器。默认: None

  • log_config (LogConfig) -- 日志记录配置。

  • lxc_conf (dict) -- LXC配置。

  • mac_address (str) -- 要分配给容器的MAC地址。

  • mem_limit (int or str) -- 内存限制。接受浮点值(以字节为单位表示所创建容器的内存限制)或带有单元标识字符的字符串 (100000b1000k128m1g )。如果指定的字符串没有单位字符,则假定字节为目标单位。

  • mem_reservation (int or str) -- 内存软限制。

  • mem_swappiness (int) -- 调整容器的内存交换行为。接受介于0和100之间的数字。

  • memswap_limit (str or int) -- 容器允许消耗的最大内存+交换空间。

  • mounts (list) -- 要加到集装箱上的底座规范。更强大的替代方案 volumes 。列表中的每一项预计都是 docker.types.Mount 对象。

  • name (str) -- 此容器的名称。

  • nano_cpus (int) -- CPU配额,以1e-9个CPU为单位。

  • network (str) -- 此容器在创建时将连接到的网络的名称。您可以使用以下命令连接到其他网络 Network.connect() 。与不兼容 network_mode

  • network_disabled (bool) -- 禁用网络。

  • network_mode (str) -- 以下其中一项: bridge 为桥接网络上的容器创建新的网络堆栈。- none 此容器没有网络连接。- container:<name|id> 重用另一个容器的网络堆栈。- host 使用主机网络堆栈。此模式与不兼容 ports 。与不兼容 network

  • network_driver_opt (dict) -- 提供给网络驱动程序的选项词典。默认为 None 。用于与…连用 network 。与不兼容 network_mode

  • oom_kill_disable (bool) -- 是否禁用OOM杀手。

  • oom_score_adj (int) -- 一个整数值,包含为调整OOM杀手首选项而为容器指定的分数。

  • pid_mode (str) -- 如果设置为 host ,则在容器内使用主机ID命名空间。

  • pids_limit (int) -- 调整容器的PID限制。集 -1 不限量。

  • platform (str) -- 格式中的平台 os[/arch[/variant]] 。仅在方法需要拉取请求的图像时使用。

  • ports (dict) -- 要绑定到容器内部的端口。字典的键是要在容器内绑定的端口,可以是整数形式,也可以是形式的字符串 port/protocol ,其中的协议是 tcpudp ,或 sctp 。字典的值是要在主机上打开的相应端口,可以是以下任一种:-端口号,为整数。例如, {'2222/tcp': 3333} 会将容器内的端口2222暴露为主机上的端口3333。- None ,以分配随机主机端口。例如, {'2222/tcp': None} 。-一个元组 (address, port) 如果您想要指定主机接口。例如, {'1111/tcp': ('127.0.0.1', 1111)} 。-如果要将多个主机端口绑定到单个容器端口,则为整数列表。例如, {'1111/tcp': [1234, 4567]} 。与不兼容 host 网络模式。

  • privileged (bool) -- 将扩展权限授予此容器。

  • publish_all_ports (bool) -- 将所有端口发布到主机。

  • read_only (bool) -- 将容器的根文件系统挂载为只读。

  • remove (bool) -- 当容器运行完毕后,将其取出。默认: False

  • restart_policy (dict) -- 容器退出时重新启动。配置为带有关键字的词典:- Name 其中之一 on-failure ,或 always 。- MaximumRetryCount 失败时重新启动容器的次数。例如: {"Name": "on-failure", "MaximumRetryCount": 5}

  • runtime (str) -- 要与此容器一起使用的运行时。

  • security_opt (list) -- 用于为MLS系统(如SELinux)自定义标签的字符串值列表。

  • shm_size (str or int) -- /dev/shm的大小(例如 1G )。

  • stdin_open (bool) -- 留着 STDIN 即使没有连接,也要打开。

  • stdout (bool) -- 将日志从 STDOUT 什么时候 detach=False 。默认: True

  • stderr (bool) -- 将日志从 STDERR 什么时候 detach=False 。默认: False

  • stop_signal (str) -- 用于停止集装箱的停止信号(例如 SIGINT )。

  • storage_opt (dict) -- 每个容器的存储驱动程序选项作为键-值映射。

  • stream (bool) -- 如果为真,并且 detach 为False,则返回日志生成器而不是字符串。在以下情况下忽略 detach 是真的。默认: False

  • sysctls (dict) -- 要在容器中设置的内核参数。

  • tmpfs (dict) -- 要挂载的临时文件系统,作为将容器内的路径映射到该路径的选项的字典。例如:..代码块::Python{‘/mnt/vol2’:‘’,‘/mnt/vol1’:‘Size=3G,uid=1000’}

  • tty (bool) -- 分配一个伪TTY。

  • ulimits (list) -- 要在容器内设置的U限制,作为 docker.types.Ulimit 实例。

  • use_config_proxy (bool) -- 如果 True ,并且如果Docker客户端配置文件 (~/.docker/config.json 默认情况下)包含代理配置,则将在要构建的容器中设置相应的环境变量。

  • user (str or int) -- 在容器内运行命令的用户名或UID。

  • userns_mode (str) -- 启用用户命名空间重新映射选项时,设置容器的用户命名空间模式。支持的值包括: host

  • uts_mode (str) -- 设置容器的UTS名称空间模式。支持的值包括: host

  • version (str) -- 要使用的API的版本。设为 auto 自动检测服务器的版本。默认: 1.35

  • volume_driver (str) -- 卷驱动程序/插件的名称。

  • volumes (dict or list) --

    用于配置装载在容器内的卷的字典。键是主机路径或卷名,值是包含键的字典:

    • bind 在容器内挂载卷的路径

    • mode 要么 rw 以读/写方式装载卷,或 ro 以只读方式装载它。

    例如:

    {'/home/user1/': {'bind': '/mnt/vol2', 'mode': 'rw'},
     '/var/www': {'bind': '/mnt/vol1', 'mode': 'ro'}}
    

    或其每个元素指定装入卷的字符串列表。

    例如:

    ['/home/user1/:/mnt/vol2','/var/www:/mnt/vol1']
    

  • volumes_from (list) -- 从中获取卷的容器名称或ID的列表。

  • working_dir (str) -- 工作目录的路径。

返回:

容器日志,或者 STDOUTSTDERR ,或者两者都有,具体取决于 stdoutstderr 争论。 STDOUTSTDERR 可以是只读的,满足以下条件之一 json-filejournald 已使用日志记录驱动程序。因此,如果您没有使用这些驱动程序,则 None 对象,而是返回。请参阅 Engine API documentation 有关详细信息,请参阅。如果 detachTrue 一种 Container 对象,而是返回。

抛出:
  • docker.errors.ContainerError -- 如果容器以非零退出代码退出,并且 detachFalse

  • docker.errors.ImageNotFound -- 如果指定的图像不存在。

  • docker.errors.APIError -- 如果服务器返回错误。

create(image, command=None, **kwargs)

在不启动的情况下创建容器。类似于 docker create

所采取的论点与 run() ,但以下情况除外 stdoutstderr ,以及 remove

返回:

A Container 对象。

抛出:
  • docker.errors.ImageNotFound -- 如果指定的图像不存在。

  • docker.errors.APIError -- 如果服务器返回错误。

get(id_or_name)

按名称或ID获取容器。

参数:

container_id (str) -- 容器名称或ID。

返回:

A Container 对象。

抛出:
  • docker.errors.NotFound -- 如果容器不存在。

  • docker.errors.APIError -- 如果服务器返回错误。

list(**kwargs)

列出容器。类似于 docker ps 指挥部。

参数:
  • all (bool) -- 显示所有容器。默认情况下,仅显示正在运行的容器

  • since (str) -- 仅显示自ID或名称以来创建的容器,包括未运行的容器

  • before (str) -- 仅显示在ID或名称之前创建的容器,包括未运行的容器

  • limit (int) -- 显示 limit 上次创建的容器,包括未运行的容器

  • filters (dict) -- 要在图像列表上处理的滤镜。可用过滤器:- exited (int): Only containers with specified exit code - status (str): One of restarting, running, paused, exited - label (str|list): format either "key", "key=value" or a list of such. - id (str): The id of the container. - name (str): The name of the container. - ancestor (str): Filter by container ancestor. Format of <image-name>[:tag], <image-id>, or <image@digest>. - before (str): Only containers created before a particular container. Give the container name or id. - since (str): Only containers created after a particular container. Give container name or id. A comprehensive list can be found in the documentation for docker ps

  • sparse (bool) -- 不要检查集装箱。返回部分信息,但保证不会阻塞。使用 Container.reload() 在结果对象上检索所有属性。默认: False

  • ignore_removed (bool) -- 尝试检查原始列表中的容器时,忽略因缺少容器而导致的故障。设为 True 如果可能出现竞争条件。在以下情况下不起作用 sparse=True 。默认: False

返回:

(列表 Container )

抛出:

docker.errors.APIError -- 如果服务器返回错误。

prune(filters=None)

删除停止的容器

参数:

filters (dict) -- 要在清理列表上处理的筛选器。

返回:

包含已删除容器ID列表和回收的磁盘空间量(以字节为单位)的DICT。

返回类型:

(dict)

抛出:

docker.errors.APIError -- 如果服务器返回错误。

容器对象

class Container

容器对象的本地表示形式。详细配置可通过 attrs 属性。请注意,本地属性是缓存的;用户可以调用 reload() 查询Docker守护进程的当前属性,导致 attrs 需要重新振作。

attrs
id

对象的ID。

image

容器的图像。

labels

作为词典的容器的标签。

name

容器的名称。

short_id

对象的ID,截断为12个字符。

status

容器的状态。例如, running ,或 exited

服务器中此对象的原始表示形式。

attach(**kwargs)

附在这个容器上。

logs() 是该方法的包装器,如果您希望在不首先检索整个Backlog的情况下获取/流容器输出,则可以使用它。

参数:
  • stdout (bool) -- 包括标准输出。

  • stderr (bool) -- 包括stderr。

  • stream (bool) -- 以字符串迭代器的形式逐步返回容器输出,而不是单个字符串。

  • logs (bool) -- 包括容器以前的输出。

返回:

默认情况下,容器的输出为单个字符串。如果 stream=True ,输出字符串的迭代器。

抛出:

docker.errors.APIError -- 如果服务器返回错误。

attach_socket(**kwargs)

喜欢 attach() ,但返回HTTP请求的基础类似套接字的对象。

参数:
  • params (dict) -- 请求参数词典(例如 stdoutstderrstream )。

  • ws (bool) -- 使用WebSockets而不是原始的HTTP。

抛出:

docker.errors.APIError -- 如果服务器返回错误。

commit(repository=None, tag=None, **kwargs)

将容器提交到映像。类似于 docker commit 指挥部。

参数:
  • repository (str) -- 要将映像推送到的存储库

  • tag (str) -- 要推送的标签

  • message (str) -- 提交消息

  • author (str) -- 作者的姓名

  • pause (bool) -- 提交前是否暂停容器

  • changes (str) -- 提交时要应用的Dockerfile说明

  • conf (dict) -- 容器的配置。请参阅 Engine API documentation 有关详细信息,请参阅。

抛出:

docker.errors.APIError -- 如果服务器返回错误。

diff()

检查容器的文件系统上的更改。

返回:

(列表)包含属性的词典列表 PathKind

抛出:

docker.errors.APIError -- 如果服务器返回错误。

exec_run(cmd, stdout=True, stderr=True, stdin=False, tty=False, privileged=False, user='', detach=False, stream=False, socket=False, environment=None, workdir=None, demux=False)

在该容器内运行命令。类似于 docker exec

参数:
  • cmd (str or list) -- 要执行的命令

  • stdout (bool) -- 附加到标准输出。默认: True

  • stderr (bool) -- 附加到标准错误。默认: True

  • stdin (bool) -- 附加到标准输入。默认: False

  • tty (bool) -- 分配一个伪TTY。默认:FALSE

  • privileged (bool) -- 以特权身份运行。

  • user (str) -- 执行命令的用户身份。默认:根

  • detach (bool) -- 如果为True,则从EXEC命令断开连接。默认:FALSE

  • stream (bool) -- 流响应数据。默认:FALSE

  • socket (bool) -- 返回连接套接字以允许自定义读/写操作。默认:FALSE

  • environment (dict or list) -- 以下格式的词典或字符串列表 ["PASSWORD=xxx"]{"PASSWORD": "xxx"}

  • workdir (str) -- 此EXEC会话的工作目录的路径

  • demux (bool) -- 分别返回stdout和stderr

返回:

(EXIT_CODE,OUTPUT)EXIT_CODE:(Int)的元组:已执行命令的退出代码或 None 如果有任何一个 streamsocketTrue 。输出:(生成器、字节或元组):if stream=True ,一个产生响应块的生成器。如果 socket=True ,连接的Socket对象。如果 demux=True ,两个字节的元组:stdout和stderr。否则包含响应数据的字节字符串。

返回类型:

(ExecResult)

抛出:

docker.errors.APIError -- 如果服务器返回错误。

export(chunk_size=2097152)

将容器的文件系统的内容导出为TAR归档。

参数:

chunk_size (int) -- 生成器的每次迭代返回的字节数。如果 None ,数据将在接收时进行流传输。默认:2 MB

返回:

文件系统tar归档

返回类型:

(str)

抛出:

docker.errors.APIError -- 如果服务器返回错误。

get_archive(path, chunk_size=2097152, encode_stream=False)

以TAR存档的形式从容器中检索文件或文件夹。

参数:
  • path (str) -- 要检索的文件或文件夹的路径

  • chunk_size (int) -- 生成器的每次迭代返回的字节数。如果 None ,数据将在接收时进行流传输。默认:2 MB

  • encode_stream (bool) -- 确定是否应在传输期间对数据进行编码(GZIP压缩)。默认:FALSE

返回:

第一个元素是原始TAR数据流。第二个元素是包含以下内容的词典 stat 有关指定的 path

返回类型:

(tuple)

抛出:

docker.errors.APIError -- 如果服务器返回错误。

示例

>>> f = open('./sh_bin.tar', 'wb')
>>> bits, stat = container.get_archive('/bin/sh')
>>> print(stat)
{'name': 'sh', 'size': 1075464, 'mode': 493,
 'mtime': '2018-10-01T15:37:48-07:00', 'linkTarget': ''}
>>> for chunk in bits:
...    f.write(chunk)
>>> f.close()
kill(signal=None)

杀死或向集装箱发送信号。

参数:

signal (str or int) -- 要发送的信号。默认为 SIGKILL

抛出:

docker.errors.APIError -- 如果服务器返回错误。

logs(**kwargs)

从此容器中获取日志。类似于 docker logs 指挥部。

这个 stream 参数使 logs 函数返回一个阻塞生成器,您可以迭代该生成器以在发生时检索日志输出。

参数:
  • stdout (bool) -- 到达 STDOUT 。默认 True

  • stderr (bool) -- 到达 STDERR 。默认 True

  • stream (bool) -- 流传输响应。默认 False

  • timestamps (bool) -- 显示时间戳。默认 False

  • tail (str or int) -- 在日志末尾输出指定的行数。行数的整数或字符串 all 。默认 all

  • since (datetime, int, or float) -- 显示自给定日期时间、整数纪元(以秒为单位)或浮点数(以纳秒为单位)以来的日志

  • follow (bool) -- 遵循日志输出。默认 False

  • until (datetime, int, or float) -- 显示在给定日期时间、整数纪元(秒)或浮点数(纳秒)之前发生的日志

返回:

容器中的日志。

返回类型:

(generator or str)

抛出:

docker.errors.APIError -- 如果服务器返回错误。

pause()

暂停此容器中的所有进程。

抛出:

docker.errors.APIError -- 如果服务器返回错误。

put_archive(path, data)

使用TAR存档作为源在此容器中插入文件或文件夹。

参数:
  • path (str) -- 将在其中提取文件的容器内的路径。必须存在。

  • data (bytes or stream) -- 要提取的TAR数据

返回:

如果调用成功,则为True。

返回类型:

(bool)

抛出:

APIError --

reload()

再次从服务器加载此对象并更新 attrs 使用新的数据。

remove(**kwargs)

移走这个容器。类似于 docker rm 指挥部。

参数:
  • v (bool) -- 删除与容器关联的卷

  • link (bool) -- 删除指定的链接,而不是基础容器

  • force (bool) -- 强制移除运行中的容器(使用 SIGKILL )

抛出:

docker.errors.APIError -- 如果服务器返回错误。

rename(name)

重命名此容器。类似于 docker rename 指挥部。

参数:

name (str) -- 容器的新名称

抛出:

docker.errors.APIError -- 如果服务器返回错误。

resize(height, width)

调整tty会话的大小。

参数:
  • height (int) -- TTY会话高度

  • width (int) -- TTY会话宽度

抛出:

docker.errors.APIError -- 如果服务器返回错误。

restart(**kwargs)

重新启动此容器。类似于 docker restart 指挥部。

参数:

timeout (int) -- 在终止容器之前尝试停止的秒数。一旦被杀死,它将被重启。默认为10秒。

抛出:

docker.errors.APIError -- 如果服务器返回错误。

start(**kwargs)

启动这个容器。类似于 docker start 命令,但不支持附加选项。

抛出:

docker.errors.APIError -- 如果服务器返回错误。

stats(**kwargs)

此容器的流统计信息。类似于 docker stats 指挥部。

参数:
  • decode (bool) -- 如果设置为TRUE,流将被动态解码为DICTS。仅在以下情况下适用 stream 是真的。默认情况下为False。

  • stream (bool) -- 如果设置为FALSE,则只返回当前统计信息,而不返回流。默认情况下为True。

抛出:

docker.errors.APIError -- 如果服务器返回错误。

stop(**kwargs)

停止容器。类似于 docker stop 指挥部。

参数:

timeout (int) -- 等待容器停止,然后发送 SIGKILL 。默认:10

抛出:

docker.errors.APIError -- 如果服务器返回错误。

top(**kwargs)

显示容器正在运行的进程。

参数:

ps_args (str) -- 传递给PS的可选参数(例如 aux )

返回:

顶端的输出

返回类型:

(str)

抛出:

docker.errors.APIError -- 如果服务器返回错误。

unpause()

取消暂停容器内的所有进程。

抛出:

docker.errors.APIError -- 如果服务器返回错误。

update(**kwargs)

更新容器的资源配置。

参数:
  • blkio_weight (int) -- 数据块IO(相对重量),介于10%和1000之间

  • cpu_period (int) -- 限制CPU CFS(完全公平调度程序)周期

  • cpu_quota (int) -- 限制CPU CFS(完全公平调度程序)配额

  • cpu_shares (int) -- CPU占有率(相对权重)

  • cpuset_cpus (str) -- 允许执行的CPU

  • cpuset_mems (str) -- 允许在其中执行的MEMS

  • mem_limit (int or str) -- 内存限制

  • mem_reservation (int or str) -- 内存软限制

  • memswap_limit (int or str) -- 总内存(内存+交换),-1表示禁用交换

  • kernel_memory (int or str) -- 内核内存限制

  • restart_policy (dict) -- 重新启动策略字典

返回:

包含一个 Warnings 钥匙。

返回类型:

(dict)

抛出:

docker.errors.APIError -- 如果服务器返回错误。

wait(**kwargs)

块,直到容器停止,然后返回其退出代码。类似于 docker wait 指挥部。

参数:
  • timeout (int) -- 请求超时

  • condition (str) -- 等待容器状态达到给定条件,或者 not-running (默认), next-exit ,或 removed

返回:

API的响应作为一个Python字典,包括容器在 StatusCode 属性。

返回类型:

(dict)

抛出:
  • requests.exceptions.ReadTimeout -- 如果超过超时时间。

  • docker.errors.APIError -- 如果服务器返回错误。