az storage blob

注意

此命令群組具有 Azure CLI 和至少一個擴充功能中定義的命令。 安裝每個擴充功能以受益於其擴充功能。 深入了解擴充功能。

管理非結構化數據的物件記憶體(Blob)。

請為命令指定下列其中一個驗證參數:--auth-mode、--account-key、--connection-string、--sas-token。 您也可以使用對應的環境變數來儲存您的驗證認證,例如AZURE_STORAGE_KEY、AZURE_STORAGE_CONNECTION_STRING和AZURE_STORAGE_SAS_TOKEN。

命令

名稱 Description 類型 狀態
az storage blob access

啟用階層命名空間時,管理 Blob 的存取控制屬性。

副檔名 預覽和已淘汰
az storage blob access set

設定 Blob 的存取控制屬性。

副檔名 預覽和已淘汰
az storage blob access show

顯示 Blob 的存取控制屬性。

副檔名 預覽和已淘汰
az storage blob access update

更新 Blob 的存取控制屬性。

副檔名 預覽和已淘汰
az storage blob copy

管理 Blob 複製作業。 使用 az storage blob show 來檢查 Blob 的狀態。

核心和擴充功能 GA
az storage blob copy cancel

中止進行中的複製作業。

核心 GA
az storage blob copy start

以異步方式複製 Blob。 使用 az storage blob show 來檢查 Blob 的狀態。

核心 GA
az storage blob copy start (storage-blob-preview 擴充功能)

啟動複製 Blob 作業。

副檔名 GA
az storage blob copy start-batch

將多個 Blob 複製到 Blob 容器。 使用 az storage blob show 來檢查 Blob 的狀態。

核心 GA
az storage blob delete

標記要刪除的 Blob 或快照集。

核心 GA
az storage blob delete (storage-blob-preview 擴充功能)

標記要刪除的 Blob 或快照集。

副檔名 GA
az storage blob delete-batch

以遞歸方式從 Blob 容器中刪除 Blob。

核心 GA
az storage blob directory

管理記憶體帳戶容器中的 Blob 目錄。

副檔名 預覽和已淘汰
az storage blob directory access

啟用階層命名空間時,管理目錄的訪問控制屬性。

副檔名 預覽和已淘汰
az storage blob directory access set

設定目錄的訪問控制屬性。

副檔名 預覽和已淘汰
az storage blob directory access show

顯示目錄的訪問控制屬性。

副檔名 預覽和已淘汰
az storage blob directory access update

更新目錄的訪問控制屬性。

副檔名 預覽和已淘汰
az storage blob directory create

在記憶體容器中建立記憶體 Blob 目錄。

副檔名 預覽和已淘汰
az storage blob directory delete

刪除記憶體容器中的記憶體 Blob 目錄。

副檔名 預覽和已淘汰
az storage blob directory download

將 Blob 下載到本機檔案路徑。

副檔名 預覽和已淘汰
az storage blob directory exists

檢查記憶體容器中是否有 Blob 目錄。

副檔名 預覽和已淘汰
az storage blob directory list

列出記憶體目錄中的 Blob 和 Blob 子目錄。

副檔名 預覽和已淘汰
az storage blob directory metadata

管理目錄元數據。

副檔名 預覽和已淘汰
az storage blob directory metadata show

顯示指定之 Blob 目錄的所有使用者定義元數據。

副檔名 預覽和已淘汰
az storage blob directory metadata update

將指定 Blob 目錄的使用者定義元資料設定為一或多個名稱/值組。

副檔名 預覽和已淘汰
az storage blob directory move

將記憶體目錄移至記憶體容器中的另一個記憶體 Blob 目錄。

副檔名 預覽和已淘汰
az storage blob directory show

在記憶體容器中顯示記憶體 Blob 目錄屬性。

副檔名 預覽和已淘汰
az storage blob directory upload

將 Blob 或子目錄上傳至記憶體 Blob 目錄。

副檔名 預覽和已淘汰
az storage blob download

將 Blob 下載至檔案路徑。

核心 GA
az storage blob download-batch

以遞歸方式從 Blob 容器下載 Blob。

核心 GA
az storage blob exists

檢查容器中是否有 Blob。

核心 GA
az storage blob filter

列出標記符合指定搜尋表達式之所有容器的 Blob。

副檔名 預覽​​
az storage blob generate-sas

產生 Blob 的共用存取簽章。

核心 GA
az storage blob generate-sas (storage-blob-preview 擴充功能)

產生 Blob 的共用存取簽章。

副檔名 GA
az storage blob immutability-policy

管理 Blob 不變性原則。

核心 GA
az storage blob immutability-policy delete

刪除 Blob 的不變性原則。

核心 GA
az storage blob immutability-policy set

設定 Blob 的不變性原則。

核心 GA
az storage blob incremental-copy

管理 Blob 累加複製作業。

核心 GA
az storage blob incremental-copy cancel

中止擱置copy_blob作業,並保留長度為零和完整元數據的目的地 Blob。

核心 GA
az storage blob incremental-copy start

以異步方式複製 Blob 的增量複本。

核心 GA
az storage blob lease

管理記憶體 Blob 租用。

核心 GA
az storage blob lease acquire

要求新的租用。

核心 GA
az storage blob lease break

如果容器或 Blob 有作用中的租用,請中斷租用。

核心 GA
az storage blob lease change

變更使用中租用的租用標識符。

核心 GA
az storage blob lease release

釋放租用。

核心 GA
az storage blob lease renew

更新租用。

核心 GA
az storage blob list

列出指定容器中的 Blob。

核心 GA
az storage blob metadata

管理 Blob 元數據。

核心 GA
az storage blob metadata show

傳回指定之 Blob 或快照集的所有用戶定義元數據。

核心 GA
az storage blob metadata update

將 Blob 的使用者定義元數據設定為一或多個名稱/值組。

核心 GA
az storage blob move

移動記憶體容器中的 Blob。

副檔名 預覽和已淘汰
az storage blob query

提供簡單的查詢表達式,讓使用者在 Blob 或 Blob 快照集數據上選取/專案。

核心 預覽​​
az storage blob restore

還原指定 Blob 範圍中的 Blob。

核心 GA
az storage blob rewrite

建立新的區塊 Blob,其中 Blob 的內容會從指定的 URL 讀取。

核心 預覽​​
az storage blob service-properties

管理記憶體 Blob 服務屬性。

核心和擴充功能 GA
az storage blob service-properties delete-policy

管理記憶體 Blob 刪除原則服務屬性。

核心 GA
az storage blob service-properties delete-policy show

顯示記憶體 Blob 刪除原則。

核心 GA
az storage blob service-properties delete-policy update

更新記憶體 Blob 刪除原則。

核心 GA
az storage blob service-properties show

取得記憶體帳戶 Blob 服務的屬性,包括 Azure 儲存體 Analytics。

核心 GA
az storage blob service-properties update

更新儲存體 Blob 服務屬性。

核心 GA
az storage blob service-properties update (storage-blob-preview 擴充功能)

更新儲存體 Blob 服務屬性。

副檔名 GA
az storage blob set-legal-hold

設定 Blob 合法保留。

核心 GA
az storage blob set-tier

在 Blob 上設定區塊或頁面層。

核心 GA
az storage blob set-tier (storage-blob-preview 擴充功能)

在 Blob 上設定區塊或頁面層。

副檔名 GA
az storage blob show

取得 Blob 的詳細數據。

核心 GA
az storage blob show (storage-blob-preview 擴充功能)

取得 Blob 的詳細數據。

副檔名 GA
az storage blob snapshot

建立 Blob 的快照集。

核心 GA
az storage blob sync

以遞歸方式將 Blob 同步處理至記憶體 Blob 容器。

核心 預覽​​
az storage blob tag

管理 Blob 標籤。

副檔名 預覽​​
az storage blob tag list

取得 Blob 或特定 Blob 版本或快照集上的標籤。

副檔名 預覽​​
az storage blob tag set

在 Blob 或特定 Blob 版本上設定標籤,但不設定快照集。

副檔名 預覽​​
az storage blob undelete

還原虛刪除的 Blob 或快照集。

核心 GA
az storage blob update

在 Blob 上設定系統屬性。

核心 GA
az storage blob upload

將檔案上傳至記憶體 Blob。

核心 GA
az storage blob upload-batch

將檔案從本機目錄上傳至 Blob 容器。

核心 GA
az storage blob url

建立 URL 以存取 Blob。

核心 GA

az storage blob delete

標記要刪除的 Blob 或快照集。

Blob 會標示為稍後在垃圾收集期間刪除。 若要刪除 Blob,也必須刪除其所有快照集。 這兩者都可以同時移除。

az storage blob delete [--account-key]
                       [--account-name]
                       [--auth-mode {key, login}]
                       [--blob-endpoint]
                       [--blob-url]
                       [--connection-string]
                       [--container-name]
                       [--delete-snapshots {include, only}]
                       [--if-match]
                       [--if-modified-since]
                       [--if-none-match]
                       [--if-unmodified-since]
                       [--lease-id]
                       [--name]
                       [--sas-token]
                       [--snapshot]
                       [--tags-condition]
                       [--timeout]

範例

刪除 Blob。

az storage blob delete -c mycontainer -n MyBlob

使用登入認證刪除 Blob。

az storage blob delete -c mycontainer -n MyBlob --account-name mystorageaccount --auth-mode login

選擇性參數

--account-key

儲存體 帳戶金鑰。 必須與記憶體帳戶名稱或服務端點搭配使用。 環境變數:AZURE_STORAGE_KEY。

--account-name

儲存體帳戶名稱。 相關的環境變數:AZURE_STORAGE_ACCOUNT。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 如果兩者都不存在,命令會嘗試使用已驗證的 Azure 帳戶來查詢記憶體帳戶密鑰。 如果執行大量記憶體命令,可能會叫用 API 配額。

--auth-mode

執行命令的模式。 「登入」模式將直接使用您的登入認證進行驗證。 如果未提供帳戶的驗證參數,舊版「金鑰」模式將會嘗試查詢帳戶密鑰。 環境變數:AZURE_STORAGE_AUTH_MODE。

接受的值: key, login
--blob-endpoint

儲存體 資料服務端點。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 您可以使用 找到每個服務主要端點 az storage account show。 環境變數:AZURE_STORAGE_SERVICE_ENDPOINT。

--blob-url

Blob 的完整端點 URL,包括已使用 SAS 令牌和快照集。 這可能是主要端點或次要端點,視目前的 location_mode而定。

--connection-string

儲存體 帳戶 連接字串。 環境變數:AZURE_STORAGE_CONNECTION_STRING。

--container-name -c

容器名稱。

--delete-snapshots

如果 Blob 有相關聯的快照集,則為必要專案。 值包括:「only」:只刪除 Blob 快照集。 “include”:刪除 Blob 以及所有快照集。

接受的值: include, only
--if-match

ETag 值,或通配符 \。 只有在資源的 ETag 符合指定的值時,才指定此標頭來執行作業。

--if-modified-since

只有在提供UTC 日期時間後修改後才會開始 (Y-m-d'T'H:M'Z')。

--if-none-match

ETag 值或通配符 ()。只有在資源的 ETag 不符合指定的值時,才指定此標頭來執行作業。只有在資源不存在時,才指定通配符 () 來執行作業,如果作業確實存在,則作業會失敗。

--if-unmodified-since

只有在提供UTC 日期時間後未修改時才開始 (Y-m-d'T'H:M'Z')。

--lease-id

如果 Blob 具有作用中租用,則為必要專案。

--name -n

Blob 名稱。

--sas-token

共用存取簽章 (SAS)。 必須與記憶體帳戶名稱或服務端點搭配使用。 環境變數:AZURE_STORAGE_SAS_TOKEN。

--snapshot

快照集參數是不透明的 DateTime 值,當存在時,會指定要刪除的 Blob 快照集。

--tags-condition

指定 BLOB 標記上的 SQL where 子句,以只在具有相符值的 Blob 上運作。

--timeout

要求以秒為單位的逾時。 適用於服務的每個呼叫。

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az storage blob delete (storage-blob-preview 擴充功能)

標記要刪除的 Blob 或快照集。

Blob 會標示為稍後在垃圾收集期間刪除。 若要刪除 Blob,也必須刪除其所有快照集。 這兩者都可以同時移除。

az storage blob delete [--account-key]
                       [--account-name]
                       [--auth-mode {key, login}]
                       [--blob-endpoint]
                       [--blob-url]
                       [--connection-string]
                       [--container-name]
                       [--delete-snapshots {include, only}]
                       [--if-match]
                       [--if-modified-since]
                       [--if-none-match]
                       [--if-unmodified-since]
                       [--lease-id]
                       [--name]
                       [--sas-token]
                       [--snapshot]
                       [--tags-condition]
                       [--timeout]
                       [--version-id]

範例

刪除 Blob。

az storage blob delete -c mycontainer -n MyBlob

使用登入認證刪除 Blob。

az storage blob delete -c mycontainer -n MyBlob --account-name mystorageaccount --auth-mode login

選擇性參數

--account-key

儲存體 帳戶金鑰。 必須與記憶體帳戶名稱搭配使用。 環境變數:AZURE_STORAGE_KEY。

