Mulai cepat: Buat, unduh, dan buat daftar blob dengan Azure CLI
Azure CLI adalah pengalaman baris perintah Azure untuk mengelola sumber daya Azure. Anda dapat menggunakannya di browser Anda dengan Azure Cloud Shell. Anda juga dapat memasangnya di macOS, Linux, atau Windows, dan menjalankannya dari baris perintah. Dalam panduan cepat ini, Anda belajar menggunakan Azure CLI untuk mengunggah dan mengunduh data ke dan dari penyimpanan Azure Blob.
Prasyarat
Untuk mengakses Azure Storage, Anda perlu berlangganan Azure. Jika Anda belum berlangganan, buat akun gratis sebelum memulai.
Semua akses ke Azure Storage dilakukan melalui akun penyimpanan. Untuk mulai cepat ini, Anda dapat membuat akun penyimpanan menggunakan portal Azure, Azure PowerShell, atau Azure CLI. Untuk bantuan membuat akun penyimpanan, lihat Membuat akun penyimpanan.
Persiapkan lingkungan Anda untuk Azure CLI
Gunakan lingkungan Bash di Azure Cloud Shell. Untuk informasi selengkapnya, lihat Mulai Cepat untuk Bash di Azure Cloud Shell.
Jika Anda lebih memilih untuk menjalankan perintah referensi CLI secara lokal, pasang Azure CLI. Jika Anda menjalankan Windows atau macOS, pertimbangkan untuk menjalankan Azure CLI dalam kontainer Docker. Untuk informasi lebih lanjut, lihat Cara menjalankan Azure CLI di kontainer Docker.
Jika Anda menggunakan instalasi lokal, masuk ke Azure CLI dengan menggunakan perintah login az. Untuk menyelesaikan proses autentikasi, ikuti langkah-langkah yang ditampilkan di terminal Anda. Untuk opsi masuk lainnya, lihat Masuk dengan Azure CLI.
Saat Anda diminta, instal ekstensi Azure CLI pada penggunaan pertama. Untuk informasi selengkapnya tentang ekstensi, lihat Menggunakan ekstensi dengan Azure CLI.
Jalankan versi az untuk menemukan versi dan pustaka dependen yang diinstal. Untuk meningkatkan ke versi terbaru, jalankan peningkatan az.
- Artikel ini memerlukan Azure CLI versi 2.0.46 atau versi terbaru. Jika menggunakan Azure Cloud Shell, berarti versi terbaru sudah terpasang.
Izinkan akses ke penyimpanan Blob
Anda dapat memberi izin akses ke penyimpanan Blob dari Azure CLI baik dengan kredensial Azure Active Directory atau dengan kunci akses akun penyimpanan. Disarankan menggunakan kredensial Azure Active Directory. Artikel ini memperlihatkan cara memberi izin operasi penyimpanan Blob menggunakan Azure Active Directory.
Perintah Azure CLI untuk operasi data terhadap penyimpanan Blob mendukung --auth-mode parameter, yang memungkinkan Anda menentukan cara memberi izin operasi tertentu. Atur --auth-mode parameter untuk login diotorisasi dengan kredensial Azure Active Directory. Untuk informasi selengkapnya, lihat Izin akses ke data blob atau antrean dengan Azure CLI.
Hanya operasi data penyimpanan Blob yang mendukung --auth-mode parameter. Operasi manajemen, seperti membuat grup sumber daya atau akun penyimpanan, secara otomatis menggunakan kredensial Azure Active Directory untuk otorisasi.
Untuk memulai, masuk ke akun Azure Anda dengan login az.
az login
Buat grup sumber daya
Buat grup sumber daya Azure dengan perintah pembuatan grupaz. Grup sumber daya adalah kontainer logis yang disebarkan dan dikelola oleh sumber daya Azure.
Ingatlah untuk mengganti nilai tempat penampung dalam tanda kurung sudut dengan nilai Anda sendiri:
az group create \
--name <resource-group> \
--location <location>
Buat akun penyimpanan
Buat akun penyimpanan serbaguna dengan perintah buat akun penyimpanan az. Akun penyimpanan serbaguna dapat digunakan untuk keempat layanan: blob, file, tabel, dan antrean.
Ingatlah untuk mengganti nilai tempat penampung dalam tanda kurung sudut dengan nilai Anda sendiri:
az storage account create \
--name <storage-account> \
--resource-group <resource-group> \
--location <location> \
--sku Standard_ZRS \
--encryption-services blob
Buat kontainer
Blob selalu diunggah ke dalam kontainer. Anda dapat mengatur grup blob dalam kontainer seperti saat Anda mengatur file di komputer dalam folder. Buat kontainer untuk menyimpan blob dengan perintah pembuatan kontainer penyimpanan az.
Contoh berikut menggunakan akun Azure Active Directory Anda untuk mengotorisasi operasi untuk membuat kontainer. Sebelum Anda membuat kontainer, tetapkan peran Kontributor Data Blob Penyimpanan untuk Anda sendiri. Bahkan jika Anda adalah pemilik akun, Anda memerlukan izin eksplisit untuk melakukan operasi data terhadap akun penyimpanan. Untuk informasi selengkapnya tentang penetapan peran Azure, lihat Menetapkan peran Azure untuk akses ke data blob.
Ingatlah untuk mengganti nilai tempat penampung dalam tanda kurung sudut dengan nilai Anda sendiri:
az ad signed-in-user show --query Id -o tsv | az role assignment create \
--role "Storage Blob Data Contributor" \
--assignee @- \
--scope "/subscriptions/<subscription>/resourceGroups/<resource-group>/providers/Microsoft.Storage/storageAccounts/<storage-account>"
az storage container create \
--account-name <storage-account> \
--name <container> \
--auth-mode login
Penting
Penetapan peran Azure mungkin memerlukan waktu beberapa menit untuk disebarluaskan.
Anda juga dapat menggunakan kunci akun penyimpanan untuk mengotorisasi operasi untuk membuat kontainer. Untuk informasi selengkapnya tentang otorisasi operasi data dengan Azure CLI, lihat Mengotorisasi akses ke blob atau data antrean dengan Azure CLI.
Unggah blob
Penyimpanan blob mendukung blob blok, blob penambahan, dan blob halaman. Contoh dalam panduan mulai cepat ini menunjukkan cara kerja dengan blob blok.
Pertama, buat file untuk diunggah ke blob blok. Jika Anda menggunakan Azure Cloud Shell, gunakan perintah berikut untuk membuat file:
vi helloworld
Saat file terbuka, tekan sisipkan. Ketik Hello world, kemudian tekan Esc. Selanjutnya, ketik :x, lalu tekan Enter.
Dalam contoh ini, Anda mengunggah blob ke kontainer yang Anda buat di langkah terakhir menggunakan perintah unggah blob penyimpanan az. Anda tidak perlu menentukan jalur file sejak file dibuat pada direktori akar. Ingatlah untuk mengganti nilai tempat penampung dalam tanda kurung sudut dengan nilai Anda sendiri:
az storage blob upload \
--account-name <storage-account> \
--container-name <container> \
--name myFile.txt \
--file myFile.txt \
--auth-mode login
Operasi ini dapat membuat blob jika belum tersedia, dan menimpanya jika sudah terdapat blob. Unggah file sebanyak yang Anda inginkan sebelum melanjutkan.
Untuk mengunggah beberapa file secara bersamaan, Anda dapat menggunakan perintah upload-batch blob penyimpanan az.
Buat daftar blob dalam kontainer
Buat daftar blob dalam kontainer dengan perintah daftar blob penyimpanan az. Ingatlah untuk mengganti nilai tempat penampung dalam tanda kurung sudut dengan nilai Anda sendiri:
az storage blob list \
--account-name <storage-account> \
--container-name <container> \
--output table \
--auth-mode login
Unduh blob
Gunakan perintah pengunduhan blob penyimpanan az untuk mengunduh blob yang Anda unggah sebelumnya. Ingatlah untuk mengganti nilai tempat penampung dalam tanda kurung sudut dengan nilai Anda sendiri:
az storage blob download \
--account-name <storage-account> \
--container-name <container> \
--name myFile.txt \
--file <~/destination/path/for/file> \
--auth-mode login
Transfer data dengan AzCopy
Utilitas baris perintah AzCopy menawarkan transfer data performa tinggi dan dapat ditulis untuk Azure Storage. Anda dapat menggunakan AzCopy untuk mentransfer data ke dan dari penyimpanan Blob dan Azure Files. Selengkapnya tentang AzCopy v10, azcopy versi terbaru, lihat Mulai menggunakan AzCopy. Untuk mempelajari menggunakan AzCopy v10 dengan penyimpanan Blob, lihat Mentransfer data dengan penyimpanan AzCopy dan Blob.
Contoh berikut menggunakan AzCopy untuk mengunggah file lokal ke blob. Ingatlah untuk mengganti nilai sampel dengan nilai Anda sendiri:
azcopy login
azcopy copy 'C:\myDirectory\myFile.txt' 'https://mystorageaccount.blob.core.windows.net/mycontainer/myFile.txt'
Bersihkan sumber daya
Jika Anda ingin menghapus sumber daya yang Anda buat sebagai bagian dari panduan mulai cepat ini, termasuk akun penyimpanan, hapus grup sumber daya dengan menggunakan perintah hapus grup az. Ingatlah untuk mengganti nilai tempat penampung dalam tanda kurung sudut dengan nilai Anda sendiri:
az group delete \
--name <resource-group> \
--no-wait
Langkah berikutnya
Dalam panduan mulai cepat ini, Anda mempelajari cara mentransfer file antara sistem file lokal dan kontainer di penyimpanan Azure Blob. Untuk mempelajari selengkapnya tentang bekerja dengan penyimpanan Blob menggunakan Azure CLI, pilih opsi di bawah ini.