AzCopy v10-configuratie-instellingen (Azure Storage)

  • Artikel

AzCopy is een opdrachtregelprogramma dat u kunt gebruiken om blobs of bestanden te kopiëren vanuit of naar een opslagaccount. Dit artikel bevat een lijst met omgevingsvariabelen die u kunt gebruiken om AzCopy v10 te configureren.

Notitie

Als u inhoud zoekt om aan de slag te gaan met AzCopy, raadpleegt u Aan de slag met AzCopy.

AzCopy v10-omgevingsvariabelen

De volgende tabel beschrijft elke omgevingsvariabele en bevat koppelingen naar inhoud waarmee u de variabele kunt gebruiken.

Omgevingsvariabele Beschrijving
AWS_ACCESS_KEY_ID Amazon Web Services-toegangssleutel. Biedt een sleutel om te autoriseren met Amazon Web Services.Gegevens kopiëren van Amazon S3 naar Azure Storage met behulp van AzCopy
AWS_SECRET_ACCESS_KEY Amazon Web Services geheime toegangssleutel biedt een geheime sleutel om te autoriseren met Amazon Web Services. Gegevens kopiëren van Amazon S3 naar Azure Storage met behulp van AzCopy
AZCOPY_ACTIVE_DIRECTORY_ENDPOINT Het Microsoft Entra-eindpunt dat moet worden gebruikt. Deze variabele wordt alleen gebruikt voor automatische aanmelding. Gebruik in plaats daarvan de opdrachtregelvlag wanneer u de aanmeldingsopdracht aanroept.
AZCOPY_AUTO_LOGIN_TYPE Stel deze variabele in op DEVICE, MSI, SPN, en AZCLI.PSCRED Deze variabele biedt de mogelijkheid om te autoriseren zonder de azcopy login opdracht te gebruiken. Zie Toegang tot blobs autoriseren met AzCopy en Microsoft Entra-id.
AZCOPY_BUFFER_GB Geef de maximale hoeveelheid systeemgeheugen op die AzCopy moet gebruiken bij het downloaden en uploaden van bestanden. Geef deze waarde op in gigabytes (GB). Zie Geheugengebruik optimaliseren
AZCOPY_CACHE_PROXY_LOOKUP Standaard slaat AzCopy in Windows proxyserverzoekacties op hostnaamniveau op in de cache (waarbij geen rekening wordt gehouden met het URL-pad). Stel deze waarde in op een andere waarde dan 'true' om de cache uit te schakelen.
AZCOPY_CONCURRENCY_VALUE Hiermee geeft u het aantal gelijktijdige aanvragen op dat kan optreden. U kunt deze variabele gebruiken om de doorvoer te verhogen. Als uw computer minder dan 5 CPU's heeft, wordt de waarde van deze variabele ingesteld op 32. Anders is de standaardwaarde gelijk aan 16 vermenigvuldigd met het aantal CPU's. De maximale standaardwaarde van deze variabele is 3000, maar u kunt deze waarde handmatig hoger of lager instellen. Zie Gelijktijdigheid verhogen
AZCOPY_CONCURRENT_FILES Overschrijft het (geschatte) aantal bestanden dat op elk moment wordt uitgevoerd door te bepalen hoeveel bestanden we gelijktijdig overdrachten starten.
AZCOPY_CONCURRENT_SCAN Bepaalt de (max) mate van parallelle uitvoering die tijdens het scannen wordt gebruikt. Alleen van invloed op geparallelliseerde enumerators, waaronder Azure Files/Blobs en lokale bestandssystemen.
AZCOPY_CONTENT_TYPE_MAP Overschrijft een of meer van de standaard MIME-typetoewijzingen die zijn gedefinieerd door uw besturingssysteem. Stel deze variabele in op het pad van een JSON-bestand dat een toewijzing definieert. Hier volgt de inhoud van een voorbeeld-JSON-bestand:

{
  "MIMETypeMapping": {
    ".323": "text/h323",
    ".aaf": "application/octet-stream",
    ".aca": "application/octet-stream",
    ".accdb": "application/msaccess"
     }
}
AZCOPY_DEFAULT_SERVICE_API_VERSION Hiermee wordt de service-API-versie overschreven, zodat AzCopy geschikt kan zijn voor aangepaste omgevingen zoals Azure Stack.
AZCOPY_DISABLE_HIERARCHICAL_SCAN Is alleen van toepassing wanneer Azure Blobs de bron is. Gelijktijdig scannen is sneller, maar maakt gebruik van de hiërarchische API, wat kan leiden tot meer IOs/kosten. Geef 'true' op om prestaties op te offeren, maar bespaar op kosten.
AZCOPY_DISABLE_SYSLOG Hiermee schakelt u logboekregistratie in Syslog of de Windows-gebeurtenislogboekregistratie uit. Standaard verzendt AzCopy logboeken naar deze kanalen. U kunt deze variabele instellen op true als u de ruis in Syslog of het Windows-gebeurtenislogboek wilt verminderen.
AZCOPY_DOWNLOAD_TO_TEMP_PATH Hiermee configureert u AzCopy om te downloaden naar een tijdelijk pad voordat de werkelijke download wordt uitgevoerd. Toegestane waarden zijn waar of onwaar
AZCOPY_JOB_PLAN_LOCATION Onderdrukkingen waarbij de bestanden van het taakplan (gebruikt voor het bijhouden en hervatten van voortgang) worden opgeslagen om te voorkomen dat een schijf volloopt.
AZCOPY_LOG_LOCATION Overschrijft waar de logboekbestanden worden opgeslagen, om te voorkomen dat een schijf volloopt.
AZCOPY_MSI_CLIENT_ID De client-id van een door de gebruiker toegewezen beheerde identiteit. Gebruik wanneer AZCOPY_AUTO_LOGIN_TYPE is ingesteld op MSI. Zie Autoriseren zonder een geheim archief
AZCOPY_MSI_OBJECT_ID De object-id van de door de gebruiker toegewezen beheerde identiteit. Gebruik wanneer AZCOPY_AUTO_LOGIN_TYPE is ingesteld op MSI. Zie Autoriseren zonder een geheim archief
AZCOPY_MSI_RESOURCE_STRING De resource-id van de door de gebruiker toegewezen beheerde identiteit. Zie Autoriseren zonder een geheim archief
AZCOPY_PACE_PAGE_BLOBS Moet doorvoer voor pagina-blobs automatisch worden aangepast aan servicelimieten? De standaardwaarde is waar. Ingesteld op 'false' om uit te schakelen
AZCOPY_PARALLEL_STAT_FILES Zorgt ervoor dat AzCopy bestandseigenschappen opzoekt op parallelle threads bij het scannen van het lokale bestandssysteem. De threads worden getrokken uit de pool die is gedefinieerd door AZCOPY_CONCURRENT_SCAN. Als u dit instelt op Waar, kunnen de scanprestaties in Linux worden verbeterd. Niet nodig of aanbevolen in Windows.
AZCOPY_REQUEST_TRY_TIMEOUT Stel het aantal minuten in dat AzCopy bestanden voor elke aanvraag moet uploaden voordat er een time-out optreedt voor AzCopy.
AZCOPY_SHOW_PERF_STATES Als deze optie is ingesteld, bevat uitvoer op het scherm het aantal segmenten per status
AZCOPY_SPA_APPLICATION_ID De toepassings-id van de app-registratie van uw service-principal. Gebruik wanneer AZCOPY_AUTO_LOGIN_TYPE is ingesteld op SPN. Zie Autoriseren zonder een geheim archief
AZCOPY_SPA_CERT_PASSWORD Het wachtwoord van een certificaat. Gebruik wanneer AZCOPY_AUTO_LOGIN_TYPE is ingesteld op SPN. Zie Autoriseren zonder een geheim archief
AZCOPY_SPA_CERT_PATH Het relatieve of volledig gekwalificeerde pad naar een certificaatbestand. Gebruik wanneer AZCOPY_AUTO_LOGIN_TYPE is ingesteld op SPN. Zie Autoriseren zonder een geheim archief
AZCOPY_SPA_CLIENT_SECRET Het clientgeheim. Gebruik wanneer AZCOPY_AUTO_LOGIN_TYPE is ingesteld op SPN. Zie Autoriseren zonder een geheim archief
AZCOPY_TENANT_ID De tenant-id van Microsoft Entra voor interactieve aanmelding bij OAuth-apparaten. Deze variabele wordt alleen gebruikt voor automatische aanmelding. Gebruik in plaats daarvan de opdrachtregelvlag wanneer u de aanmeldingsopdracht aanroept.
AZCOPY_TUNE_TO_CPU Ingesteld op onwaar om te voorkomen dat AzCopy rekening houdt met het CPU-gebruik bij het automatisch afstemmen van het gelijktijdigheidsniveau (bijvoorbeeld in de benchmarkopdracht).
AZCOPY_USER_AGENT_PREFIX Voeg een voorvoegsel toe aan de standaard AzCopy-gebruikersagent, die wordt gebruikt voor telemetriedoeleinden. Er wordt automatisch een spatie ingevoegd.
CPK_ENCRYPTION_KEY Een met Base64 gecodeerde AES-256-versleutelingssleutelwaarde. Deze variabele is vereist voor zowel lees- als schrijfaanvragen bij het gebruik van door de klant verstrekte sleutels voor het versleutelen en ontsleutelen van gegevens in Blob Storage-bewerkingen. U kunt door de klant geleverde sleutels gebruiken door de --cpk-by-value=true vlag in te stellen.
CPK_ENCRYPTION_KEY_SHA256 De Base64-gecodeerde SHA256 van de versleutelingssleutel. Deze variabele is vereist voor zowel lees- als schrijfaanvragen bij het gebruik van door de klant verstrekte sleutels voor het versleutelen en ontsleutelen van gegevens in Blob Storage-bewerkingen. U kunt door de klant geleverde sleutels gebruiken door de --cpk-by-value=true vlag in te stellen.
GOOGLE_APPLICATION_CREDENTIALS Het absolute pad naar het sleutelbestand van het serviceaccount biedt een sleutel om te autoriseren met Google Cloud Storage. Gegevens kopiëren van Google Cloud Storage naar Azure Storage met behulp van AzCopy (preview)
GOOGLE_CLOUD_PROJECT Project-id vereist voor traversals op serviceniveau in Google Cloud Storage.
HTTPS_PROXY Hiermee configureert u proxy-instellingen voor AzCopy. Stel deze variabele in op het IP-adres van de proxy en het proxypoortnummer. Bijvoorbeeld xx.xxx.xx.xxx:xx. Als u AzCopy uitvoert in Windows, detecteert AzCopy proxyinstellingen automatisch. U hoeft deze instelling dus niet te gebruiken in Windows. Als u ervoor kiest om deze instelling te gebruiken in Windows, wordt automatische detectie overschreven. Zie Proxy-instellingen configureren

