Membuat dan mengelola sewa kontainer dengan JavaScript
Artikel ini memperlihatkan cara membuat dan mengelola sewa kontainer menggunakan pustaka klien Azure Storage untuk JavaScript. Anda dapat menggunakan pustaka klien untuk memperoleh, memperbarui, merilis, dan memutuskan sewa kontainer.
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 bekerja dengan sewa kontainer. Untuk mempelajari lebih lanjut, lihat panduan otorisasi untuk operasi REST API berikut:
Tentang sewa kontainer
Sewa menetapkan dan mengelola kunci pada kontainer untuk operasi penghapusan. Durasi penguncian bisa 15 hingga 60 detik, atau bisa tak terbatas. Sewa pada kontainer menyediakan akses penghapusan eksklusif ke kontainer. Sewa kontainer hanya mengontrol kemampuan untuk menghapus kontainer menggunakan operasi Delete Container REST API. Untuk menghapus kontainer dengan sewa aktif, klien harus menyertakan ID sewa aktif dengan permintaan penghapusan. Semua operasi kontainer lainnya berhasil pada kontainer sewaan tanpa ID sewa. Jika Anda telah mengaktifkan penghapusan sementara kontainer, Anda dapat memulihkan kontainer yang dihapus.
Untuk mempelajari selengkapnya tentang status sewa dan kapan Anda dapat melakukan tindakan tertentu pada sewa, lihat Status sewa dan tindakan.
Operasi sewa ditangani oleh kelas BlobLeaseClient , yang menyediakan klien yang berisi semua operasi sewa untuk blob dan kontainer. Untuk mempelajari selengkapnya tentang sewa blob menggunakan pustaka klien, lihat Membuat dan mengelola sewa blob dengan JavaScript.
Mendapatkan sewa
Ketika Anda memperoleh sewa kontainer, Anda mendapatkan ID sewa yang dapat digunakan kode Anda untuk beroperasi pada kontainer. Jika kontainer sudah memiliki sewa aktif, Anda hanya dapat meminta sewa baru dengan menggunakan ID sewa aktif. Namun, Anda dapat menentukan durasi sewa baru.
Untuk memperoleh sewa, buat instans kelas BlobLeaseClient , lalu gunakan salah satu metode berikut:
Contoh berikut memperoleh sewa 30 detik untuk kontainer:
async function acquireContainerLeaseAsync(blobContainerClient) {
const leaseClient = blobContainerClient.getBlobLeaseClient();
await leaseClient.acquireLease(30);
return leaseClient;
}
Memperpanjang sewa
Anda dapat memperbarui sewa kontainer jika ID sewa yang ditentukan pada permintaan cocok dengan ID sewa yang terkait dengan kontainer. Sewa dapat diperpanjang bahkan jika telah kedaluwarsa, selama kontainer belum disewakan lagi sejak kedaluwarsa sewa tersebut. Saat Anda memperbarui sewa, durasi reset sewa.
Untuk memperbarui sewa, gunakan salah satu metode berikut pada instans BlobLeaseClient :
Contoh berikut memperbarui sewa kontainer:
async function renewContainerLeaseAsync(blobContainerClient, leaseID) {
const leaseClient = blobContainerClient.getBlobLeaseClient(leaseID);
await leaseClient.renewLease();
}
Melepaskan sewa
Anda dapat merilis sewa kontainer jika ID sewa yang ditentukan pada permintaan cocok dengan ID sewa yang terkait dengan kontainer. Melepaskan sewa memungkinkan klien lain untuk memperoleh sewa untuk kontainer segera setelah rilis selesai.
Anda dapat merilis sewa menggunakan salah satu metode berikut pada instans BlobLeaseClient :
Contoh berikut merilis sewa pada kontainer:
async function releaseContainerLeaseAsync(blobContainerClient, leaseID) {
const leaseClient = blobContainerClient.getBlobLeaseClient(leaseID);
await leaseClient.releaseLease();
}
Memutuskan sewa
Anda dapat memutuskan sewa kontainer jika kontainer memiliki sewa aktif. Setiap permintaan yang diotorisasi dapat memutus sewa; permintaan tidak diperlukan untuk menentukan ID sewa yang cocok. Sewa tidak dapat diperbarui setelah rusak, dan melanggar sewa mencegah sewa baru diperoleh sampai sewa asli kedaluwarsa atau dilepaskan.
Anda dapat memutuskan sewa menggunakan salah satu metode berikut pada instans BlobLeaseClient :
Contoh berikut memutus sewa pada kontainer:
async function breakContainerLeaseAsync(blobContainerClient) {
const leaseClient = blobContainerClient.getBlobLeaseClient();
await leaseClient.breakLease();
}
Status dan tindakan sewa
Diagram berikut menunjukkan lima status sewa, dan perintah atau peristiwa yang menyebabkan perubahan status sewa.
Tabel berikut mencantumkan lima status sewa, memberikan deskripsi singkat masing-masing, dan mencantumkan tindakan sewa yang diizinkan dalam status tertentu. Tindakan sewa ini menyebabkan transisi status, seperti yang ditunjukkan dalam diagram.
| status sewa | Deskripsi | Tindakan sewa diizinkan |
|---|---|---|
| Tersedia | Sewa tidak terkunci dan dapat diperoleh. | acquire |
| Disewakan | Sewa dikunci. | acquire (id sewa yang sama saja), renew, , change, releasedan break |
| Kedaluwarsa | Durasi sewa telah kedaluwarsa. | acquire, renew, release, dan break |
| Melanggar | Sewa telah rusak, tetapi sewa akan terus dikunci sampai periode istirahat berakhir. | release dan break |
| Terputus | Sewa telah rusak, dan periode istirahat telah kedaluwarsa. | acquire, release, dan break |
Ketika sewa kedaluwarsa, ID sewa dipertahankan oleh layanan Blob sampai kontainer dimodifikasi atau disewakan lagi. Klien dapat mencoba memperbarui atau melepaskan sewa menggunakan ID sewa yang kedaluwarsa. Jika permintaan gagal, klien tahu bahwa kontainer disewakan lagi, atau kontainer dihapus sejak sewa terakhir aktif.
Jika sewa kedaluwarsa daripada dirilis secara eksplisit, klien mungkin perlu menunggu hingga satu menit sebelum sewa baru dapat diperoleh untuk kontainer. Namun, klien dapat segera memperbarui sewa dengan ID sewa yang kedaluwarsa.
Sumber
Untuk mempelajari selengkapnya tentang mengelola sewa 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 mengelola sewa kontainer menggunakan operasi REST API berikut: