Nastavení konfigurace AzCopy v10 (Azure Storage)
AzCopy je nástroj příkazového řádku, pomocí kterého můžete kopírovat objekty blob nebo soubory do nebo z účtu úložiště. Tento článek obsahuje seznam proměnných prostředí, které můžete použít ke konfiguraci AzCopy v10.
Poznámka:
Pokud hledáte obsah, který vám pomůže začít s nástrojem AzCopy, přečtěte si téma Začínáme s nástrojem AzCopy.
Proměnné prostředí AzCopy v10
Následující tabulka popisuje každou proměnnou prostředí a obsahuje odkazy na obsah, který vám může pomoct s použitím proměnné.
| Proměnná prostředí | Popis |
|---|---|
| AWS_ACCESS_KEY_ID | Přístupový klíč Amazon Web Services. Poskytuje klíč pro autorizaci s Amazon Web Services.Kopírování dat z AmazonU S3 do Azure Storage pomocí AzCopy |
| AWS_SECRET_ACCESS_KEY | Tajný přístupový klíč služby Amazon Web Services Poskytuje tajný klíč pro autorizaci s Amazon Web Services. Kopírování dat z AmazonU S3 do Azure Storage pomocí AzCopy |
| AZCOPY_ACTIVE_DIRECTORY_ENDPOINT | Koncový bod Microsoft Entra, který se má použít. Tato proměnná se používá pouze pro automatické přihlášení. Při vyvolání příkazu login použijte příznak příkazového řádku. |
| AZCOPY_AUTO_LOGIN_TYPE | Nastavte tuto proměnnou na DEVICE, , MSISPN, AZCLIa PSCRED. Tato proměnná poskytuje možnost autorizovat bez použití azcopy login příkazu. Viz Autorizace přístupu k objektům blob pomocí nástroje AzCopy a ID Microsoft Entra. |
| AZCOPY_BUFFER_GB | Zadejte maximální velikost systémové paměti, kterou má AzCopy použít při stahování a nahrávání souborů. Tuto hodnotu vyjádřete v gigabajtech (GB). Viz Optimalizace využití paměti |
| AZCOPY_CACHE_PROXY_LOOKUP | Ve výchozím nastavení AzCopy ve Windows uloží vyhledávání proxy serveru do mezipaměti na úrovni názvu hostitele (nebere v úvahu cestu URL). Pokud chcete mezipaměť zakázat, nastavte na jinou hodnotu než true. |
| AZCOPY_CONCURRENCY_VALUE | Určuje počet souběžných požadavků, ke kterým může dojít. Tuto proměnnou můžete použít ke zvýšení propustnosti. Pokud má váš počítač méně než 5 procesorů, je hodnota této proměnné nastavena na 32hodnotu . Jinak se výchozí hodnota rovná 16násobku počtu CPU. Maximální výchozí hodnota této proměnné je 3000, ale tuto hodnotu můžete nastavit ručně vyšší nebo nižší. Viz Zvýšení souběžnosti |
| AZCOPY_CONCURRENT_FILES | Přepíše (přibližný) počet probíhajících souborů najednou tím, že určuje, kolik souborů současně zahájíme přenosy. |
| AZCOPY_CONCURRENT_SCAN | Řídí (maximální) stupeň paralelismu použitý během skenování. Ovlivňuje pouze paralelizované enumerátory, které zahrnují soubory Azure nebo objekty blob a místní systémy souborů. |
| AZCOPY_CONTENT_TYPE_MAP | Přepíše jedno nebo více výchozích mapování typů MIME definovaných vaším operačním systémem. Nastavte tuto proměnnou na cestu k souboru JSON, který definuje jakékoli mapování. Tady je obsah ukázkového souboru JSON: { "MIMETypeMapping": { ".323": "text/h323", ".aaf": "application/octet-stream", ".aca": "application/octet-stream", ".accdb": "application/msaccess" } } |
| AZCOPY_DEFAULT_SERVICE_API_VERSION | Přepíše verzi rozhraní API služby tak, aby Nástroj AzCopy mohl pojmout vlastní prostředí, jako je Azure Stack. |
| AZCOPY_DISABLE_HIERARCHICAL_SCAN | Platí jenom v případech, kdy jsou objekty blob Azure zdrojem. Souběžná kontrola je rychlejší, ale využívá hierarchické rozhraní API pro výpis, což může vést k většímu počtu IO/nákladů. Zadejte true pro obětování výkonu, ale ušetřete na nákladech. |
| AZCOPY_DISABLE_SYSLOG | Zakáže protokolování v syslogu nebo v nástroji Windows Event Logger. Ve výchozím nastavení AzCopy odesílá protokoly do těchto kanálů. Tuto proměnnou můžete nastavit na true, pokud chcete snížit šum v syslogu nebo v protokolu událostí systému Windows. |
| AZCOPY_DOWNLOAD_TO_TEMP_PATH | Nakonfiguruje Nástroj AzCopy ke stažení do dočasné cesty před skutečným stažením. Povolené hodnoty jsou true nebo false |
| AZCOPY_JOB_PLAN_LOCATION | Přepisuje, kde se ukládají soubory plánu úloh (používané ke sledování průběhu a obnovení), aby se zabránilo zaplnění disku. |
| AZCOPY_LOG_LOCATION | Přepíše místo uložení souborů protokolu, aby se zabránilo vyplnění disku. |
| AZCOPY_MSI_CLIENT_ID | ID klienta spravované identity přiřazené uživatelem. Používá se, pokud AZCOPY_AUTO_LOGIN_TYPE je nastavena hodnota MSI. Zobrazení autorizace bez úložiště tajných kódů |
| AZCOPY_MSI_OBJECT_ID | ID objektu spravované identity přiřazené uživatelem. Používá se, pokud AZCOPY_AUTO_LOGIN_TYPE je nastavena hodnota MSI. Zobrazení autorizace bez úložiště tajných kódů |
| AZCOPY_MSI_RESOURCE_STRING | ID prostředku spravované identity přiřazené uživatelem. Zobrazení autorizace bez úložiště tajných kódů |
| AZCOPY_PACE_PAGE_BLOBS | Měla by se propustnost pro objekty blob stránky automaticky upravit tak, aby odpovídala limitům služby? Výchozí hodnota je true. Nastavení na false pro zakázání |
| AZCOPY_PARALLEL_STAT_FILES | Způsobí, že AzCopy při kontrole místního systému souborů vyhledá vlastnosti souboru v paralelních vláknech. Vlákna jsou nakreslena z fondu definovaného AZCOPY_CONCURRENT_SCAN. Nastavení na hodnotu True může zlepšit výkon skenování v Linuxu. Ve Windows není potřeba ani nedoporučujeme. |
| AZCOPY_REQUEST_TRY_TIMEOUT | Nastavte počet minut, po které by se nástroj AzCopy měl pokusit nahrát soubory pro každý požadavek, než vyprší časový limit nástroje AzCopy. |
| AZCOPY_SHOW_PERF_STATES | Pokud nastavíte hodnotu na cokoli, výstup na obrazovce bude obsahovat počty bloků dat podle stavu. |
| AZCOPY_SPA_APPLICATION_ID | ID aplikace instančního objektu registrace aplikace Používá se, pokud AZCOPY_AUTO_LOGIN_TYPE je nastavena hodnota SPN. Zobrazení autorizace bez úložiště tajných kódů |
| AZCOPY_SPA_CERT_PASSWORD | Heslo certifikátu. Používá se, pokud AZCOPY_AUTO_LOGIN_TYPE je nastavena hodnota SPN. Zobrazení autorizace bez úložiště tajných kódů |
| AZCOPY_SPA_CERT_PATH | Relativní nebo plně kvalifikovaná cesta k souboru certifikátu. Používá se, pokud AZCOPY_AUTO_LOGIN_TYPE je nastavena hodnota SPN. Zobrazení autorizace bez úložiště tajných kódů |
| AZCOPY_SPA_CLIENT_SECRET | Tajný klíč klienta. Používá se, pokud AZCOPY_AUTO_LOGIN_TYPE je nastavena hodnota SPN. Zobrazení autorizace bez úložiště tajných kódů |
| AZCOPY_TENANT_ID | ID tenanta Microsoft Entra, které se má použít pro interaktivní přihlášení zařízení OAuth. Tato proměnná se používá pouze pro automatické přihlášení. Při vyvolání příkazu login použijte příznak příkazového řádku. |
| AZCOPY_TUNE_TO_CPU | Nastavte hodnotu false, aby nástroj AzCopy při automatickém ladění úrovně souběžnosti nezohledňoval využití procesoru (například v příkazu srovnávacího testu). |
| AZCOPY_USER_AGENT_PREFIX | Přidejte předponu k výchozímu uživatelskému agentu AzCopy, který se používá pro účely telemetrie. Automaticky se vloží mezera. |
| CPK_ENCRYPTION_KEY | Hodnota šifrovacího klíče AES-256 s kódováním Base64. Tato proměnná se vyžaduje pro požadavky na čtení i zápis při použití klíčů zadaných zákazníkem k šifrování a dešifrování dat v operacích úložiště objektů blob. Klíče poskytnuté zákazníkem můžete použít nastavením příznaku --cpk-by-value=true . |
| CPK_ENCRYPTION_KEY_SHA256 | Sha256 šifrovacího klíče s kódováním Base64. Tato proměnná se vyžaduje pro požadavky na čtení i zápis při použití klíčů zadaných zákazníkem k šifrování a dešifrování dat v operacích úložiště objektů blob. Klíče poskytnuté zákazníkem můžete použít nastavením příznaku --cpk-by-value=true . |
| GOOGLE_APPLICATION_CREDENTIALS | Absolutní cesta k souboru klíče účtu služby Poskytuje klíč pro autorizaci s Google Cloud Storage. Kopírování dat z Google Cloud Storage do Azure Storage pomocí AzCopy (Preview) |
| GOOGLE_CLOUD_PROJECT | ID projektu vyžadované pro procházení na úrovni služeb v Úložišti Google Cloud. |
| HTTPS_PROXY | Nakonfiguruje nastavení proxy serveru pro AzCopy. Nastavte tuto proměnnou na IP adresu proxy serveru a číslo portu proxy serveru. Například xx.xxx.xx.xxx:xx. Pokud používáte AzCopy ve Windows, AzCopy automaticky detekuje nastavení proxy serveru, takže ve Windows toto nastavení používat nemusíte. Pokud se rozhodnete toto nastavení použít ve Windows, přepíše se tím automatická detekce. Viz Konfigurace nastavení proxy serveru |
Konfigurace nastavení proxy serveru
Pokud chcete nakonfigurovat nastavení proxy serveru pro AzCopy, nastavte proměnnou HTTPS_PROXY prostředí. Pokud používáte AzCopy ve Windows, AzCopy automaticky detekuje nastavení proxy serveru, takže ve Windows toto nastavení používat nemusíte. Pokud se rozhodnete toto nastavení použít ve Windows, přepíše se tím automatická detekce.
| Operační systém | Příkaz |
|---|---|
| Windows | V příkazovém řádku použijte: set HTTPS_PROXY=<proxy IP>:<proxy port>V PowerShellu použijte: $env:HTTPS_PROXY="<proxy IP>:<proxy port>" |
| Linux | export HTTPS_PROXY=<proxy IP>:<proxy port> |
| macOS | export HTTPS_PROXY=<proxy IP>:<proxy port> |
AzCopy v současné době nepodporuje proxy servery, které vyžadují ověřování pomocí protokolu NTLM nebo Kerberos.
Obejití proxy serveru
Pokud používáte AzCopy ve Windows a chcete mu říct, aby nepoužít vůbec žádný proxy server (místo automatického zjišťování nastavení), použijte tyto příkazy. V těchto nastaveních AzCopy nebude vyhledávat ani se pokoušet použít žádný proxy server.
| Operační systém | Environment | Příkazy |
|---|---|---|
| Windows | Příkazový řádek (CMD) | set HTTPS_PROXY=dummy.invalid set NO_PROXY=* |
| Windows | PowerShell | $env:HTTPS_PROXY="dummy.invalid" $env:NO_PROXY="*" |
V jiných operačních systémech jednoduše nechejte proměnnou HTTPS_PROXY nenasazenou, pokud chcete použít žádný proxy server.