--account-name

儲存體帳戶名稱。 相關的環境變數:AZURE_STORAGE_ACCOUNT。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 如果兩者都不存在,命令會嘗試使用已驗證的 Azure 帳戶來查詢記憶體帳戶密鑰。 如果執行大量記憶體命令,可能會叫用 API 配額。

--auth-mode

執行命令的模式。 「登入」模式將直接使用您的登入認證進行驗證。 如果未提供帳戶的驗證參數,舊版「金鑰」模式將會嘗試查詢帳戶密鑰。 環境變數:AZURE_STORAGE_AUTH_MODE。

接受的值: key, login
--blob-endpoint

儲存體 資料服務端點。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 您可以使用 找到每個服務主要端點 az storage account show。 環境變數:AZURE_STORAGE_SERVICE_ENDPOINT。

--blob-url

Blob 的完整端點 URL,包括已使用 SAS 令牌和快照集。 這可能是主要端點或次要端點,視目前的 location_mode而定。

--connection-string

儲存體 帳戶 連接字串。 環境變數:AZURE_STORAGE_CONNECTION_STRING。

--container-name -c

容器名稱。

--delete-snapshots

如果 Blob 有相關聯的快照集,則為必要專案。 “only”:只刪除 Blob 快照集。 “include”:刪除 Blob 以及所有快照集。

接受的值: include, only
--if-match

ETag 值,或通配符 \。 只有在資源的 ETag 符合指定的值時,才指定此標頭來執行作業。

--if-modified-since

只有在提供UTC 日期時間後修改後才會開始 (Y-m-d'T'H:M'Z')。

--if-none-match

ETag 值或通配符 ()。只有在資源的 ETag 不符合指定的值時,才指定此標頭來執行作業。只有在資源不存在時,才指定通配符 () 來執行作業,如果作業確實存在,則作業會失敗。

--if-unmodified-since

只有在提供UTC 日期時間後未修改時才開始 (Y-m-d'T'H:M'Z')。

--lease-id

如果 Blob 具有作用中租用,則為必要專案。

--name -n

Blob 名稱。

--sas-token

共用存取簽章 (SAS)。 必須與記憶體帳戶名稱搭配使用。 環境變數:AZURE_STORAGE_SAS_TOKEN。

--snapshot

快照集參數是不透明的 DateTime 值,當存在時,會指定要擷取的 Blob 快照集。

--tags-condition

指定 BLOB 標記上的 SQL where 子句,以只在具有相符值的 Blob 上運作。

--timeout

要求以秒為單位的逾時。 適用於服務的每個呼叫。

--version-id

選擇性的 Blob 版本識別碼。 此參數僅適用於啟用版本設定的帳戶。

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az storage blob delete-batch

以遞歸方式從 Blob 容器中刪除 Blob。

az storage blob delete-batch --source
                             [--account-key]
                             [--account-name]
                             [--auth-mode {key, login}]
                             [--blob-endpoint]
                             [--connection-string]
                             [--delete-snapshots {include, only}]
                             [--dryrun]
                             [--if-match]
                             [--if-modified-since]
                             [--if-none-match]
                             [--if-unmodified-since]
                             [--lease-id]
                             [--pattern]
                             [--sas-token]
                             [--timeout]

範例

刪除容器中結尾為 「.py」 的所有 Blob,但尚未修改 10 天。

date=`date -d "10 days ago" '+%Y-%m-%dT%H:%MZ'`
az storage blob delete-batch -s mycontainer --account-name mystorageaccount --pattern "*.py" --if-unmodified-since $date --auth-mode login

刪除名為 「mycontainer」 之容器中名為 「dir」 的目錄中的所有 Blob。

az storage blob delete-batch -s mycontainer --pattern "dir/*"

刪除容器中格式為 『cli-2018-xx-xx.txt』 或 『cli-2019-xx-xx.txt』 的 Blob。

az storage blob delete-batch -s mycontainer --pattern "cli-201[89]-??-??.txt"

刪除容器中格式為 『cli-201x-xx-xx.txt』 和 『cli-2019-xx-xx.txt』 cli-2018-xx-xx.txt 以外的所有 blob。

az storage blob delete-batch -s mycontainer --pattern "cli-201[!89]-??-??.txt"

必要參數

--source -s

將刪除檔案的 Blob 容器。

來源可以是容器 URL 或容器名稱。 當來源是容器 URL 時,記憶體帳戶名稱將會從 URL 剖析。

選擇性參數

--account-key

儲存體 帳戶金鑰。 必須與記憶體帳戶名稱或服務端點搭配使用。 環境變數:AZURE_STORAGE_KEY。

--account-name

儲存體帳戶名稱。 相關的環境變數:AZURE_STORAGE_ACCOUNT。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 如果兩者都不存在,命令會嘗試使用已驗證的 Azure 帳戶來查詢記憶體帳戶密鑰。 如果執行大量記憶體命令,可能會叫用 API 配額。

--auth-mode

執行命令的模式。 「登入」模式將直接使用您的登入認證進行驗證。 如果未提供帳戶的驗證參數,舊版「金鑰」模式將會嘗試查詢帳戶密鑰。 環境變數:AZURE_STORAGE_AUTH_MODE。

接受的值: key, login
--blob-endpoint

儲存體 資料服務端點。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 您可以使用 找到每個服務主要端點 az storage account show。 環境變數:AZURE_STORAGE_SERVICE_ENDPOINT。

--connection-string

儲存體 帳戶 連接字串。 環境變數:AZURE_STORAGE_CONNECTION_STRING。

--delete-snapshots

如果 Blob 有相關聯的快照集,則為必要專案。

接受的值: include, only
--dryrun

顯示要採取的作業摘要,而不是實際刪除檔案。

如果指定這個值,則會忽略包含 --if-modified-since 和 --if-unmodified-since 的所有前置條件自變數。 因此,檔案會以不含 --dryrun 的命令刪除,可能與具有 --dryrun 旗標的結果清單不同。

預設值: False
--if-match

ETag 值,或通配符 \。 只有在資源的 ETag 符合指定的值時,才指定此標頭來執行作業。

--if-modified-since

只有在提供UTC 日期時間後修改後才會開始 (Y-m-d'T'H:M'Z')。

--if-none-match

ETag 值,或通配符 \。

只有在資源的 ETag 不符合指定的值時,才指定此標頭來執行作業。 指定通配符 \ 只有在資源不存在時,才能執行作業,並在作業存在時失敗。

--if-unmodified-since

只有在提供UTC 日期時間後未修改時才開始 (Y-m-d'T'H:M'Z')。

--lease-id

Blob 的作用中租用標識碼。

--pattern

用於在來源中擷取檔案或 Blob 的模式。 支援的模式為 '*'、'?'、'[seq]'和 '[!seq]'。 如需詳細資訊,請參閱 https://docs.python.org/3.7/library/fnmatch.html

當您在 --pattern 中使用 '*' 時,它會比對包含目錄分隔符 '/' 的任何字元。 您也可以嘗試使用 --include 和 --exclude 搭配 azure cli >= 2.0.70 的 “az storage remove” 命令來比對多個模式。

--sas-token

共用存取簽章 (SAS)。 必須與記憶體帳戶名稱或服務端點搭配使用。 環境變數:AZURE_STORAGE_SAS_TOKEN。

--timeout

要求以秒為單位的逾時。 適用於服務的每個呼叫。

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az storage blob download

將 Blob 下載至檔案路徑。

az storage blob download [--account-key]
                         [--account-name]
                         [--auth-mode {key, login}]
                         [--blob-endpoint]
                         [--blob-url]
                         [--connection-string]
                         [--container-name]
                         [--end-range]
                         [--file]
                         [--if-match]
                         [--if-modified-since]
                         [--if-none-match]
                         [--if-unmodified-since]
                         [--lease-id]
                         [--max-connections]
                         [--name]
                         [--no-progress]
                         [--open-mode]
                         [--overwrite {false, true}]
                         [--sas-token]
                         [--snapshot]
                         [--start-range]
                         [--tags-condition]
                         [--timeout]
                         [--validate-content]
                         [--version-id]

範例

下載 Blob。

az storage blob download -f /path/to/file -c mycontainer -n MyBlob

將 Blob 內容下載至 stdout(管道支援)。

az storage blob download -c mycontainer -n myblob --account-name mystorageaccount --account-key myaccountkey

選擇性參數

--account-key

儲存體 帳戶金鑰。 必須與記憶體帳戶名稱或服務端點搭配使用。 環境變數:AZURE_STORAGE_KEY。

--account-name

儲存體帳戶名稱。 相關的環境變數:AZURE_STORAGE_ACCOUNT。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 如果兩者都不存在,命令會嘗試使用已驗證的 Azure 帳戶來查詢記憶體帳戶密鑰。 如果執行大量記憶體命令,可能會叫用 API 配額。

--auth-mode

執行命令的模式。 「登入」模式將直接使用您的登入認證進行驗證。 如果未提供帳戶的驗證參數,舊版「金鑰」模式將會嘗試查詢帳戶密鑰。 環境變數:AZURE_STORAGE_AUTH_MODE。

接受的值: key, login
--blob-endpoint

儲存體 資料服務端點。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 您可以使用 找到每個服務主要端點 az storage account show。 環境變數:AZURE_STORAGE_SERVICE_ENDPOINT。

--blob-url

Blob 的完整端點 URL,包括已使用 SAS 令牌和快照集。 這可能是主要端點或次要端點,視目前的 location_mode而定。

--connection-string

儲存體 帳戶 連接字串。 環境變數:AZURE_STORAGE_CONNECTION_STRING。

--container-name -c

容器名稱。

--end-range

要用來下載 Blob 區段的位元組範圍結尾。 如果提供end_range,則必須提供start_range。 start_range和end_range參數是包容性的。 例如:start_range=0,end_range=511 會下載前 512 個字節的 Blob。

--file -f

要寫出之檔案的路徑。 如果未指定,則會使用 stdout,並將max_connections設定為 1。

--if-match

ETag 值,或通配符 \。 只有在資源的 ETag 符合指定的值時,才指定此標頭來執行作業。

--if-modified-since

只有在提供UTC 日期時間後修改後才會開始 (Y-m-d'T'H:M'Z')。

--if-none-match

ETag 值或通配符 ()。只有在資源的 ETag 不符合指定的值時,才指定此標頭來執行作業。只有在資源不存在時,才指定通配符 () 來執行作業,如果作業確實存在,則作業會失敗。

--if-unmodified-since

只有在提供UTC 日期時間後未修改時才開始 (Y-m-d'T'H:M'Z')。

--lease-id

如果 Blob 具有作用中租用,則為必要專案。

--max-connections

要下載的平行連線數目。

預設值: 2
--name -n

Blob 名稱。

--no-progress

包含此旗標以停用命令的進度報告。

預設值: False
--open-mode

開啟檔案時要使用的模式。 請注意,只指定附加open_mode可防止平行下載。 因此,如果使用這個open_mode,max_connections必須設定為1。

預設值: wb
--overwrite

指定時覆寫現有的檔案。 預設值為 True。

接受的值: false, true
預設值: True
--sas-token

共用存取簽章 (SAS)。 必須與記憶體帳戶名稱或服務端點搭配使用。 環境變數:AZURE_STORAGE_SAS_TOKEN。

--snapshot

快照集參數是不透明的 DateTime 值,當存在時,會指定要擷取的 Blob 快照集。

--start-range

要用來下載 Blob 區段的位元組範圍開始。 如果未指定任何end_range,則會下載start_range之後的所有位元組。 start_range和end_range參數是包容性的。 例如:start_range=0,end_range=511 會下載前 512 個字節的 Blob。

--tags-condition

指定 BLOB 標記上的 SQL where 子句,以只在具有相符值的 Blob 上運作。

--timeout

要求以秒為單位的逾時。 適用於服務的每個呼叫。

--validate-content

如果為 true,則計算 Blob 每個區塊的 MD5 哈希。 記憶體服務會檢查已隨已傳送之哈希而抵達的內容哈希。 如果使用 HTTP 而不是 HTTPs,這主要是在線路上偵測 bitflips 的寶貴價值,因為 HTTPs (預設值)已經驗證。 請注意,此 MD5 哈希不會與 Blob 一起儲存。 另請注意,如果啟用,則不會使用記憶體有效率的演算法,因為計算 MD5 哈希需要緩衝處理整個區塊,因此會失敗記憶體效率演算法的用途。

預設值: False
--version-id

選擇性的 Blob 版本識別碼。 此參數僅適用於啟用版本設定的帳戶。

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az storage blob download-batch

以遞歸方式從 Blob 容器下載 Blob。

az storage blob download-batch --destination
                               --source
                               [--account-key]
                               [--account-name]
                               [--auth-mode {key, login}]
                               [--blob-endpoint]
                               [--connection-string]
                               [--dryrun]
                               [--max-connections]
                               [--no-progress]
                               [--overwrite {false, true}]
                               [--pattern]
                               [--sas-token]

範例

下載以 .py 結尾的所有 Blob

az storage blob download-batch -d . --pattern "*.py" -s mycontainer --account-name mystorageaccount --account-key 00000000

