مشاركة عبر

إنشاء وإدارة عقود إيجار الكائن الثنائي كبير الحجم باستخدام .NET

  • مقالة

توضح هذه المقالة كيفية إنشاء وإدارة عقود إيجار الكائنات الثنائية كبيرة الحجم باستخدام مكتبة عميل Azure Storage ل .NET. يمكنك استخدام مكتبة العميل للحصول على عقود إيجار الكائن الثنائي كبير الحجم وتجديدها وإصدارها وكسرها.

المتطلبات الأساسية

إعداد بيئتك

إذا لم يكن لديك مشروع موجود، يوضح لك هذا القسم كيفية إعداد مشروع للعمل مع مكتبة عميل Azure Blob Storage ل .NET. تتضمن الخطوات تثبيت الحزمة وإضافة using التوجيهات وإنشاء كائن عميل معتمد. للحصول على التفاصيل، راجع بدء استخدام Azure Blob Storage و.NET.

تثبيت الحزم

من دليل المشروع الخاص بك، قم بتثبيت حزم Azure Blob Storage ومكتبات عميل Azure Identity باستخدام dotnet add package الأمر . حزمة Azure.Identity مطلوبة للاتصالات بدون كلمة مرور بخدمات Azure.

dotnet add package Azure.Storage.Blobs
dotnet add package Azure.Identity

أضف توجيهات using

أضف هذه using التوجيهات إلى أعلى ملف التعليمات البرمجية:

using Azure.Identity;
using Azure.Storage.Blobs;
using Azure.Storage.Blobs.Models;
using Azure.Storage.Blobs.Specialized;

قد تتطلب بعض أمثلة التعليمات البرمجية في هذه المقالة توجيهات إضافية using .

إنشاء كائن عميل

لتوصيل تطبيق ب Blob Storage، قم بإنشاء مثيل BlobServiceClient. يوضح المثال التالي كيفية إنشاء كائن عميل باستخدام DefaultAzureCredential للتخويل:

public BlobServiceClient GetBlobServiceClient(string accountName)
{
    BlobServiceClient client = new(
        new Uri($"https://{accountName}.blob.core.windows.net"),
        new DefaultAzureCredential());

    return client;
}

يمكنك تسجيل عميل خدمة لإدخال التبعية في تطبيق .NET.

يمكنك أيضا إنشاء كائنات العميل لحاويات أو كائنات ثنائية كبيرة الحجم معينة. لمعرفة المزيد حول إنشاء كائنات العميل وإدارتها، راجع إنشاء كائنات العميل التي تتفاعل مع موارد البيانات وإدارتها.

التصريح

يجب أن يكون لآلية التخويل الأذونات اللازمة للعمل مع عقد تأجير كائن ثنائي كبير الحجم. للحصول على تخويل باستخدام معرف Microsoft Entra (مستحسن)، تحتاج إلى دور Azure RBAC المضمن في Storage Blob Data Contributor أو أعلى. لمعرفة المزيد، راجع إرشادات التخويل ل Lease Blob (REST API).

حول عقود إيجار الكائن الثنائي كبير الحجم

يقوم عقد الإيجار بإنشاء وإدارة تأمين على كائن ثنائي كبير الحجم لعمليات الكتابة والحذف. يمكن أن تتراوح مدة التأمين من 15 إلى 60 ثانية، أو يمكن أن تكون غير محدودة. يوفر عقد الإيجار على كائن ثنائي كبير الحجم وصولا حصريا للكتابة والحذف إلى الكائن الثنائي كبير الحجم. للكتابة إلى كائن ثنائي كبير الحجم مع عقد إيجار نشط، يجب أن يتضمن العميل معرف التأجير النشط مع طلب الكتابة.

لمعرفة المزيد حول حالات التأجير ومتى يمكنك تنفيذ إجراء معين على عقد إيجار، راجع حالات وإجراءات التأجير.

يسمح بجميع عمليات الحاوية على حاوية تتضمن الكائنات الثنائية كبيرة الحجم مع عقد إيجار نشط، بما في ذلك حذف الحاوية. لذلك، قد يتم حذف حاوية حتى إذا كانت الكائنات الثنائية كبيرة الحجم داخلها لها عقود إيجار نشطة. استخدم عملية تأجير الحاوية للتحكم في الحقوق لحذف حاوية.

