AzCopy v10 組態設定 (Azure 儲存體)
AzCopy 是命令列公用程式,可讓您在儲存體帳戶之間複製 Blob 或檔案。 本文包含可用來設定 AzCopy v10 的環境變數清單。
注意
如果您要尋找內容以協助您開始使用 AzCopy,請參閱 開始使用 AzCopy。
AzCopy v10 環境變數
下表描述每個環境變數,並提供可協助您使用變數的內容連結。
環境變數 | 描述 |
---|---|
AWS_ACCESS_KEY_ID | Amazon Web Services 存取金鑰。 提供密鑰以授權 Amazon Web Services。使用 AzCopy 將資料從 Amazon S3 複製到 Azure 儲存體 |
AWS_SECRET_ACCESS_KEY | Amazon Web Services 秘密存取密鑰 提供秘密密鑰,以授權 Amazon Web Services。 使用 AzCopy 將資料從 Amazon S3 複製到 Azure 儲存體 |
AZCOPY_ACTIVE_DIRECTORY_ENDPOINT | 要使用的 Microsoft Entra 端點。 此變數僅用於自動登入,請在叫用登入命令時改用命令行旗標。 |
AZCOPY_AUTO_LOGIN_TYPE | 將這個變數設定為DEVICE 、、SPN MSI 、 AZCLI 和 PSCRED 。 此變數可讓您在不使用 命令的情況下 azcopy login 授權。 請參閱 使用 AzCopy 和 Microsoft Entra ID 授權 Blob 的存取權。 |
AZCOPY_BUFFER_GB | 指定下載和上傳檔案時,您希望 AzCopy 使用的系統記憶體數量上限。 以 GB 表示此值。 請參閱 優化記憶體使用量 |
AZCOPY_CACHE_PROXY_LOOKUP | 根據預設,Windows 上的 AzCopy 會在主機名層級快取 Proxy 伺服器查閱(不考慮 URL 路徑)。 設定為 'true' 以外的任何其他值,以停用快取。 |
AZCOPY_CONCURRENCY_VALUE | 指定可能發生的並行要求數目。 您可以使用此變數來增加輸送量。 如果您的電腦少於 5 個 CPU,則此變數的值會設定為 32 。 否則,預設值會等於 16 乘以 CPU 數目。 此變數的預設值上限為 3000 ,但您可以手動設定此值的較高或更低。 請參閱 增加並行存取 |
AZCOPY_CONCURRENT_FILES | 藉由控制我們同時起始傳輸的檔案數目,覆寫任何一次進行中的檔案數目(近似值)。 |
AZCOPY_CONCURRENT_SCAN | 控制掃描期間所使用平行處理原則的 (max) 程度。 只會影響平行化列舉值,其中包括 Azure 檔案儲存體/Blob 和本機文件系統。 |
AZCOPY_CONTENT_TYPE_MAP | 覆寫作業系統所定義的一或多個預設MIME類型對應。 將此變數設定為定義任何對應的 JSON 檔案路徑。 以下是範例 JSON 檔案的內容: { “MIMETypeMapping”: { “.323”: “text/h323”, “.aaf”: “application/octet-stream”, “.aca”: “application/octet-stream”, “.accdb”: “application/msaccess” } } |
AZCOPY_DEFAULT_SERVICE_API_VERSION | 覆寫服務 API 版本,讓 AzCopy 可以容納 Azure Stack 等自定義環境。 |
AZCOPY_DISABLE_HIERARCHICAL_SCAN | 僅適用於 Azure Blob 是來源時。 並行掃描速度較快,但採用階層式清單 API,這可能會導致更多 IO/成本。 指定 'true' 以犧牲效能,但節省成本。 |
AZCOPY_DISABLE_SYSLOG | 停用 Syslog 或 Windows 事件記錄器中的記錄。 根據預設,AzCopy 會將記錄傳送至這些通道。 如果您想要減少 Syslog 或 Windows 事件記錄檔中的雜訊,您可以將此變數設定為 true。 |
AZCOPY_DOWNLOAD_TO_TEMP_PATH | 將 AzCopy 設定為在實際下載之前下載至暫存路徑。 允許的值為 true 或 false |
AZCOPY_JOB_PLAN_LOCATION | 覆寫作業計畫檔案的儲存位置(用於進度追蹤和繼續),以避免填滿磁碟。 |
AZCOPY_LOG_LOCATION | 覆寫儲存記錄檔的位置,以避免填滿磁碟。 |
AZCOPY_MSI_CLIENT_ID | 使用者指派受控識別的用戶端標識碼。 當設定為MSI 時AZCOPY_AUTO_LOGIN_TYPE ,請使用 。 請參閱 不使用秘密存放區授權 |
AZCOPY_MSI_OBJECT_ID | 使用者指派受控識別的物件標識碼。 當設定為MSI 時AZCOPY_AUTO_LOGIN_TYPE ,請使用 。 請參閱 不使用秘密存放區授權 |
AZCOPY_MSI_RESOURCE_STRING | 使用者指派受控識別的資源標識碼。 請參閱 不使用秘密存放區授權 |
AZCOPY_PACE_PAGE_BLOBS | 分頁 Blob 的輸送量是否應該自動調整以符合服務限制? 預設為 true。 設定為 『false』 以停用 |
AZCOPY_PARALLEL_STAT_FILES | 當掃描本機文件系統時,會導致 AzCopy 在平行 『threads』 上查閱檔案屬性。 線程會從AZCOPY_CONCURRENT_SCAN所定義的集區中繪製。 將此設定為 true 可能會改善 Linux 上的掃描效能。 Windows 上不需要或建議使用。 |
AZCOPY_REQUEST_TRY_TIMEOUT | 設定 AzCopy 在 AzCopy 逾時之前,應該嘗試上傳每個要求的檔案的分鐘數。 |
AZCOPY_SHOW_PERF_STATES | 如果設定為任何專案,螢幕上的輸出將會依狀態包含區塊計數 |
AZCOPY_SPA_APPLICATION_ID | 服務主體應用程式註冊的應用程式識別碼。 當 設定為 SPN 時 AZCOPY_AUTO_LOGIN_TYPE ,請使用 。 請參閱 不使用秘密存放區授權 |
AZCOPY_SPA_CERT_PASSWORD | 憑證的密碼。 當 設定為 SPN 時 AZCOPY_AUTO_LOGIN_TYPE ,請使用 。 請參閱 不使用秘密存放區授權 |
AZCOPY_SPA_CERT_PATH | 憑證檔案的相對或完整路徑。 當 設定為 SPN 時 AZCOPY_AUTO_LOGIN_TYPE ,請使用 。 請參閱 不使用秘密存放區授權 |
AZCOPY_SPA_CLIENT_SECRET | 客戶端密碼。 當設定為SPN 時AZCOPY_AUTO_LOGIN_TYPE ,請使用 。 請參閱 不使用秘密存放區授權 |
AZCOPY_TENANT_ID | 要用於 OAuth 裝置互動式登入的 Microsoft Entra 租使用者識別碼。 此變數僅用於自動登入,請在叫用登入命令時改用命令行旗標。 |
AZCOPY_TUNE_TO_CPU | 設定為 false 以防止 AzCopy 在自動調整其並行層級時考慮 CPU 使用量(例如,在基準檢驗命令中)。 |
AZCOPY_USER_AGENT_PREFIX | 將前置詞新增至預設 AzCopy User Agent,以用於遙測用途。 會自動插入空格。 |
CPK_ENCRYPTION_KEY | Base64 編碼的 AES-256 加密金鑰值。 使用客戶提供的金鑰來加密和解密 Blob 記憶體作業上的數據時,讀取和寫入要求都需要此變數。 您可以藉由設定 --cpk-by-value=true 旗標來使用客戶提供的金鑰。 |
CPK_ENCRYPTION_KEY_SHA256 | 加密金鑰的Base64編碼SHA256。 使用客戶提供的金鑰來加密和解密 Blob 記憶體作業上的數據時,讀取和寫入要求都需要此變數。 您可以藉由設定 --cpk-by-value=true 旗標來使用客戶提供的金鑰。 |
GOOGLE_APPLICATION_CREDENTIALS | 服務帳戶金鑰檔案的絕對路徑 提供金鑰以授權 Google Cloud 儲存體。 使用 AzCopy 將資料從 Google Cloud 儲存體 複製到 Azure 儲存體 (預覽) |
GOOGLE_CLOUD_PROJECT | Google Cloud 儲存體 中服務等級周遊所需的專案標識碼。 |
HTTPS_PROXY | 設定 AzCopy 的 Proxy 設定。 將此變數設定為 Proxy IP 位址和 Proxy 埠號碼。 例如: xx.xxx.xx.xxx:xx 。 如果您在 Windows 上執行 AzCopy,AzCopy 會自動偵測 Proxy 設定,因此您不需要在 Windows 中使用此設定。 如果您選擇在 Windows 中使用此設定,其將會覆寫自動偵測。 請參閱 設定 Proxy 設定 |
設定 Proxy 設定
若要設定 AzCopy 的 Proxy 設定,請設定 HTTPS_PROXY
環境變數。 如果您在 Windows 上執行 AzCopy,AzCopy 會自動偵測 Proxy 設定,因此您不需要在 Windows 中使用此設定。 如果您選擇在 Windows 中使用此設定,其將會覆寫自動偵測。
作業系統 | Command |
---|---|
Windows | 在命令提示字元中,請使用:set HTTPS_PROXY=<proxy IP>:<proxy port> 在 PowerShell 中使用: $env:HTTPS_PROXY="<proxy IP>:<proxy port>" |
Linux | export HTTPS_PROXY=<proxy IP>:<proxy port> |
macOS | export HTTPS_PROXY=<proxy IP>:<proxy port> |
目前,AzCopy 不支援使用 NTLM 或 Kerberos 進行驗證的 Proxy。
略過 Proxy
如果您在 Windows 上執行 AzCopy,而且想要告訴它 完全不使用 Proxy(而不是自動偵測設定),請使用這些命令。 使用這些設定,AzCopy 將不會查閱或嘗試使用任何 Proxy。
作業系統 | Environment | 命令 |
---|---|---|
Windows | 命令提示字元 (CMD) | set HTTPS_PROXY=dummy.invalid set NO_PROXY=* |
Windows | PowerShell | $env:HTTPS_PROXY="dummy.invalid" $env:NO_PROXY="*" |
在其他操作系統上,如果您想要不使用 Proxy,只要將HTTPS_PROXY變數保持未設定。