Impostazioni di configurazione di AzCopy v10 (Archiviazione di Azure)
AzCopy è un'utilità della riga di comando che è possibile usare per copiare i BLOB o i file da e verso un account di archiviazione. Questo articolo contiene un elenco di variabili di ambiente che è possibile usare per configurare AzCopy v10.
Nota
Per informazioni su come iniziare a usare AzCopy, vedere Introduzione ad AzCopy.
Variabili di ambiente azCopy v10
La tabella seguente descrive ogni variabile di ambiente e fornisce collegamenti al contenuto che consente di usare la variabile .
| Variabile di ambiente | Descrizione |
|---|---|
| AWS_ACCESS_KEY_ID | Chiave di accesso di Amazon Web Services. Fornisce una chiave per autorizzare con Amazon Web Services.Copiare dati da Amazon S3 a Archiviazione di Azure usando AzCopy |
| AWS_edizione StandardCRET_ACCESS_KEY | Chiave di accesso segreto di Amazon Web Services Fornisce una chiave privata da autorizzare con Amazon Web Services. Copiare dati da Amazon S3 a Archiviazione di Azure usando AzCopy |
| AZCOPY_ACTIVE_DIRECTORY_ENDPOINT | Endpoint di Microsoft Entra da usare. Questa variabile viene usata solo per l'accesso automatico. Usare invece il flag della riga di comando quando si richiama il comando di accesso. |
| AZCOPY_AUTO_LOGIN_TYPE | Impostare questa variabile su DEVICE, SPNMSI, AZCLI, e PSCRED. Questa variabile consente di autorizzare senza usare il azcopy login comando . Vedere Autorizzare l'accesso ai BLOB con AzCopy e Microsoft Entra ID. |
| AZCOPY_BUFFER_GB | Specificare la quantità massima di memoria di sistema che si vuole usare AzCopy durante il download e il caricamento dei file. Esprimere questo valore in gigabyte (GB). Vedere Ottimizzare l'uso della memoria |
| AZCOPY_CACHE_PROXY_LOOKUP | Per impostazione predefinita, AzCopy in Windows memorizza nella cache le ricerche del server proxy a livello di nome host (senza tenere conto del percorso URL). Impostare su qualsiasi valore diverso da 'true' per disabilitare la cache. |
| AZCOPY_CONCURRENCY_VALUE | Specifica il numero di richieste simultanee che possono verificarsi. È possibile usare questa variabile per aumentare la velocità effettiva. Se il computer ha meno di 5 CPU, il valore di questa variabile è impostato su 32. Altrimenti, il valore predefinito è pari a 16 moltiplicato per il numero di CPU. Il valore predefinito massimo di questa variabile è 3000, ma è possibile impostare manualmente questo valore superiore o inferiore. Vedere Aumentare la concorrenza |
| AZCOPY_CONCURRENT_FILES | Esegue l'override del numero (approssimativo) di file in corso in qualsiasi momento, controllando il numero di file per cui si avviano simultaneamente i trasferimenti. |
| AZCOPY_CONCURRENT_SCAN | Controlla il grado di parallelismo (massimo) usato durante l'analisi. Influisce solo sugli enumeratori parallelizzati, che includono File di Azure/BLOB e file system locali. |
| AZCOPY_CONTENT_TYPE_MAP | Esegue l'override di uno o più mapping dei tipi MIME predefiniti definiti dal sistema operativo. Impostare questa variabile sul percorso di un file JSON che definisce qualsiasi mapping. Ecco il contenuto di un file JSON di esempio: { "MIMETypeMapping": { ".323": "text/h323", ".aaf": "application/octet-stream", ".aca": "application/octet-stream", ".accdb": "application/msaccess" } } |
| AZCOPY_DEFAULT_edizione StandardRVICE_API_VERSION | Esegue l'override della versione dell'API del servizio in modo che AzCopy possa ospitare ambienti personalizzati come Azure Stack. |
| AZCOPY_DISABLE_HIERARCHICAL_SCAN | Si applica solo quando BLOB di Azure è l'origine. L'analisi simultanea è più veloce, ma usa l'API di elenco gerarchico, che può comportare un aumento dei costi/operazioni di I/O. Specificare "true" per sacrificare le prestazioni, ma risparmiare sui costi. |
| AZCOPY_DISABLE_SYSLOG | Disabilita la registrazione in Syslog o nel Logger di eventi di Windows. Per impostazione predefinita, AzCopy invia i log a questi canali. È possibile impostare questa variabile su true se si desidera ridurre il rumore in Syslog o nel registro eventi di Windows. |
| AZCOPY_DOWNLOAD_TO_TEMP_PATH | Configura AzCopy per il download in un percorso temporaneo prima del download effettivo. I valori consentiti sono true o false |
| AZCOPY_JOB_PLAN_LOCATION | Esegue l'override in cui vengono archiviati i file del piano di processo (usati per il rilevamento dello stato e la ripresa) per evitare di riempire un disco. |
| AZCOPY_LOG_LOCATION | Esegue l'override in cui vengono archiviati i file di log, per evitare di riempire un disco. |
| AZCOPY_MSI_CLIENT_ID | ID client di un'identità gestita assegnata dall'utente. Usare quando AZCOPY_AUTO_LOGIN_TYPE è impostato su MSI. Vedere Autorizzare senza un archivio segreto |
| AZCOPY_MSI_OBJECT_ID | ID oggetto dell'identità gestita assegnata dall'utente. Usare quando AZCOPY_AUTO_LOGIN_TYPE è impostato su MSI. Vedere Autorizzare senza un archivio segreto |
| AZCOPY_MSI_RESOURCE_STRING | ID risorsa dell'identità gestita assegnata dall'utente. Vedere Autorizzare senza un archivio segreto |
| AZCOPY_PACE_PAGE_BLOBS | La velocità effettiva per i BLOB di pagine deve essere modificata automaticamente in base ai limiti del servizio? Il valore predefinito è true. Impostare su 'false' per disabilitare |
| AZCOPY_PARALLEL_STAT_FILES | Fa in modo che AzCopy cerchi le proprietà dei file in 'thread' paralleli durante l'analisi del file system locale. I thread vengono disegnati dal pool definito da AZCOPY_CONCURRENT_SCAN. L'impostazione di questo valore su true può migliorare le prestazioni di analisi in Linux. Non è necessario o consigliato in Windows. |
| AZCOPY_REQUEST_TRY_TIMEOUT | Impostare il numero di minuti che AzCopy deve provare a caricare i file per ogni richiesta prima del timeout di AzCopy. |
| AZCOPY_SHOW_PERF_STATES | Se impostato, su qualsiasi elemento, l'output sullo schermo includerà il numero di blocchi per stato |
| AZCOPY_SPA_APPLICATION_ID | ID applicazione della registrazione dell'app dell'entità servizio. Usare quando AZCOPY_AUTO_LOGIN_TYPE è impostato su SPN. Vedere Autorizzare senza un archivio segreto |
| AZCOPY_SPA_CERT_PASSWORD | Password di un certificato. Usare quando AZCOPY_AUTO_LOGIN_TYPE è impostato su SPN. Vedere Autorizzare senza un archivio segreto |
| AZCOPY_SPA_CERT_PATH | Percorso relativo o completo di un file di certificato. Usare quando AZCOPY_AUTO_LOGIN_TYPE è impostato su SPN. Vedere Autorizzare senza un archivio segreto |
| AZCOPY_SPA_CLIENT_edizione Standard CRET | Segreto client. Usare quando AZCOPY_AUTO_LOGIN_TYPE è impostato su SPN. Vedere Autorizzare senza un archivio segreto |
| AZCOPY_TENANT_ID | ID tenant di Microsoft Entra da usare per l'accesso interattivo del dispositivo OAuth. Questa variabile viene usata solo per l'accesso automatico. Usare invece il flag della riga di comando quando si richiama il comando di accesso. |
| AZCOPY_TUNE_TO_CPU | Impostare su false per impedire ad AzCopy di prendere in considerazione l'utilizzo della CPU durante la regolazione automatica del livello di concorrenza, ad esempio nel comando benchmark. |
| AZCOPY_Uedizione StandardR_AGENT_PREFIX | Aggiungere un prefisso all'agente utente AzCopy predefinito, che viene usato per scopi di telemetria. Viene inserito automaticamente uno spazio. |
| CPK_ENCRYPTION_KEY | Valore della chiave di crittografia AES-256 con codifica Base64. Questa variabile è necessaria per le richieste di lettura e scrittura quando si usano chiavi fornite dal cliente per crittografare e decrittografare i dati nelle operazioni di archiviazione BLOB. È possibile usare chiavi fornite dal cliente impostando il --cpk-by-value=true flag . |
| CPK_ENCRYPTION_KEY_SHA256 | Sha256 con codifica Base64 della chiave di crittografia. Questa variabile è necessaria per le richieste di lettura e scrittura quando si usano chiavi fornite dal cliente per crittografare e decrittografare i dati nelle operazioni di archiviazione BLOB. È possibile usare chiavi fornite dal cliente impostando il --cpk-by-value=true flag . |
| GOOGLE_APPLICATION_CREDENTIALS | Il percorso assoluto del file di chiave dell'account del servizio Fornisce una chiave da autorizzare con Google Cloud Archiviazione. Copiare dati da Google Cloud Archiviazione a Archiviazione di Azure usando AzCopy (anteprima) |
| GOOGLE_CLOUD_PROJECT | ID progetto necessario per gli attraversamenti a livello di servizio in Google Cloud Archiviazione. |
| HTTPS_PROXY | Configura le impostazioni proxy per AzCopy. Impostare questa variabile sull'indirizzo IP proxy e sul numero di porta proxy. Ad esempio, xx.xxx.xx.xxx:xx. Se si esegue AzCopy in Windows, AzCopy rileva automaticamente le impostazioni proxy, quindi non è necessario usare questa impostazione in Windows. Se si sceglie di usare questa impostazione in Windows, verrà eseguito l'override del rilevamento automatico. Vedere Configurare le impostazioni proxy |
Configurare impostazioni del proxy
Per configurare le impostazioni proxy per AzCopy, impostare la HTTPS_PROXY variabile di ambiente. Se si esegue AzCopy in Windows, AzCopy rileva automaticamente le impostazioni proxy, quindi non è necessario usare questa impostazione in Windows. Se si sceglie di usare questa impostazione in Windows, verrà eseguito l'override del rilevamento automatico.
| Sistema operativo | Comando |
|---|---|
| Windows | Al prompt dei comandi digitare quanto segue: set HTTPS_PROXY=<proxy IP>:<proxy port>In PowerShell usare: $env:HTTPS_PROXY="<proxy IP>:<proxy port>" |
| Linux | export HTTPS_PROXY=<proxy IP>:<proxy port> |
| macOS | export HTTPS_PROXY=<proxy IP>:<proxy port> |
attualmente, AzCopy non supporta i proxy che richiedono l'autenticazione con NTLM o Kerberos.
Bypass di un proxy
Se si esegue AzCopy in Windows e si vuole indicare all'utente di non usare alcun proxy (invece di rilevare automaticamente le impostazioni) usare questi comandi. Con queste impostazioni, AzCopy non cercherà o tenterà di usare alcun proxy.
| Sistema operativo | Ambiente | Comandi |
|---|---|---|
| Windows | Prompt dei comandi (CMD) | set HTTPS_PROXY=dummy.invalid set NO_PROXY=* |
| Windows | PowerShell | $env:HTTPS_PROXY="dummy.invalid" $env:NO_PROXY="*" |
In altri sistemi operativi è sufficiente lasciare deselezionata la variabile HTTPS_PROXY se si desidera non usare alcun proxy.