تتم معالجة عمليات التأجير بواسطة فئة BlobLeaseClient ، والتي توفر عميلا يحتوي على جميع عمليات التأجير للكائنات الثنائية كبيرة الحجم والحاويات. لمعرفة المزيد حول عقود إيجار الحاويات باستخدام مكتبة العميل، راجع إنشاء عقود إيجار الحاوية وإدارتها باستخدام .NET.

الحصول على عقد إيجار

عند الحصول على عقد تأجير كائن ثنائي كبير الحجم، تحصل على معرف عقد الإيجار الذي يمكن أن تستخدمه التعليمات البرمجية الخاصة بك للعمل على الكائن الثنائي كبير الحجم. إذا كان الكائن الثنائي كبير الحجم لديه عقد إيجار نشط بالفعل، يمكنك فقط طلب عقد إيجار جديد باستخدام معرف التأجير النشط. ومع ذلك، يمكنك تحديد مدة تأجير جديدة.

للحصول على عقد إيجار، أنشئ مثيلا لفئة BlobLeaseClient ، ثم استخدم إحدى الطرق التالية:

يكتسب المثال التالي عقد إيجار لمدة 30 ثانية لكائن ثنائي كبير الحجم:

public static async Task<BlobLeaseClient> AcquireBlobLeaseAsync(
    BlobClient blobClient)
{
    // Get a BlobLeaseClient object to work with a blob lease
    BlobLeaseClient leaseClient = blobClient.GetBlobLeaseClient();

    Response<BlobLease> response = 
        await leaseClient.AcquireAsync(duration: TimeSpan.FromSeconds(30));

    // Use response.Value to get information about the blob lease

    return leaseClient;
}

تجديد عقد الإيجار

يمكنك تجديد عقد إيجار كائن ثنائي كبير الحجم إذا كان معرف التأجير المحدد في الطلب يطابق معرف التأجير المقترن بالكائن الثنائي كبير الحجم. يمكن تجديد عقد الإيجار حتى إذا انتهت صلاحيته، طالما لم يتم تعديل الكائن الثنائي كبير الحجم أو تأجيره مرة أخرى منذ انتهاء عقد الإيجار هذا. عند تجديد عقد إيجار، يتم إعادة تعيين مدة التأجير.

لتجديد عقد إيجار، استخدم إحدى الطرق التالية على مثيل BlobLeaseClient :

يجدد المثال التالي عقد إيجار لكائن ثنائي كبير الحجم:

public static async Task RenewBlobLeaseAsync(
    BlobClient blobClient,
    string leaseID)
{
    // Get a BlobLeaseClient object to work with a blob lease
    BlobLeaseClient leaseClient = blobClient.GetBlobLeaseClient(leaseID);

    await leaseClient.RenewAsync();
}

الإفراج عن عقد إيجار

يمكنك تحرير عقد تأجير كائن ثنائي كبير الحجم إذا كان معرف التأجير المحدد في الطلب يطابق معرف التأجير المقترن بالكائن الثنائي كبير الحجم. يتيح إصدار عقد إيجار لعميل آخر الحصول على عقد إيجار للكائن الثنائي كبير الحجم مباشرة بعد اكتمال الإصدار.

يمكنك إصدار عقد تأجير باستخدام إحدى الطرق التالية على مثيل BlobLeaseClient :

يصدر المثال التالي عقد تأجير على كائن ثنائي كبير الحجم:

public static async Task ReleaseBlobLeaseAsync(
    BlobClient blobClient,
    string leaseID)
{
    // Get a BlobLeaseClient object to work with a blob lease
    BlobLeaseClient leaseClient = blobClient.GetBlobLeaseClient(leaseID);

    await leaseClient.ReleaseAsync();
}

إنهاء عقد الإيجار

يمكنك قطع عقد تأجير كائن ثنائي كبير الحجم إذا كان للكائن الثنائي كبير الحجم عقد إيجار نشط. يمكن لأي طلب مصرح به قطع عقد الإيجار؛ الطلب غير مطلوب لتحديد معرف تأجير مطابق. لا يمكن تجديد عقد الإيجار بعد قطعه، ويمنع قطع عقد الإيجار الحصول على عقد إيجار جديد لفترة من الوقت حتى تنتهي صلاحية عقد الإيجار الأصلي أو يتم تحريره.

