Bagikan melalui

Mulai cepat: Membuat, mengunduh, dan mencantumkan 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

  • 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 Mengizinkan 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

Membuat grup sumber daya

Buat grup sumber daya Azure dengan perintah pembuatan grupaz. Grup sumber daya adalah wadah logis di mana sumber daya Azure ditempatkan dan dikelola.

Ingatlah untuk mengganti nilai placeholder dalam tanda kurung sudut dengan nilai Anda sendiri.

az group create \
    --name <resource-group> \
    --location <location>

Buat akun penyimpanan

Buat akun penyimpanan tujuan umum dengan perintah az storage account create . Akun penyimpanan tujuan umum dapat digunakan untuk keempat layanan: blob, file, tabel, dan antrean.

Ingatlah untuk mengganti nilai placeholder 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 sebuah kontainer. Anda dapat mengatur grup blob dalam kontainer yang mirip dengan cara Anda mengatur file di komputer Anda 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 Storage Blob Data Contributor untuk diri Anda sendiri. Bahkan jika Anda adalah pemilik akun, Anda memerlukan izin eksplisit untuk melakukan operasi data terhadap akun penyimpanan. Untuk informasi selengkapnya tentang menetapkan peran Azure, lihat Menetapkan peran Azure untuk akses ke data blob.

Ingatlah untuk mengganti nilai placeholder 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 perlu waktu beberapa menit untuk disebarluaskan.

Anda juga dapat menggunakan kunci akun penyimpanan untuk mengotorisasi operasi untuk membuat kontainer. Untuk informasi selengkapnya tentang mengotorisasi operasi data dengan Azure CLI, lihat Mengotorisasi akses ke data blob atau antrean dengan Azure CLI.

Mengunggah objek data (blob)

Penyimpanan blob mendukung blob blok, blob tambahan, dan blob halaman. Contoh dalam panduan cepat ini menunjukkan cara bekerja dengan blok blob.

Pertama, buat file untuk diunggah ke block blob. Jika Anda menggunakan Azure Cloud Shell, gunakan perintah berikut untuk membuat file:

vi helloworld

Saat file terbuka, tekan sisipkan. Ketik Halo dunia, lalu tekan Esc. Selanjutnya, ketik :x, lalu tekan Enter.

Dalam contoh ini, Anda mengunggah blob ke kontainer yang Anda buat di langkah terakhir menggunakan perintah az storage blob upload . Tidak perlu menentukan jalur file karena file dibuat di direktori akar. Ingatlah untuk mengganti nilai placeholder 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 membuat blob jika belum ada, dan menimpanya jika sudah ada. 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 az storage blob upload-batch .

Daftar blob dalam wadah

Cantumkan blob dalam kontainer dengan perintah az storage blob list . Ingatlah untuk mengganti nilai placeholder 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 sebuah blob

Gunakan perintah az storage blob download untuk mengunduh blob yang Anda unggah sebelumnya. Ingatlah untuk mengganti nilai placeholder 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 mulai cepat ini, termasuk akun penyimpanan, hapus grup sumber daya dengan menggunakan perintah az group delete . Ingatlah untuk mengganti nilai placeholder dalam tanda kurung sudut dengan nilai Anda sendiri.

az group delete \
    --name <resource-group> \
    --no-wait

Langkah berikutnya

Dalam panduan cepat ini, Anda mempelajari cara mentransfer file dari sistem file lokal ke kontainer dalam Azure Blob Storage. Untuk mempelajari selengkapnya tentang bekerja dengan penyimpanan Blob dengan menggunakan Azure CLI, pilih opsi di bawah ini.

Mengelola blob blok dengan Azure CLI

Sampel Azure CLI untuk penyimpanan Blob

  • Last updated on