BlobLeaseClient الفصل

إنشاء BlobLeaseClient جديد.

يوفر هذا العميل عمليات التأجير على BlobClient أو ContainerClient.

توريث

builtins.object

BlobLeaseClient

الدالمنشئ

BlobLeaseClient(client: BlobClient | ContainerClient, lease_id: str | None = None)

المعلمات

client

BlobClient أو ContainerClient

مطلوب

عميل الكائن الثنائي كبير الحجم أو الحاوية للتأجير.

lease_id

str

القيمة الافتراضية: None

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

المتغيرات

id

str

معرف عقد الإيجار الجاري الاحتفاظ به حاليا. سيكون هذا بلا إذا لم يتم الحصول على عقد إيجار بعد.

etag

str

ETag للإيجار الجاري الاحتفاظ به حاليا. سيكون هذا بلا إذا لم يتم الحصول على عقد إيجار أو تعديله بعد.

last_modified

datetime

آخر طابع زمني تم تعديله لعقد الإيجار الذي يتم الاحتفاظ به حاليا. سيكون هذا بلا إذا لم يتم الحصول على عقد إيجار أو تعديله بعد.

الأساليب

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

acquire

طلب عقد إيجار جديد.

إذا لم يكن للحاوية عقد إيجار نشط، تقوم خدمة Blob بإنشاء عقد إيجار على الحاوية وإرجاع معرف إيجار جديد.

acquire(lease_duration: int = -1, **kwargs: Any) -> None

المعلمات

lease_duration

int

مطلوب

يحدد مدة عقد الإيجار، بالثوان، أو القيمة السالبة (-1) لعقد إيجار لا تنتهي صلاحيته أبدا. يمكن أن يتراوح عقد الإيجار غير اللانهائي بين 15 و60 ثانية. لا يمكن تغيير مدة الإيجار باستخدام التجديد أو التغيير. الافتراضي هو -1 (التأجير اللانهائي).

if_modified_since

datetime

قيمة DateTime. يتوقع Azure أن تكون قيمة التاريخ التي تم تمريرها UTC. إذا تم تضمين المنطقة الزمنية، فسيتم تحويل أي تواريخ غير UTC إلى UTC. إذا تم تمرير تاريخ دون معلومات المنطقة الزمنية، فمن المفترض أن يكون UTC. حدد هذا العنوان لتنفيذ العملية فقط إذا تم تعديل المورد منذ الوقت المحدد.

if_unmodified_since

datetime

قيمة DateTime. يتوقع Azure أن تكون قيمة التاريخ التي تم تمريرها UTC. إذا تم تضمين المنطقة الزمنية، فسيتم تحويل أي تواريخ غير UTC إلى UTC. إذا تم تمرير تاريخ دون معلومات المنطقة الزمنية، فمن المفترض أن يكون UTC. حدد هذا العنوان لتنفيذ العملية فقط إذا لم يتم تعديل المورد منذ التاريخ/الوقت المحدد.

etag

str

قيمة ETag أو حرف البدل (*). يستخدم للتحقق مما إذا كان المورد قد تغير، والعمل وفقا للشرط المحدد بواسطة المعلمة match_condition .

match_condition

MatchConditions

شرط المطابقة لاستخدامه على etag.

if_tags_match_condition

str

حدد عبارة SQL حيث تعمل على علامات الكائن الثنائي كبير الحجم فقط على كائن ثنائي كبير الحجم بقيمة مطابقة. مثل. "\"tagname\"='my tag'"

جديد في الإصدار 12.4.0.

timeout

int

تعيين المهلة من جانب الخادم للعملية بالثوان. لمزيد من التفاصيل، راجع https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. لا يتم تعقب هذه القيمة أو التحقق من صحتها على العميل. لتكوين مهلات الشبكة من جانب العميل، راجع هنا.

نوع الإرجاع

None

break_lease

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

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

break_lease(lease_break_period: int | None = None, **kwargs: Any) -> int

المعلمات

lease_break_period

int

مطلوب

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

if_modified_since

