az storage blob copy
注意
此命令群組具有 Azure CLI 和至少一個擴充功能中定義的命令。 安裝每個擴充功能以受益于其擴充功能。 深入了解擴充功能。
管理 Blob 複製作業。 使用 az storage blob show
來檢查 Blob 的狀態。
命令
名稱 | Description | 類型 | 狀態 |
---|---|---|---|
az storage blob copy cancel |
中止進行中的複製作業。 |
核心 | GA |
az storage blob copy start |
以非同步方式複製 Blob。 使用 |
核心 | GA |
az storage blob copy start (storage-blob-preview 擴充功能) |
啟動複製 Blob 作業。 |
擴充 | GA |
az storage blob copy start-batch |
將多個 Blob 複製到 Blob 容器。 使用 |
核心 | GA |
az storage blob copy cancel
中止進行中的複製作業。
這會將目的地 Blob 保留長度為零和完整中繼資料。 如果複製作業已經結束,就會引發錯誤。
az storage blob copy cancel --copy-id
--destination-blob
--destination-container
[--account-key]
[--account-name]
[--auth-mode {key, login}]
[--blob-endpoint]
[--connection-string]
[--lease-id]
[--sas-token]
[--timeout]
必要參數
要中止的複製作業。 這可以是識別碼字串或 BlobProperties 的實例。
目的地 Blob 的名稱。 如果存在,將會覆寫它。
容器名稱。
選擇性參數
儲存體帳戶金鑰。 必須與儲存體帳戶名稱或服務端點搭配使用。 環境變數:AZURE_STORAGE_KEY。
儲存體帳戶名稱。 相關的環境變數:AZURE_STORAGE_ACCOUNT。 必須與儲存體帳戶金鑰或 SAS 權杖搭配使用。 如果兩者都不存在,命令會嘗試使用已驗證的 Azure 帳戶來查詢儲存體帳戶金鑰。 如果執行大量儲存體命令,可能會叫用 API 配額。
執行命令的模式。 「登入」模式將直接使用您的登入認證進行驗證。 如果未提供帳戶的驗證參數,舊版「金鑰」模式將會嘗試查詢帳戶金鑰。 環境變數:AZURE_STORAGE_AUTH_MODE。
儲存體資料服務端點。 必須與儲存體帳戶金鑰或 SAS 權杖搭配使用。 您可以使用 找到每個服務主要端點 az storage account show
。 環境變數:AZURE_STORAGE_SERVICE_ENDPOINT。
儲存體帳戶連接字串。 環境變數:AZURE_STORAGE_CONNECTION_STRING。
如果目的地 Blob 具有作用中的無限租用,則為必要專案。
共用存取簽章 (SAS)。 必須與儲存體帳戶名稱或服務端點搭配使用。 環境變數:AZURE_STORAGE_SAS_TOKEN。
要求以秒為單位的逾時。 適用于服務的每個呼叫。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID
帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az storage blob copy start
以非同步方式複製 Blob。 使用 az storage blob show
來檢查 Blob 的狀態。
az storage blob copy start --destination-blob
--destination-container
[--account-key]
[--account-name]
[--auth-mode {key, login}]
[--blob-endpoint]
[--connection-string]
[--destination-blob-type {AppendBlob, BlockBlob, Detect, PageBlob}]
[--destination-if-match]
[--destination-if-modified-since]
[--destination-if-none-match]
[--destination-if-unmodified-since]
[--destination-lease-id]
[--destination-tags-condition]
[--metadata]
[--rehydrate-priority]
[--requires-sync {false, true}]
[--sas-token]
[--source-account-key]
[--source-account-name]
[--source-blob]
[--source-container]
[--source-if-match]
[--source-if-modified-since]
[--source-if-none-match]
[--source-if-unmodified-since]
[--source-lease-id]
[--source-path]
[--source-sas]
[--source-share]
[--source-snapshot]
[--source-tags-condition]
[--source-uri]
[--tags]
[--tier]
[--timeout]
範例
以非同步方式複製 Blob。 使用 'az storage blob show' 來檢查 Blob 的狀態。
az storage blob copy start --account-key 00000000 --account-name MyAccount --destination-blob MyDestinationBlob --destination-container MyDestinationContainer --source-uri https://storage.blob.core.windows.net/photos
以非同步方式複製 Blob。 使用 'az storage blob show' 來檢查 Blob 的狀態。
az storage blob copy start --account-name MyAccount --destination-blob MyDestinationBlob --destination-container MyDestinationContainer --sas-token $sas --source-uri https://storage.blob.core.windows.net/photos
複製 Blob 特定版本
az storage blob copy start --account-name MyAccount --destination-blob MyDestinationBlob --destination-container MyDestinationContainer --source-uri https://my-account.blob.core.windows.net/my-container/my-blob?versionId=2022-03-21T18:28:44.4431011Z --auth-mode login
必要參數
目的地 Blob 的名稱。 如果存在,將會覆寫它。
容器名稱。
選擇性參數
儲存體帳戶金鑰。 必須與儲存體帳戶名稱或服務端點搭配使用。 環境變數:AZURE_STORAGE_KEY。
儲存體帳戶名稱。 相關的環境變數:AZURE_STORAGE_ACCOUNT。 必須與儲存體帳戶金鑰或 SAS 權杖搭配使用。 如果兩者都不存在,命令會嘗試使用已驗證的 Azure 帳戶來查詢儲存體帳戶金鑰。 如果執行大量儲存體命令,可能會叫用 API 配額。
執行命令的模式。 「登入」模式將直接使用您的登入認證進行驗證。 如果未提供帳戶的驗證參數,舊版「金鑰」模式將會嘗試查詢帳戶金鑰。 環境變數:AZURE_STORAGE_AUTH_MODE。
儲存體資料服務端點。 必須與儲存體帳戶金鑰或 SAS 權杖搭配使用。 您可以使用 找到每個服務主要端點 az storage account show
。 環境變數:AZURE_STORAGE_SERVICE_ENDPOINT。
儲存體帳戶連接字串。 環境變數:AZURE_STORAGE_CONNECTION_STRING。
定義目的地的 Blob 類型。 「Detect」 的值會根據來源 Blob 類型來判斷類型。
ETag 值,或萬用字元 \。 只有在資源的 ETag 符合指定的值時,才指定此標頭來執行作業。
DateTime 值。 Azure 預期傳入的日期值必須是 UTC。 如果包含時區,任何非 UTC 日期時間都會轉換成 UTC。 如果日期在沒有時區資訊的情況下傳入,則會假設為 UTC。 指定此條件式標頭,只有在目的地 Blob 自指定的日期/時間之後已修改時,才複製 Blob。 如果目的地 Blob 尚未修改,Blob 服務會傳回狀態碼 412 (前置條件失敗)。
ETag 值或萬用字元 ( )。只有在資源的 ETag 不符合指定的值時,才指定此標頭來執行作業。只有在資源不存在時,才指定萬用字元 ( ) 來執行作業,如果作業確實存在,則作業會失敗。
DateTime 值。 Azure 預期傳入的日期值必須是 UTC。 如果包含時區,任何非 UTC 日期時間都會轉換成 UTC。 如果日期在沒有時區資訊的情況下傳入,則會假設為 UTC。 指定此條件式標頭,只有在目的地 Blob 自指定的日期/時間之後尚未修改時,才複製 Blob。 如果目的地 Blob 已修改,Blob 服務會傳回狀態碼 412 (前置條件失敗)。
為此標頭指定的租用識別碼必須符合內嵌 Blob 的租用識別碼。 如果要求不包含租用識別碼或無效,則作業會失敗,狀態碼為 412 (前置條件失敗)。
指定 BLOB 標記上的 SQL where 子句,以只在具有相符值的 Blob 上運作。
空格分隔索引鍵=值組中的中繼資料。 這會覆寫任何現有的中繼資料。
指出要解除封存 Blob 凍結的優先順序。
強制服務在複製完成之前不會傳迴響應。
共用存取簽章 (SAS)。 必須與儲存體帳戶名稱或服務端點搭配使用。 環境變數:AZURE_STORAGE_SAS_TOKEN。
來源 Blob 的儲存體帳戶金鑰。
來源 Blob 的儲存體帳戶名稱。
來源儲存體帳戶的 Blob 名稱。
來源儲存體帳戶的容器名稱。
ETag 值,或萬用字元 \。 只有在資源的 ETag 符合指定的值時,才指定此標頭來執行作業。
DateTime 值。 Azure 預期傳入的日期值必須是 UTC。 如果包含時區,任何非 UTC 日期時間都會轉換成 UTC。 如果日期在沒有時區資訊的情況下傳入,則會假設為 UTC。 指定此條件式標頭,只有在來源 Blob 自指定的日期/時間之後修改過時,才複製 Blob。
ETag 值或萬用字元 ( )。只有在資源的 ETag 不符合指定的值時,才指定此標頭來執行作業。只有在資源不存在時,才指定萬用字元 ( ) 來執行作業,如果作業確實存在,則作業會失敗。
DateTime 值。 Azure 預期傳入的日期值必須是 UTC。 如果包含時區,任何非 UTC 日期時間都會轉換成 UTC。 如果日期在沒有時區資訊的情況下傳入,則會假設為 UTC。 指定此條件式標頭,只有在來源 Blob 自指定的日期/時間之後尚未修改時,才複製 Blob。
只有在指定的租用識別碼符合來源 Blob 的作用中租用識別碼時,才指定這個來執行複製 Blob 作業。
來源儲存體帳戶的檔案路徑。
來源儲存體帳戶的共用存取簽章。
來源儲存體帳戶的共用名稱稱。
來源儲存體帳戶的 Blob 快照集。
指定 BLOB 標記上的 SQL where 子句,以只在具有相符值的 Blob 上運作。
長度最多 2 KB 的 URL,指定 Azure 檔案或 Blob。 此值應該以 URL 編碼,因為它會出現在要求 URI 中。 如果來源位於另一個帳戶中,來源必須是公用或必須透過共用存取簽章進行驗證。 如果來源是公用的,則不需要驗證。 範例: https://myaccount.blob.core.windows.net/mycontainer/myblob
、、 https://otheraccount.blob.core.windows.net/mycontainer/myblob?sastoken
https://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot=<DateTime>
。
以空格分隔的標記:key[=value] [key[=value] ...]。使用 「」 清除現有的標記。
要設定 Blob 的階層值。 對於分頁 Blob,層會與 Blob 的大小和允許的 IOPS 數目相互關聯。 可能的值為 P10、P15、P20、P30、P4、P40、P50、P6、P60、P70、P80,這只適用于進階儲存體帳戶上的分頁 Blob:針對區塊 Blob,可能的值為 Archive、Cold、Cool 和 Hot。 這只適用于標準儲存體帳戶上的區塊 Blob。
要求以秒為單位的逾時。 適用于服務的每個呼叫。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID
帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az storage blob copy start (storage-blob-preview 擴充功能)
啟動複製 Blob 作業。
az storage blob copy start --destination-blob
--destination-container
[--account-key]
[--account-name]
[--auth-mode {key, login}]
[--blob-endpoint]
[--connection-string]
[--destination-blob-type {AppendBlob, BlockBlob, Detect, PageBlob}]
[--destination-if-match]
[--destination-if-modified-since]
[--destination-if-none-match]
[--destination-if-unmodified-since]
[--destination-lease-id]
[--destination-tags-condition]
[--metadata]
[--rehydrate-priority]
[--requires-sync {false, true}]
[--sas-token]
[--source-account-key]
[--source-account-name]
[--source-blob]
[--source-container]
[--source-if-match]
[--source-if-modified-since]
[--source-if-none-match]
[--source-if-unmodified-since]
[--source-lease-id]
[--source-path]
[--source-sas]
[--source-share]
[--source-snapshot]
[--source-tags-condition]
[--source-uri]
[--tags]
[--tier]
[--timeout]
範例
以非同步方式複製 Blob。 使用 'az storage blob show' 來檢查 Blob 的狀態。
az storage blob copy start --account-key 00000000 --account-name MyAccount --destination-blob MyDestinationBlob --destination-container MyDestinationContainer --source-uri https://storage.blob.core.windows.net/photos
以非同步方式複製 Blob。 使用 'az storage blob show' 來檢查 Blob 的狀態。
az storage blob copy start --account-name MyAccount --destination-blob MyDestinationBlob --destination-container MyDestinationContainer --sas-token $sas --source-uri https://storage.blob.core.windows.net/photos
必要參數
目的地 Blob 的名稱。 如果存在,將會覆寫它。
容器名稱。
選擇性參數
儲存體帳戶金鑰。 必須與儲存體帳戶名稱搭配使用。 環境變數:AZURE_STORAGE_KEY。
儲存體帳戶名稱。 相關的環境變數:AZURE_STORAGE_ACCOUNT。 必須與儲存體帳戶金鑰或 SAS 權杖搭配使用。 如果兩者都不存在,命令會嘗試使用已驗證的 Azure 帳戶來查詢儲存體帳戶金鑰。 如果執行大量儲存體命令,可能會叫用 API 配額。
執行命令的模式。 「登入」模式將直接使用您的登入認證進行驗證。 如果未提供帳戶的驗證參數,舊版「金鑰」模式將會嘗試查詢帳戶金鑰。 環境變數:AZURE_STORAGE_AUTH_MODE。
儲存體資料服務端點。 必須與儲存體帳戶金鑰或 SAS 權杖搭配使用。 您可以使用 找到每個服務主要端點 az storage account show
。 環境變數:AZURE_STORAGE_SERVICE_ENDPOINT。
儲存體帳戶連接字串。 環境變數:AZURE_STORAGE_CONNECTION_STRING。
定義目的地的 Blob 類型。 「Detect」 的值會根據來源 Blob 類型來判斷類型。
ETag 值,或萬用字元 \。 只有在資源的 ETag 符合指定的值時,才指定此標頭來執行作業。
DateTime 值。 Azure 預期傳入的日期值必須是 UTC。 如果包含時區,任何非 UTC 日期時間都會轉換成 UTC。 如果日期在沒有時區資訊的情況下傳入,則會假設為 UTC。 指定此條件式標頭,只有在目的地 Blob 自指定的日期/時間之後已修改時,才複製 Blob。 如果目的地 Blob 尚未修改,Blob 服務會傳回狀態碼 412 (前置條件失敗)。
ETag 值或萬用字元 ( )。只有在資源的 ETag 不符合指定的值時,才指定此標頭來執行作業。只有在資源不存在時,才指定萬用字元 ( ) 來執行作業,如果作業確實存在,則作業會失敗。
DateTime 值。 Azure 預期傳入的日期值必須是 UTC。 如果包含時區,任何非 UTC 日期時間都會轉換成 UTC。 如果日期在沒有時區資訊的情況下傳入,則會假設為 UTC。 指定此條件式標頭,只有在目的地 Blob 自指定的日期/時間之後尚未修改時,才複製 Blob。 如果目的地 Blob 已修改,Blob 服務會傳回狀態碼 412 (前置條件失敗)。
為此標頭指定的租用識別碼必須符合內嵌 Blob 的租用識別碼。 如果要求不包含租用識別碼或無效,則作業會失敗,狀態碼為 412 (前置條件失敗)。
指定 BLOB 標記上的 SQL where 子句,以只在具有相符值的 Blob 上運作。
空格分隔索引鍵=值組中的中繼資料。 這會覆寫任何現有的中繼資料。
指出要解除封存 Blob 凍結的優先順序。
強制服務在複製完成之前不會傳迴響應。
共用存取簽章 (SAS)。 必須與儲存體帳戶名稱搭配使用。 環境變數:AZURE_STORAGE_SAS_TOKEN。
來源 Blob 的儲存體帳戶金鑰。
來源 Blob 的儲存體帳戶名稱。
來源儲存體帳戶的 Blob 名稱。
來源儲存體帳戶的容器名稱。
ETag 值,或萬用字元 \。 只有在資源的 ETag 符合指定的值時,才指定此標頭來執行作業。
DateTime 值。 Azure 預期傳入的日期值必須是 UTC。 如果包含時區,任何非 UTC 日期時間都會轉換成 UTC。 如果日期在沒有時區資訊的情況下傳入,則會假設為 UTC。 指定此條件式標頭,只有在來源 Blob 自指定的日期/時間之後修改過時,才複製 Blob。
ETag 值或萬用字元 ( )。只有在資源的 ETag 不符合指定的值時,才指定此標頭來執行作業。只有在資源不存在時,才指定萬用字元 ( ) 來執行作業,如果作業確實存在,則作業會失敗。
DateTime 值。 Azure 預期傳入的日期值必須是 UTC。 如果包含時區,任何非 UTC 日期時間都會轉換成 UTC。 如果日期在沒有時區資訊的情況下傳入,則會假設為 UTC。 指定此條件式標頭,只有在來源 Blob 自指定的日期/時間之後尚未修改時,才複製 Blob。
只有在指定的租用識別碼符合來源 Blob 的作用中租用識別碼時,才指定這個來執行複製 Blob 作業。
來源儲存體帳戶的檔案路徑。
來源儲存體帳戶的共用存取簽章。
來源儲存體帳戶的共用名稱稱。
來源儲存體帳戶的 Blob 快照集。
指定 BLOB 標記上的 SQL where 子句,以只在具有相符值的 Blob 上運作。
長度最多 2 KB 的 URL,指定 Azure 檔案或 Blob。 此值應該以 URL 編碼,因為它會出現在要求 URI 中。 如果來源位於另一個帳戶中,來源必須是公用或必須透過共用存取簽章進行驗證。 如果來源是公用的,則不需要驗證。 範例: https://myaccount.blob.core.windows.net/mycontainer/myblob
、、 https://otheraccount.blob.core.windows.net/mycontainer/myblob?sastoken
https://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot=<DateTime>
。
以空格分隔的標記:key[=value] [key[=value] ...]。標籤會區分大小寫。 標記集最多可以包含 10 個標籤。 標記索引鍵必須介於 1 到 128 個字元之間,而標籤值必須介於 0 到 256 個字元之間。 有效的標記索引鍵和值字元包括:小寫和大寫字母、數位(0-9)、空格(
)、加(+)、減(-)、句號(.)、solidus (/)、冒號(:)、等號(=)、底線(_)。
要設定 Blob 的階層值。 對於分頁 Blob,層會與 Blob 的大小和允許的 IOPS 數目相互關聯。 可能的值為 P10、P15、P20、P30、P4、P40、P50、P6、P60、P70、P80,這只適用于進階儲存體帳戶上的分頁 Blob:針對區塊 Blob,可能的值為封存、冷、非經常性存取和經常性存取。 這只適用于標準儲存體帳戶上的區塊 Blob。
要求以秒為單位的逾時。 適用于服務的每個呼叫。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID
帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az storage blob copy start-batch
將多個 Blob 複製到 Blob 容器。 使用 az storage blob show
來檢查 Blob 的狀態。
az storage blob copy start-batch [--account-key]
[--account-name]
[--auth-mode {key, login}]
[--blob-endpoint]
[--connection-string]
[--destination-blob-type {AppendBlob, BlockBlob, Detect, PageBlob}]
[--destination-container]
[--destination-path]
[--dryrun]
[--pattern]
[--rehydrate-priority]
[--sas-token]
[--source-account-key]
[--source-account-name]
[--source-container]
[--source-sas]
[--source-share]
[--source-uri]
[--tier]
範例
將多個 Blob 複製到 Blob 容器。 使用 'az storage blob show' 來檢查 Blob 的狀態。 (自動產生)
az storage blob copy start-batch --account-key 00000000 --account-name MyAccount --destination-container MyDestinationContainer --source-account-key MySourceKey --source-account-name MySourceAccount --source-container MySourceContainer
選擇性參數
儲存體帳戶金鑰。 必須與儲存體帳戶名稱或服務端點搭配使用。 環境變數:AZURE_STORAGE_KEY。
儲存體帳戶名稱。 相關的環境變數:AZURE_STORAGE_ACCOUNT。 必須與儲存體帳戶金鑰或 SAS 權杖搭配使用。 如果兩者都不存在,命令會嘗試使用已驗證的 Azure 帳戶來查詢儲存體帳戶金鑰。 如果執行大量儲存體命令,可能會叫用 API 配額。
執行命令的模式。 「登入」模式將直接使用您的登入認證進行驗證。 如果未提供帳戶的驗證參數,舊版「金鑰」模式將會嘗試查詢帳戶金鑰。 環境變數:AZURE_STORAGE_AUTH_MODE。
儲存體資料服務端點。 必須與儲存體帳戶金鑰或 SAS 權杖搭配使用。 您可以使用 找到每個服務主要端點 az storage account show
。 環境變數:AZURE_STORAGE_SERVICE_ENDPOINT。
儲存體帳戶連接字串。 環境變數:AZURE_STORAGE_CONNECTION_STRING。
定義目的地的 Blob 類型。 「Detect」 的值會根據來源 Blob 類型來判斷類型。
將複製所選來源檔案或 Blob 的 Blob 容器。
將前面加上 Blob 名稱的目的地路徑。
列出要上傳的檔案或 Blob。 不會進行實際的資料傳輸。
用於在來源中擷取檔案或 Blob 的模式。 支援的模式為 '*'、'?'、'[seq]'和 '[!seq]'。 如需詳細資訊,請參閱 https://docs.python.org/3.7/library/fnmatch.html 。
當您在 --pattern 中使用 '*' 時,它會比對包含目錄分隔符號 '/' 的任何字元。
指出要解除封存 Blob 凍結的優先順序。
共用存取簽章 (SAS)。 必須與儲存體帳戶名稱或服務端點搭配使用。 環境變數:AZURE_STORAGE_SAS_TOKEN。
來源儲存體帳戶的帳戶金鑰。
將檔案或 Blob 複製到目的地的來源儲存體帳戶。 如果省略,則會使用目的地帳戶。
複製 Blob 的來源容器。
來源儲存體帳戶的共用存取簽章。
從中複製檔案的來源共用。
URI,指定從中複製檔案或 Blob 的檔案共用或 Blob 容器。
如果來源位於另一個帳戶中,來源必須是公用,或是使用共用存取簽章進行驗證。
要設定 Blob 的階層值。 對於分頁 Blob,層會與 Blob 的大小和允許的 IOPS 數目相互關聯。 可能的值為 P10、P15、P20、P30、P4、P40、P50、P6、P60、P70、P80,這只適用于進階儲存體帳戶上的分頁 Blob:針對區塊 Blob,可能的值為 Archive、Cold、Cool 和 Hot。 這只適用于標準儲存體帳戶上的區塊 Blob。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID
帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。