إنشاء وإدارة عقود إيجار الحاويات باستخدام JavaScript أو TypeScript
توضح هذه المقالة كيفية إنشاء وإدارة عقود إيجار الحاوية باستخدام مكتبة عميل Azure Storage ل JavaScript. يمكنك استخدام مكتبة العميل للحصول على عقود إيجار الحاوية وتجديدها وإصدارها وإيقافها.
المتطلبات الأساسية
- تفترض الأمثلة في هذه المقالة أن لديك بالفعل مشروعا تم إعداده للعمل مع مكتبة عميل Azure Blob Storage ل JavaScript. للتعرف على إعداد مشروعك، بما في ذلك تثبيت الحزمة، واستيراد الوحدات النمطية، وإنشاء كائن عميل معتمد للعمل مع موارد البيانات، راجع بدء استخدام Azure Blob Storage وJavaScript.
- يجب أن يكون لآلية التخويل أذونات للعمل مع عقد تأجير حاوية. لمعرفة المزيد، راجع إرشادات التخويل لعملية REST API التالية:
حول عقود إيجار الحاوية
يقوم عقد الإيجار بإنشاء تأمين على حاوية وإدارتها لعمليات الحذف. يمكن أن تتراوح مدة التأمين من 15 إلى 60 ثانية، أو يمكن أن تكون غير محدودة. يوفر التأجير على حاوية وصول حذف حصري إلى الحاوية. يتحكم تأجير الحاوية فقط في القدرة على حذف الحاوية باستخدام عملية Delete Container REST API. لحذف حاوية ذات عقد إيجار نشط، يجب على العميل تضمين معرف الإيجار النشط مع طلب الحذف. تنجح جميع عمليات الحاوية الأخرى على حاوية مؤجرة دون معرف التأجير. إذا قمت بتمكين الحذف المبدئي للحاوية، يمكنك استعادة الحاويات المحذوفة.
لمعرفة المزيد حول حالات التأجير ومتى يمكنك تنفيذ إجراء معين على عقد إيجار، راجع حالات وإجراءات التأجير.
تتم معالجة عمليات التأجير بواسطة فئة BlobLeaseClient ، والتي توفر عميلا يحتوي على جميع عمليات التأجير للكائنات الثنائية كبيرة الحجم والحاويات. لمعرفة المزيد حول عقود إيجار الكائنات الثنائية كبيرة الحجم باستخدام مكتبة العميل، راجع إنشاء عقود إيجار blob وإدارتها باستخدام JavaScript.
الحصول على عقد إيجار
عند الحصول على عقد تأجير حاوية، يمكنك الحصول على معرف عقد الإيجار الذي يمكن أن تستخدمه التعليمات البرمجية الخاصة بك للعمل على الحاوية. إذا كانت الحاوية تحتوي بالفعل على عقد إيجار نشط، يمكنك فقط طلب عقد إيجار جديد باستخدام معرف التأجير النشط. ومع ذلك، يمكنك تحديد مدة تأجير جديدة.
للحصول على عقد إيجار، أنشئ مثيلا لفئة BlobLeaseClient ، ثم استخدم إحدى الطرق التالية:
يكتسب المثال التالي عقد إيجار لمدة 30 ثانية لحاوية:
async function acquireContainerLeaseAsync(blobContainerClient) {
const leaseClient = blobContainerClient.getBlobLeaseClient();
await leaseClient.acquireLease(30);
return leaseClient;
}
تجديد عقد الإيجار
يمكنك تجديد عقد تأجير حاوية إذا كان معرف التأجير المحدد في الطلب يطابق معرف التأجير المقترن بالحاوية. يمكن تجديد عقد الإيجار حتى إذا انتهت صلاحيته، طالما لم يتم تأجير الحاوية مرة أخرى منذ انتهاء عقد الإيجار هذا. عند تجديد عقد إيجار، يتم إعادة تعيين مدة التأجير.
لتجديد عقد إيجار، استخدم إحدى الطرق التالية على مثيل BlobLeaseClient :
يجدد المثال التالي عقد تأجير الحاوية:
async function renewContainerLeaseAsync(blobContainerClient, leaseID) {
const leaseClient = blobContainerClient.getBlobLeaseClient(leaseID);
await leaseClient.renewLease();
}
الإفراج عن عقد إيجار
يمكنك تحرير عقد تأجير حاوية إذا كان معرف التأجير المحدد في الطلب يطابق معرف التأجير المقترن بالحاوية. يسمح إصدار عقد إيجار لعميل آخر بالحصول على عقد إيجار للحاوية مباشرة بعد اكتمال الإصدار.
يمكنك إصدار عقد تأجير باستخدام إحدى الطرق التالية على مثيل BlobLeaseClient :
يقوم المثال التالي بإصدار عقد تأجير على حاوية:
async function releaseContainerLeaseAsync(blobContainerClient, leaseID) {
const leaseClient = blobContainerClient.getBlobLeaseClient(leaseID);
await leaseClient.releaseLease();
}
إنهاء عقد الإيجار
يمكنك قطع عقد تأجير الحاوية إذا كانت الحاوية لديها عقد إيجار نشط. يمكن لأي طلب مصرح به قطع عقد الإيجار؛ الطلب غير مطلوب لتحديد معرف تأجير مطابق. لا يمكن تجديد عقد الإيجار بعد قطعه، ويمنع قطع عقد الإيجار الحصول على عقد إيجار جديد حتى تنتهي صلاحية عقد الإيجار الأصلي أو يتم تحريره.
يمكنك قطع عقد تأجير باستخدام إحدى الطرق التالية على مثيل BlobLeaseClient :
يكسر المثال التالي عقد إيجار على حاوية:
async function breakContainerLeaseAsync(blobContainerClient) {
const leaseClient = blobContainerClient.getBlobLeaseClient();
await leaseClient.breakLease();
}
حالات الإيجار والإجراءات
يوضح الرسم التخطيطي التالي الحالات الخمس لإيجار، والأوامر أو الأحداث التي تتسبب في تغييرات حالة التأجير.
يسرد الجدول التالي حالات التأجير الخمس، ويعطي وصفا موجزا لكل منها، ويسرد إجراءات التأجير المسموح بها في حالة معينة. تتسبب إجراءات التأجير هذه في انتقالات الحالة، كما هو موضح في الرسم التخطيطي.
| حالة التأجير | الوصف | إجراءات التأجير المسموح بها |
|---|---|---|
| متوفر | عقد الإيجار غير مؤمن ويمكن الحصول عليه. | acquire |
| المؤجره | عقد الإيجار مؤمن. | acquire (معرف التأجير نفسه فقط)، renewو change، و، releaseو break |
| انتهت | انتهت مدة التأجير. | acquireو renewreleaseوbreak |
| كسر | تم قطع عقد الإيجار، ولكن سيستمر تأمين عقد الإيجار حتى انتهاء فترة التوقف. | release وbreak |
| مكسور | تم قطع عقد الإيجار، وانتهاء فترة التوقف. | acquire وrelease وbreak |
عند انتهاء صلاحية عقد الإيجار، يتم الاحتفاظ بمعرف التأجير بواسطة خدمة Blob حتى يتم تعديل الحاوية أو تأجيرها مرة أخرى. قد يحاول العميل تجديد عقد الإيجار أو تحريره باستخدام معرف التأجير منتهية الصلاحية. إذا فشل الطلب، يعرف العميل أن الحاوية قد تم تأجيرها مرة أخرى، أو تم حذف الحاوية منذ آخر نشاط للإيجار.
إذا انتهت صلاحية عقد الإيجار بدلا من إصداره بشكل صريح، فقد يحتاج العميل إلى الانتظار لمدة تصل إلى دقيقة واحدة قبل الحصول على عقد إيجار جديد للحاوية. ومع ذلك، يمكن للعميل تجديد التأجير مع معرف التأجير منتهية الصلاحية على الفور.
الموارد
لمعرفة المزيد حول إدارة عقود إيجار الحاويات باستخدام مكتبة عميل Azure Blob Storage ل JavaScript، راجع الموارد التالية.
نماذج التعليمات البرمجية
- عرض نماذج التعليمات البرمجية JavaScript وTypeScript من هذه المقالة (GitHub)
عمليات واجهة برمجة تطبيقات REST
يحتوي Azure SDK ل JavaScript على مكتبات تستند إلى واجهة برمجة تطبيقات AZURE REST، ما يسمح لك بالتفاعل مع عمليات REST API من خلال نماذج JavaScript المألوفة. تستخدم أساليب مكتبة العميل لإدارة عقود إيجار الحاوية عملية REST API التالية:
موارد مكتبة العميل
(راجع أيضًا )
المحتوى ذو الصلة
- هذه المقالة هي جزء من دليل مطور Blob Storage ل JavaScript/Typescript. لمعرفة المزيد، راجع القائمة الكاملة لمقالات دليل المطور في إنشاء تطبيق JavaScript/Typescript.