datetime

قيمة DateTime. يتوقع Azure أن تكون قيمة التاريخ التي تم تمريرها UTC. إذا تم تضمين المنطقة الزمنية، فسيتم تحويل أي تواريخ غير UTC إلى UTC. إذا تم تمرير تاريخ دون معلومات المنطقة الزمنية، فمن المفترض أن يكون UTC. حدد هذا العنوان لتنفيذ العملية فقط إذا تم تعديل المورد منذ الوقت المحدد.

if_unmodified_since

datetime

قيمة DateTime. يتوقع Azure أن تكون قيمة التاريخ التي تم تمريرها UTC. إذا تم تضمين المنطقة الزمنية، فسيتم تحويل أي تواريخ غير UTC إلى UTC. إذا تم تمرير تاريخ دون معلومات المنطقة الزمنية، فمن المفترض أن يكون UTC. حدد هذا العنوان لتنفيذ العملية فقط إذا لم يتم تعديل المورد منذ التاريخ/الوقت المحدد.

if_tags_match_condition

str

حدد عبارة SQL حيث تعمل على علامات الكائن الثنائي كبير الحجم فقط على كائن ثنائي كبير الحجم بقيمة مطابقة. مثل. "\"tagname\"='my tag'"

جديد في الإصدار 12.4.0.

timeout

int

تعيين المهلة من جانب الخادم للعملية بالثوان. لمزيد من التفاصيل، راجع https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. لا يتم تعقب هذه القيمة أو التحقق من صحتها على العميل. لتكوين مهلات الشبكة من جانب العميل، راجع هنا.

المرتجعات

الوقت التقريبي المتبقي في فترة التأجير، بالثوان.

نوع الإرجاع

int

change

تغيير معرف عقد الإيجار لعقد إيجار نشط.

change(proposed_lease_id: str, **kwargs: Any) -> None

المعلمات

proposed_lease_id

str

مطلوب

معرف الإيجار المقترح، بتنسيق سلسلة GUID. تقوم خدمة Blob بإرجاع 400 (طلب غير صالح) إذا لم يكن معرف الإيجار المقترح بالتنسيق الصحيح.

if_modified_since

datetime

قيمة DateTime. يتوقع Azure أن تكون قيمة التاريخ التي تم تمريرها UTC. إذا تم تضمين المنطقة الزمنية، فسيتم تحويل أي تواريخ غير UTC إلى UTC. إذا تم تمرير تاريخ دون معلومات المنطقة الزمنية، فمن المفترض أن يكون UTC. حدد هذا العنوان لتنفيذ العملية فقط إذا تم تعديل المورد منذ الوقت المحدد.

if_unmodified_since

datetime

قيمة DateTime. يتوقع Azure أن تكون قيمة التاريخ التي تم تمريرها UTC. إذا تم تضمين المنطقة الزمنية، فسيتم تحويل أي تواريخ غير UTC إلى UTC. إذا تم تمرير تاريخ دون معلومات المنطقة الزمنية، فمن المفترض أن يكون UTC. حدد هذا العنوان لتنفيذ العملية فقط إذا لم يتم تعديل المورد منذ التاريخ/الوقت المحدد.

etag

str

قيمة ETag أو حرف البدل (*). يستخدم للتحقق مما إذا كان المورد قد تغير، والعمل وفقا للشرط المحدد بواسطة المعلمة match_condition .

match_condition

MatchConditions

شرط المطابقة لاستخدامه على etag.

if_tags_match_condition

str

حدد عبارة SQL حيث تعمل على علامات الكائن الثنائي كبير الحجم فقط على كائن ثنائي كبير الحجم بقيمة مطابقة. مثل. "\"tagname\"='my tag'"

جديد في الإصدار 12.4.0.

timeout

int

تعيين المهلة من جانب الخادم للعملية بالثوان. لمزيد من التفاصيل، راجع https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. لا يتم تعقب هذه القيمة أو التحقق من صحتها على العميل. لتكوين مهلات الشبكة من جانب العميل، راجع هنا.

