`mc share download`

語法

mc share download 命令會產生一個帶有整合存取憑證的臨時預先簽署 URL，用於從 MinIO 儲存桶下載物件。該臨時 URL 會在可設定的時間限制後過期。

應用程式可以執行 GET 來從 URL 擷取物件。
使用者可以在瀏覽器中開啟 URL 來下載物件。

如需關於可分享物件 URL 的更多資訊，請參閱 Amazon S3 文件中關於預先簽署 URL的說明。

範例

以下命令會為 myminio MinIO 部署上的 mydata 儲存桶產生一個新的預先簽署下載 URL。

mc share download --recursive myminio/mydata

語法

此命令具有以下語法：

mc [GLOBALFLAGS] share download           \
                 [--expire "string"]      \
                 [--recursive]            \
                 [--version-id "string"]  \
                 ALIAS

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

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

參數

ALIAS

必要

MinIO 部署的別名，以及要產生下載 URL 的物件完整路徑。例如：

mc share download play/mybucket/object.txt

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

mc share download play/mybucket/object.txt play/mybucket/otherobject.txt

如果指定儲存桶或儲存桶前綴的路徑，則**必須**同時指定 --recursive 引數。例如：

mc share download --recursive play/mybucket/

mc share download --recursive play/mybucket/myprefix/

--expire, E

可選

設定所有產生的 URL 的到期時間限制。

指定格式為 ##h##m##s 的字串。例如：12h34m56s 代表 URL 產生後 12 小時、34 分鐘和 56 秒後過期。

預設值為 168h 或 168 小時（7 天）。

--recursive, r

可選

遞迴地為 mc share download ALIAS 儲存桶或儲存桶前綴中的所有物件產生 URL。

如果任何 ALIAS 指定了儲存桶或儲存桶前綴的路徑，則為必要參數。

--version-id, vid

可選

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

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

全域旗標

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

範例

產生下載物件的 URL

取得特定物件

使用 mc share download 來產生一個支援物件 GET 請求的 URL。

mc share download --expire DURATION ALIAS/PATH

將 ALIAS 替換為 MinIO 部署的別名。
將 PATH 替換為 MinIO 部署上物件的路徑。
將 DURATION 替換為 URL 過期之前的時間長度。例如，要設定 30 天的到期時間，請指定 30d。

取得儲存桶中的物件

使用 mc share download 和 --recursive 選項，為儲存桶中的每個物件產生 URL。每個 URL 都支援其關聯物件的 GET 請求。

mc share download --recursive --expire DURATION ALIAS/PATH

將 ALIAS 替換為 MinIO 部署的別名。
將 PATH 替換為 MinIO 部署上儲存桶或儲存桶前綴的路徑。
將 DURATION 替換為 URL 過期之前的時間長度。例如，要設定 30 天的到期時間，請指定 30d。

行為

S3 相容性

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

MinIO 對其他 S3 相容服務不提供任何保證，因為其 S3 API 實作未知，因此不受支援。雖然 mc 命令可能會如文件所述運作，但任何此類用法都需自行承擔風險。