`mc get`

新版本：RELEASE.2024-02-24T01-33-20Z

語法

mc get 命令會從目標 S3 部署下載物件到本機檔案系統。

相較於 mc cp 或 mc mirror，mc get 提供了一個簡化的介面來下載檔案。mc get 使用單向下載功能，以效率換取其他命令的功能和複雜性。

範例

以下將檔案 logo.png 從 s3 來源下載到本機檔案系統，路徑為 ~/images/collateral/。

mc get minio/marketing/logo.png ~/images/collateral

語法

命令具有以下語法

mc [GLOBALFLAGS] get                      \
                 SOURCE                   \
                 TARGET                   \
                 [--enc-c string]         \
                 [--version-id, --vid value]

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

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

參數

SOURCE: 必要
要下載的別名、儲存桶、前綴（如果使用）和物件的完整路徑。

TARGET: 必要
本機檔案系統上的目的地路徑，命令應將下載的檔案放置在此處。

--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.ext。

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

VALUE

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

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。

--version-id, --vid: 可選
擷取物件的特定版本。傳遞要擷取的物件版本 ID。

全域標誌

此命令支援任何的全域標誌。

範例

從 MinIO 擷取物件到本機檔案系統

以下命令從別名 myminio 的儲存桶 mybucket 中擷取檔案 myobject.csv，並將其放置在本機檔案系統的 /my/local/folder 路徑中。

mc get myminio/mybucket/myobject.csv /my/local/folder

從 MinIO 擷取加密物件

以下命令擷取加密檔案並將其放置在本機資料夾路徑中。

mc get --enc-c "play/mybucket/object=MDEyMzQ1Njc4OTAxMjM0NTY3ODkwMTIzNDU2Nzg5MDA" play/mybucket/object path-to/object