從名為 「mycontainer」 的容器下載名為 「dir」 目錄中的所有 Blob。

az storage blob download-batch -d . -s mycontainer --pattern "dir/*"

將容器中格式為 『cli-2018-xx-xx.txt』 或 『cli-2019-xx-xx.txt』 的所有 Blob 下載到目前的路徑。

az storage blob download-batch -d . -s mycontainer --pattern "cli-201[89]-??-??.txt"

將容器中格式為 『cli-201x-xx-xx.txt』 和 『cli-2019-xx-xx.txt cli-2018-xx-xx.txt』 的所有 Blob 下載到目前的路徑。

az storage blob download-batch -d . -s mycontainer --pattern "cli-201[!89]-??-??.txt"

必要參數

--destination -d

此下載作業的現有目的地資料夾。

--source -s

要從中下載檔案的 Blob 容器。

來源可以是容器 URL 或容器名稱。 當來源是容器 URL 時,記憶體帳戶名稱將會從 URL 剖析。

選擇性參數

--account-key

儲存體 帳戶金鑰。 必須與記憶體帳戶名稱或服務端點搭配使用。 環境變數:AZURE_STORAGE_KEY。

--account-name

儲存體帳戶名稱。 相關的環境變數:AZURE_STORAGE_ACCOUNT。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 如果兩者都不存在,命令會嘗試使用已驗證的 Azure 帳戶來查詢記憶體帳戶密鑰。 如果執行大量記憶體命令,可能會叫用 API 配額。

--auth-mode

執行命令的模式。 「登入」模式將直接使用您的登入認證進行驗證。 如果未提供帳戶的驗證參數,舊版「金鑰」模式將會嘗試查詢帳戶密鑰。 環境變數:AZURE_STORAGE_AUTH_MODE。

接受的值: key, login
--blob-endpoint

儲存體 資料服務端點。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 您可以使用 找到每個服務主要端點 az storage account show。 環境變數:AZURE_STORAGE_SERVICE_ENDPOINT。

--connection-string

儲存體 帳戶 連接字串。 環境變數:AZURE_STORAGE_CONNECTION_STRING。

--dryrun

顯示要採取的作業摘要,而不是實際下載檔案。

預設值: False
--max-connections

要下載的平行連線數目。

預設值: 2
--no-progress

包含此旗標以停用命令的進度報告。

預設值: False
--overwrite

指定時覆寫現有的檔案。 預設值為 False。

接受的值: false, true
預設值: False
--pattern

用於在來源中擷取檔案或 Blob 的模式。 支援的模式為 '*'、'?'、'[seq]'和 '[!seq]'。 如需詳細資訊,請參閱 https://docs.python.org/3.7/library/fnmatch.html

當您在 --pattern 中使用 '*' 時,它會比對包含目錄分隔符 '/' 的任何字元。

--sas-token

共用存取簽章 (SAS)。 必須與記憶體帳戶名稱或服務端點搭配使用。 環境變數:AZURE_STORAGE_SAS_TOKEN。

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az storage blob exists

檢查容器中是否有 Blob。

az storage blob exists [--account-key]
                       [--account-name]
                       [--auth-mode {key, login}]
                       [--blob-endpoint]
                       [--blob-url]
                       [--connection-string]
                       [--container-name]
                       [--name]
                       [--sas-token]
                       [--snapshot]
                       [--timeout]

範例

檢查容器中是否有 Blob。 ( 自動產生 )

az storage blob exists --account-key 00000000 --account-name MyAccount --container-name mycontainer --name MyBlob

選擇性參數

--account-key

儲存體 帳戶金鑰。 必須與記憶體帳戶名稱或服務端點搭配使用。 環境變數:AZURE_STORAGE_KEY。

--account-name

儲存體帳戶名稱。 相關的環境變數:AZURE_STORAGE_ACCOUNT。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 如果兩者都不存在,命令會嘗試使用已驗證的 Azure 帳戶來查詢記憶體帳戶密鑰。 如果執行大量記憶體命令,可能會叫用 API 配額。

--auth-mode

執行命令的模式。 「登入」模式將直接使用您的登入認證進行驗證。 如果未提供帳戶的驗證參數,舊版「金鑰」模式將會嘗試查詢帳戶密鑰。 環境變數:AZURE_STORAGE_AUTH_MODE。

接受的值: key, login
--blob-endpoint

儲存體 資料服務端點。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 您可以使用 找到每個服務主要端點 az storage account show。 環境變數:AZURE_STORAGE_SERVICE_ENDPOINT。

--blob-url

Blob 的完整端點 URL,包括已使用 SAS 令牌和快照集。 這可能是主要端點或次要端點,視目前的 location_mode而定。

--connection-string

儲存體 帳戶 連接字串。 環境變數:AZURE_STORAGE_CONNECTION_STRING。

--container-name -c

容器名稱。

--name -n

Blob 名稱。

--sas-token

共用存取簽章 (SAS)。 必須與記憶體帳戶名稱或服務端點搭配使用。 環境變數:AZURE_STORAGE_SAS_TOKEN。

--snapshot

快照集參數是不透明的 DateTime 值,當存在時,會指定快照集。

--timeout

要求以秒為單位的逾時。 適用於服務的每個呼叫。

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az storage blob filter

預覽

此命令處於預覽狀態,且正在開發中。 參考和支援層級: https://aka.ms/CLI_refstatus

列出標記符合指定搜尋表達式之所有容器的 Blob。

az storage blob filter --tag-filter
                       [--account-key]
                       [--account-name]
                       [--auth-mode {key, login}]
                       [--blob-endpoint]
                       [--connection-string]
                       [--container-name]
                       [--sas-token]

必要參數

--tag-filter

要尋找標籤符合指定條件之 Blob 的運算式。 例如 “”yourtagname“='firsttag' 和 ”yourtagname2“='secondtag'”。

選擇性參數

--account-key

儲存體 帳戶金鑰。 必須與記憶體帳戶名稱搭配使用。 環境變數:AZURE_STORAGE_KEY。

--account-name

儲存體帳戶名稱。 相關的環境變數:AZURE_STORAGE_ACCOUNT。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 如果兩者都不存在,命令會嘗試使用已驗證的 Azure 帳戶來查詢記憶體帳戶密鑰。 如果執行大量記憶體命令,可能會叫用 API 配額。

--auth-mode

執行命令的模式。 「登入」模式將直接使用您的登入認證進行驗證。 如果未提供帳戶的驗證參數,舊版「金鑰」模式將會嘗試查詢帳戶密鑰。 環境變數:AZURE_STORAGE_AUTH_MODE。

接受的值: key, login
--blob-endpoint

儲存體 資料服務端點。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 您可以使用 找到每個服務主要端點 az storage account show。 環境變數:AZURE_STORAGE_SERVICE_ENDPOINT。

--connection-string

儲存體 帳戶 連接字串。 環境變數:AZURE_STORAGE_CONNECTION_STRING。

--container-name -c

當您想要列出指定容器下的 Blob 時使用。

--sas-token

共用存取簽章 (SAS)。 必須與記憶體帳戶名稱搭配使用。 環境變數:AZURE_STORAGE_SAS_TOKEN。

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az storage blob generate-sas

產生 Blob 的共用存取簽章。

az storage blob generate-sas [--account-key]
                             [--account-name]
                             [--as-user]
                             [--auth-mode {key, login}]
                             [--blob-endpoint]
                             [--blob-url]
                             [--cache-control]
                             [--connection-string]
                             [--container-name]
                             [--content-disposition]
                             [--content-encoding]
                             [--content-language]
                             [--content-type]
                             [--encryption-scope]
                             [--expiry]
                             [--full-uri]
                             [--https-only]
                             [--ip]
                             [--name]
                             [--permissions]
                             [--policy-name]
                             [--snapshot]
                             [--start]
                             [--timeout]

範例

為具有唯讀許可權的 Blob 產生 sas 令牌。

end=`date -u -d "30 minutes" '+%Y-%m-%dT%H:%MZ'`
az storage blob generate-sas -c myycontainer -n MyBlob --permissions r --expiry $end --https-only

為指定ip範圍的 Blob 產生 sas 令牌。

end=`date -u -d "30 minutes" '+%Y-%m-%dT%H:%MZ'`
az storage blob generate-sas -c myycontainer -n MyBlob --ip "176.134.171.0-176.134.171.255" --permissions r --expiry $end --https-only

產生 Blob 的共用存取簽章。 ( 自動產生 )

az storage blob generate-sas --account-key 00000000 --account-name MyStorageAccount --container-name mycontainer --expiry 2018-01-01T00:00:00Z --name MyBlob --permissions r

選擇性參數

--account-key

儲存體 帳戶金鑰。 必須與記憶體帳戶名稱或服務端點搭配使用。 環境變數:AZURE_STORAGE_KEY。

--account-name

儲存體帳戶名稱。 相關的環境變數:AZURE_STORAGE_ACCOUNT。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 如果兩者都不存在,命令會嘗試使用已驗證的 Azure 帳戶來查詢記憶體帳戶密鑰。 如果執行大量記憶體命令,可能會叫用 API 配額。

--as-user

指出此命令會傳回使用使用者委派金鑰簽署的 SAS。 如果指定這個自變數,則需要到期參數和 『--auth-mode login』。

預設值: False
--auth-mode

執行命令的模式。 「登入」模式將直接使用您的登入認證進行驗證。 如果未提供帳戶的驗證參數,舊版「金鑰」模式將會嘗試查詢帳戶密鑰。 環境變數:AZURE_STORAGE_AUTH_MODE。

接受的值: key, login
--blob-endpoint

儲存體 資料服務端點。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 您可以使用 找到每個服務主要端點 az storage account show。 環境變數:AZURE_STORAGE_SERVICE_ENDPOINT。

--blob-url

Blob 的完整端點 URL,包括已使用 SAS 令牌和快照集。 這可能是主要端點或次要端點,視目前的 location_mode而定。

--cache-control

當使用此共用存取簽章存取資源時,Cache-Control 的響應標頭值。

--connection-string

儲存體 帳戶 連接字串。 環境變數:AZURE_STORAGE_CONNECTION_STRING。

--container-name -c

容器名稱。

--content-disposition

當使用此共用存取簽章存取資源時,Content-Disposition 的響應標頭值。

--content-encoding

使用此共用存取簽章存取資源時,Content-Encoding 的響應標頭值。

--content-language

使用此共用存取簽章存取資源時,Content-Language 的響應標頭值。

--content-type

當使用此共用存取簽章存取資源時,Content-Type 的響應標頭值。

--encryption-scope

預先定義的加密範圍,用來加密服務上的數據。

--expiry

指定 SAS 無效的 UTC 日期時間(Y-m-d'T'H:M'Z')。 如果以指定此值的 --policy-name 參考預存取原則,請勿使用 。

--full-uri

表示此命令會傳回完整的 Blob URI 和共用存取簽章令牌。

預設值: False
--https-only

只允許使用 HTTPS 通訊協定提出的要求。 如果省略,則允許來自 HTTP 和 HTTPS 通訊協定的要求。

--ip

指定要接受要求的IP位址或IP位址範圍。 僅支援 IPv4 樣式位址。

--name -n

Blob 名稱。

--permissions

SAS 授與的許可權。 允許的值: (a)dd (c)reate (d)elete (e)xecute (i)set_immutability_policy (m)ove (r)ead (t)ag (w)rite (x)delete_previous_version (y)permanent_delete。 如果指定此值的 --id 參考預存取原則,請勿使用 。 可以合併。

--policy-name

容器 ACL 記憶體存取原則的名稱。

--snapshot

選擇性的 Blob 快照集標識碼。 不透明的 DateTime 值,當存在時,會指定要授與許可權的 Blob 快照集。

--start

指定 SAS 生效的 UTC 日期時間(Y-m-d'T'H:M'Z')。 如果以指定此值的 --policy-name 參考預存取原則,請勿使用 。 預設為要求的時間。

--timeout

要求以秒為單位的逾時。 適用於服務的每個呼叫。

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az storage blob generate-sas (storage-blob-preview 擴充功能)

產生 Blob 的共用存取簽章。

az storage blob generate-sas --container-name
                             --name
                             [--account-key]
                             [--account-name]
                             [--as-user]
                             [--auth-mode {key, login}]
                             [--blob-endpoint]
                             [--cache-control]
                             [--connection-string]
                             [--content-disposition]
                             [--content-encoding]
                             [--content-language]
                             [--content-type]
                             [--expiry]
                             [--full-uri]
                             [--https-only]
                             [--ip]
                             [--permissions]
                             [--policy-name]
                             [--snapshot]
                             [--start]
                             [--version-id]

範例

為具有唯讀許可權的 Blob 產生 sas 令牌。

end=`date -u -d "30 minutes" '+%Y-%m-%dT%H:%MZ'`
az storage blob generate-sas -c myycontainer -n MyBlob --permissions r --expiry $end --https-only

為指定ip範圍的 Blob 產生 sas 令牌。

end=`date -u -d "30 minutes" '+%Y-%m-%dT%H:%MZ'`
az storage blob generate-sas -c myycontainer -n MyBlob --ip "176.134.171.0-176.134.171.255" --permissions r --expiry $end --https-only

