Mencantumkan kontainer blob dengan JavaScript atau TypeScript
Saat Anda mencantumkan kontainer di akun Azure Storage dari kode, Anda dapat menentukan beberapa opsi untuk mengelola bagaimana hasil dikembalikan dari Azure Storage. Artikel ini menunjukkan cara mencantumkan kontainer menggunakan Pustaka klien Azure Storage untuk JavaScript.
Prasyarat
- Contoh dalam artikel ini mengasumsikan Anda sudah menyiapkan proyek untuk bekerja dengan pustaka klien Azure Blob Storage untuk JavaScript. Untuk mempelajari tentang menyiapkan proyek Anda, termasuk penginstalan paket, mengimpor modul, dan membuat objek klien resmi untuk bekerja dengan sumber daya data, lihat Mulai menggunakan Azure Blob Storage dan JavaScript.
- Mekanisme otorisasi harus memiliki izin untuk mencantumkan kontainer blob. Untuk mempelajari lebih lanjut, lihat panduan otorisasi untuk operasi REST API berikut:
Tentang opsi daftar kontainer
Saat mencantumkan kontainer dari kode, Anda dapat menentukan opsi untuk mengelola bagaimana hasil dikembalikan dari Azure Storage. Anda dapat menentukan jumlah hasil yang akan dikembalikan di setiap set hasil, lalu mengambil set berikutnya. Anda juga dapat memfilter hasil dengan awalan, dan mengembalikan metadata kontainer dengan hasilnya. Opsi ini dijelaskan di bagian berikut.
Untuk mencantumkan kontainer di akun penyimpanan Anda, panggil metode berikut:
Metode ini mengembalikan daftar objek ContainerItem . Kontainer diurutkan secara leksikografis berdasarkan nama.
Mengelola berapa banyak hasil yang dikembalikan
Secara default, operasi daftar mengembalikan hingga 5000 hasil sekaligus, tetapi Anda dapat menentukan jumlah hasil yang Anda inginkan untuk setiap operasi daftar dikembalikan. Contoh yang disajikan dalam artikel ini memperlihatkan kepada Anda cara mengembalikan hasil di halaman.
Memfilter hasil dengan prefiks
Untuk memfilter daftar kontainer, tentukan string untuk prefix parameter di ServiceListContainersOptions. String awalan dapat menyertakan satu atau lebih karakter. Azure Storage kemudian mengembalikan kontainer yang namanya dimulai dengan prefiks tersebut saja.
Sertakan metadata kontainer
Untuk menyertakan metadata kontainer dengan hasil, atur includeMetadata parameter ke true di ServiceListContainersOptions. Azure Storage menyertakan metadata dengan setiap kontainer yang dikembalikan, sehingga Anda tidak perlu mengambil metadata kontainer secara terpisah.
Sertakan kontainer yang dihapus
Untuk menyertakan kontainer yang dihapus sementara dengan hasilnya, atur includeDeleted parameter di ServiceListContainersOptions.
Contoh kode: Mencantumkan kontainer
Contoh berikut secara asinkron mencantumkan kontainer di akun penyimpanan yang dimulai dengan prefiks yang ditentukan. Contoh tersebut mencantumkan kontainer yang dimulai dengan prefiks yang ditentukan dan mengembalikan jumlah hasil yang ditentukan per panggilan ke operasi listingan. Kemudian menggunakan token kontinuasi untuk mendapatkan segmen hasil berikutnya. Contoh tersebut juga mengembalikan metadata kontainer dengan hasilnya.
async function listContainers(blobServiceClient, containerNamePrefix) {
const options = {
includeDeleted: false,
includeMetadata: true,
includeSystem: true,
prefix: containerNamePrefix
}
console.log("Containers (by page):");
for await (const response of blobServiceClient.listContainers(options).byPage({
maxPageSize: 20,
})) {
console.log("- Page:");
if (response.containerItems) {
for (const container of response.containerItems) {
console.log(` - ${container.name}`);
}
}
}
}
Sumber
Untuk mempelajari selengkapnya tentang mencantumkan kontainer menggunakan pustaka klien Azure Blob Storage untuk JavaScript, lihat sumber daya berikut ini.
Operasi REST API
Azure SDK untuk JavaScript berisi pustaka yang dibangun di atas Azure REST API, memungkinkan Anda berinteraksi dengan operasi REST API melalui paradigma JavaScript yang sudah dikenal. Metode pustaka klien untuk mencantumkan kontainer menggunakan operasi REST API berikut:
- Daftar Kontainer (REST API)
Sampel kode
- Lihat sampel kode JavaScript dan TypeScript dari artikel ini (GitHub)