mc stat

參數

別名

必要

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	物件的完整路徑，格式為 別名/儲存桶/路徑/物件.ext。 您只能指定頂層路徑，以便在該路徑中的所有操作使用單一加密金鑰。
VALUE	指定用於 SSE-C 加密的 32 位元組 RawBase64 編碼金鑰或 64 位元組十六進位編碼金鑰。 Raw Base64 編碼拒絕使用 = 填充的金鑰。請省略填充或使用支援 RAW 格式的 Base64 編碼器。

• KEY - 物件的完整路徑，格式為 別名/儲存桶/路徑/物件。

• VALUE - 用於加密物件的 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 指定給 別名 的 MinIO 儲存桶的內容。

--rewind

選用。

指示 mc stat 僅對指定時間點存在的物件版本執行操作。

• 若要回溯到過去的特定日期，請將日期指定為 ISO8601 格式的時間戳記。例如：--rewind "2020.03.24T10:00"。

• 若要回溯一段時間，請將時間指定為 #d#hh#mm#ss 格式的字串。例如：--rewind "1d2hh3mm4ss"。

--rewind 要求指定的 別名 必須是支援 儲存桶版本控制 的 S3 相容服務。對於 MinIO 部署，請使用 mc version 來啟用或停用儲存桶版本控制。

--versions

選用。

指示 mc stat 對儲存桶中存在的所有物件版本執行操作。

--versions 要求指定的 別名 必須是支援 儲存桶版本控制 的 S3 相容服務。對於 MinIO 部署，請使用 mc version 來啟用或停用儲存桶版本控制。

一起使用 --versions 和 --rewind 來移除在特定時間點存在的所有物件版本。

--version-id, vid

選用。

指示 mc stat 僅對指定的物件版本執行操作。

--version-id 要求指定的 別名 必須是支援 儲存桶版本控制 的 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

若要顯示儲存桶中所有物件的詳細資訊，請使用 --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

顯示儲存桶詳細資訊

以下範例顯示關於 myminio MinIO 部署上的儲存桶 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 命令可能會按照文件說明運作，但任何此類使用均由您自行承擔風險。