mc stat

参数

ALIAS

必需

MinIO 部署的 别名 以及要检索其详细信息的对象的完整路径。例如

mc stat myminio/mybucket/myobject.txt

您可以在相同或不同的 MinIO 部署上指定多个对象

mc stat myminio/mybucket/myobject.txt myminio/mybucket/myobject.txt

如果指定存储桶或存储桶前缀的路径，则**必须**包含 mc stat --recursive 标志

mc stat --recursive myminio/mybucket/

要检索本地文件系统中文件的相关信息，请指定该文件的完整路径

mc stat ~/data/myobject.txt

--enc-c

可选

使用服务器端 SSE-C 加密 和客户端管理的密钥来加密或解密对象。

该参数接受格式为 KEY=VALUE 的键值对

KEY	对象的完整路径，如 alias/bucket/path/object.ext。 您只能指定顶层路径，以便对该路径中的所有操作使用单个加密密钥。
VALUE	指定与 SSE-C 加密一起使用的 32 字节 RawBase64 编码密钥*或* 64 字节十六进制编码密钥。 Raw Base64 编码**拒绝** = 填充的密钥。省略填充或使用支持 RAW 格式的 Base64 编码器。

• KEY - 对象的完整路径，如 alias/bucket/path/object。

• VALUE - 用于加密对象（s）的 32 字节 RAW Base64 编码数据密钥。

例如

# RawBase64-Encoded string "mybucket32byteencryptionkeyssec"
--enc-c "myminio/mybucket/prefix/object.obj=bXlidWNrZXQzMmJ5dGVlbmNyeXB0aW9ua2V5c3NlYwo"

您可以通过重复参数指定多个加密密钥。

指定前缀的路径，以将加密应用于该路径下所有匹配的对象

--enc-c "myminio/mybucket/prefix/=bXlidWNrZXQzMmJ5dGVlbmNyeXB0aW9ua2V5c3NlYwo"

注意

MinIO 强烈建议不要在生产工作负载中使用 SSE-C 加密。请改用通过 --enc-kms 参数的 SSE-KMS 或通过 --enc-s3 参数的 SSE-S3。

--no-list

可选

如果目标不存在，则禁用所有 LIST 操作。

--recursive, r

可选

递归地 mc stat 指定到 ALIAS 的 MinIO 存储桶的内容。

--rewind

可选

指示 mc stat 仅对指定时间点存在的对象版本进行操作。

• 要回溯到过去的特定日期，请将日期指定为 ISO8601 格式的时间戳。例如：--rewind "2020.03.24T10:00"。

• 要回溯一段时间，请以 #d#hh#mm#ss 格式指定持续时间字符串。例如：--rewind "1d2hh3mm4ss"。

--rewind 要求指定的 ALIAS 是支持 存储桶版本控制 的 S3 兼容服务。对于 MinIO 部署，请使用 mc version 来启用或禁用存储桶版本控制。

--versions

可选

指示 mc stat 对存储桶中存在的 tất cả 版本对象进行操作。

--versions 要求指定的 ALIAS 是支持 存储桶版本控制 的 S3 兼容服务。对于 MinIO 部署，请使用 mc version 来启用或禁用存储桶版本控制。

将 --versions 和 --rewind 结合使用以删除特定时间点存在的 tất cả 版本对象。

--version-id, vid

可选

指示 mc stat 仅对指定的对象版本进行操作。

--version-id 要求指定的 ALIAS 是支持 存储桶版本控制 的 S3 兼容服务。对于 MinIO 部署，请使用 mc version 来启用或禁用存储桶版本控制。

与以下任何标志互斥

• --versions

• --rewind

• --recursive

显示对象详细信息

以下示例显示存储桶 mybucket 中的对象 myfile.txt 的详细信息

mc stat myminio/mybucket/myfile.txt

输出类似于以下内容

Name      : myfile.txt
Date      : 2024-07-16 15:40:02 MDT
Size      : 6.0 KiB
ETag      : 3b38f7b05a0c42acdc377e60b2a74ddf
Type      : file
Metadata  :
  Content-Type: text/plain

您可以通过添加多个路径来指定多个对象

mc stat myminio/mybucket/file1.txt myminio/yourbucket/file2.txt

要显示存储桶中 tất cả 对象的详细信息，请使用 --recursive。以下示例显示存储桶 mybucket 中 tất cả 对象的详细信息

mc stat --recursive myminio/mybucket

输出类似于以下内容

Name      : file1.txt
Date      : 2024-07-16 15:40:02 MDT
Size      : 6.0 KiB
ETag      : 3b38f7b05a0c42acdc377e60b2a74ddf
Type      : file
Metadata  :
  Content-Type: text/plain

Name      : file2.txt
Date      : 2024-07-26 10:45:19 MDT
Size      : 6.0 KiB
ETag      : 3b38f7b05a0c42acdc377e60b2a74ddf
Type      : file
Metadata  :
  Content-Type: text/plain

显示存储桶详细信息

以下示例显示 MinIO 部署 myminio 上的存储桶 mybucket 的信息

mc stat myminio/mybucket

输出类似于以下内容

Name      : mybucket
Date      : 2024-07-26 10:56:43 MDT
Size      : N/A
Type      : folder

Properties:
  Versioning: Un-versioned
  Location: us-east-1
  Anonymous: Disabled
  ILM: Disabled

Usage:
      Total size: 6.0 KiB
   Objects count: 1
  Versions count: 0

Object sizes histogram:
   1 object(s) BETWEEN_1024B_AND_1_MB
   1 object(s) BETWEEN_1024_B_AND_64_KB
   0 object(s) BETWEEN_10_MB_AND_64_MB
   0 object(s) BETWEEN_128_MB_AND_512_MB
   0 object(s) BETWEEN_1_MB_AND_10_MB
   0 object(s) BETWEEN_256_KB_AND_512_KB
   0 object(s) BETWEEN_512_KB_AND_1_MB
   0 object(s) BETWEEN_64_KB_AND_256_KB
   0 object(s) BETWEEN_64_MB_AND_128_MB
   0 object(s) GREATER_THAN_512_MB
   0 object(s) LESS_THAN_1024_B

存储桶中对象的计数

要显示存储桶中对象的数目，请使用 --json 并使用 JSON 解析器提取 objectsCount 的值

以下示例使用 jq 实用程序

mc stat myminio/mybucket --json | jq '.Usage.objectsCount'

S3 兼容性

mc 命令行工具专为与 AWS S3 API 兼容而构建，并已针对 MinIO 和 AWS S3 进行测试，以确保预期功能和行为。

MinIO 不对其他 S3 兼容服务提供任何保证，因为它们的 S3 API 实现未知，因此不受支持。虽然 mc 命令可能按文档说明工作，但任何此类使用均由您自行承担风险。