Bagikan melalui

Pengaturan konfigurasi AzCopy v10 (Azure Storage)

  • Artikel

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.

Baca juga