Pengaturan konfigurasi AzCopy v10 (Azure Storage)
AzCopy adalah utilitas baris perintah yang dapat Anda gunakan untuk menyalin gumpalan atau file ke atau dari akun penyimpanan. Artikel ini berisi daftar variabel lingkungan yang dapat Anda gunakan untuk mengonfigurasikan AzCopy v10.
Catatan
Jika Anda mencari konten untuk membantu Anda mulai menggunakan AzCopy, lihat Mulai menggunakan AzCopy.
Variabel lingkungan AzCopy v10
Tabel berikut ini menjelaskan setiap variabel lingkungan dan menyediakan tautan ke konten yang dapat membantu Anda menggunakan variabel.
| Variabel lingkungan | Deskripsi |
|---|---|
| AWS_ACCESS_KEY_ID | Kunci akses AWS. Menyediakan kunci otorisasi dengan AWS. Menyalin data dari Amazon S3 ke Azure Storage menggunakan AzCopy |
| AWS_SECRET_ACCESS_KEY | Kunci akses rahasia AWS Menyediakan kunci rahasia untuk diotorisasi dengan AWS. Menyalin data dari Amazon S3 ke Azure Storage menggunakan AzCopy |
| AZCOPY_ACTIVE_DIRECTORY_ENDPOINT | Titik akhir Microsoft Entra yang akan digunakan. Variabel ini hanya digunakan untuk log masuk otomatis, silakan gunakan bendera baris perintah sebagai gantinya ketika menggunakan perintah log masuk. |
| AZCOPY_AUTO_LOGIN_TYPE | Atur variabel ini ke DEVICE, MSI, SPN, AZCLI, dan PSCRED. Variabel ini menyediakan kemampuan otorisasi tanpa menggunakan perintah azcopy login. Lihat Mengotorisasi akses ke blob dengan AzCopy dan ID Microsoft Entra. |
| AZCOPY_BUFFER_GB | Menentukan jumlah maksimum memori sistem yang Anda inginkan untuk digunakan AzCopy saat mengunduh dan mengunggah file. Nyatakan nilai ini dalam gigabyte (GB). Lihat Mengoptimalkan penggunaan memori |
| AZCOPY_CACHE_PROXY_LOOKUP | Secara default AzCopy pada Windows akan melakukan cache pada pencarian server proksi pada tingkat nama host (tidak memperhitungkan jalur URL). Atur ke nilai lain selain 'true' untuk menonaktifkan cache. |
| AZCOPY_CONCURRENCY_VALUE | Variabel ini menentukan jumlah permintaan bersamaan yang dapat terjadi. Anda dapat menggunakan variabel ini untuk meningkatkan throughput. Jika komputer Anda memiliki kurang dari 5 CPU, maka nilai variabel ini diatur ke 32. Jika tidak, nilai default sama dengan 16 dikalikan dengan jumlah CPU. Nilai default maksimum dari variabel ini adalah 3000, tetapi Anda dapat mengatur nilai ini lebih tinggi atau lebih rendah secara manual. Lihat Menambah konkurensi |
| AZCOPY_CONCURRENT_FILES | Mengambil alih (perkiraan) jumlah file yang sedang berlangsung pada satu waktu, dengan mengontrol berapa banyak file yang kami mulai transfer secara bersamaan. |
| AZCOPY_CONCURRENT_SCAN | Mengontrol tingkat paralelisme (maks) yang digunakan selama pemindaian. Hanya memengaruhi enumerator paralel, yang mencakup Azure Files/Blob, dan sistem file lokal. |
| AZCOPY_CONTENT_TYPE_MAP | Mengganti satu atau beberapa pemetaan tipe MIME default yang ditentukan oleh sistem operasi Anda. Atur variabel ini ke jalur file JSON yang mendefinisikan pemetaan apa pun. Berikut adalah konten contoh file JSON: { "MIMETypeMapping": { ".323": "text/h323", ".aaf": "application/octet-stream", ".aca": "application/octet-stream", ".accdb": "application/msaccess" } } |
| AZCOPY_DEFAULT_SERVICE_API_VERSION | Mengambil alih versi API layanan sehingga AzCopy dapat mengakomodasi lingkungan kustom seperti Azure Stack. |
| AZCOPY_DISABLE_HIERARCHICAL_SCAN | Hanya berlaku saat Blob Azure adalah sumbernya. Pemindaian bersamaan lebih cepat namun menggunakan API daftar hierarki, yang dapat menimbulkan lebih banyak IO/biaya. Tetapkan 'true' untuk mengorbankan performa tetapi menghemat biaya. |
| AZCOPY_DISABLE_SYSLOG | Menonaktifkan pengelogan di Syslog atau Windows Event Logger. Secara default, AzCopy mengirim log ke saluran ini. Anda dapat mengatur variabel ini ke true jika Anda ingin mengurangi kebisingan di Syslog atau Log Peristiwa Windows. |
| AZCOPY_DOWNLOAD_TO_TEMP_PATH | Mengonfigurasi AzCopy untuk mengunduh ke jalur sementara sebelum unduhan aktual. Nilai yang diizinkan adalah benar atau salah |
| AZCOPY_JOB_PLAN_LOCATION | Mengambil alih file paket pekerjaan (digunakan untuk proses pelacakan dan melanjutkan) tersimpan, untuk menghindari pengisian disk. |
| AZCOPY_LOG_LOCATION | Mengambil alih tempat file log disimpan, untuk menghindari pengisian disk. |
| AZCOPY_MSI_CLIENT_ID | ID klien identitas terkelola yang ditetapkan pengguna. Gunakan saat AZCOPY_AUTO_LOGIN_TYPE diatur ke MSI. Lihat Otorisasi tanpa penyimpanan rahasia |
| AZCOPY_MSI_OBJECT_ID | ID objek dari identitas terkelola yang ditetapkan pengguna. Gunakan saat AZCOPY_AUTO_LOGIN_TYPE diatur ke MSI. Lihat Otorisasi tanpa penyimpanan rahasia |
| AZCOPY_MSI_RESOURCE_STRING | ID sumber daya identitas terkelola yang ditetapkan pengguna. Lihat Otorisasi tanpa penyimpanan rahasia |
| AZCOPY_PACE_PAGE_BLOBS | Haruskah throughput untuk blob halaman disesuaikan secara otomatis agar sesuai dengan batas Layanan? Default-nya adalah true. Atur ke 'false' untuk menonaktifkan |
| AZCOPY_PARALLEL_STAT_FILES | Menyebabkan AzCopy mencari properti file pada 'utas' paralel saat pemindaian sistem file lokal. Utas ditarik dari kumpulan yang ditentukan oleh AZCOPY_CONCURRENT_SCAN. Mengatur ini ke true dapat meningkatkan performa pemindaian di Linux. Tidak diperlukan atau direkomendasikan di Windows. |
| AZCOPY_REQUEST_TRY_TIMEOUT | Atur jumlah menit yang harus dicoba AzCopy untuk mengunggah file untuk setiap permintaan sebelum waktu AzCopy habis. |
| AZCOPY_SHOW_PERF_STATES | Jika diatur, ke mana pun, output di layar akan mencakup jumlah gugus menurut status |
| AZCOPY_SPA_APPLICATION_ID | ID aplikasi pendaftaran aplikasi perwakilan layanan Anda. Gunakan saat AZCOPY_AUTO_LOGIN_TYPE diatur ke SPN. Lihat Otorisasi tanpa penyimpanan rahasia |
| AZCOPY_SPA_CERT_PASSWORD | Kata sandi sertifikat. Gunakan saat AZCOPY_AUTO_LOGIN_TYPE diatur ke SPN. Lihat Otorisasi tanpa penyimpanan rahasia |
| AZCOPY_SPA_CERT_PATH | Jalur relatif atau yang sepenuhnya terkualifikasi ke file sertifikat. Gunakan saat AZCOPY_AUTO_LOGIN_TYPE diatur ke SPN. Lihat Otorisasi tanpa penyimpanan rahasia |
| AZCOPY_SPA_CLIENT_SECRET | Rahasia klien. Gunakan saat AZCOPY_AUTO_LOGIN_TYPE diatur ke SPN. Lihat Otorisasi tanpa penyimpanan rahasia |
| AZCOPY_TENANT_ID | ID penyewa Microsoft Entra yang akan digunakan untuk masuk interaktif perangkat OAuth. Variabel ini hanya digunakan untuk log masuk otomatis, silakan gunakan bendera baris perintah sebagai gantinya ketika menggunakan perintah log masuk. |
| AZCOPY_TUNE_TO_CPU | Atur ke false untuk mencegah AzCopy memperhitungkan penggunaan CPU saat menyetel otomatis tingkat konkurensinya (misalnya, dalam perintah tolok ukur). |
| AZCOPY_USER_AGENT_PREFIX | Menambahkan prefiks pada Agen Pengguna AzCopy default, yang digunakan untuk tujuan telemetri. Ruang disisipkan secara otomatis. |
| CPK_ENCRYPTION_KEY | Nilai kunci enkripsi AES-256 yang dikodekan Base64. Variabel ini diperlukan untuk permintaan baca dan tulis saat menggunakan Kunci yang Disediakan Pelanggan untuk mengenkripsi dan mendekripsi data pada operasi penyimpanan Blob. Anda dapat menggunakan Kunci yang Disediakan Pelanggan dengan mengatur --cpk-by-value=true bendera. |
| CPK_ENCRYPTION_KEY_SHA256 | SHA256 yang dikodekan Base64 milik kunci enkripsi. Variabel ini diperlukan untuk permintaan baca dan tulis saat menggunakan Kunci yang Disediakan Pelanggan untuk mengenkripsi dan mendekripsi data pada operasi penyimpanan Blob. Anda dapat menggunakan Kunci yang Disediakan Pelanggan dengan mengatur --cpk-by-value=true bendera. |
| GOOGLE_APPLICATION_CREDENTIALS | Jalur mutlak ke file kunci akun layanan Menyediakan kunci untuk otorisasi dengan Google Cloud Storage. Menyalin data dari Google Cloud Storage ke Azure Storage dengan menggunakan AzCopy (pratinjau) |
| GOOGLE_CLOUD_PROJECT | ID Proyek diperlukan untuk traversal tingkat layanan di Google Cloud Storage. |
| HTTPS_PROXY | Mengonfigurasikan pengaturan proksi untuk AzCopy. Atur variabel ini ke alamat IP proksi dan nomor port proksi. Contohnya, xx.xxx.xx.xxx:xx. Jika Anda menjalankan AzCopy di Windows, AzCopy secara otomatis mendeteksi pengaturan proksi, sehingga Anda tidak perlu menggunakan pengaturan ini di Windows. Jika Anda memilih untuk menggunakan setelan ini di Windows, sehingga akan mengambil alih deteksi otomatis. Lihat Mengonfigurasikan pengaturan proksi |
Mengonfigurasi pengaturan proksi
Untuk mengonfigurasikan pengaturan proksi untuk AzCopy, atur variabel lingkungan HTTPS_PROXY. Jika Anda menjalankan AzCopy di Windows, AzCopy secara otomatis mendeteksi pengaturan proksi, sehingga Anda tidak perlu menggunakan pengaturan ini di Windows. Jika Anda memilih untuk menggunakan setelan ini di Windows, sehingga akan mengambil alih deteksi otomatis.
| Sistem operasi | Perintah |
|---|---|
| Windows | Di perintah gunakan: set HTTPS_PROXY=<proxy IP>:<proxy port>Di PowerShell gunakan: $env:HTTPS_PROXY="<proxy IP>:<proxy port>" |
| Linux | export HTTPS_PROXY=<proxy IP>:<proxy port> |
| macOS | export HTTPS_PROXY=<proxy IP>:<proxy port> |
Saat ini, AzCopy tidak mendukung proksi yang memerlukan autentikasi dengan NTLM atau Kerberos.
Melewati proksi
Jika Anda menjalankan AzCopy di Windows, dan Anda ingin membuatnya untuk tidak menggunakan proksi sama sekali (bukan mendeteksi pengaturan secara otomatis) gunakan perintah ini. Dengan pengaturan ini, AzCopy tidak akan mencari atau mencoba menggunakan proksi mana pun.
| Sistem operasi | Lingkungan | Perintah |
|---|---|---|
| Windows | Perintah (CMD) | set HTTPS_PROXY=dummy.invalid set NO_PROXY=* |
| Windows | PowerShell | $env:HTTPS_PROXY="dummy.invalid" $env:NO_PROXY="*" |
Pada sistem operasi lain, cukup biarkan variabel HTTPS_PROXY tidak ditetapkan jika Anda ingin tidak menggunakan proksi.