Proxy-instellingen configureren

Als u de proxy-instellingen voor AzCopy wilt configureren, stelt u de HTTPS_PROXY omgevingsvariabele in. Als u AzCopy uitvoert in Windows, detecteert AzCopy proxyinstellingen automatisch. U hoeft deze instelling dus niet te gebruiken in Windows. Als u ervoor kiest om deze instelling te gebruiken in Windows, wordt automatische detectie overschreven.

Besturingssysteem Opdracht
Windows Gebruik in een opdrachtprompt: set HTTPS_PROXY=<proxy IP>:<proxy port>
Gebruik in PowerShell: $env:HTTPS_PROXY="<proxy IP>:<proxy port>"
Linux export HTTPS_PROXY=<proxy IP>:<proxy port>
MacOS export HTTPS_PROXY=<proxy IP>:<proxy port>

Momenteel biedt AzCopy geen ondersteuning voor proxy's waarvoor verificatie met NTLM of Kerberos is vereist.

Een proxy omzeilen

Als u AzCopy uitvoert in Windows en u wilt aangeven dat er helemaal geen proxy wordt gebruikt (in plaats van de instellingen automatisch te detecteren) gebruikt u deze opdrachten. Met deze instellingen zal AzCopy geen proxy opzoeken of proberen te gebruiken.

Besturingssysteem Omgeving Opdrachten
Windows Opdrachtprompt (CMD) set HTTPS_PROXY=dummy.invalid
set NO_PROXY=*
Windows PowerShell $env:HTTPS_PROXY="dummy.invalid"
$env:NO_PROXY="*"

Laat op andere besturingssystemen de HTTPS_PROXY variabele uitgeschakeld als u geen proxy wilt gebruiken.

Zie ook