產生 Blob 的共用存取簽章。 ( 自動產生 )

az storage blob generate-sas --account-key 00000000 --account-name MyStorageAccount --container-name mycontainer --expiry 2018-01-01T00:00:00Z --name MyBlob --permissions r

必要參數

--container-name -c

容器名稱。

--name -n

Blob 名稱。

選擇性參數

--account-key

儲存體 帳戶金鑰。 必須與記憶體帳戶名稱搭配使用。 環境變數:AZURE_STORAGE_KEY。

--account-name

儲存體帳戶名稱。 相關的環境變數:AZURE_STORAGE_ACCOUNT。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 如果兩者都不存在,命令會嘗試使用已驗證的 Azure 帳戶來查詢記憶體帳戶密鑰。 如果執行大量記憶體命令,可能會叫用 API 配額。

--as-user

指出此命令會傳回使用使用者委派金鑰簽署的 SAS。 如果指定這個自變數,則需要到期參數和 『--auth-mode login』。

預設值: False
--auth-mode

執行命令的模式。 「登入」模式將直接使用您的登入認證進行驗證。 如果未提供帳戶的驗證參數,舊版「金鑰」模式將會嘗試查詢帳戶密鑰。 環境變數:AZURE_STORAGE_AUTH_MODE。

接受的值: key, login
--blob-endpoint

儲存體 資料服務端點。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 您可以使用 找到每個服務主要端點 az storage account show。 環境變數:AZURE_STORAGE_SERVICE_ENDPOINT。

--cache-control

存取此共用存取簽章的資源時,Cache-Control 的響應標頭值。

--connection-string

儲存體 帳戶 連接字串。 環境變數:AZURE_STORAGE_CONNECTION_STRING。

--content-disposition

存取此共用存取簽章的資源時,Content-Disposition 的響應標頭值。

--content-encoding

存取此共用存取簽章的資源時,Content-Encoding 的響應標頭值。

--content-language

存取此共用存取簽章的資源時,Content-Language 的響應標頭值。

--content-type

存取此共用存取簽章的資源時,Content-Type 的響應標頭值。

--expiry

指定 SAS 無效的 UTC 日期時間(Y-m-d'T'H:M'Z')。 如果指定此值的 --id 參考預存取原則,請勿使用 。

--full-uri

表示此命令會傳回完整的 Blob URI 和共用存取簽章令牌。

預設值: False
--https-only

只允許使用 HTTPS 通訊協定提出的要求。 如果省略,則允許來自 HTTP 和 HTTPS 通訊協定的要求。

--ip

指定要接受要求的IP位址或IP位址範圍。 如果要求的來源IP位址不符合SAS令牌上指定的IP位址或位址範圍,則不會驗證要求。 例如,在 SAS 上指定 ip=168.1.5.65 或 ip=168.1.5.60-168.1.5.70 會限制這些 IP 位址的要求。

--permissions

SAS 授與的許可權。 允許的值: (a)dd (c)reate (d)elete (x)delete_previous_version (e)xecute (m)ove (p)ermanent_delete (r)ead (s)et_immutability_policy (t)ag (w)rite. 如果以指定此值的 --policy-name 參考預存取原則,請勿使用 。 可以合併。

--policy-name

容器 ACL 記憶體存取原則的名稱。

--snapshot

快照集參數是不透明的 DateTime 值,當存在時,會指定要擷取的 Blob 快照集。

--start

指定 SAS 生效的 UTC 日期時間(Y-m-d'T'H:M'Z')。 如果指定此值的 --id 參考預存取原則,請勿使用 。 預設為要求的時間。

--version-id
預覽

選擇性的 Blob 版本識別碼。 此參數僅適用於啟用版本設定的帳戶。

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az storage blob list

列出指定容器中的 Blob。

az storage blob list --container-name
                     [--account-key]
                     [--account-name]
                     [--auth-mode {key, login}]
                     [--blob-endpoint]
                     [--connection-string]
                     [--delimiter]
                     [--include]
                     [--marker]
                     [--num-results]
                     [--prefix]
                     [--sas-token]
                     [--show-next-marker]
                     [--timeout]

範例

列出名稱開頭為 『foo』 的容器中的所有記憶體 Blob;會比對 『foo』、『foobar』 和 『foo/bar』 等名稱

az storage blob list -c mycontainer --prefix foo

必要參數

--container-name -c

容器名稱。

選擇性參數

--account-key

儲存體 帳戶金鑰。 必須與記憶體帳戶名稱或服務端點搭配使用。 環境變數:AZURE_STORAGE_KEY。

--account-name

儲存體帳戶名稱。 相關的環境變數:AZURE_STORAGE_ACCOUNT。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 如果兩者都不存在,命令會嘗試使用已驗證的 Azure 帳戶來查詢記憶體帳戶密鑰。 如果執行大量記憶體命令,可能會叫用 API 配額。

--auth-mode

執行命令的模式。 「登入」模式將直接使用您的登入認證進行驗證。 如果未提供帳戶的驗證參數,舊版「金鑰」模式將會嘗試查詢帳戶密鑰。 環境變數:AZURE_STORAGE_AUTH_MODE。

接受的值: key, login
--blob-endpoint

儲存體 資料服務端點。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 您可以使用 找到每個服務主要端點 az storage account show。 環境變數:AZURE_STORAGE_SERVICE_ENDPOINT。

--connection-string

儲存體 帳戶 連接字串。 環境變數:AZURE_STORAGE_CONNECTION_STRING。

--delimiter

當要求包含此參數時,此作業會在結果清單中傳回 BlobPrefix 元素,做為名稱開頭為相同子字串的所有 Blob 佔位元,而該 Blob 的名稱開頭為分隔符字元的外觀。 分隔符可以是單一字元或字串。

--include

指定要包含在回應中的一或多個其他數據集。 選項包括:(c)opy、(d)eleted、(m)etadata、(s)napshots、(v)ersions、(t)ags、(i)mmutabilitypolicy、(l)egalhold、(d)eletedwithversions。 可以合併。

--marker

字串值,識別要隨著下一個清單作業傳回之容器清單的部分。 如果清單作業未傳回剩餘的所有容器,則此作業會傳回響應主體內的 NextMarker 值,以與目前頁面一起列出。 如果指定,這個產生器會從前一個產生器停止的點開始傳回結果。

--num-results

指定要傳回的最大數目。 如果要求未指定num_results,或指定大於 5000 的值,伺服器將傳回最多 5000 個專案。 請注意,如果清單作業跨越數據分割界限,則服務會傳回接續令牌,以擷取其餘的結果。 提供 「*」 以傳回全部。

預設值: 5000
--prefix

篩選結果,只傳回名稱開頭為指定前置詞的 Blob。

--sas-token

共用存取簽章 (SAS)。 必須與記憶體帳戶名稱或服務端點搭配使用。 環境變數:AZURE_STORAGE_SAS_TOKEN。

--show-next-marker

指定時,在結果中顯示 nextMarker。

--timeout

要求以秒為單位的逾時。 適用於服務的每個呼叫。

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az storage blob move

預覽 已被取代

命令群組 『az storage』 處於預覽狀態,且正在開發中。 參考和支援層級: https://aka.ms/CLI_refstatus

此命令已被取代,未來版本將會移除。 請改用 『az storage fs file move』。 如需詳細資訊,請移至 https://github.com/Azure/azure-cli/blob/dev/src/azure-cli/azure/cli/command_modules/storage/docs/ADLS%20Gen2.md

移動記憶體容器中的 Blob。

az storage blob move --container-name
                     --destination-blob
                     --source-blob
                     [--account-key]
                     [--account-name]
                     [--auth-mode {key, login}]
                     [--connection-string]
                     [--lease-id]
                     [--sas-token]
                     [--source-if-match]
                     [--source-if-modified-since]
                     [--source-if-none-match]
                     [--source-if-unmodified-since]
                     [--source-lease-id]
                     [--timeout]

範例

移動記憶體容器中的 Blob。

az storage blob move -c MyContainer -d DestinationBlobPath -s SourceBlobPath --account-name MyStorageAccount

必要參數

--container-name -c

容器名稱。

--destination-blob -d

目的地 Blob 名稱。 它應該是容器下的絕對路徑。 例如『topdir1/dirbar』。

--source-blob -s

來源 Blob 名稱。 它應該是容器下的絕對路徑。 例如『topdir1/dirsubfoo』。

選擇性參數

--account-key

儲存體 帳戶金鑰。 必須與記憶體帳戶名稱搭配使用。 環境變數:AZURE_STORAGE_KEY。

--account-name

儲存體帳戶名稱。 相關的環境變數:AZURE_STORAGE_ACCOUNT。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 如果兩者都不存在,命令會嘗試使用已驗證的 Azure 帳戶來查詢記憶體帳戶密鑰。 如果執行大量記憶體命令,可能會叫用 API 配額。

--auth-mode

執行命令的模式。 「登入」模式將直接使用您的登入認證進行驗證。 如果未提供帳戶的驗證參數,舊版「金鑰」模式將會嘗試查詢帳戶密鑰。 環境變數:AZURE_STORAGE_AUTH_MODE。

接受的值: key, login
--connection-string

儲存體 帳戶 連接字串。 環境變數:AZURE_STORAGE_CONNECTION_STRING。

--lease-id

選擇性。 new_path的租用標識碼。 new_path必須具有作用中的租用,且租用標識碼必須相符。

--sas-token

共用存取簽章 (SAS)。 必須與記憶體帳戶名稱搭配使用。 環境變數:AZURE_STORAGE_SAS_TOKEN。

--source-if-match

選擇性。 ETag 值。 只有在來源的 ETag 符合指定的值時,才指定此標頭來執行重新命名作業。

--source-if-modified-since

選擇性。 日期及時間值。 只有在來源自指定的日期和時間之後修改過時,才指定此標頭來執行重新命名作業。

--source-if-none-match

選擇性。 ETag 值或特殊通配符 (“*”) 值。 只有在來源的 ETag 不符合指定的值時,才指定此標頭來執行重新命名作業。

--source-if-unmodified-since

選擇性。 日期及時間值。 只有在來源自指定的日期和時間之後尚未修改時,才指定此標頭來執行重新命名作業。

--source-lease-id

選擇性。 source_path的租用標識碼。 source_path必須具有作用中的租用,且租用標識碼必須相符。

--timeout

要求以秒為單位的逾時。 適用於服務的每個呼叫。

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az storage blob query

預覽

此命令處於預覽狀態,且正在開發中。 參考和支援層級: https://aka.ms/CLI_refstatus

提供簡單的查詢表達式,讓使用者在 Blob 或 Blob 快照集數據上選取/專案。

az storage blob query --query-expression
                      [--account-key]
                      [--account-name]
                      [--auth-mode {key, login}]
                      [--blob-endpoint]
                      [--blob-url]
                      [--connection-string]
                      [--container-name]
                      [--if-match]
                      [--if-modified-since]
                      [--if-none-match]
                      [--if-unmodified-since]
                      [--in-column-separator]
                      [--in-escape-char]
                      [--in-has-header]
                      [--in-line-separator]
                      [--in-quote-char]
                      [--in-record-separator]
                      [--input-format {csv, json}]
                      [--lease-id]
                      [--name]
                      [--out-column-separator]
                      [--out-escape-char]
                      [--out-has-header]
                      [--out-line-separator]
                      [--out-quote-char]
                      [--out-record-separator]
                      [--output-format {csv, json}]
                      [--result-file]
                      [--sas-token]
                      [--tags-condition]
                      [--timeout]

範例

藉由提供簡單的查詢表達式,讓使用者在 Blob 上選取/專案。

az storage blob query -c mycontainer -n myblob --query-expression "SELECT _2 from BlobStorage"

讓使用者在 Blob 上選取/專案,方法是提供簡單的查詢表達式,並將它儲存在目標檔案中。

az storage blob query -c mycontainer -n myblob --query-expression "SELECT _2 from BlobStorage" --result-file result.csv

必要參數

--query-expression

SQL 中的查詢表達式。 查詢表達式的大小上限為 256KiB。 如需表示式語法的詳細資訊,請參閱 https://docs.microsoft.com/azure/storage/blobs/query-acceleration-sql-reference

選擇性參數

--account-key

儲存體 帳戶金鑰。 必須與記憶體帳戶名稱或服務端點搭配使用。 環境變數:AZURE_STORAGE_KEY。

--account-name

儲存體帳戶名稱。 相關的環境變數:AZURE_STORAGE_ACCOUNT。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 如果兩者都不存在,命令會嘗試使用已驗證的 Azure 帳戶來查詢記憶體帳戶密鑰。 如果執行大量記憶體命令,可能會叫用 API 配額。

--auth-mode

執行命令的模式。 「登入」模式將直接使用您的登入認證進行驗證。 如果未提供帳戶的驗證參數,舊版「金鑰」模式將會嘗試查詢帳戶密鑰。 環境變數:AZURE_STORAGE_AUTH_MODE。

接受的值: key, login
--blob-endpoint

