Mulai menggunakan Azure Blob Storage dan JavaScript atau TypeScript

• .NET
• Java
• JavaScript
• Python
• Pergi

Artikel ini memperlihatkan kepada Anda cara menyambungkan ke Azure Blob Storage dengan menggunakan pustaka klien Azure Blob Storage untuk JavaScript. Setelah terhubung, gunakan panduan pengembang untuk mempelajari bagaimana kode Anda dapat beroperasi pada kontainer, blob, dan fitur layanan Blob Storage.

Jika Anda ingin memulai dengan contoh lengkap, lihat panduan memulai cepat pustaka klien untuk JavaScript atau TypeScript.

Referensi API | Paket (npm) | Kode sumber pustaka | Sampel | Berikan umpan balik

Prasyarat

• Langganan Azure - buat akun secara gratis
• Akun penyimpanan Azure - buat akun penyimpanan
• Node.js LTS
• TypeScript, jika berlaku
• Untuk aplikasi klien (browser), Anda memerlukan alat penggabungan.

Menyiapkan proyek Anda

Bagian ini memandu Anda menyiapkan proyek untuk bekerja dengan pustaka klien untuk Azure Blob Storage di JavaScript.

Buka perintah dan navigasikan ke folder proyek Anda. Ubah <project-directory> ke nama folder Anda:

cd <project-directory>

Jika Anda belum memiliki file package.json di direktori Anda, inisialisasi proyek untuk membuat file:

npm init -y

Dari direktori proyek Anda, instal paket untuk pustaka klien Azure Blob Storage dan Azure Identity menggunakan perintah npm install atau yarn add. Paket @azure/identitas diperlukan untuk koneksi tanpa kata sandi ke layanan Azure.

JavaScript

npm install @azure/storage-blob @azure/identity

TypeScript

npm install typescript @azure/storage-blob @azure/identity

Mengotorisasi akses dan menyambungkan ke Blob Storage

Untuk menyambungkan aplikasi ke Blob Storage, buat instans kelas BlobServiceClient . Objek ini adalah titik awal Anda untuk berinteraksi dengan sumber daya data di tingkat akun penyimpanan. Anda dapat menggunakannya untuk mengoperasikan akun penyimpanan dan kontainernya. Anda juga dapat menggunakan klien layanan untuk membuat klien kontainer atau klien blob, tergantung pada sumber daya yang perlu Anda kerjakan.

Untuk mempelajari selengkapnya tentang membuat dan mengelola objek klien, termasuk praktik terbaik, lihat Membuat dan mengelola objek klien yang berinteraksi dengan sumber daya data.

Anda dapat mengotorisasi BlobServiceClient objek dengan menggunakan token otorisasi Microsoft Entra, kunci akses akun, atau tanda tangan akses bersama (SAS). Untuk keamanan yang optimal, Microsoft merekomendasikan penggunaan ID Microsoft Entra dengan identitas terkelola untuk mengotorisasi permintaan terhadap data blob. Untuk informasi selengkapnya, lihat Mengotorisasi akses ke blob menggunakan ID Microsoft Entra.

ID Microsoft Entra (disarankan)

Untuk mengotorisasi dengan ID Microsoft Entra, Anda perlu menggunakan prinsip keamanan. Jenis prinsip keamanan mana yang Anda butuhkan tergantung pada tempat aplikasi Anda berjalan. Gunakan tabel berikut sebagai panduan:

Tempat aplikasi berjalan	Prinsipal keamanan	Panduan
Komputer lokal (pengembangan dan pengujian)	Prinsipal layanan	Untuk mempelajari cara mendaftarkan aplikasi, menyiapkan grup Microsoft Entra, menetapkan peran, dan mengonfigurasi variabel lingkungan, lihat Mengotorisasi akses menggunakan perwakilan layanan pengembang
Komputer lokal (pengembangan dan pengujian)	Identitas pengguna	Untuk mempelajari cara menyiapkan grup Microsoft Entra, menetapkan peran, dan masuk ke Azure, lihat Mengotorisasi akses menggunakan kredensial pengembang
Dipasang dalam Azure	Identitas terkelola	Untuk mempelajari cara mengaktifkan identitas terkelola dan menetapkan peran, lihat Mengotorisasi akses dari aplikasi yang dihosting Azure menggunakan identitas terkelola
Dihosting di luar Azure (misalnya, aplikasi lokal)	Principal layanan	Untuk mempelajari cara mendaftarkan aplikasi, menetapkan peran, dan mengonfigurasi variabel lingkungan, lihat Mengotorisasi akses dari aplikasi lokal menggunakan perwakilan layanan aplikasi

Mengotorisasi akses menggunakan DefaultAzureCredential

Cara mudah dan aman untuk mengotorisasi akses dan terhubung ke Blob Storage adalah dengan mendapatkan token OAuth dengan membuat instans DefaultAzureCredential . Anda kemudian dapat menggunakan kredensial tersebut untuk membuat BlobServiceClient objek.

Contoh berikut membuat BlobServiceClient objek menggunakan DefaultAzureCredential:

const accountName = "<account-name>";
const accountURL = `https://${accountName}.blob.core.windows.net`;
const blobServiceClient = new BlobServiceClient(
  accountURL,
  new DefaultAzureCredential()
);

