`mc od`

語法

mc od 命令會將本機檔案以指定的部分數量和部分大小複製到遠端位置。該命令會輸出上傳檔案所需的時間。

使用 mc od 來模擬 Linux dd 命令的功能。

範例

以下命令將 200MiB 的檔案上傳到一個儲存桶中，分為 5 個大小為 40MiB 的部分。輸出顯示上傳的結果，包括完成上傳所需的時間長度。

mc od if=file.zip of=myminio/mybucket/file.zip size=40MiB parts=5

如果傳遞 --json 全域旗標，命令的輸出會類似如下：

{
  "source": "home/user/file.zip"
  "target": "myminio/mybucket/file.zip"
  "partSize": 41943040
  "totalSize": 209715200
  "parts": 5
  "elapsed": "314ms"
}

語法

此命令具有以下語法：

mc [GLOBALFLAGS] od                                            \
                 if=<path of source file to upload>            \
                 of=<target MinIO path to upload to>           \
                 [size=<size of file>]                         \
                 [parts=<number of parts to split file into>]  \
                 [skip=<number of parts to skip>]

括號 [] 表示選用參數。
在同一行上的參數彼此相依。
使用管道符號 | 分隔的參數是互斥的。

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

參數

if

必填

要用於上傳的來源物件路徑。使用相對於目前位置的完整路徑。

mc od if=file.zip of=myminio/mybucket/file.zip

of: 必填
要將物件上傳到的完整目標路徑。

size: 選用
要上傳的檔案每個部分的大小。如果未指定，MinIO 會從來源串流判斷每個部分的大小。

parts: 選用
將物件分割成以上傳的部分數。如果未指定，MinIO 會根據來源串流的大小判斷部分數量。

skip: 選用
在上傳期間要跳過的檔案部分數。例如，使用此選項來測試一個包含許多部分的大型檔案的上傳速度，只需測試物件的一部分部分即可。

全域旗標

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

範例

上傳具有 40MiB 部分的完整檔案

使用 mc od 將檔案上傳到 MinIO，並設定每個部分的大小。 size 選項允許您指定所需的部分大小。

mc od if=file.zip of=myminio/mybucket/file.zip size=40MiB

將 myminio/mybucket/file.zip 替換為要上傳的物件或檔案串流的路徑。
將 size 替換為所需物件部分的大小。

MinIO 會檢查來源檔案，並將其分割為必要的部分數量，使每個部分都不會大於指定的 40MiB 部分大小。

上傳檔案的前五個 40 MiB 部分

使用 mc od 將檔案的部分上傳到 MinIO，並設定每個部分的大小。size 選項允許您指定所需的部分大小。parts 選項允許您指定要用於物件的部分總數。

mc od if=file.zip of=myminio/mybucket/file.zip size=40MiB parts=5

將 myminio/mybucket/file.zip 替換為要上傳的物件或檔案串流的路徑。
將 size 替換為所需物件部分的大小。
將 parts 替換為要用於物件的所需部分數量。

在此命令範例中，如果來源物件串流大於 200MiB（40MiB × 5 個部分），則僅上傳檔案的前 200MiB。

重要事項

以這種方式使用命令可能無法上傳整個物件。

以 5 個部分上傳完整檔案

取得來源檔案，將檔案分割為指定數量的部分，然後將檔案的所有部分上傳到 MinIO 目標。

mc od if=file.zip of=myminio/mybucket/file.zip parts=5

上述命令將來源檔案分割為五個相等的部分，然後上傳這些部分。

S3 相容性

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

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