儲存體 資料服務端點。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 您可以使用 找到每個服務主要端點 az storage account show。 環境變數:AZURE_STORAGE_SERVICE_ENDPOINT。

--blob-url

Blob 的完整端點 URL,包括已使用 SAS 令牌和快照集。 這可能是主要端點或次要端點,視目前的 location_mode而定。

--connection-string

儲存體 帳戶 連接字串。 環境變數:AZURE_STORAGE_CONNECTION_STRING。

--container-name -c

容器名稱。

--if-match

ETag 值,或通配符 \。 只有在資源的 ETag 符合指定的值時,才指定此標頭來執行作業。

--if-modified-since

只有在提供UTC 日期時間後修改後才會開始 (Y-m-d'T'H:M'Z')。

--if-none-match

ETag 值或通配符 ()。只有在資源的 ETag 不符合指定的值時,才指定此標頭來執行作業。只有在資源不存在時,才指定通配符 () 來執行作業,如果作業確實存在,則作業會失敗。

--if-unmodified-since

只有在提供UTC 日期時間後未修改時才開始 (Y-m-d'T'H:M'Z')。

--in-column-separator

用來分隔數據行的字串。

預設值: ,
--in-escape-char

做為逸出字元的字串。 預設值為空白。

--in-has-header

Blob 資料是否包含第一行中的標頭。 默認值為 False,表示會傳回包含第一行的數據。 如果設定為 True,則數據會傳回第一行的獨佔。

預設值: False
--in-line-separator

用來分隔記錄的字串。

預設值:
--in-quote-char

用來引述特定欄位的字串。

預設值: "
--in-record-separator

用來分隔記錄的字串。

預設值:
--input-format

目前儲存在 Blob 中的數據串行化類型。 預設值是將 Blob 資料視為以預設方言格式化的 CSV 數據。指定 Blob 格式時,Blob 資料會根據該設定檔重新格式化。 如果您選擇 json,請據以指定 Output Json Text Configuration Arguments ;如果您選擇 csv,請指定 Output Delimited Text Configuration Arguments

接受的值: csv, json
--lease-id

如果 Blob 具有作用中租用,則為必要專案。

--name -n

Blob 名稱。

--out-column-separator

用來分隔數據行的字串。

預設值: ,
--out-escape-char

做為逸出字元的字串。 預設值為空白。

--out-has-header

Blob 資料是否包含第一行中的標頭。 默認值為 False,表示會傳回包含第一行的數據。 如果設定為 True,則數據會傳回第一行的獨佔。

預設值: False
--out-line-separator

用來分隔記錄的字串。

預設值:
--out-quote-char

用來引述特定欄位的字串。

預設值: "
--out-record-separator

用來分隔記錄的字串。

預設值:
--output-format

數據流的輸出串行化類型。 根據預設,數據會在 Blob 中表示時傳回。 藉由提供輸出格式,Blob 資料將會根據該配置檔重新格式化。 如果您選擇 json,請據以指定 Output Json Text Configuration Arguments ;如果您選擇 csv,請指定 Output Delimited Text Configuration Arguments

接受的值: csv, json
--result-file

指定要儲存結果的檔案路徑。

--sas-token

共用存取簽章 (SAS)。 必須與記憶體帳戶名稱或服務端點搭配使用。 環境變數:AZURE_STORAGE_SAS_TOKEN。

--tags-condition

指定 BLOB 標記上的 SQL where 子句,以只在具有相符值的 Blob 上運作。

--timeout

要求以秒為單位的逾時。 適用於服務的每個呼叫。

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az storage blob restore

還原指定 Blob 範圍中的 Blob。

az storage blob restore --account-name
                        --time-to-restore
                        [--blob-range]
                        [--no-wait]
                        [--resource-group]

範例

在兩個指定的 Blob 範圍中還原 Blob。 例如,(container1/blob1、container2/blob2) 和 (container2/blob3..container2/blob4)。

az storage blob restore --account-name mystorageaccount -g MyResourceGroup -t 2020-02-27T03:59:59Z -r container1/blob1 container2/blob2 -r container2/blob3 container2/blob4

從帳戶開始到帳戶結尾,還原指定 Blob 範圍中的 Blob。

az storage blob restore --account-name mystorageaccount -g MyResourceGroup -t 2020-02-27T03:59:59Z -r "" ""

還原指定 Blob 範圍中的 Blob。

time=`date -u -d "30 minutes" '+%Y-%m-%dT%H:%MZ'`
az storage blob restore --account-name mystorageaccount -g MyResourceGroup -t $time -r container0/blob1 container0/blob2

使用 'az storage account show' 還原指定 Blob 範圍內的 Blob,而不需等候並查詢 Blob 還原狀態。

time=`date -u -d "30 minutes" '+%Y-%m-%dT%H:%MZ'`
az storage blob restore --account-name mystorageaccount -g MyResourceGroup -t $time -r container0/blob1 container0/blob2 --no-wait

必要參數

--account-name -n

儲存體帳戶名稱。

--time-to-restore -t

將 Blob 還原至指定的時間,這應該是 UTC 日期時間 (Y-m-d'T'H:M:S'Z')。

選擇性參數

--blob-range -r

要還原的 Blob 範圍。 您必須有兩個值來指定每個 Blob 範圍的start_range和end_range,例如 -r blob1 blob2。 注意:空白表示帳戶起始為開始範圍值,而表示結束範圍的帳戶結束。

--no-wait

請勿等候長時間執行的作業完成。

預設值: False
--resource-group -g

資源群組的名稱。 您可以使用 az configure --defaults group=<name> 來設定預設群組。

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az storage blob rewrite

預覽

此命令處於預覽狀態,且正在開發中。 參考和支援層級: https://aka.ms/CLI_refstatus

建立新的區塊 Blob,其中 Blob 的內容會從指定的 URL 讀取。

現有 Blob 的內容會以新的 Blob 覆寫。

az storage blob rewrite --container-name
                        --name
                        --source-uri
                        [--account-key]
                        [--account-name]
                        [--auth-mode {key, login}]
                        [--blob-endpoint]
                        [--connection-string]
                        [--encryption-scope]
                        [--if-match]
                        [--if-modified-since]
                        [--if-none-match]
                        [--if-unmodified-since]
                        [--lease-id]
                        [--sas-token]
                        [--tags-condition]
                        [--tier {Archive, Cold, Cool, Hot, P10, P15, P20, P30, P4, P40, P50, P6, P60, P70, P80}]
                        [--timeout]

範例

更新現有 Blob 的加密範圍。

az storage blob rewrite --source-uri https://srcaccount.blob.core.windows.net/mycontainer/myblob?<sastoken> --encryption-scope newscope -c mycontainer -n myblob --account-name mystorageaccount --account-key 0000-0000

必要參數

--container-name -c

容器名稱。

--name -n

Blob 名稱。

--source-uri -u

長度最多 2 KB 的 URL,指定檔案或 Blob。 此值應該以 URL 編碼,因為它會出現在要求 URI 中。 如果來源位於另一個帳戶中,來源必須是公用或必須透過共用存取簽章進行驗證。 如果來源是公用的,則不需要驗證。

選擇性參數

--account-key

儲存體 帳戶金鑰。 必須與記憶體帳戶名稱或服務端點搭配使用。 環境變數:AZURE_STORAGE_KEY。

--account-name

儲存體帳戶名稱。 相關的環境變數:AZURE_STORAGE_ACCOUNT。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 如果兩者都不存在,命令會嘗試使用已驗證的 Azure 帳戶來查詢記憶體帳戶密鑰。 如果執行大量記憶體命令,可能會叫用 API 配額。

--auth-mode

執行命令的模式。 「登入」模式將直接使用您的登入認證進行驗證。 如果未提供帳戶的驗證參數,舊版「金鑰」模式將會嘗試查詢帳戶密鑰。 環境變數:AZURE_STORAGE_AUTH_MODE。

接受的值: key, login
--blob-endpoint

儲存體 資料服務端點。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 您可以使用 找到每個服務主要端點 az storage account show。 環境變數:AZURE_STORAGE_SERVICE_ENDPOINT。

--connection-string

儲存體 帳戶 連接字串。 環境變數:AZURE_STORAGE_CONNECTION_STRING。

--encryption-scope

預先定義的加密範圍,用來加密服務上的數據。 您可以使用管理 API 來建立加密範圍,並依名稱在這裡參考。 如果已在容器上定義預設加密範圍,如果容器層級範圍設定為允許覆寫,這個值將會覆寫它。 否則會引發錯誤。

--if-match

ETag 值,或通配符 \。 只有在資源的 ETag 符合指定的值時,才指定此標頭來執行作業。

--if-modified-since

只有在提供UTC 日期時間後修改後才會開始 (Y-m-d'T'H:M'Z')。

--if-none-match

ETag 值或通配符 ()。只有在資源的 ETag 不符合指定的值時,才指定此標頭來執行作業。只有在資源不存在時,才指定通配符 () 來執行作業,如果作業確實存在,則作業會失敗。

--if-unmodified-since

只有在提供UTC 日期時間後未修改時才開始 (Y-m-d'T'H:M'Z')。

--lease-id

如果 Blob 具有作用中租用,則為必要專案。 值可以是 BlobLeaseClient 物件或租用標識碼做為字串。

--sas-token

共用存取簽章 (SAS)。 必須與記憶體帳戶名稱或服務端點搭配使用。 環境變數:AZURE_STORAGE_SAS_TOKEN。

--tags-condition

指定 BLOB 標記上的 SQL where 子句,以只在具有相符值的 Blob 上運作。

--tier

要設定 Blob 的標準 Blob 層值。 針對此版本的連結庫,這隻適用於標準記憶體帳戶上的區塊 Blob。

接受的值: Archive, Cold, Cool, Hot, P10, P15, P20, P30, P4, P40, P50, P6, P60, P70, P80
--timeout

要求以秒為單位的逾時。 適用於服務的每個呼叫。

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

設定 Blob 合法保留。

az storage blob set-legal-hold --container-name
                               --legal-hold {false, true}
                               --name
                               [--account-key]
                               [--account-name]
                               [--auth-mode {key, login}]
                               [--blob-endpoint]
                               [--connection-string]
                               [--sas-token]
                               [--timeout]

設定 Blob 法務保留。

az storage blob set-legal-hold --legal-hold -c mycontainer -n myblob --account-name mystorageaccount --account-key 0000-0000

清除 Blob 合法保留。

az storage blob set-legal-hold --legal-hold false -c mycontainer -n myblob --account-name mystorageaccount --account-key 0000-0000
--container-name -c

容器名稱。

--legal-hold

指定是否應該在 Blob 上設定合法保留。

接受的值: false, true
--name -n

Blob 名稱。

--account-key

儲存體 帳戶金鑰。 必須與記憶體帳戶名稱或服務端點搭配使用。 環境變數:AZURE_STORAGE_KEY。

--account-name

儲存體帳戶名稱。 相關的環境變數:AZURE_STORAGE_ACCOUNT。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 如果兩者都不存在,命令會嘗試使用已驗證的 Azure 帳戶來查詢記憶體帳戶密鑰。 如果執行大量記憶體命令,可能會叫用 API 配額。

--auth-mode

執行命令的模式。 「登入」模式將直接使用您的登入認證進行驗證。 如果未提供帳戶的驗證參數,舊版「金鑰」模式將會嘗試查詢帳戶密鑰。 環境變數:AZURE_STORAGE_AUTH_MODE。

接受的值: key, login
--blob-endpoint

儲存體 資料服務端點。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 您可以使用 找到每個服務主要端點 az storage account show。 環境變數:AZURE_STORAGE_SERVICE_ENDPOINT。

--connection-string

儲存體 帳戶 連接字串。 環境變數:AZURE_STORAGE_CONNECTION_STRING。

--sas-token

共用存取簽章 (SAS)。 必須與記憶體帳戶名稱或服務端點搭配使用。 環境變數:AZURE_STORAGE_SAS_TOKEN。

--timeout

要求以秒為單位的逾時。 適用於服務的每個呼叫。

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az storage blob set-tier

在 Blob 上設定區塊或頁面層。

對於區塊 Blob,此命令僅支援標準記憶體帳戶上的區塊 Blob。 對於分頁 Blob,此命令僅支援進階帳戶上的分頁 Blob。

az storage blob set-tier --tier
                         [--account-key]
                         [--account-name]
                         [--auth-mode {key, login}]
                         [--blob-endpoint]
                         [--blob-url]
                         [--connection-string]
                         [--container-name]
                         [--name]
                         [--rehydrate-priority {High, Standard}]
                         [--sas-token]
                         [--timeout]
                         [--type {block, page}]

範例

在 Blob 上設定區塊或頁面層。 ( 自動產生 )

az storage blob set-tier --account-key 00000000 --account-name MyAccount --container-name mycontainer --name MyBlob --tier P10

必要參數

--tier

要設定 Blob 的階層值。

選擇性參數

--account-key

儲存體 帳戶金鑰。 必須與記憶體帳戶名稱或服務端點搭配使用。 環境變數:AZURE_STORAGE_KEY。

--account-name