المرتجعات

بلا

release

حرر عقد الإيجار.

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

release(**kwargs: Any) -> None

المعلمات

if_modified_since

datetime

قيمة DateTime. يتوقع Azure أن تكون قيمة التاريخ التي تم تمريرها UTC. إذا تم تضمين المنطقة الزمنية، فسيتم تحويل أي تواريخ غير UTC إلى UTC. إذا تم تمرير تاريخ دون معلومات المنطقة الزمنية، فمن المفترض أن يكون UTC. حدد هذا العنوان لتنفيذ العملية فقط إذا تم تعديل المورد منذ الوقت المحدد.

if_unmodified_since

datetime

قيمة DateTime. يتوقع Azure أن تكون قيمة التاريخ التي تم تمريرها UTC. إذا تم تضمين المنطقة الزمنية، فسيتم تحويل أي تواريخ غير UTC إلى UTC. إذا تم تمرير تاريخ دون معلومات المنطقة الزمنية، فمن المفترض أن يكون UTC. حدد هذا العنوان لتنفيذ العملية فقط إذا لم يتم تعديل المورد منذ التاريخ/الوقت المحدد.

etag

str

قيمة ETag أو حرف البدل (*). يستخدم للتحقق مما إذا كان المورد قد تغير، والعمل وفقا للشرط المحدد بواسطة المعلمة match_condition .

match_condition

MatchConditions

شرط المطابقة لاستخدامه على etag.

if_tags_match_condition

str

حدد عبارة SQL حيث تعمل على علامات الكائن الثنائي كبير الحجم فقط على كائن ثنائي كبير الحجم بقيمة مطابقة. مثل. "\"tagname\"='my tag'"

جديد في الإصدار 12.4.0.

timeout

int

تعيين المهلة من جانب الخادم للعملية بالثوان. لمزيد من التفاصيل، راجع https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. لا يتم تعقب هذه القيمة أو التحقق من صحتها على العميل. لتكوين مهلات الشبكة من جانب العميل، راجع هنا.

المرتجعات

بلا

renew

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

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

renew(**kwargs: Any) -> None

المعلمات

if_modified_since

datetime

قيمة DateTime. يتوقع Azure أن تكون قيمة التاريخ التي تم تمريرها UTC. إذا تم تضمين المنطقة الزمنية، فسيتم تحويل أي تواريخ غير UTC إلى UTC. إذا تم تمرير تاريخ دون معلومات المنطقة الزمنية، فمن المفترض أن يكون UTC. حدد هذا العنوان لتنفيذ العملية فقط إذا تم تعديل المورد منذ الوقت المحدد.

if_unmodified_since

datetime

قيمة DateTime. يتوقع Azure أن تكون قيمة التاريخ التي تم تمريرها UTC. إذا تم تضمين المنطقة الزمنية، فسيتم تحويل أي تواريخ غير UTC إلى UTC. إذا تم تمرير تاريخ دون معلومات المنطقة الزمنية، فمن المفترض أن يكون UTC. حدد هذا العنوان لتنفيذ العملية فقط إذا لم يتم تعديل المورد منذ التاريخ/الوقت المحدد.

etag

str

قيمة ETag أو حرف البدل (*). يستخدم للتحقق مما إذا كان المورد قد تغير، والعمل وفقا للشرط المحدد بواسطة المعلمة match_condition .

match_condition

MatchConditions

شرط المطابقة لاستخدامه على etag.

if_tags_match_condition

str

حدد عبارة SQL حيث تعمل على علامات الكائن الثنائي كبير الحجم فقط على كائن ثنائي كبير الحجم بقيمة مطابقة. مثل. "\"tagname\"='my tag'"

جديد في الإصدار 12.4.0.

timeout

int

تعيين المهلة من جانب الخادم للعملية بالثوان. لمزيد من التفاصيل، راجع https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. لا يتم تعقب هذه القيمة أو التحقق من صحتها على العميل. لتكوين مهلات الشبكة من جانب العميل، راجع هنا.

المرتجعات

بلا