AzCopy v10 yapılandırma ayarları (Azure Depolama)
AzCopy, bir depolama hesabına iki yönlü blob veya dosya kopyalama işlemi gerçekleştirmenizi sağlayan bir komut satırı yardımcı programıdır. Bu makale, AzCopy v10'un yapılandırmak için kullanabileceğiniz ortam değişkenlerinin listesini içerir.
Dekont
AzCopy'yi kullanmaya başlamanıza yardımcı olacak içerik arıyorsanız bkz . AzCopy'yi kullanmaya başlama.
AzCopy v10 ortam değişkenleri
Aşağıdaki tabloda her ortam değişkeni açıklanır ve değişkeni kullanmanıza yardımcı olabilecek içeriğe bağlantılar sağlanır.
| Ortam değişkeni | Açıklama |
|---|---|
| AWS_ACCESS_KEY_ID | Amazon Web Services erişim anahtarı. Amazon Web Services ile yetkilendirmek için bir anahtar sağlar.AzCopy kullanarak Amazon S3'ten Azure Depolama'a veri kopyalama |
| AWS_SECRET_ACCESS_KEY | Amazon Web Services gizli erişim anahtarı Amazon Web Services ile yetkilendirmek için bir gizli anahtar sağlar. AzCopy kullanarak Amazon S3'ten Azure Depolama'a veri kopyalama |
| AZCOPY_ACTIVE_DIRECTORY_ENDPOINT | Kullanılacak Microsoft Entra uç noktası. Bu değişken yalnızca otomatik oturum açma için kullanılır, lütfen oturum açma komutunu çağırırken bunun yerine komut satırı bayrağını kullanın. |
| AZCOPY_AUTO_LOGIN_TYPE | Bu değişkeni , , MSI, SPNAZCLIve PSCREDolarak DEVICEayarlayın. Bu değişken komutunu kullanmadan azcopy login yetkilendirme olanağı sağlar. Bkz . AzCopy ve Microsoft Entra Id ile bloblara erişimi yetkilendirme. |
| AZCOPY_BUFFER_GB | AzCopy'nin dosyaları indirirken ve karşıya yüklerken kullanmasını istediğiniz en fazla sistem belleği miktarını belirtin. Bu değeri gigabayt (GB) cinsinden ifade edin. Bkz. Bellek kullanımını iyileştirme |
| AZCOPY_CACHE_PROXY_LOOKUP | Varsayılan olarak, Windows'da AzCopy proxy sunucu aramalarını ana bilgisayar adı düzeyinde önbelleğe alır (URL yolunu dikkate almaz). Önbelleği devre dışı bırakmak için 'true' dışında bir değere ayarlayın. |
| AZCOPY_CONCURRENCY_VALUE | Gerçekleşebilecek eşzamanlı istek sayısını belirtir. Aktarım hızını artırmak için bu değişkeni kullanabilirsiniz. Bilgisayarınızda 5'ten az CPU varsa, bu değişkenin değeri olarak 32ayarlanır. CPU dana fazlaysa, varsayılan değer CPU sayısının 16 katına eşittir. Bu değişkenin varsayılan değeri üst sınırıdır 3000, ancak bu değeri el ile daha yüksek veya daha düşük bir değere ayarlayabilirsiniz. Bkz . Eşzamanlılığı artırma |
| AZCOPY_CONCURRENT_FILES | Eşzamanlı olarak kaç dosya için aktarım başlattığımızı denetleyerek, herhangi bir anda devam eden dosya sayısını (yaklaşık) geçersiz kılar. |
| AZCOPY_CONCURRENT_SCAN | Tarama sırasında kullanılan paralellik (maksimum) derecesini denetler. Yalnızca Azure Dosyalar/Bloblar ve yerel dosya sistemleri içeren paralel numaralandırıcıları etkiler. |
| AZCOPY_CONTENT_TYPE_MAP | İşletim sisteminiz tarafından tanımlanan varsayılan MIME türü eşlemelerinden birini veya daha fazlasını geçersiz kılar. Bu değişkeni herhangi bir eşlemeyi tanımlayan bir JSON dosyasının yoluna ayarlayın. Örnek JSON dosyasının içeriği şunlardır: { "MIMETypeMapping": { ".323": "text/h323", ".aaf": "application/octet-stream", ".aca": "application/octet-stream", ".accdb": "application/msaccess" } } |
| AZCOPY_DEFAULT_SERVICE_API_VERSION | AzCopy'nin Azure Stack gibi özel ortamlara uyum sağlaması için hizmet API'sinin sürümünü geçersiz kılar. |
| AZCOPY_DISABLE_HIERARCHICAL_SCAN | Yalnızca kaynak Azure Blobları olduğunda geçerlidir. Eşzamanlı tarama daha hızlıdır ancak hiyerarşik listeleme API'sini kullanır ve bu da daha fazla G/Ç/maliyetle sonuçlanabilir. Performansı feda etmek ancak maliyetten tasarruf etmek için 'true' değerini belirtin. |
| AZCOPY_DISABLE_SYSLOG | Syslog veya Windows Event Logger'da günlüğe kaydetmeyi devre dışı bırakır. Varsayılan olarak, AzCopy günlükleri bu kanallara gönderir. Syslog veya Windows Olay Günlüğü'nde gürültüyü azaltmak istiyorsanız bu değişkeni true olarak ayarlayabilirsiniz. |
| AZCOPY_DOWNLOAD_TO_TEMP_PATH | AzCopy'yi gerçek indirmeden önce geçici bir yola indirecek şekilde yapılandırılır. İzin verilen değerler true veya false |
| AZCOPY_JOB_PLAN_LOCATION | Disk doldurmaktan kaçınmak için iş planı dosyalarının (ilerleme izleme ve devam etme için kullanılır) depolandığı yeri geçersiz kılar. |
| AZCOPY_LOG_LOCATION | Diskin doldurulmasını önlemek için günlük dosyalarının depolandığı yeri geçersiz kılar. |
| AZCOPY_MSI_CLIENT_ID | Kullanıcı tarafından atanan yönetilen kimliğin istemci kimliği. olarak AZCOPY_AUTO_LOGIN_TYPE ayarlandığında MSIkullanın. Bkz. Gizli dizi deposu olmadan yetkilendirme |
| AZCOPY_MSI_OBJECT_ID | Kullanıcı tarafından atanan yönetilen kimliğin nesne kimliği. olarak AZCOPY_AUTO_LOGIN_TYPE ayarlandığında MSIkullanın. Bkz. Gizli dizi deposu olmadan yetkilendirme |
| AZCOPY_MSI_RESOURCE_STRING | Kullanıcı tarafından atanan yönetilen kimliğin kaynak kimliği. Bkz. Gizli dizi deposu olmadan yetkilendirme |
| AZCOPY_PACE_PAGE_BLOBS | Sayfa blobları için aktarım hızı, Hizmet sınırlarıyla eşleşecek şekilde otomatik olarak ayarlanmalı mı? Varsayılanı doğrudur Devre dışı bırakmak için 'false' olarak ayarlayın |
| AZCOPY_PARALLEL_STAT_FILES | Yerel dosya sistemini tararken AzCopy'nin paralel 'iş parçacıklarında' dosya özelliklerini aramasına neden olur. İş parçacıkları, AZCOPY_CONCURRENT_SCAN tarafından tanımlanan havuzdan çizilir. Bunu true olarak ayarlamak Linux'ta tarama performansını iyileştirebilir. Windows'ta gerekli değildir veya önerilmez. |
| AZCOPY_REQUEST_TRY_TIMEOUT | AzCopy zaman aşımına uğramadan önce AzCopy'nin her istek için dosyaları karşıya yüklemeye çalışacağı dakika sayısını ayarlayın. |
| AZCOPY_SHOW_PERF_STATES | Ayarlanırsa, ekran çıkışı duruma göre öbek sayısını içerir |
| AZCOPY_SPA_APPLICATION_ID | Hizmet sorumlunuzun uygulama kaydının uygulama kimliği. olarak AZCOPY_AUTO_LOGIN_TYPE ayarlandığında SPNkullanın. Bkz. Gizli dizi deposu olmadan yetkilendirme |
| AZCOPY_SPA_CERT_PASSWORD | Sertifikanın parolası. olarak AZCOPY_AUTO_LOGIN_TYPE ayarlandığında SPNkullanın. Bkz. Gizli dizi deposu olmadan yetkilendirme |
| AZCOPY_SPA_CERT_PATH | Sertifika dosyasının göreli veya tam yolu. olarak AZCOPY_AUTO_LOGIN_TYPE ayarlandığında SPNkullanın. Bkz. Gizli dizi deposu olmadan yetkilendirme |
| AZCOPY_SPA_CLIENT_SECRET | İstemci gizli dizisi. olarak AZCOPY_AUTO_LOGIN_TYPE ayarlandığında SPNkullanın. Bkz. Gizli dizi deposu olmadan yetkilendirme |
| AZCOPY_TENANT_ID | OAuth cihazı etkileşimli oturum açma bilgileri için kullanılacak Microsoft Entra kiracı kimliği. Bu değişken yalnızca otomatik oturum açma için kullanılır, lütfen oturum açma komutunu çağırırken bunun yerine komut satırı bayrağını kullanın. |
| AZCOPY_TUNE_TO_CPU | AzCopy'nin eşzamanlılık düzeyini otomatikleştirirken CPU kullanımını hesaba katmasını önlemek için false olarak ayarlayın (örneğin, karşılaştırma komutunda). |
| AZCOPY_USER_AGENT_PREFIX | Telemetri amacıyla kullanılan varsayılan AzCopy Kullanıcı Aracısı'na bir ön ek ekleyin. Otomatik olarak bir boşluk eklenir. |
| CPK_ENCRYPTION_KEY | Base64 kodlamalı AES-256 şifreleme anahtarı değeri. Bu değişken, Blob depolama işlemlerindeki verileri şifrelemek ve şifresini çözmek için Müşteri Tarafından Sağlanan Anahtarlar kullanılırken hem okuma hem de yazma istekleri için gereklidir. Bayrağını ayarlayarak --cpk-by-value=true Müşteri Tarafından Sağlanan Anahtarları kullanabilirsiniz. |
| CPK_ENCRYPTION_KEY_SHA256 | Şifreleme anahtarının Base64 ile kodlanmış SHA256'sı. Bu değişken, Blob depolama işlemlerindeki verileri şifrelemek ve şifresini çözmek için Müşteri Tarafından Sağlanan Anahtarlar kullanılırken hem okuma hem de yazma istekleri için gereklidir. Bayrağını ayarlayarak --cpk-by-value=true Müşteri Tarafından Sağlanan Anahtarları kullanabilirsiniz. |
| GOOGLE_APPLICATION_CREDENTIALS | Hizmet hesabı anahtar dosyasının mutlak yolu Google Cloud Depolama ile yetkilendirmek için bir anahtar sağlar. AzCopy (önizleme) kullanarak Google Cloud Depolama'dan Azure Depolama'a veri kopyalama |
| GOOGLE_CLOUD_PROJECT | Google Cloud Depolama'da hizmet düzeyi geçişleri için gereken Proje Kimliği. |
| HTTPS_PROXY | AzCopy için ara sunucu ayarlarını yapılandırıyor. Bu değişkeni ara sunucu IP adresi ve proxy bağlantı noktası numarası olarak ayarlayın. Örneğin, xx.xxx.xx.xxx:xx. AZCopy’yi Windows’da çalıştırıyorsanız AzCopy ara sunucu ayarlarını otomatik olarak algılar, bu nedenle bu ayarı Windows’da kullanmanız gerekmez. Bu ayarı Windows’da kullanmayı seçerseniz otomatik algılama geçersiz kılınır. Bkz. Ara sunucu ayarlarını yapılandırma |
Ara sunucu ayarlarını yapılandırma
AzCopy proxy ayarlarını yapılandırmak için ortam değişkenini HTTPS_PROXY ayarlayın. AZCopy’yi Windows’da çalıştırıyorsanız AzCopy ara sunucu ayarlarını otomatik olarak algılar, bu nedenle bu ayarı Windows’da kullanmanız gerekmez. Bu ayarı Windows’da kullanmayı seçerseniz otomatik algılama geçersiz kılınır.
| İşletim sistemi | Komut |
|---|---|
| Windows | Komut isteminde şunu kullanın: set HTTPS_PROXY=<proxy IP>:<proxy port>PowerShell'de şunları kullanın: $env:HTTPS_PROXY="<proxy IP>:<proxy port>" |
| Linux | export HTTPS_PROXY=<proxy IP>:<proxy port> |
| macOS | export HTTPS_PROXY=<proxy IP>:<proxy port> |
Şu anda AzCopy NTLM veya Kerberos üzerinden kimlik doğrulaması gerektiren ara sunucuları desteklemiyor.
Ara sunucuyu atlama
Windows'da AzCopy çalıştırıyorsanız ve hiç ara sunucu kullanmamasını söylemek istiyorsanız (ayarları otomatik algılamak yerine) bu komutları kullanın. Bu ayarlarla AzCopy ara sunucu aramaz veya herhangi bir ara sunucu kullanmayı denemez.
| İşletim sistemi | Ortam | Komutlar |
|---|---|---|
| Windows | Komut istemi (CMD) | set HTTPS_PROXY=dummy.invalid set NO_PROXY=* |
| Windows | PowerShell | $env:HTTPS_PROXY="dummy.invalid" $env:NO_PROXY="*" |
Diğer işletim sistemlerinde, ara sunucu kullanmak istemiyorsanız HTTPS_PROXY değişkenini ayarsız bırakmanız yeterlidir.