儲存體帳戶名稱。 相關的環境變數:AZURE_STORAGE_ACCOUNT。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 如果兩者都不存在,命令會嘗試使用已驗證的 Azure 帳戶來查詢記憶體帳戶密鑰。 如果執行大量記憶體命令,可能會叫用 API 配額。

--auth-mode

執行命令的模式。 「登入」模式將直接使用您的登入認證進行驗證。 如果未提供帳戶的驗證參數,舊版「金鑰」模式將會嘗試查詢帳戶密鑰。 環境變數:AZURE_STORAGE_AUTH_MODE。

接受的值: key, login
--blob-endpoint

儲存體 資料服務端點。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 您可以使用 找到每個服務主要端點 az storage account show。 環境變數:AZURE_STORAGE_SERVICE_ENDPOINT。

--blob-url

Blob 的完整端點 URL,包括已使用 SAS 令牌和快照集。 這可能是主要端點或次要端點,視目前的 location_mode而定。

--connection-string

儲存體 帳戶 連接字串。 環境變數:AZURE_STORAGE_CONNECTION_STRING。

--container-name -c

容器名稱。

--name -n

Blob 名稱。

--rehydrate-priority -r
預覽

指出要解除封存 Blob 凍結的優先順序。 優先順序只能在 Blob 上設定一次,預設值為 Standard。

接受的值: High, Standard
--sas-token

共用存取簽章 (SAS)。 必須與記憶體帳戶名稱或服務端點搭配使用。 環境變數:AZURE_STORAGE_SAS_TOKEN。

--timeout

timeout 參數是以秒為單位來表示。 此方法可能會對 Azure 服務進行多個呼叫,而逾時會個別套用至每個呼叫。

--type -t

Blob 類型。

接受的值: block, page
預設值: block
全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az storage blob set-tier (storage-blob-preview 擴充功能)

在 Blob 上設定區塊或頁面層。

對於區塊 Blob,此命令僅支援標準記憶體帳戶上的區塊 Blob。 對於分頁 Blob,此命令僅支援進階帳戶上的分頁 Blob。

az storage blob set-tier --tier
                         [--account-key]
                         [--account-name]
                         [--auth-mode {key, login}]
                         [--blob-endpoint]
                         [--blob-url]
                         [--connection-string]
                         [--container-name]
                         [--name]
                         [--rehydrate-priority {High, Standard}]
                         [--sas-token]
                         [--tags-condition]
                         [--timeout]
                         [--type {block, page}]
                         [--version-id]

範例

在 Blob 上設定區塊或頁面層。 ( 自動產生 )

az storage blob set-tier --account-key 00000000 --account-name MyAccount --container-name mycontainer --name MyBlob --tier P10

必要參數

--tier

要設定 Blob 的階層值。

選擇性參數

--account-key

儲存體 帳戶金鑰。 必須與記憶體帳戶名稱搭配使用。 環境變數:AZURE_STORAGE_KEY。

--account-name

儲存體帳戶名稱。 相關的環境變數:AZURE_STORAGE_ACCOUNT。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 如果兩者都不存在,命令會嘗試使用已驗證的 Azure 帳戶來查詢記憶體帳戶密鑰。 如果執行大量記憶體命令,可能會叫用 API 配額。

--auth-mode

執行命令的模式。 「登入」模式將直接使用您的登入認證進行驗證。 如果未提供帳戶的驗證參數,舊版「金鑰」模式將會嘗試查詢帳戶密鑰。 環境變數:AZURE_STORAGE_AUTH_MODE。

接受的值: key, login
--blob-endpoint

儲存體 資料服務端點。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 您可以使用 找到每個服務主要端點 az storage account show。 環境變數:AZURE_STORAGE_SERVICE_ENDPOINT。

--blob-url

Blob 的完整端點 URL,包括已使用 SAS 令牌和快照集。 這可能是主要端點或次要端點,視目前的 location_mode而定。

--connection-string

儲存體 帳戶 連接字串。 環境變數:AZURE_STORAGE_CONNECTION_STRING。

--container-name -c

容器名稱。

--name -n

Blob 名稱。

--rehydrate-priority -r
預覽

指出要解除封存 Blob 凍結的優先順序。

接受的值: High, Standard
--sas-token

共用存取簽章 (SAS)。 必須與記憶體帳戶名稱搭配使用。 環境變數:AZURE_STORAGE_SAS_TOKEN。

--tags-condition

指定 BLOB 標記上的 SQL where 子句,以只在具有相符值的 Blob 上運作。

--timeout

timeout 參數是以秒為單位來表示。 此方法可能會對 Azure 服務進行多個呼叫,而逾時會個別套用至每個呼叫。

--type -t

Blob 類型。

接受的值: block, page
預設值: block
--version-id

選擇性的 Blob 版本識別碼。 此參數僅適用於啟用版本設定的帳戶。

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az storage blob show

取得 Blob 的詳細數據。

az storage blob show [--account-key]
                     [--account-name]
                     [--auth-mode {key, login}]
                     [--blob-endpoint]
                     [--blob-url]
                     [--connection-string]
                     [--container-name]
                     [--if-match]
                     [--if-modified-since]
                     [--if-none-match]
                     [--if-unmodified-since]
                     [--lease-id]
                     [--name]
                     [--sas-token]
                     [--snapshot]
                     [--tags-condition]
                     [--timeout]

範例

顯示 Blob 的所有屬性。

az storage blob show -c mycontainer -n MyBlob

取得 Blob 的詳細資料(自動產生)

az storage blob show --account-name mystorageccount --account-key 00000000 --container-name mycontainer --name MyBlob

選擇性參數

--account-key

儲存體 帳戶金鑰。 必須與記憶體帳戶名稱或服務端點搭配使用。 環境變數:AZURE_STORAGE_KEY。

--account-name

儲存體帳戶名稱。 相關的環境變數:AZURE_STORAGE_ACCOUNT。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 如果兩者都不存在,命令會嘗試使用已驗證的 Azure 帳戶來查詢記憶體帳戶密鑰。 如果執行大量記憶體命令,可能會叫用 API 配額。

--auth-mode

執行命令的模式。 「登入」模式將直接使用您的登入認證進行驗證。 如果未提供帳戶的驗證參數,舊版「金鑰」模式將會嘗試查詢帳戶密鑰。 環境變數:AZURE_STORAGE_AUTH_MODE。

接受的值: key, login
--blob-endpoint

儲存體 資料服務端點。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 您可以使用 找到每個服務主要端點 az storage account show。 環境變數:AZURE_STORAGE_SERVICE_ENDPOINT。

--blob-url

Blob 的完整端點 URL,包括已使用 SAS 令牌和快照集。 這可能是主要端點或次要端點,視目前的 location_mode而定。

--connection-string

儲存體 帳戶 連接字串。 環境變數:AZURE_STORAGE_CONNECTION_STRING。

--container-name -c

容器名稱。

--if-match

ETag 值,或通配符 \。 只有在資源的 ETag 符合指定的值時,才指定此標頭來執行作業。

--if-modified-since

只有在提供UTC 日期時間後修改後才會開始 (Y-m-d'T'H:M'Z')。

--if-none-match

ETag 值或通配符 ()。只有在資源的 ETag 不符合指定的值時,才指定此標頭來執行作業。只有在資源不存在時,才指定通配符 () 來執行作業,如果作業確實存在,則作業會失敗。

--if-unmodified-since

只有在提供UTC 日期時間後未修改時才開始 (Y-m-d'T'H:M'Z')。

--lease-id

如果 Blob 具有作用中租用,則為必要專案。

--name -n

Blob 名稱。

--sas-token

共用存取簽章 (SAS)。 必須與記憶體帳戶名稱或服務端點搭配使用。 環境變數:AZURE_STORAGE_SAS_TOKEN。

--snapshot

快照集參數是不透明的 DateTime 值,當存在時,會指定要擷取的 Blob 快照集。

--tags-condition

指定 BLOB 標記上的 SQL where 子句,以只在具有相符值的 Blob 上運作。

--timeout

要求以秒為單位的逾時。 適用於服務的每個呼叫。

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az storage blob show (storage-blob-preview 擴充功能)

取得 Blob 的詳細數據。

az storage blob show [--account-key]
                     [--account-name]
                     [--auth-mode {key, login}]
                     [--blob-endpoint]
                     [--blob-url]
                     [--connection-string]
                     [--container-name]
                     [--if-match]
                     [--if-modified-since]
                     [--if-none-match]
                     [--if-unmodified-since]
                     [--lease-id]
                     [--name]
                     [--sas-token]
                     [--snapshot]
                     [--tags-condition]
                     [--timeout]
                     [--version-id]

範例

顯示 Blob 的所有屬性。

az storage blob show -c mycontainer -n MyBlob

取得 Blob 的詳細資料(自動產生)

az storage blob show --account-name mystorageccount --account-key 00000000 --container-name mycontainer --name MyBlob

選擇性參數

--account-key

儲存體 帳戶金鑰。 必須與記憶體帳戶名稱搭配使用。 環境變數:AZURE_STORAGE_KEY。

--account-name

儲存體帳戶名稱。 相關的環境變數:AZURE_STORAGE_ACCOUNT。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 如果兩者都不存在,命令會嘗試使用已驗證的 Azure 帳戶來查詢記憶體帳戶密鑰。 如果執行大量記憶體命令,可能會叫用 API 配額。

--auth-mode

執行命令的模式。 「登入」模式將直接使用您的登入認證進行驗證。 如果未提供帳戶的驗證參數,舊版「金鑰」模式將會嘗試查詢帳戶密鑰。 環境變數:AZURE_STORAGE_AUTH_MODE。

接受的值: key, login
--blob-endpoint

儲存體 資料服務端點。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 您可以使用 找到每個服務主要端點 az storage account show。 環境變數:AZURE_STORAGE_SERVICE_ENDPOINT。

--blob-url

Blob 的完整端點 URL,包括已使用 SAS 令牌和快照集。 這可能是主要端點或次要端點,視目前的 location_mode而定。

--connection-string

儲存體 帳戶 連接字串。 環境變數:AZURE_STORAGE_CONNECTION_STRING。

--container-name -c

容器名稱。

--if-match

ETag 值,或通配符 \。 只有在資源的 ETag 符合指定的值時,才指定此標頭來執行作業。

--if-modified-since

只有在提供UTC 日期時間後修改後才會開始 (Y-m-d'T'H:M'Z')。

--if-none-match

ETag 值或通配符 ()。只有在資源的 ETag 不符合指定的值時,才指定此標頭來執行作業。只有在資源不存在時,才指定通配符 () 來執行作業,如果作業確實存在,則作業會失敗。

--if-unmodified-since

只有在提供UTC 日期時間後未修改時才開始 (Y-m-d'T'H:M'Z')。

--lease-id

如果 Blob 具有作用中租用,則為必要專案。

--name -n

Blob 名稱。

--sas-token

共用存取簽章 (SAS)。 必須與記憶體帳戶名稱搭配使用。 環境變數:AZURE_STORAGE_SAS_TOKEN。

--snapshot

快照集參數是不透明的 DateTime 值,當存在時,會指定要擷取的 Blob 快照集。

--tags-condition

指定 BLOB 標記上的 SQL where 子句,以只在具有相符值的 Blob 上運作。

--timeout

要求以秒為單位的逾時。 適用於服務的每個呼叫。

--version-id
預覽

選擇性的 Blob 版本識別碼。 此參數僅適用於啟用版本設定的帳戶。

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az storage blob snapshot

建立 Blob 的快照集。

快照集是一個在某個時間點拍攝之 Blob 的只讀版本。 它可以讀取、複製或刪除,但無法修改。 快照集提供在某個時間點備份 Blob 的方法。 Blob 的快照集與建立快照集的基底 Blob 名稱相同,並附加 DateTime 值,以指出快照集拍攝的時間。

az storage blob snapshot [--account-key]
                         [--account-name]
                         [--auth-mode {key, login}]
                         [--blob-endpoint]
                         [--blob-url]
                         [--connection-string]
                         [--container-name]
                         [--if-match]
                         [--if-modified-since]
                         [--if-none-match]
                         [--if-unmodified-since]
                         [--lease-id]
                         [--metadata]
                         [--name]
                         [--sas-token]
                         [--tags-condition]
                         [--timeout]

選擇性參數

--account-key

儲存體 帳戶金鑰。 必須與記憶體帳戶名稱或服務端點搭配使用。 環境變數:AZURE_STORAGE_KEY。

--account-name

儲存體帳戶名稱。 相關的環境變數:AZURE_STORAGE_ACCOUNT。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 如果兩者都不存在,命令會嘗試使用已驗證的 Azure 帳戶來查詢記憶體帳戶密鑰。 如果執行大量記憶體命令,可能會叫用 API 配額。

--auth-mode

執行命令的模式。 「登入」模式將直接使用您的登入認證進行驗證。 如果未提供帳戶的驗證參數,舊版「金鑰」模式將會嘗試查詢帳戶密鑰。 環境變數:AZURE_STORAGE_AUTH_MODE。

接受的值: key, login
--blob-endpoint

儲存體 資料服務端點。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 您可以使用 找到每個服務主要端點 az storage account show。 環境變數:AZURE_STORAGE_SERVICE_ENDPOINT。

