Konfigurationsinställningar för AzCopy v10 (Azure Storage)
AzCopy är ett kommandoradsverktyg som du kan använda för att kopiera blobar eller filer till eller från ett lagringskonto. Den här artikeln innehåller en lista över miljövariabler som du kan använda för att konfigurera AzCopy v10.
Kommentar
Om du letar efter innehåll som hjälper dig att komma igång med AzCopy kan du läsa Komma igång med AzCopy.
AzCopy v10-miljövariabler
I följande tabell beskrivs varje miljövariabel och länkar till innehåll som kan hjälpa dig att använda variabeln.
| Miljövariabel | beskrivning |
|---|---|
| AWS_ACCESS_KEY_ID | Åtkomstnyckel för Amazon Web Services. Tillhandahåller en nyckel för auktorisering med Amazon Web Services.Kopiera data från Amazon S3 till Azure Storage med hjälp av AzCopy |
| AWS_SECRET_ACCESS_KEY | Amazon Web Services hemlig åtkomstnyckel Ger en hemlig nyckel för att auktorisera med Amazon Web Services. Kopiera data från Amazon S3 till Azure Storage med hjälp av AzCopy |
| AZCOPY_ACTIVE_DIRECTORY_ENDPOINT | Den Microsoft Entra-slutpunkt som ska användas. Den här variabeln används endast för automatisk inloggning. Använd kommandoradsflaggan i stället när du anropar inloggningskommandot. |
| AZCOPY_AUTO_LOGIN_TYPE | Ange variabeln till DEVICE, MSI, SPN, AZCLIoch PSCRED. Den här variabeln ger möjlighet att auktorisera utan att azcopy login använda kommandot . Se Auktorisera åtkomst till blobar med AzCopy och Microsoft Entra-ID. |
| AZCOPY_BUFFER_GB | Ange den maximala mängd systemminne som du vill att AzCopy ska använda när du laddar ned och laddar upp filer. Uttrycka det här värdet i gigabyte (GB). Se Optimera minnesanvändning |
| AZCOPY_CACHE_PROXY_LOOKUP | Som standard cachelagrar AzCopy på Windows proxyserversökningar på värdnamnsnivå (utan att ta hänsyn till URL-sökvägen). Ange till ett annat värde än "true" för att inaktivera cacheminnet. |
| AZCOPY_CONCURRENCY_VALUE | Anger antalet samtidiga begäranden som kan inträffa. Du kan använda den här variabeln för att öka dataflödet. Om datorn har färre än 5 processorer är värdet för den här variabeln inställt på 32. Annars är standardvärdet lika med 16 multiplicerat med antalet processorer. Det maximala standardvärdet för den här variabeln är 3000, men du kan ange det här värdet högre eller lägre manuellt. Se Öka samtidighet |
| AZCOPY_CONCURRENT_FILES | Åsidosätter det (ungefärliga) antalet filer som pågår samtidigt genom att styra hur många filer vi initierar överföringar samtidigt för. |
| AZCOPY_CONCURRENT_SCAN | Styr den (maximala) grad av parallellitet som används under genomsökningen. Påverkar endast parallelliserade uppräknare, som inkluderar Azure Files/Blobs och lokala filsystem. |
| AZCOPY_CONTENT_TYPE_MAP | Åsidosätter en eller flera standardmappningar av MIME-typ som definierats av operativsystemet. Ange den här variabeln till sökvägen till en JSON-fil som definierar en mappning. Här är innehållet i en JSON-exempelfil: { "MIMETypeMapping": { ".323": "text/h323", ".aaf": "application/octet-stream", ".aca": "application/octet-stream", ".accdb": "application/msaccess" } } |
| AZCOPY_DEFAULT_SERVICE_API_VERSION | Åsidosätter tjänstens API-version så att AzCopy kan hantera anpassade miljöer som Azure Stack. |
| AZCOPY_DISABLE_HIERARCHICAL_SCAN | Gäller endast när Azure Blobs är källan. Samtidig genomsökning går snabbare men använder det hierarkiska listnings-API:et, vilket kan resultera i fler IO:er/kostnader. Ange "sant" för att offra prestanda men spara på kostnaden. |
| AZCOPY_DISABLE_SYSLOG | Inaktiverar loggning i Syslog eller Windows-händelseloggaren. Som standard skickar AzCopy loggar till dessa kanaler. Du kan ange den här variabeln till true om du vill minska bruset i Syslog eller Windows-händelseloggen. |
| AZCOPY_DOWNLOAD_TO_TEMP_PATH | Konfigurerar AzCopy att ladda ned till en temporär sökväg före den faktiska nedladdningen. Tillåtna värden är sanna eller falska |
| AZCOPY_JOB_PLAN_LOCATION | Åsidosätter var jobbplansfilerna (används för förloppsspårning och återupptagande) lagras för att undvika att fylla en disk. |
| AZCOPY_LOG_LOCATION | Åsidosätter var loggfilerna lagras för att undvika att fylla en disk. |
| AZCOPY_MSI_CLIENT_ID | Klient-ID för en användartilldelad hanterad identitet. Använd när AZCOPY_AUTO_LOGIN_TYPE är inställt på MSI. Se Auktorisera utan ett hemligt arkiv |
| AZCOPY_MSI_OBJECT_ID | Objekt-ID för den användartilldelade hanterade identiteten. Använd när AZCOPY_AUTO_LOGIN_TYPE är inställt på MSI. Se Auktorisera utan ett hemligt arkiv |
| AZCOPY_MSI_RESOURCE_STRING | Resurs-ID för den användartilldelade hanterade identiteten. Se Auktorisera utan ett hemligt arkiv |
| AZCOPY_PACE_PAGE_BLOBS | Ska dataflödet för sidblobbar automatiskt justeras för att matcha tjänstbegränsningar? Standard är sant. Ställ in på "false" för att inaktivera |
| AZCOPY_PARALLEL_STAT_FILES | Gör att AzCopy söker efter filegenskaper på parallella "trådar" när det lokala filsystemet genomsöks. Trådarna hämtas från poolen som definieras av AZCOPY_CONCURRENT_SCAN. Om du ställer in detta på sant kan genomsökningsprestandan förbättras på Linux. Behövs inte eller rekommenderas inte i Windows. |
| AZCOPY_REQUEST_TRY_TIMEOUT | Ange hur många minuter AzCopy ska försöka ladda upp filer för varje begäran innan AzCopy överskrider tidsgränsen. |
| AZCOPY_SHOW_PERF_STATES | Om värdet är inställt på vad som helst kommer utdata på skärmen att innehålla antal segment efter tillstånd |
| AZCOPY_SPA_APPLICATION_ID | Program-ID för tjänstens huvudnamns appregistrering. Använd när AZCOPY_AUTO_LOGIN_TYPE är inställt på SPN. Se Auktorisera utan ett hemligt arkiv |
| AZCOPY_SPA_CERT_PASSWORD | Lösenordet för ett certifikat. Använd när AZCOPY_AUTO_LOGIN_TYPE är inställt på SPN. Se Auktorisera utan ett hemligt arkiv |
| AZCOPY_SPA_CERT_PATH | Den relativa eller fullständigt kvalificerade sökvägen till en certifikatfil. Använd när AZCOPY_AUTO_LOGIN_TYPE är inställt på SPN. Se Auktorisera utan ett hemligt arkiv |
| AZCOPY_SPA_CLIENT_SECRET | Klienthemligheten. Använd när AZCOPY_AUTO_LOGIN_TYPE är inställt på SPN. Se Auktorisera utan ett hemligt arkiv |
| AZCOPY_TENANT_ID | Det Microsoft Entra-klient-ID som ska användas för interaktiv inloggning med OAuth-enhet. Den här variabeln används endast för automatisk inloggning. Använd kommandoradsflaggan i stället när du anropar inloggningskommandot. |
| AZCOPY_TUNE_TO_CPU | Ställ in på false för att förhindra att AzCopy tar hänsyn till CPU-användning när den automatiskt finjusterar samtidighetsnivån (till exempel i benchmark-kommandot). |
| AZCOPY_USER_AGENT_PREFIX | Lägg till ett prefix i standardanvändaragenten för AzCopy, som används i telemetrisyfte. Ett blanksteg infogas automatiskt. |
| CPK_ENCRYPTION_KEY | Ett Base64-kodat AES-256-krypteringsnyckelvärde. Den här variabeln krävs för både läs- och skrivbegäranden när du använder kundanpassade nycklar för att kryptera och dekryptera data om Blob Storage-åtgärder. Du kan använda kundhanterade nycklar genom att --cpk-by-value=true ange flaggan. |
| CPK_ENCRYPTION_KEY_SHA256 | Base64-kodad SHA256 för krypteringsnyckeln. Den här variabeln krävs för både läs- och skrivbegäranden när du använder kundanpassade nycklar för att kryptera och dekryptera data om Blob Storage-åtgärder. Du kan använda kundhanterade nycklar genom att --cpk-by-value=true ange flaggan. |
| GOOGLE_APPLICATION_CREDENTIALS | Den absoluta sökvägen till nyckelfilen för tjänstkontot Tillhandahåller en nyckel för att auktorisera med Google Cloud Storage. Kopiera data från Google Cloud Storage till Azure Storage med hjälp av AzCopy (förhandsversion) |
| GOOGLE_CLOUD_PROJECT | Projekt-ID som krävs för bläddringen på tjänstnivå i Google Cloud Storage. |
| HTTPS_PROXY | Konfigurerar proxyinställningar för AzCopy. Ange den här variabeln till proxyns IP-adress och proxyportnummer. Exempel: xx.xxx.xx.xxx:xx Om du kör AzCopy i Windows identifierar AzCopy automatiskt proxyinställningar, så du behöver inte använda den här inställningen i Windows. Om du väljer att använda den här inställningen i Windows kommer den att åsidosätta automatisk identifiering. Se Konfigurera proxyinställningar |
Konfigurera proxyinställningar
Om du vill konfigurera proxyinställningarna för AzCopy anger du HTTPS_PROXY miljövariabeln. Om du kör AzCopy i Windows identifierar AzCopy automatiskt proxyinställningar, så du behöver inte använda den här inställningen i Windows. Om du väljer att använda den här inställningen i Windows kommer den att åsidosätta automatisk identifiering.
| Operativsystem | Kommando |
|---|---|
| Windows | I en kommandotolk använder du: set HTTPS_PROXY=<proxy IP>:<proxy port>I PowerShell använder du: $env:HTTPS_PROXY="<proxy IP>:<proxy port>" |
| Linux | export HTTPS_PROXY=<proxy IP>:<proxy port> |
| macOS | export HTTPS_PROXY=<proxy IP>:<proxy port> |
För närvarande stöder AzCopy inte proxyservrar som kräver autentisering med NTLM eller Kerberos.
Kringgå en proxy
Om du kör AzCopy i Windows och vill be den att inte använda någon proxy alls (i stället för att automatiskt identifiera inställningarna) använder du dessa kommandon. Med de här inställningarna kommer AzCopy inte att söka efter eller försöka använda någon proxy.
| Operativsystem | Miljö | Kommandon |
|---|---|---|
| Windows | Kommandotolken (CMD) | set HTTPS_PROXY=dummy.invalid set NO_PROXY=* |
| Windows | PowerShell | $env:HTTPS_PROXY="dummy.invalid" $env:NO_PROXY="*" |
I andra operativsystem lämnar du helt enkelt HTTPS_PROXY variabeln oetig om du inte vill använda någon proxy.