mc stat

参数

ALIAS

必需

The别名MinIO 部署的存储桶名称和要检索详细信息的对象的完整路径。例如：

mc stat myminio/mybucket/myobject.txt

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

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

如果指定存储桶或存储桶前缀的路径，您必须include themc stat --recursiveflag:

mc stat --recursive myminio/mybucket/

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

mc stat ~/data/myobject.txt

--enc-c

可选

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

该参数接受一个键值对，格式为KEY=VALUE

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

• KEY- 对象的完整路径为alias/bucket/path/object.

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

例如：

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

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

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

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

Note

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

--no-list

可选

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

--recursive, r

可选

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

--rewind

可选

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

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

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

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

--versions

可选

Directsmc stat对存储桶中存在的所有对象版本执行操作。

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

使用--versions和--rewind共同移除在特定时间点存在的所有对象版本。

--version-id, vid

可选

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

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

与以下任何标志互斥：

• --versions

• --rewind

• --recursive

全局标志

此命令支持任何全局标志.

显示对象详细信息

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

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

要显示存储桶中所有对象的详细信息，请使用--recursive以下示例显示存储桶中所有对象的详细信息mybucket:

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

显示存储桶详细信息

以下示例显示有关存储桶的信息mybucket在myminioMinIO 部署：

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并提取值objectsCount使用 JSON 解析器：

以下示例使用了jq实用工具：

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

S3 Compatibility

Themc命令行工具专为兼容 AWS S3 API 而构建，并已通过 MinIO 和 AWS S3 测试，确保功能与行为符合预期。

MinIO 不提供对其他 S3 兼容服务的保证，因为它们的 S3 API 实现方式未知，因此不受支持。尽管mc命令可能按文档所述工作，任何此类使用风险自负。