--blob-url

Blob 的完整端點 URL,包括已使用 SAS 令牌和快照集。 這可能是主要端點或次要端點,視目前的 location_mode而定。

--connection-string

儲存體 帳戶 連接字串。 環境變數:AZURE_STORAGE_CONNECTION_STRING。

--container-name -c

容器名稱。

--if-match

ETag 值,或通配符 \。 只有在資源的 ETag 符合指定的值時,才指定此標頭來執行作業。

--if-modified-since

只有在提供UTC 日期時間後修改後才會開始 (Y-m-d'T'H:M'Z')。

--if-none-match

ETag 值或通配符 ()。只有在資源的 ETag 不符合指定的值時,才指定此標頭來執行作業。只有在資源不存在時,才指定通配符 () 來執行作業,如果作業確實存在,則作業會失敗。

--if-unmodified-since

只有在提供UTC 日期時間後未修改時才開始 (Y-m-d'T'H:M'Z')。

--lease-id

如果 Blob 具有作用中租用,則為必要專案。

--metadata

空格分隔索引鍵=值組中的元數據。 這會覆寫任何現有的元數據。

--name -n

Blob 名稱。

--sas-token

共用存取簽章 (SAS)。 必須與記憶體帳戶名稱或服務端點搭配使用。 環境變數:AZURE_STORAGE_SAS_TOKEN。

--tags-condition

指定 BLOB 標記上的 SQL where 子句,以只在具有相符值的 Blob 上運作。

--timeout

要求以秒為單位的逾時。 適用於服務的每個呼叫。

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az storage blob sync

預覽

此命令處於預覽狀態,且正在開發中。 參考和支援層級: https://aka.ms/CLI_refstatus

以遞歸方式將 Blob 同步處理至記憶體 Blob 容器。

az storage blob sync --container
                     --source
                     [--account-key]
                     [--account-name]
                     [--connection-string]
                     [--delete-destination {false, prompt, true}]
                     [--destination]
                     [--exclude-path]
                     [--exclude-pattern]
                     [--include-pattern]
                     [--sas-token]
                     [<EXTRA_OPTIONS>]

範例

將單一 Blob 同步至容器。

az storage blob sync -c mycontainer -s "path/to/file" -d NewBlob

將目錄同步至容器。

az storage blob sync -c mycontainer --account-name mystorageccount --account-key 00000000 -s "path/to/directory"

使用 azcopy 選項傳遞將目錄同步至容器(在此案例中,會將上傳 bandwith 限制為 20 MBit/秒)。

az storage blob sync -c mycontainer --account-name mystorageccount --account-key 00000000 -s "path/to/directory" -- --cap-mbps=20

必要參數

--container -c

同步目的地容器。

--source -s

要同步的來源檔案路徑。

選擇性參數

--account-key

儲存體 帳戶金鑰。 必須與記憶體帳戶名稱搭配使用。 環境變數:AZURE_STORAGE_KEY。

--account-name

儲存體帳戶名稱。 相關的環境變數:AZURE_STORAGE_ACCOUNT。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 如果兩者都不存在,命令會嘗試使用已驗證的 Azure 帳戶來查詢記憶體帳戶密鑰。 如果執行大量記憶體命令,可能會叫用 API 配額。

--connection-string

儲存體 帳戶 連接字串。 環境變數:AZURE_STORAGE_CONNECTION_STRING。

--delete-destination

定義是否要從來源不存在的目的地刪除額外的檔案。 可以設定為 true、false 或提示。 如果設定為提示,則會在排程檔案和 Blob 進行刪除之前,先詢問用戶的問題。

接受的值: false, prompt, true
預設值: true
--destination -d

將前面加上 Blob 名稱的目的地路徑。

--exclude-path

排除這些路徑。 此選項不支援通配符 \。 檢查相對路徑前置詞。 例如:myFolder;myFolder/subDirName/file.pdf。

--exclude-pattern

排除名稱符合模式清單的這些檔案。 例如: .jpg;。Pdf;exactName。 此選項支援通配符 \。

--include-pattern

只包含名稱符合模式清單的這些檔案。 例如: .jpg;。Pdf;exactName。 此選項支援通配符 \。

--sas-token

共用存取簽章 (SAS)。 必須與記憶體帳戶名稱搭配使用。 環境變數:AZURE_STORAGE_SAS_TOKEN。

<EXTRA_OPTIONS>
實驗

其他將透過 azcopy 傳遞至 azcopy 的選項。 請在 之後 --放置所有額外的選項。

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az storage blob undelete

還原虛刪除的 Blob 或快照集。

只有在刪除保留原則中所設定的指定天數內使用時,作業才會成功。 嘗試取消刪除未虛刪除的 Blob 或快照集將會成功,而不會進行任何變更。

az storage blob undelete [--account-key]
                         [--account-name]
                         [--auth-mode {key, login}]
                         [--blob-endpoint]
                         [--blob-url]
                         [--connection-string]
                         [--container-name]
                         [--name]
                         [--sas-token]
                         [--timeout]

範例

取消刪除 Blob。

az storage blob undelete -c mycontainer -n MyBlob

使用登入認證取消刪除 Blob。

az storage blob undelete -c mycontainer -n MyBlob --account-name mystorageaccount --auth-mode login

選擇性參數

--account-key

儲存體 帳戶金鑰。 必須與記憶體帳戶名稱或服務端點搭配使用。 環境變數:AZURE_STORAGE_KEY。

--account-name

儲存體帳戶名稱。 相關的環境變數:AZURE_STORAGE_ACCOUNT。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 如果兩者都不存在,命令會嘗試使用已驗證的 Azure 帳戶來查詢記憶體帳戶密鑰。 如果執行大量記憶體命令,可能會叫用 API 配額。

--auth-mode

執行命令的模式。 「登入」模式將直接使用您的登入認證進行驗證。 如果未提供帳戶的驗證參數,舊版「金鑰」模式將會嘗試查詢帳戶密鑰。 環境變數:AZURE_STORAGE_AUTH_MODE。

接受的值: key, login
--blob-endpoint

儲存體 資料服務端點。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 您可以使用 找到每個服務主要端點 az storage account show。 環境變數:AZURE_STORAGE_SERVICE_ENDPOINT。

--blob-url

Blob 的完整端點 URL,包括已使用 SAS 令牌和快照集。 這可能是主要端點或次要端點,視目前的 location_mode而定。

--connection-string

儲存體 帳戶 連接字串。 環境變數:AZURE_STORAGE_CONNECTION_STRING。

--container-name -c

容器名稱。

--name -n

Blob 名稱。

--sas-token

共用存取簽章 (SAS)。 必須與記憶體帳戶名稱或服務端點搭配使用。 環境變數:AZURE_STORAGE_SAS_TOKEN。

--timeout

要求以秒為單位的逾時。 適用於服務的每個呼叫。

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az storage blob update

在 Blob 上設定系統屬性。

如果為content_settings設定一個屬性,則會覆寫所有屬性。

az storage blob update --container-name
                       --name
                       [--account-key]
                       [--account-name]
                       [--auth-mode {key, login}]
                       [--blob-endpoint]
                       [--clear-content-settings {false, true}]
                       [--connection-string]
                       [--content-cache]
                       [--content-disposition]
                       [--content-encoding]
                       [--content-language]
                       [--content-md5]
                       [--content-type]
                       [--if-match]
                       [--if-modified-since]
                       [--if-none-match]
                       [--if-unmodified-since]
                       [--lease-id]
                       [--sas-token]
                       [--tags-condition]
                       [--timeout]

必要參數

--container-name -c

容器名稱。

--name -n

Blob 名稱。

選擇性參數

--account-key

儲存體 帳戶金鑰。 必須與記憶體帳戶名稱或服務端點搭配使用。 環境變數:AZURE_STORAGE_KEY。

--account-name

儲存體帳戶名稱。 相關的環境變數:AZURE_STORAGE_ACCOUNT。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 如果兩者都不存在,命令會嘗試使用已驗證的 Azure 帳戶來查詢記憶體帳戶密鑰。 如果執行大量記憶體命令,可能會叫用 API 配額。

--auth-mode

執行命令的模式。 「登入」模式將直接使用您的登入認證進行驗證。 如果未提供帳戶的驗證參數,舊版「金鑰」模式將會嘗試查詢帳戶密鑰。 環境變數:AZURE_STORAGE_AUTH_MODE。

接受的值: key, login
--blob-endpoint

儲存體 資料服務端點。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 您可以使用 找到每個服務主要端點 az storage account show。 環境變數:AZURE_STORAGE_SERVICE_ENDPOINT。

--clear-content-settings

如果已設定此旗標,則如果已設定下列任何一或多個屬性(--content-cache-control、--content-disposition、--content-encoding、--content-language、--content-md5、--content-type),則所有這些屬性都會一起設定。 如果至少設定下列其中一個屬性時,未提供給定屬性的值,則會清除該屬性。

接受的值: false, true
--connection-string

儲存體 帳戶 連接字串。 環境變數:AZURE_STORAGE_CONNECTION_STRING。

--content-cache --content-cache-control

快取控制字串。

--content-disposition

傳達有關如何處理響應承載的其他資訊,也可用來附加其他元數據。

--content-encoding

內容編碼類型。

--content-language

內容語言。

--content-md5

內容的 MD5 哈希。

--content-type

內容MIME類型。

--if-match

ETag 值,或通配符 \。 只有在資源的 ETag 符合指定的值時,才指定此標頭來執行作業。

--if-modified-since

只有在提供UTC 日期時間後修改後才會開始 (Y-m-d'T'H:M'Z')。

--if-none-match

ETag 值或通配符 ()。只有在資源的 ETag 不符合指定的值時,才指定此標頭來執行作業。只有在資源不存在時,才指定通配符 () 來執行作業,如果作業確實存在,則作業會失敗。

--if-unmodified-since

只有在提供UTC 日期時間後未修改時才開始 (Y-m-d'T'H:M'Z')。

--lease-id

如果 Blob 具有作用中租用,則為必要專案。

--sas-token

共用存取簽章 (SAS)。 必須與記憶體帳戶名稱或服務端點搭配使用。 環境變數:AZURE_STORAGE_SAS_TOKEN。

--tags-condition

指定 BLOB 標記上的 SQL where 子句,以只在具有相符值的 Blob 上運作。

--timeout

要求以秒為單位的逾時。 適用於服務的每個呼叫。

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az storage blob upload

將檔案上傳至記憶體 Blob。

從檔案路徑建立新的 Blob,或使用自動區塊化和進度通知來更新現有 Blob 的內容。

az storage blob upload [--account-key]
                       [--account-name]
                       [--auth-mode {key, login}]
                       [--blob-endpoint]
                       [--blob-url]
                       [--connection-string]
                       [--container-name]
                       [--content-cache]
                       [--content-disposition]
                       [--content-encoding]
                       [--content-language]
                       [--content-md5]
                       [--content-type]
                       [--data]
                       [--encryption-scope]
                       [--file]
                       [--if-match]
                       [--if-modified-since]
                       [--if-none-match]
                       [--if-unmodified-since]
                       [--lease-id]
                       [--length]
                       [--max-connections]
                       [--maxsize-condition]
                       [--metadata]
                       [--name]
                       [--no-progress]
                       [--overwrite {false, true}]
                       [--sas-token]
                       [--socket-timeout]
                       [--tags]
                       [--tags-condition]
                       [--tier]
                       [--timeout]
                       [--type {append, block, page}]
                       [--validate-content]

範例

上傳至 Blob。

az storage blob upload -f /path/to/file -c mycontainer -n MyBlob

上傳至具有 Blob sas URL 的 Blob。

az storage blob upload -f /path/to/file --blob-url https://mystorageaccount.blob.core.windows.net/mycontainer/myblob?sv=2019-02-02&st=2020-12-22T07%3A07%3A29Z&se=2020-12-23T07%3A07%3A29Z&sr=b&sp=racw&sig=redacted

將檔案上傳至記憶體 Blob。 ( 自動產生 )

az storage blob upload --account-name mystorageaccount --account-key 0000-0000 --container-name mycontainer --file /path/to/file --name myblob

將字串上傳至 Blob。

az storage blob upload --data "teststring" -c mycontainer -n myblob --account-name mystorageaccount --account-key 0000-0000

透過管道上傳至 。

echo $data | az storage blob upload --data @- -c mycontainer -n myblob --account-name mystorageaccount --account-key 0000-0000

選擇性參數

--account-key

儲存體 帳戶金鑰。 必須與記憶體帳戶名稱或服務端點搭配使用。 環境變數:AZURE_STORAGE_KEY。

--account-name

儲存體帳戶名稱。 相關的環境變數:AZURE_STORAGE_ACCOUNT。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 如果兩者都不存在,命令會嘗試使用已驗證的 Azure 帳戶來查詢記憶體帳戶密鑰。 如果執行大量記憶體命令,可能會叫用 API 配額。

--auth-mode

執行命令的模式。 「登入」模式將直接使用您的登入認證進行驗證。 如果未提供帳戶的驗證參數,舊版「金鑰」模式將會嘗試查詢帳戶密鑰。 環境變數:AZURE_STORAGE_AUTH_MODE。

