`mc head`

語法

mc head 命令會顯示物件的前 n 行，其中 n 是指定給命令的引數。

mc head 不會對物件內容執行任何轉換或格式化以方便閱讀。您也可以對本機檔案系統使用 mc head，以產生與 head 命令列工具類似的結果。

範例

以下命令會傳回在 myminio MinIO 部署上的 mydata 儲存貯體中物件的前 10 行

mc head myminio/mydata/myobject.txt

語法

此命令具有以下語法

mc [GLOBALFLAGS] head                     \
                 [--lines int]            \
                 [--rewind "string"]      \
                 [--version-id "string"]  \
                 [--enc-c "string"]       \
                 ALIAS [ALIAS ...]

方括號 [] 表示選用參數。
共用一行的參數是相互關聯的。
使用管道 | 運算子分隔的參數是互斥的。

將範例複製到文字編輯器中，並在終端機/Shell 中執行命令之前視需要修改。

參數

ALIAS

必要

要列印的物件。

對於 MinIO 上的物件，請指定別名和該物件的完整路徑（例如，儲存貯體和物件的路徑）。例如

mc head play/mybucket/object.txt

您可以指定相同或不同 MinIO 部署上的多個物件。例如

mc head ~/mydata/object.txt myminio/mydata/object.txt

對於本機檔案系統上的物件，請指定該物件的完整路徑。例如

mc head ~/mydata/object.txt

--lines, n

選用

要列印的行數。

預設為 10。

--enc-c

選用

使用伺服器端 SSE-C 加密和客戶管理的金鑰來加密或解密物件。

此參數接受格式為 KEY=VALUE 的金鑰值對

`KEY`	物件的完整路徑，格式為 `alias/bucket/path/object.ext`。您只能指定最上層路徑，以便在該路徑中的所有操作使用單一加密金鑰。
`VALUE`	指定 32 位元組的 RawBase64 編碼金鑰或 64 位元組的十六進位編碼金鑰，以用於 SSE-C 加密。 Raw Base64 編碼拒絕 `=` 填補的金鑰。請省略填補或使用支援 RAW 格式的 Base64 編碼器。

KEY

物件的完整路徑，格式為 alias/bucket/path/object.ext。

您只能指定最上層路徑，以便在該路徑中的所有操作使用單一加密金鑰。

VALUE

指定 32 位元組的 RawBase64 編碼金鑰*或* 64 位元組的十六進位編碼金鑰，以用於 SSE-C 加密。

Raw 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"

注意

MinIO 強烈建議不要在生產工作負載中使用 SSE-C 加密。請改為使用透過 --enc-kms 參數的 SSE-KMS 或透過 --enc-s3 參數的 SSE-S3。

--rewind

選用

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

若要倒轉到過去的特定日期，請將日期指定為 ISO8601 格式的時間戳記。例如：--rewind "2020.03.24T10:00"。
若要倒轉一段時間，請將持續時間指定為 #d#hh#mm#ss 格式的字串。例如：--rewind "1d2hh3mm4ss"。

--rewind 需要指定的 ALIAS 是支援儲存貯體版本控制的 S3 相容服務。對於 MinIO 部署，請使用 mc version 來啟用或停用儲存貯體版本控制。

--version-id, vid

選用

指示 mc head 僅對指定的物件版本進行操作。

--version-id 需要指定的 ALIAS 是支援儲存貯體版本控制的 S3 相容服務。對於 MinIO 部署，請使用 mc version 來啟用或停用儲存貯體版本控制。

全域旗標

此命令支援任何全域旗標。

範例

檢視物件的部分內容

使用 mc head 傳回物件的前 10 行

mc head ALIAS/PATH

將 ALIAS 取代為 S3 相容主機的 別名。
將 PATH 取代為 S3 相容主機上物件的路徑。

檢視物件在某時間點的部分內容

使用 mc head --rewind 傳回物件在過去特定時間點的前 10 行

mc head ALIAS/PATH --rewind DURATION

將 ALIAS 取代為 S3 相容主機的 別名。
將 PATH 取代為 S3 相容主機上物件的路徑。
將 DURATION 取代為命令傳回物件的過去時間點。例如，指定 30d 以傳回在目前日期前 30 天的物件版本。

需要版本控制

mc head 需要儲存貯體版本控制才能使用此功能。使用 mc version 以啟用儲存貯體的版本控制。

檢視具有特定版本的物件的部分內容

使用 mc head --version-id 傳回物件在過去特定時間點的前 10 行

mc head ALIAS/PATH --version-id VERSION

將 ALIAS 取代為 S3 相容主機的 別名。
將 PATH 取代為 S3 相容主機上物件的路徑。
將 VERSION 取代為物件的版本。例如，指定 30d 以傳回在目前日期前 30 天的物件版本。

需要版本控制

mc head 需要儲存貯體版本控制才能使用此功能。使用 mc version 以啟用儲存貯體的版本控制。

行為

S3 相容性

mc 命令列工具是為了與 AWS S3 API 相容而建置，並已使用 MinIO 和 AWS S3 進行測試，以確保預期的功能和行為。

MinIO 不保證其他 S3 相容服務，因為它們的 S3 API 實作未知，因此不受支援。雖然 mc 命令*可能*會如文件所述運作，但任何此類使用皆由您自行承擔風險。