Contoh kode ini dapat digunakan untuk proyek JavaScript atau TypeScript.

Token SAS

Untuk menggunakan token tanda tangan akses bersama (SAS), tambahkan token ke string URL akun yang dipisahkan oleh pemisah ? . Kemudian, buat objek BlobServiceClient dengan URL.

const accountName = "<account-name>";
const sasToken = "<sas-token>";
const accountURL = `https://${accountName}.blob.core.windows.net?${sasToken}`;
const blobServiceClient = new BlobServiceClient(accountURL);

Contoh kode ini dapat digunakan untuk proyek JavaScript atau TypeScript.

Untuk mempelajari selengkapnya tentang membuat dan mengelola token SAS, lihat artikel berikut ini:

• Berikan akses terbatas ke sumber daya Azure Storage menggunakan tanda tangan akses bersama (SAS)
• Membuat SAS akun dengan JavaScript
• Membuat layanan SAS dengan JavaScript
• Membuat pendelegasian SAS pengguna dengan JavaScript

Catatan

Untuk skenario di mana tanda tangan akses bersama (SAS) digunakan, Microsoft merekomendasikan penggunaan SAS delegasi pengguna. Delegasi SAS pengguna diamankan menggunakan kredensial Microsoft Entra, bukan kunci akun.

Kunci akun

Untuk menggunakan kunci bersama akun penyimpanan, berikan kunci sebagai string dan inisialisasi BlobServiceClient objek.

const credential = new StorageSharedKeyCredential(accountName, accountKey);
const blobServiceClient = new BlobServiceClient(
  `https://${accountName}.blob.core.windows.net`,
  credential
);

Contoh kode ini dapat digunakan untuk proyek JavaScript atau TypeScript.

Anda juga dapat membuat BlobServiceClient objek menggunakan string koneksi.

const blobServiceClient = BlobServiceClient.fromConnectionString(connectionString);

Untuk informasi tentang cara mendapatkan kunci akun dan panduan praktik terbaik untuk mengelola dan mengamankan kunci Anda dengan benar, lihat Mengelola kunci akses akun penyimpanan.

Penting

Kunci akses akun harus digunakan dengan hati-hati. Jika kunci akses akun Anda hilang atau tidak sengaja ditempatkan di lokasi yang tidak aman, layanan Anda mungkin menjadi rentan. Siapa pun yang memiliki kunci akses dapat mengotorisasi permintaan terhadap akun penyimpanan, dan secara efektif memiliki akses ke semua data. DefaultAzureCredential memberikan fitur dan manfaat keamanan yang ditingkatkan dan merupakan pendekatan yang direkomendasikan untuk mengelola otorisasi ke layanan Azure.

Membuat aplikasi Anda

Saat Anda membuat aplikasi untuk bekerja dengan sumber daya data di Azure Blob Storage, kode Anda terutama berinteraksi dengan tiga jenis sumber daya: akun penyimpanan, kontainer, dan blob. Untuk mempelajari selengkapnya tentang jenis sumber daya ini, bagaimana mereka berhubungan satu dengan yang lain, dan bagaimana aplikasi berinteraksi dengan sumber daya, lihat Memahami bagaimana aplikasi berinteraksi dengan sumber daya data Blob Storage.

Panduan berikut menunjukkan kepada Anda cara mengakses data dan melakukan tindakan tertentu menggunakan pustaka klien Azure Storage untuk JavaScript:

Panduan	Deskripsi
Konfigurasi kebijakan pengulangan	Terapkan kebijakan coba lagi untuk operasi klien.
Menyalin blob	Salin blob dari satu lokasi ke lokasi lain.
Membuat kontainer	Buat kontainer blob.
Buat SAS otorisasi pengguna	Buat SAS delegasi pengguna untuk kontainer atau blob.
Membuat dan mengelola sewa blob	Buat dan kelola kunci pada blob.
Membuat dan mengelola sewa kontainer	Membuat dan mengelola kunci pada kontainer.
Menghapus dan memulihkan	Hapus blob dan pulihkan blob yang dihapus lunak.
Menghapus dan memulihkan kontainer	Hapus kontainer dan pulihkan kontainer yang dihapus sementara.
Unduh blob	Unduh blob dengan menggunakan string, aliran, dan jalur file.
Menemukan blob menggunakan tag	Atur dan ambil tag, dan gunakan tag untuk menemukan blob.
Daftar blob	Cantumkan blob dengan cara yang berbeda.
Daftar kontainer	Cantumkan kontainer di akun dan berbagai opsi yang tersedia untuk menyesuaikan pencantuman.
Mengelola properti dan metadata (blob)	Dapatkan dan atur properti dan metadata untuk blob.
Mengelola properti dan metadata (kontainer)	Dapatkan dan atur properti dan metadata untuk kontainer.
Penyetelan performa untuk transfer data	Optimalkan performa untuk operasi transfer data.
Mengatur atau mengubah tingkat akses blob	Atur atau ubah tingkat akses untuk blok blob.
Unggah blob	Pelajari cara mengunggah blob dengan menggunakan string, aliran, jalur file, dan metode lainnya.