AzCopy v10 konfigurációs beállításai (Azure Storage)
AzCopy is a command-line utility that you can use to copy blobs or files to or from a storage account. Ez a cikk az AzCopy v10 konfigurálásához használható környezeti változók listáját tartalmazza.
Megjegyzés:
Ha olyan tartalmat keres, amely segít az AzCopy használatának megkezdésében, olvassa el az AzCopy használatának első lépéseit.
AzCopy v10 környezeti változói
Az alábbi táblázat az egyes környezeti változókat ismerteti, és olyan tartalomra mutató hivatkozásokat tartalmaz, amelyek segíthetnek a változó használatában.
| Környezeti változó | Leírás |
|---|---|
| AWS_ACCESS_KEY_ID | Amazon Web Services hozzáférési kulcs. Megadja az Amazon Web Services engedélyezéséhez használandó kulcsot.Adatok másolása az Amazon S3-ból az Azure Storage-ba az AzCopy használatával |
| AWS_Standard kiadásCRET_ACCESS_KEY | Az Amazon Web Services titkos hozzáférési kulcsa titkos kulcsot biztosít az Amazon Web Services szolgáltatással való engedélyezéshez. Adatok másolása az Amazon S3-ból az Azure Storage-ba az AzCopy használatával |
| AZCOPY_ACTIVE_DIRECTORY_ENDPOINT | A használni kívánt Microsoft Entra-végpont. Ez a változó csak az automatikus bejelentkezéshez használatos, a bejelentkezési parancs meghívásakor használja inkább a parancssori jelzőt. |
| AZCOPY_AUTO_LOGIN_TYPE | Állítsa ezt a változót a következőreDEVICE: , MSI, SPNAZCLI, és PSCRED. Ez a változó lehetővé teszi az engedélyezést a azcopy login parancs használata nélkül. Lásd: Blobok hozzáférésének engedélyezése az AzCopyval és a Microsoft Entra-azonosítóval. |
| AZCOPY_BUFFER_GB | Adja meg a rendszermemória maximális mennyiségét, amelyet az AzCopy használ a fájlok letöltése és feltöltése során. Fejezze ki ezt az értéket gigabájtban (GB). Lásd: Memóriahasználat optimalizálása |
| AZCOPY_CACHE_PROXY_LOOKUP | Alapértelmezés szerint a WindowsOn az AzCopy gyorsítótárazza a proxykiszolgáló-kereséseket a gazdagépnév szintjén (az URL-elérési utat nem veszi figyelembe). A gyorsítótár letiltásához állítsa az "igaz" értéken kívül más értékre. |
| AZCOPY_CONCURRENCY_VALUE | Megadja az egyidejű kérések számát. Ezzel a változóval növelheti az átviteli sebességet. Ha a számítógép 5 cpu-nál kevesebbet, akkor ennek a változónak az értéke a következőre 32van állítva: . Egyéb esetben az alapértelmezett érték a CPU-k száma szorozva 16-tal. Ennek a változónak a maximális alapértelmezett értéke, 3000de manuálisan is beállíthatja ezt az értéket magasabbra vagy alacsonyabbra. Lásd: Egyidejűség növelése |
| AZCOPY_CONCURRENT_FILES | Felülbírálja az egyidejűleg folyamatban lévő fájlok (hozzávetőleges) számát úgy, hogy szabályozza, hogy hány fájlt kezdeményezünk egyidejűleg. |
| AZCOPY_CONCURRENT_SCAN | A vizsgálat során használt párhuzamosság (maximális) fokát szabályozza. Csak a párhuzamos enumerátorokra van hatással, amelyek közé tartoznak az Azure Files/Blobok és a helyi fájlrendszerek. |
| AZCOPY_CONTENT_TYPE_MAP | Felülbírálja az operációs rendszer által definiált alapértelmezett MIME-típusleképezéseket. Állítsa ezt a változót egy olyan JSON-fájl elérési útjára, amely bármilyen leképezést meghatároz. Egy példa JSON-fájl tartalma: { "MIMETypeMapping": { ".323": "text/h323", ".aaf": "application/octet-stream", ".aca": "application/octet-stream", ".accdb": "application/msaccess" } } |
| AZCOPY_DEFAULT_Standard kiadásRVICE_API_VERSION | Felülbírálja a szolgáltatás API-verzióját, hogy az AzCopy elférjen az olyan egyéni környezetekben, mint az Azure Stack. |
| AZCOPY_DISABLE_HIERARCHICAL_SCAN | Csak akkor érvényes, ha az Azure Blobs a forrás. Az egyidejű vizsgálat gyorsabb, de a hierarchikus lista api-t használja, ami több IOS-t/költséget eredményezhet. Adja meg az "igaz" értéket a teljesítmény feláldozásához, de költségmegtakarítást. |
| AZCOPY_DISABLE_SYSLOG | Letiltja a naplózást a Syslogban vagy a Windows eseménynaplózójában. Az AzCopy alapértelmezés szerint naplókat küld ezekre a csatornákra. Ezt a változót igaz értékre állíthatja, ha csökkenteni szeretné a zajt a Syslogban vagy a Windows eseménynaplójában. |
| AZCOPY_DOWNLOAD_TO_TEMP_PATH | Úgy konfigurálja az AzCopyt, hogy a tényleges letöltés előtt egy ideiglenes elérési útra töltsön le. Az engedélyezett értékek igaz vagy hamisak |
| AZCOPY_JOB_PLAN_LOCATION | Felülbírálja a feladatterv fájljait (amelyek a folyamatkövetéshez és a folytatáshoz használatosak) a lemez feltöltésének elkerülése érdekében. |
| AZCOPY_LOG_LOCATION | Felülbírálja a naplófájlok tárolási helyét, hogy elkerülje a lemez feltöltését. |
| AZCOPY_MSI_CLIENT_ID | A felhasználó által hozzárendelt felügyelt identitás ügyfélazonosítója. Akkor használja, ha AZCOPY_AUTO_LOGIN_TYPE be van állítva.MSI Lásd: Engedélyezés titkos tár nélkül |
| AZCOPY_MSI_OBJECT_ID | A felhasználó által hozzárendelt felügyelt identitás objektumazonosítója. Akkor használja, ha AZCOPY_AUTO_LOGIN_TYPE be van állítva.MSI Lásd: Engedélyezés titkos tár nélkül |
| AZCOPY_MSI_RESOURCE_STRING | A felhasználó által hozzárendelt felügyelt identitás erőforrás-azonosítója. Lásd: Engedélyezés titkos tár nélkül |
| AZCOPY_PACE_PAGE_BLOBS | A lapblobok átviteli sebességét automatikusan úgy kell módosítani, hogy megfeleljenek a szolgáltatási korlátoknak? Alapértelmezett érték: true (igaz). Állítsa a "false" (hamis) értékre a letiltáshoz |
| AZCOPY_PARALLEL_STAT_FILES | Emiatt az AzCopy megkeresi a fájltulajdonságokat párhuzamos "szálakon" a helyi fájlrendszer vizsgálatakor. A szálak a AZCOPY_CONCURRENT_SCAN által meghatározott készletből származnak. Ha ezt igaz értékre állítja, az javíthatja a vizsgálat teljesítményét Linuxon. Windows rendszeren nem szükséges vagy ajánlott. |
| AZCOPY_REQUEST_TRY_TIMEOUT | Adja meg, hogy az AzCopy hány percig próbálja meg feltölteni az egyes kérések fájljait, mielőtt az AzCopy túllépi az időkorlátot. |
| AZCOPY_SHOW_PERF_STATES | Ha be van állítva, a képernyőn megjelenő kimenet állapot szerint tartalmazza az adattömbök számát |
| AZCOPY_SPA_APPLICATION_ID | A szolgáltatásnév alkalmazásregisztrációjának alkalmazásazonosítója. Akkor használja, ha AZCOPY_AUTO_LOGIN_TYPE be van állítva.SPN Lásd: Engedélyezés titkos tár nélkül |
| AZCOPY_SPA_CERT_PASSWORD | A tanúsítvány jelszava. Akkor használja, ha AZCOPY_AUTO_LOGIN_TYPE be van állítva.SPN Lásd: Engedélyezés titkos tár nélkül |
| AZCOPY_SPA_CERT_PATH | A tanúsítványfájl relatív vagy teljes elérési útja. Akkor használja, ha AZCOPY_AUTO_LOGIN_TYPE be van állítva.SPN Lásd: Engedélyezés titkos tár nélkül |
| AZCOPY_SPA_CLIENT_Standard kiadás CRET | Az ügyfél titkos kódja. Akkor használja, ha AZCOPY_AUTO_LOGIN_TYPE be van állítva.SPN Lásd: Engedélyezés titkos tár nélkül |
| AZCOPY_TENANT_ID | Az OAuth-eszközök interaktív bejelentkezéséhez használandó Microsoft Entra-bérlőazonosító. Ez a változó csak az automatikus bejelentkezéshez használatos, a bejelentkezési parancs meghívásakor használja inkább a parancssori jelzőt. |
| AZCOPY_TUNE_TO_CPU | Állítsa hamisra, hogy az AzCopy ne veszi figyelembe a processzorhasználatot az egyidejűségi szint automatikustuningja során (például a benchmark parancsban). |
| AZCOPY_UStandard kiadásR_AGENT_PREFIX | Adjon hozzá egy előtagot az alapértelmezett AzCopy felhasználói ügynökhöz, amelyet telemetriai célokra használnak. A rendszer automatikusan beszúr egy szóközt. |
| CPK_ENCRYPTION_KEY | A Base64 kódolású AES-256 titkosítási kulcs értéke. Ez a változó az olvasási és írási kérésekhez is szükséges, ha ügyfél által megadott kulcsokkal titkosítja és visszafejti a Blob Storage-műveletek adatait. Az ügyfél által megadott kulcsokat a jelölő beállításával használhatja --cpk-by-value=true . |
| CPK_ENCRYPTION_KEY_SHA256 | A titkosítási kulcs Base64 kódolású SHA256-kódja. Ez a változó az olvasási és írási kérésekhez is szükséges, ha ügyfél által megadott kulcsokkal titkosítja és visszafejti a Blob Storage-műveletek adatait. Az ügyfél által megadott kulcsokat a jelölő beállításával használhatja --cpk-by-value=true . |
| GOOGLE_APPLICATION_CREDENTIALS | A szolgáltatásfiók kulcsfájljának abszolút elérési útja megadja a Google Cloud Storage-nal való engedélyezéshez használható kulcsot. Adatok másolása a Google Cloud Storage-ból az Azure Storage-ba az AzCopy használatával (előzetes verzió) |
| GOOGLE_CLOUD_PROJECT | A Google Cloud Storage szolgáltatásszintű bejárásaihoz szükséges projektazonosító. |
| HTTPS_PROXY | Proxybeállításokat konfigurál az AzCopyhoz. Állítsa be ezt a változót a proxy IP-címére és a proxyport számára. For example, xx.xxx.xx.xxx:xx. If you run AzCopy on Windows, AzCopy automatically detects proxy settings, so you don't have to use this setting in Windows. If you choose to use this setting in Windows, it will override automatic detection. Lásd: Proxybeállítások konfigurálása |
Proxybeállítások konfigurálása
Az AzCopy proxybeállításainak konfigurálásához állítsa be a környezeti változót HTTPS_PROXY . If you run AzCopy on Windows, AzCopy automatically detects proxy settings, so you don't have to use this setting in Windows. If you choose to use this setting in Windows, it will override automatic detection.
| Operating system | Command |
|---|---|
| Windows | Parancssorban használja a következőt: set HTTPS_PROXY=<proxy IP>:<proxy port>A PowerShellben használja a következőt: $env:HTTPS_PROXY="<proxy IP>:<proxy port>" |
| Linux | export HTTPS_PROXY=<proxy IP>:<proxy port> |
| macOS | export HTTPS_PROXY=<proxy IP>:<proxy port> |
Az AzCopy jelenleg nem támogatja az NTLM- vagy Kerberos-hitelesítést igénylő proxykat.
Proxy megkerülése
Ha Windows rendszeren futtatja az AzCopyt, és azt szeretné, hogy ne használjon proxyt (a beállítások automatikus észlelése helyett) használja ezeket a parancsokat. Ezekkel a beállításokkal az AzCopy nem keres és nem próbál meg proxyt használni.
| Operating system | Environment | Parancsok |
|---|---|---|
| Windows | Parancssor (CMD) | set HTTPS_PROXY=dummy.invalid set NO_PROXY=* |
| Windows | PowerShell | $env:HTTPS_PROXY="dummy.invalid" $env:NO_PROXY="*" |
Más operációs rendszereken egyszerűen hagyja meg a HTTPS_PROXY változót, ha nem szeretne proxyt használni.