mc ping

语法

mc ping 命令对指定目标执行存活性检查。

以下命令向目标发送请求，并输出响应的最小、最大、平均与往返时间，以及处理请求时遇到的错误数量。

mc ping play --count 5

该命令对 alias play 对应的部署执行五次 ping。 输出类似如下：

1: https://play.min.io   min=213.00ms   max=213.00ms   average=213.00ms   errors=0   roundtrip=213.00ms
2: https://play.min.io   min=67.15ms    max=213.00ms   average=140.07ms   errors=0   roundtrip=67.15ms
3: https://play.min.io   min=67.15ms    max=213.00ms   average=115.85ms   errors=0   roundtrip=67.41ms
4: https://play.min.io   min=61.26ms    max=213.00ms   average=102.20ms   errors=0   roundtrip=61.26ms
5: https://play.min.io   min=61.26ms    max=213.00ms   average=95.03ms    errors=0   roundtrip=66.36ms

该命令的语法如下：

mc [GLOBALFLAGS] ping                       \
                 TARGET                     \
                 [--count, -c value]        \
                 [--error-count, -e value]  \
                 [--interval, -i value]     \
                 [--distributed, -a value]
  • 方括号 [] 表示可选参数。
  • 同一行中的参数彼此相互依赖。
  • 使用管道符 | 分隔的参数彼此互斥。

请先将示例复制到文本编辑器中并按需修改，再在终端 / shell 中运行命令。

参数

TARGET

mc-cmd

Required

命令应运行所在位置的 alias 或前缀完整路径。

--count

mc-cmd

Optional

指定执行检查的次数。

如果未指定，存活性检查会持续执行，直到手动停止。

--error-count

mc-cmd

Optional

指定在退出前允许出现的错误次数。

例如，要在出现五次错误后停止 ping 进程，请使用：

mc ping TARGET -e 5
--exit

mc-cmd

Optional

在首次检查成功后退出。

--interval

mc-cmd

Optional

指定请求之间的等待时间（秒）。

默认情况下，命令在两次请求之间等待 1 秒。

--distributed

mc-cmd

Optional

向 MinIO 集群中的所有服务器发送请求。

全局标志

此命令支持 全局标志 中的任意选项。

示例

返回 5 次请求的延迟与存活性

以下命令对别名为 myminio 的部署发送五次存活性检查，输出每次检查结果后结束。

mc ping myminio --count 5

每次请求间隔 5 分钟持续发送存活性检查

以下命令持续发送存活性检查请求，且每次请求之间间隔 5 分钟（300 秒）。

mc ping myminio --interval 300

错误次数达到 20 后结束存活性检查

以下命令持续发送存活性检查，直到累计出现 20 次错误：

mc ping myminio --error-count 20
最后修改 August 2, 2026: init commit (8338d5b)

本页部分内容改编自 MinIO 对象存储文档，© 2020–至今 MinIO, Inc.，依据 CC BY 4.0 授权，由 Silo 项目转换与维护。归属与署名

本页为非官方中文翻译。如与英文原文有出入，以英文原文为准。