接受的值: key, login
--blob-endpoint

儲存體 資料服務端點。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 您可以使用 找到每個服務主要端點 az storage account show。 環境變數:AZURE_STORAGE_SERVICE_ENDPOINT。

--blob-url

Blob 的完整端點 URL,包括已使用 SAS 令牌和快照集。 這可能是主要端點或次要端點,視目前的 location_mode而定。

--connection-string

儲存體 帳戶 連接字串。 環境變數:AZURE_STORAGE_CONNECTION_STRING。

--container-name -c

容器名稱。

--content-cache --content-cache-control

快取控制字串。

--content-disposition

傳達有關如何處理響應承載的其他資訊,也可用來附加其他元數據。

--content-encoding

內容編碼類型。

--content-language

內容語言。

--content-md5

內容的 MD5 哈希。

--content-type

內容MIME類型。

--data
預覽

要上傳的 Blob 數據。

--encryption-scope

預先定義的加密範圍,用來加密服務上的數據。

--file -f

要上傳為 Blob 內容的檔案路徑。

--if-match

ETag 值,或通配符 \。 只有在資源的 ETag 符合指定的值時,才指定此標頭來執行作業。

--if-modified-since

只有在提供UTC 日期時間後修改後才會開始 (Y-m-d'T'H:M'Z')。

--if-none-match

ETag 值或通配符 ()。只有在資源的 ETag 不符合指定的值時,才指定此標頭來執行作業。只有在資源不存在時,才指定通配符 () 來執行作業,如果作業確實存在,則作業會失敗。

--if-unmodified-since

只有在提供UTC 日期時間後未修改時才開始 (Y-m-d'T'H:M'Z')。

--lease-id

如果 Blob 具有作用中租用,則為必要專案。

--length
預覽

要從數據流讀取的位元組數目。 這是選擇性的,但應該提供以獲得最佳效能。 與 --data 合作。

--max-connections

Blob 大小超過 64MB 時要使用的平行連線數目上限。

預設值: 2
--maxsize-condition

附加 Blob 允許的位元組長度上限。

--metadata

空格分隔索引鍵=值組中的元數據。 這會覆寫任何現有的元數據。

--name -n

Blob 名稱。

--no-progress

包含此旗標以停用命令的進度報告。

預設值: False
--overwrite

要上傳的 Blob 是否應該覆寫目前的數據。 如果為 True,Blob 上傳作業將會覆寫現有的數據。 如果設定為 False,則 ResourceExistsError 作業將會失敗。 上述例外狀況是附加 Blob 類型:如果設定為 False 且數據已經存在,則不會引發錯誤,並將數據附加至現有的 Blob。 如果 set overwrite=True,則會刪除現有的附加 Blob,並建立新的 Blob。 預設為 False。

接受的值: false, true
--sas-token

共用存取簽章 (SAS)。 必須與記憶體帳戶名稱或服務端點搭配使用。 環境變數:AZURE_STORAGE_SAS_TOKEN。

--socket-timeout

服務用來調節數據流的套接字逾時(秒)。

--tags

以空格分隔的標記:key[=value] [key[=value] ...]。使用 「清除現有的標記」。

--tags-condition

指定 BLOB 標記上的 SQL where 子句,以只在具有相符值的 Blob 上運作。

--tier

要設定 Blob 的階層值。 對於分頁 Blob,層會與 Blob 的大小和允許的 IOPS 數目相互關聯。 可能的值為 P10、P15、P20、P30、P4、P40、P50、P6、P60、P70、P80,這隻適用於進階記憶體帳戶上的分頁 Blob:針對區塊 Blob,可能的值為 Archive、Cold、Cool 和 Hot。 這隻適用於標準記憶體帳戶上的區塊 Blob。

--timeout

要求以秒為單位的逾時。 適用於服務的每個呼叫。

--type -t

默認為 *.vhd 檔案的 'page',否則為 'block'。

接受的值: append, block, page
--validate-content

指定應該針對 Blob 的每個區塊計算 MD5 哈希,並在區塊到達時由服務驗證。

預設值: False
全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az storage blob upload-batch

將檔案從本機目錄上傳至 Blob 容器。

az storage blob upload-batch --destination
                             --source
                             [--account-key]
                             [--account-name]
                             [--auth-mode {key, login}]
                             [--blob-endpoint]
                             [--connection-string]
                             [--content-cache]
                             [--content-disposition]
                             [--content-encoding]
                             [--content-language]
                             [--content-md5]
                             [--content-type]
                             [--destination-path]
                             [--dryrun]
                             [--if-match]
                             [--if-modified-since]
                             [--if-none-match]
                             [--if-unmodified-since]
                             [--lease-id]
                             [--max-connections]
                             [--maxsize-condition]
                             [--metadata]
                             [--no-progress]
                             [--overwrite {false, true}]
                             [--pattern]
                             [--sas-token]
                             [--tags]
                             [--tags-condition]
                             [--tier]
                             [--timeout]
                             [--type {append, block, page}]
                             [--validate-content]

範例

上傳以 .py 結尾的所有檔案,除非 Blob 存在,而且自指定日期以來已修改過。

az storage blob upload-batch -d mycontainer --account-name mystorageaccount --account-key 00000000 -s <path-to-directory> --pattern "*.py" --if-unmodified-since 2018-08-27T20:51Z

將所有檔案從本機路徑目錄上傳至名為 「mycontainer」 的容器。

az storage blob upload-batch -d mycontainer -s <path-to-directory>

在本機路徑目錄中上傳格式為 『cli-2018-xx-xx.txt』 或 『cli-2019-xx-xx.txt』 的所有檔案。

az storage blob upload-batch -d mycontainer -s <path-to-directory> --pattern "cli-201[89]-??-??.txt"

上傳容器中格式為 『cli-201x-xx-xx.txt』 和 『cli-2019-xx-xx.txt』 cli-2018-xx-xx.txt 以外的所有檔案。

az storage blob upload-batch -d mycontainer -s <path-to-directory> --pattern "cli-201[!89]-??-??.txt"

必要參數

--destination -d

將上傳檔案的 Blob 容器。

目的地可以是容器 URL 或容器名稱。 當目的地是容器 URL 時,記憶體帳戶名稱將會從 URL 剖析。

--source -s

要上傳之檔案所在的目錄。

選擇性參數

--account-key

儲存體 帳戶金鑰。 必須與記憶體帳戶名稱或服務端點搭配使用。 環境變數:AZURE_STORAGE_KEY。

--account-name

儲存體帳戶名稱。 相關的環境變數:AZURE_STORAGE_ACCOUNT。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 如果兩者都不存在,命令會嘗試使用已驗證的 Azure 帳戶來查詢記憶體帳戶密鑰。 如果執行大量記憶體命令,可能會叫用 API 配額。

--auth-mode

執行命令的模式。 「登入」模式將直接使用您的登入認證進行驗證。 如果未提供帳戶的驗證參數,舊版「金鑰」模式將會嘗試查詢帳戶密鑰。 環境變數:AZURE_STORAGE_AUTH_MODE。

接受的值: key, login
--blob-endpoint

儲存體 資料服務端點。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 您可以使用 找到每個服務主要端點 az storage account show。 環境變數:AZURE_STORAGE_SERVICE_ENDPOINT。

--connection-string

儲存體 帳戶 連接字串。 環境變數:AZURE_STORAGE_CONNECTION_STRING。

--content-cache --content-cache-control

快取控制字串。

--content-disposition

傳達有關如何處理響應承載的其他資訊,也可用來附加其他元數據。

--content-encoding

內容編碼類型。

--content-language

內容語言。

--content-md5

內容的 MD5 哈希。

--content-type

內容MIME類型。

--destination-path

將前面加上 Blob 名稱的目的地路徑。

--dryrun

顯示要採取的作業摘要,而不是實際上傳檔案。

預設值: False
--if-match

ETag 值,或通配符 \。 只有在資源的 ETag 符合指定的值時,才指定此標頭來執行作業。

--if-modified-since

只有在提供UTC 日期時間後修改後才會開始 (Y-m-d'T'H:M'Z')。

--if-none-match

ETag 值,或通配符 \。

只有在資源的 ETag 不符合指定的值時,才指定此標頭來執行作業。 指定通配符 \ 只有在資源不存在時,才能執行作業,並在作業存在時失敗。

--if-unmodified-since

只有在提供UTC 日期時間後未修改時才開始 (Y-m-d'T'H:M'Z')。

--lease-id

Blob 的作用中租用標識碼。

--max-connections

Blob 大小超過 64MB 時要使用的平行連線數目上限。

預設值: 2
--maxsize-condition

附加 Blob 允許的位元組長度上限。

--metadata

空格分隔索引鍵=值組中的元數據。 這會覆寫任何現有的元數據。

--no-progress

包含此旗標以停用命令的進度報告。

預設值: False
--overwrite

要上傳的 Blob 是否應該覆寫目前的數據。 如果為 True,Blob 上傳作業將會覆寫現有的數據。 如果設定為 False,則 ResourceExistsError 作業將會失敗。 上述例外狀況是附加 Blob 類型:如果設定為 False 且數據已經存在,則不會引發錯誤,並將數據附加至現有的 Blob。 如果 set overwrite=True,則會刪除現有的附加 Blob,並建立新的 Blob。 預設為 False。

接受的值: false, true
--pattern

用於在來源中擷取檔案或 Blob 的模式。 支援的模式為 '*'、'?'、'[seq]'和 '[!seq]'。 如需詳細資訊,請參閱 https://docs.python.org/3.7/library/fnmatch.html

當您在 --pattern 中使用 '*' 時,它會比對包含目錄分隔符 '/' 的任何字元。

--sas-token

共用存取簽章 (SAS)。 必須與記憶體帳戶名稱或服務端點搭配使用。 環境變數:AZURE_STORAGE_SAS_TOKEN。

--tags

以空格分隔的標記:key[=value] [key[=value] ...]。使用 「清除現有的標記」。

--tags-condition

指定 BLOB 標記上的 SQL where 子句,以只在具有相符值的 Blob 上運作。

--tier

要設定 Blob 的階層值。 對於分頁 Blob,層會與 Blob 的大小和允許的 IOPS 數目相互關聯。 可能的值為 P10、P15、P20、P30、P4、P40、P50、P6、P60、P70、P80,這隻適用於進階記憶體帳戶上的分頁 Blob:針對區塊 Blob,可能的值為 Archive、Cold、Cool 和 Hot。 這隻適用於標準記憶體帳戶上的區塊 Blob。

--timeout

要求以秒為單位的逾時。 適用於服務的每個呼叫。

--type -t

默認為 *.vhd 檔案的 'page',否則為 'block'。 此設定會覆寫每個檔案的 Blob 類型。

接受的值: append, block, page
--validate-content

指定應該針對 Blob 的每個區塊計算 MD5 哈希,並在區塊到達時由服務驗證。

預設值: False
全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az storage blob url

建立 URL 以存取 Blob。

az storage blob url --container-name
                    --name
                    [--account-key]
                    [--account-name]
                    [--auth-mode {key, login}]
                    [--blob-endpoint]
                    [--connection-string]
                    [--protocol {http, https}]
                    [--sas-token]
                    [--snapshot]

範例

建立 URL 以存取 Blob(自動產生)

az storage blob url --connection-string $connectionString --container-name container1 --name blob1

建立 URL 以存取 Blob(自動產生)

az storage blob url --account-name storageacct --account-key 00000000 --container-name container1 --name blob1

必要參數

--container-name -c

容器名稱。

--name -n

Blob 名稱。

選擇性參數

--account-key

儲存體 帳戶金鑰。 必須與記憶體帳戶名稱或服務端點搭配使用。 環境變數:AZURE_STORAGE_KEY。

--account-name

儲存體帳戶名稱。 相關的環境變數:AZURE_STORAGE_ACCOUNT。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 如果兩者都不存在,命令會嘗試使用已驗證的 Azure 帳戶來查詢記憶體帳戶密鑰。 如果執行大量記憶體命令,可能會叫用 API 配額。

--auth-mode

執行命令的模式。 「登入」模式將直接使用您的登入認證進行驗證。 如果未提供帳戶的驗證參數,舊版「金鑰」模式將會嘗試查詢帳戶密鑰。 環境變數:AZURE_STORAGE_AUTH_MODE。

接受的值: key, login
--blob-endpoint

儲存體 資料服務端點。 必須與記憶體帳戶金鑰或 SAS 令牌搭配使用。 您可以使用 找到每個服務主要端點 az storage account show。 環境變數:AZURE_STORAGE_SERVICE_ENDPOINT。

--connection-string

儲存體 帳戶 連接字串。 環境變數:AZURE_STORAGE_CONNECTION_STRING。

--protocol

要使用的通訊協定。

接受的值: http, https
預設值: https
--sas-token

共用存取簽章 (SAS)。 必須與記憶體帳戶名稱或服務端點搭配使用。 環境變數:AZURE_STORAGE_SAS_TOKEN。

--snapshot

可唯一識別快照集的字串值。 這個查詢參數的值表示快照集版本。

全域參數
--debug

增加記錄詳細資訊,以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤,隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。