يمكنك قطع عقد تأجير باستخدام إحدى الطرق التالية على مثيل BlobLeaseClient :

يكسر المثال التالي عقد إيجار على كائن ثنائي كبير الحجم:

public static async Task BreakBlobLeaseAsync(
    BlobClient blobClient)
{
    // Get a BlobLeaseClient object to work with a blob lease
    BlobLeaseClient leaseClient = blobClient.GetBlobLeaseClient();

    await leaseClient.BreakAsync();
}

حالات الإيجار والإجراءات

يوضح الرسم التخطيطي التالي الحالات الخمس لإيجار، والأوامر أو الأحداث التي تتسبب في تغييرات حالة التأجير.

رسم تخطيطي يوضح حالات تأجير كائن ثنائي كبير الحجم ومشغلات تغيير الحالة.

يسرد الجدول التالي حالات التأجير الخمس، ويعطي وصفا موجزا لكل منها، ويسرد إجراءات التأجير المسموح بها في حالة معينة. تتسبب إجراءات التأجير هذه في انتقالات الحالة، كما هو موضح في الرسم التخطيطي.

حالة التأجير ‏‏الوصف إجراءات التأجير المسموح بها
متوفر عقد الإيجار غير مؤمن ويمكن الحصول عليه. acquire
المؤجره عقد الإيجار مؤمن. acquire (معرف التأجير نفسه فقط)، renewو change، و، releaseو break
انتهت انتهت مدة التأجير. acquireو renewreleaseوbreak
كسر تم قطع عقد الإيجار، ولكن سيستمر تأمين عقد الإيجار حتى انتهاء فترة التوقف. release وbreak
مكسور تم قطع عقد الإيجار، وانتهاء فترة التوقف. acquire وrelease وbreak

عند انتهاء صلاحية عقد الإيجار، يتم الاحتفاظ بمعرف التأجير بواسطة خدمة Blob حتى يتم تعديل الكائن الثنائي كبير الحجم أو تأجيره مرة أخرى. قد يحاول العميل تجديد عقد الإيجار أو تحريره باستخدام معرف التأجير منتهية الصلاحية. إذا نجحت هذه العملية، يعرف العميل أن الكائن الثنائي كبير الحجم لم يتغير منذ أن كان معرف التأجير آخر صالح. إذا فشل الطلب، يعرف العميل أن الكائن الثنائي كبير الحجم قد تم تعديله، أو تم تأجير الكائن الثنائي كبير الحجم مرة أخرى منذ آخر نشاط للإيجار. يجب على العميل بعد ذلك الحصول على عقد إيجار جديد على الكائن الثنائي كبير الحجم.

إذا انتهت صلاحية عقد الإيجار بدلا من إصداره بشكل صريح، فقد يحتاج العميل إلى الانتظار لمدة دقيقة واحدة قبل الحصول على عقد إيجار جديد للكائن الثنائي كبير الحجم. ومع ذلك، يمكن للعميل تجديد التأجير بمعرف التأجير الخاص به على الفور إذا لم يتم تعديل الكائن الثنائي كبير الحجم.

لا يمكن منح عقد إيجار لقطة كائن ثنائي كبير الحجم، نظرا لأن اللقطات للقراءة فقط. يؤدي طلب عقد تأجير مقابل لقطة إلى رمز 400 (Bad Request)الحالة .

الموارد

لمعرفة المزيد حول إدارة عقود إيجار الكائن الثنائي كبير الحجم باستخدام مكتبة عميل Azure Blob Storage ل .NET، راجع الموارد التالية.

نماذج التعليمات البرمجية

عمليات واجهة برمجة تطبيقات REST

يحتوي Azure SDK ل .NET على مكتبات تستند إلى واجهة برمجة تطبيقات AZURE REST، مما يسمح لك بالتفاعل مع عمليات REST API من خلال نماذج .NET المألوفة. تستخدم أساليب مكتبة العميل لإدارة عقود إيجار الكائن الثنائي كبير الحجم عملية واجهة برمجة تطبيقات REST التالية:

موارد مكتبة العميل

(راجع أيضًا )

المحتوى ذو الصلة

  • هذه المقالة هي جزء من دليل مطور Blob Storage ل .NET. لمعرفة المزيد، راجع القائمة الكاملة لمقالات دليل المطور في إنشاء تطبيق .NET الخاص بك.