Mulai cepat: Membuat, mengunduh, dan mencantumkan blob dengan CLI Azure
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 suka menjalankan perintah referensi CLI secara lokal, instal 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, versi terbaru sudah terinstal.
Izinkan akses ke penyimpanan Blob
Anda dapat mengotorisasi akses ke penyimpanan Blob dari Azure CLI baik dengan kredensial Microsoft Entra atau dengan menggunakan kunci akses akun penyimpanan. Menggunakan kredensial Microsoft Entra disarankan. Artikel ini memperlihatkan cara mengotorisasi operasi penyimpanan Blob menggunakan ID Microsoft Entra.
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 ke login untuk mengotorisasi dengan kredensial Microsoft Entra. 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 Microsoft Entra 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 az storage account create. 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
Membuat 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 az storage container create.
Contoh berikut menggunakan akun Microsoft Entra Anda untuk mengotorisasi operasi untuk membuat kontainer. Sebelum Anda membuat kontainer, tetapkan peran Kontributor Penyimpanan Data Blob 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 hingga lima 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.
Mengunggah 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.
Saat Anda mengunggah blob menggunakan Azure CLI, blob tersebut mengeluarkan panggilan REST API masing-masing melalui protokol http dan https.
Untuk mengunggah beberapa file secara bersamaan, Anda dapat menggunakan perintah upload-batch blob penyimpanan az.
Cantumkan blob di 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
Mengunduh 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 dengan performa tinggi dan dapat ditulis untuk Azure Storage. Anda dapat menggunakan AzCopy untuk mentransfer data ke dan dari penyimpanan Blob dan Azure Files. Untuk informasi selengkapnya tentang AzCopy v10 dan AzCopy versi terbaru, lihat Memulai AzCopy. Untuk mempelajari tentang penggunaan AzCopy v10 dengan penyimpanan Blob, lihat Transfer data dengan penyimpanan AzCopy dan Blob.
Contoh berikut menggunakan AzCopy untuk mengunggah file lokal ke blob. Ganti nilai sampel dengan nilai Anda sendiri:
azcopy login
azcopy copy 'C:\myDirectory\myFile.txt' 'https://mystorageaccount.blob.core.windows.net/mycontainer/myFile.txt'
Membersihkan 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.