BlobClient الفصل
عميل للتفاعل مع كائن ثنائي كبير الحجم معين، على الرغم من أن هذا الكائن الثنائي كبير الحجم قد لا يكون موجودا بعد.
لمزيد من التكوين الاختياري، يرجى النقر هنا.
- توريث
-
azure.storage.blob._shared.base_client.StorageAccountHostsMixinBlobClientazure.storage.blob._encryption.StorageEncryptionMixinBlobClient
الدالمنشئ
BlobClient(account_url: str, container_name: str, blob_name: str, snapshot: str | Dict[str, Any] | None = None, credential: str | Dict[str, str] | AzureNamedKeyCredential | AzureSasCredential | TokenCredential | None = None, **kwargs: Any)
المعلمات
- account_url
- str
عنوان URI لحساب التخزين. لإنشاء عميل نظرا ل URI الكامل للكائن الثنائي كبير الحجم، استخدم from_blob_url classmethod.
- blob_name
- str
اسم الكائن الثنائي كبير الحجم الذي يجب التفاعل معه. إذا تم تحديدها، فستتجاوز هذه القيمة قيمة كائن ثنائي كبير الحجم محددة في عنوان URL للكائن الثنائي كبير الحجم.
- snapshot
- str
لقطة الكائن الثنائي كبير الحجم الاختيارية التي يجب العمل عليها. يمكن أن تكون هذه سلسلة معرف اللقطة أو الاستجابة التي تم إرجاعها من create_snapshot.
- credential
بيانات الاعتماد التي يجب المصادقة بها. هذا اختياري إذا كان عنوان URL للحساب يحتوي بالفعل على رمز SAS مميز. يمكن أن تكون القيمة سلسلة رمز SAS المميز أو مثيل AzureSasCredential أو AzureNamedKeyCredential من azure.core.credentials أو مفتاح وصول مشترك للحساب أو مثيل فئة TokenCredentials من azure.identity. إذا كان عنوان URI للمورد يحتوي بالفعل على رمز SAS المميز، فسيتم تجاهل هذا لصالح بيانات اعتماد صريحة
- باستثناء حالة AzureSasCredential، حيث سترفع رموز SAS المميزة المتعارضة ValueError. إذا كنت تستخدم مثيل AzureNamedKeyCredential، يجب أن يكون "الاسم" هو اسم حساب التخزين، ويجب أن يكون "المفتاح" هو مفتاح حساب التخزين.
- api_version
- str
إصدار Storage API لاستخدامه للطلبات. القيمة الافتراضية هي أحدث إصدار خدمة متوافق مع SDK الحالي. قد يؤدي الإعداد إلى إصدار أقدم إلى تقليل توافق الميزات.
جديد في الإصدار 12.2.0.
- secondary_hostname
- str
اسم مضيف نقطة النهاية الثانوية.
- max_block_size
- int
الحد الأقصى لحجم المجموعة لتحميل كائن ثنائي كبير الحجم للكتلة في مجموعات.
الإعدادات الافتراضية هي 4*1024*1024
أو 4 ميغابايت.
- max_single_put_size
- int
إذا كان حجم الكائن الثنائي كبير الحجم أقل من أو يساوي max_single_put_size، فسيتم تحميل الكائن الثنائي كبير الحجم مع طلب http PUT واحد فقط. إذا كان حجم الكائن الثنائي كبير الحجم أكبر من max_single_put_size، فسيتم تحميل الكائن الثنائي كبير الحجم في مجموعات. الإعدادات الافتراضية هي 64*1024*1024
أو 64 ميغابايت.
- min_large_block_upload_threshold
- int
الحد الأدنى لحجم المجموعة المطلوب لاستخدام خوارزمية الذاكرة الفعالة عند تحميل كائن ثنائي كبير الحجم للكتلة. الإعدادات الافتراضية إلى 4*1024*1024
+1.
- use_byte_buffer
- bool
استخدم مخزنا مؤقتا بايت لتحميلات كائن ثنائي كبير الحجم للكتلة. الإعدادات الافتراضية معينة على False.
- max_page_size
- int
الحد الأقصى لحجم المجموعة لتحميل كائن ثنائي كبير الحجم للصفحة. الإعدادات الافتراضية هي 4*1024*1024
أو 4 ميغابايت.
- max_single_get_size
- int
الحد الأقصى لحجم الكائن الثنائي كبير الحجم الذي سيتم تنزيله في مكالمة واحدة، سيتم تنزيل الجزء الذي تم تجاوزه في مجموعات (قد يكون متوازيا). الإعدادات الافتراضية هي 32*1024*1024
أو 32 ميغابايت.
- max_chunk_get_size
- int
الحد الأقصى لحجم المجموعة المستخدمة لتنزيل كائن ثنائي كبير الحجم. الإعدادات الافتراضية هي 4*1024*1024
أو 4 ميغابايت.
- version_id
- str
معلمة معرف الإصدار هي قيمة DateTime مبهمة تحدد، عند وجودها، إصدار الكائن الثنائي كبير الحجم للعمل عليه.
الأساليب
abort_copy |
إجهاض عملية نسخ مستمرة. سيؤدي ذلك إلى ترك كائن ثنائي كبير الحجم الوجهة مع طول صفري وبيانات تعريف كاملة. سيؤدي ذلك إلى ظهور خطأ إذا انتهت عملية النسخ بالفعل. |
acquire_lease |
يطلب عقد إيجار جديد. إذا لم يكن للكائن الثنائي كبير الحجم عقد إيجار نشط، تقوم خدمة Blob بإنشاء عقد إيجار على الكائن الثنائي كبير الحجم وإرجاع عقد إيجار جديد. |
append_block |
تثبيت كتلة جديدة من البيانات إلى نهاية الكائن الثنائي كبير الحجم الموجود للإلحاق. |
append_block_from_url |
إنشاء كتلة جديدة ليتم الالتزام بها كجزء من كائن ثنائي كبير الحجم، حيث تتم قراءة المحتويات من عنوان url المصدر. |
clear_page |
مسح مجموعة من الصفحات. |
close |
هذا الأسلوب هو إغلاق مآخذ التوصيل التي يفتحها العميل. لا يلزم استخدامه عند استخدام مع مدير سياق. |
commit_block_list |
تكتب عملية Commit Block List كائنا ثنائيا كبير الحجم عن طريق تحديد قائمة معرفات الكتلة التي تشكل الكائن الثنائي كبير الحجم. |
create_append_blob |
إنشاء Append Blob جديد. تنشئ هذه العملية كائنا ثنائيا كبير الحجم ملحقا جديدا بطول 0. تتم الكتابة فوق محتوى أي كائن ثنائي كبير الحجم موجود مع كائن ثنائي كبير الحجم للإلحاق الذي تم تهيئته حديثا. لإضافة محتوى إلى الكائن الثنائي كبير الحجم للإلحاق، اتصل بالأسلوب append_block أو append_block_from_url . |
create_page_blob |
إنشاء كائن ثنائي كبير الحجم جديد للصفحة بالحجم المحدد. |
create_snapshot |
إنشاء لقطة للكائن الثنائي كبير الحجم. اللقطة هي نسخة للقراءة فقط من كائن ثنائي كبير الحجم يتم التقاطه في وقت معين. يمكن قراءته أو نسخه أو حذفه، ولكن لا يمكن تعديله. توفر النسخ المطابقة طريقة لعمل نسخة احتياطية من نقطة كما تظهر في لحظة من الزمن. تحتوي لقطة الكائن الثنائي كبير الحجم على نفس اسم الكائن الثنائي كبير الحجم الأساسي الذي يتم أخذ اللقطة منه، مع إلحاق قيمة DateTime للإشارة إلى الوقت الذي تم أخذ اللقطة فيه. |
delete_blob |
وضع علامة على الكائن الثنائي كبير الحجم المحدد للحذف. يتم حذف الكائن الثنائي كبير الحجم لاحقا أثناء تجميع البيانات المهملة. لاحظ أنه لحذف كائن ثنائي كبير الحجم، يجب حذف جميع اللقطات الخاصة به. يمكنك حذف كليهما في نفس الوقت باستخدام عملية delete_blob(). إذا تم تمكين نهج استبقاء حذف للخدمة، فإن هذه العملية تحذف النقطة بشكل مبدئي وتحتفظ بالكائنات الثنائية كبيرة الحجم لعدد محدد من الأيام. بعد عدد الأيام المحدد، تتم إزالة بيانات الكائن الثنائي كبير الحجم من الخدمة أثناء تجميع البيانات المهملة. يمكن الوصول إلى الكائن الثنائي كبير الحجم المحذوف مبدئيا من خلال list_blobs تحديد خيار include=['deleted']. يمكن استعادة الكائن الثنائي كبير الحجم المحذوف مبدئيا باستخدام <xref:azure.storage.blob.undelete> العملية. |
delete_immutability_policy |
تحذف عملية Delete Immutability Policy نهج الثبات على الكائن الثنائي كبير الحجم. جديد في الإصدار 12.10.0: تم تقديم هذه العملية في إصدار واجهة برمجة التطبيقات "2020-10-02". |
download_blob |
تنزيل كائن ثنائي كبير الحجم إلى StorageStreamDownloader. يجب استخدام أسلوب readall() لقراءة كل المحتوى أو يجب استخدام readinto() لتنزيل الكائن الثنائي كبير الحجم في دفق. يؤدي استخدام القطع () إلى إرجاع مكرر يسمح للمستخدم بالتكرار عبر المحتوى في مجموعات. |
exists |
إرجاع True إذا كان هناك كائن ثنائي كبير الحجم مع المعلمات المحددة، وإرجاع False بخلاف ذلك. |
from_blob_url |
إنشاء BlobClient من عنوان url لكائن ثنائي كبير الحجم. لا يدعم هذا عنوان url للكائن الثنائي كبير الحجم المخصص مع '/' في اسم الكائن الثنائي كبير الحجم. |
from_connection_string |
إنشاء BlobClient من سلسلة اتصال. |
get_account_information |
يحصل على معلومات تتعلق بحساب التخزين الذي يوجد فيه الكائن الثنائي كبير الحجم. يمكن أيضا استرداد المعلومات إذا كان لدى المستخدم SAS إلى حاوية أو كائن ثنائي كبير الحجم. تتضمن المفاتيح الموجودة في القاموس الذي تم إرجاعه "sku_name" و"account_kind". |
get_blob_properties |
إرجاع جميع بيانات التعريف المعرفة من قبل المستخدم وخصائص HTTP القياسية وخصائص النظام للكائن الثنائي كبير الحجم. لا يرجع محتوى الكائن الثنائي كبير الحجم. |
get_blob_tags |
تمكن عملية Get Tags المستخدمين من الحصول على علامات على كائن ثنائي كبير الحجم أو إصدار كائن ثنائي كبير الحجم معين أو لقطة. جديد في الإصدار 12.4.0: تم تقديم هذه العملية في إصدار واجهة برمجة التطبيقات "2019-12-12". |
get_block_list |
تسترد عملية Get Block List قائمة الكتل التي تم تحميلها كجزء من كائن ثنائي كبير الحجم للكتلة. |
get_page_range_diff_for_managed_disk |
إرجاع قائمة نطاقات الصفحات الصالحة لقرص أو لقطة مدارة. ملاحظة تتوفر هذه العملية فقط لحسابات القرص المدارة. جديد في الإصدار 12.2.0: تم تقديم هذه العملية في إصدار واجهة برمجة التطبيقات "2019-07-07". |
get_page_ranges |
DEPRECATED: إرجاع قائمة نطاقات الصفحات الصالحة لكائن ثنائي كبير الحجم للصفحة أو لقطة لكائن ثنائي كبير الحجم للصفحة. |
list_page_ranges |
إرجاع قائمة نطاقات الصفحات الصالحة لكائن ثنائي كبير الحجم للصفحة أو لقطة لكائن ثنائي كبير الحجم للصفحة. إذا تم تحديد previous_snapshot ، ستكون النتيجة فرزا للتغييرات بين الكائن الثنائي كبير الحجم الهدف واللقطة السابقة. |
query_blob |
تمكين المستخدمين من تحديد/مشروع على بيانات لقطة كائن ثنائي كبير الحجم/أو كائن ثنائي كبير الحجم من خلال توفير تعبيرات استعلام بسيطة. ترجع هذه العمليات BlobQueryReader، يحتاج المستخدمون إلى استخدام readall() أو readinto() للحصول على بيانات الاستعلام. |
resize_blob |
تغيير حجم كائن ثنائي كبير الحجم للصفحة إلى الحجم المحدد. إذا كانت القيمة المحددة أقل من الحجم الحالي للكائن الثنائي كبير الحجم، فسيتم مسح جميع الصفحات فوق القيمة المحددة. |
seal_append_blob |
تختم عملية Seal الكائن الثنائي كبير الحجم الملحق لجعله للقراءة فقط. جديد في الإصدار 12.4.0. |
set_blob_metadata |
تعيين بيانات التعريف المعرفة من قبل المستخدم للكائن الثنائي كبير الحجم كزوج واحد أو أكثر من أزواج قيمة الاسم. |
set_blob_tags |
تمكن عملية تعيين العلامات المستخدمين من تعيين علامات على كائن ثنائي كبير الحجم أو إصدار كائن ثنائي كبير الحجم محدد، ولكن ليس لقطة. يحل كل استدعاء لهذه العملية محل جميع العلامات الموجودة المرفقة بالكائن الثنائي كبير الحجم. لإزالة جميع العلامات من الكائن الثنائي كبير الحجم، قم باستدعاء هذه العملية دون تعيين علامات. جديد في الإصدار 12.4.0: تم تقديم هذه العملية في إصدار واجهة برمجة التطبيقات "2019-12-12". |
set_http_headers |
تعيين خصائص النظام على الكائن الثنائي كبير الحجم. إذا تم تعيين خاصية واحدة content_settings، فسيتم تجاوز جميع الخصائص. |
set_immutability_policy |
تعين عملية تعيين نهج الثبات نهج الثبات على الكائن الثنائي كبير الحجم. جديد في الإصدار 12.10.0: تم تقديم هذه العملية في إصدار واجهة برمجة التطبيقات "2020-10-02". |
set_legal_hold |
تعين عملية Set Legal Hold تعليقا قانونيا على الكائن الثنائي كبير الحجم. جديد في الإصدار 12.10.0: تم تقديم هذه العملية في إصدار واجهة برمجة التطبيقات "2020-10-02". |
set_premium_page_blob_tier |
تعيين طبقات كائن ثنائي كبير الحجم للصفحة على الكائن الثنائي كبير الحجم. يتم دعم واجهة برمجة التطبيقات هذه فقط لكائنات ثنائية كبيرة الحجم للصفحة على الحسابات المتميزة. |
set_sequence_number |
تعيين رقم تسلسل الكائن الثنائي كبير الحجم. |
set_standard_blob_tier |
تعين هذه العملية الطبقة على كائن ثنائي كبير الحجم للكتلة. تحدد طبقة كائن ثنائي كبير الحجم للكتلة نوع التخزين Hot/Cool/Archive. لا تقوم هذه العملية بتحديث ETag للكائن الثنائي كبير الحجم. |
stage_block |
إنشاء كتلة جديدة ليتم الالتزام بها كجزء من كائن ثنائي كبير الحجم. |
stage_block_from_url |
إنشاء كتلة جديدة ليتم تثبيتها كجزء من كائن ثنائي كبير الحجم حيث تتم قراءة المحتويات من عنوان URL. |
start_copy_from_url |
نسخ كائن ثنائي كبير الحجم من عنوان URL المحدد. ترجع هذه العملية قاموسا يحتوي على copy_statuscopy_id، والذي يمكن استخدامه للتحقق من حالة عملية النسخ أو إجهاضها. سيكون copy_status "ناجحا" إذا اكتملت النسخة بشكل متزامن أو "معلق" إذا تم بدء النسخة بشكل غير متزامن. بالنسبة للنسخ غير المتزامنة، يمكن التحقق من الحالة عن طريق التحقق من get_blob_properties الأسلوب والتحقق من حالة النسخ. قم بتعيين requires_sync إلى True لفرض أن تكون النسخة متزامنة. تنسخ خدمة Blob الكائنات الثنائية كبيرة الحجم على أساس أفضل جهد. قد يكون الكائن الثنائي كبير الحجم المصدر لعملية نسخ كائن ثنائي كبير الحجم للكتلة أو كائن ثنائي كبير الحجم للإلحاق أو كائن ثنائي كبير الحجم للصفحة. إذا كان الكائن الثنائي كبير الحجم في الوجهة موجودة بالفعل، يجب أن يكون من نفس نوع الكائن الثنائي كبير الحجم الموجود في المصدر. سيتم استبدال أي كائن ثنائي كبير الحجم وجهة موجود. لا يمكن تعديل الكائن الثنائي كبير الحجم الوجهة أثناء عملية النسخ قيد التقدم. عند النسخ من كائن ثنائي كبير الحجم للصفحة، تقوم خدمة Blob بإنشاء كائن ثنائي كبير الحجم للصفحة الوجهة لطول الكائن الثنائي كبير الحجم المصدر، يحتوي في البداية على جميع الأصفار. ثم يتم تعداد نطاقات الصفحات المصدر، ويتم نسخ النطاقات غير الفارغة. بالنسبة لكائن ثنائي كبير الحجم للكتلة أو كائن ثنائي كبير الحجم ملحق، تنشئ خدمة Blob كائن ثنائي كبير الحجم ملتزما بطول صفري قبل العودة من هذه العملية. عند النسخ من كائن ثنائي كبير الحجم للكتلة، يتم نسخ جميع الكتل الملتزم بها ومعرفات الكتلة الخاصة بها. لا يتم نسخ الكتل غير الملتزم بها. في نهاية عملية النسخ، سيكون للكائن الثنائي كبير الحجم الوجهة نفس عدد الكتل الملتزم بها مثل المصدر. عند النسخ من كائن ثنائي كبير الحجم للإلحاق، يتم نسخ جميع الكتل الملتزم بها. في نهاية عملية النسخ، سيكون للكائن الثنائي كبير الحجم الوجهة نفس عدد الكتل الملتزم بها مثل المصدر. |
undelete_blob |
استعادة الكائنات الثنائية كبيرة الحجم أو اللقطات المحذوفة مبدئيا. لن تنجح العملية إلا إذا تم استخدامها ضمن عدد الأيام المحدد المحدد في نهج استبقاء الحذف. إذا تم تمكين تعيين إصدار كائن ثنائي كبير الحجم، فلا يمكن استعادة الكائن الثنائي كبير الحجم الأساسي باستخدام هذا الأسلوب. بدلا من ذلك، استخدم start_copy_from_url مع عنوان URL لإصدار الكائن الثنائي كبير الحجم الذي ترغب في ترقيته إلى الإصدار الحالي. |
upload_blob |
إنشاء كائن ثنائي كبير الحجم جديد من مصدر بيانات مع التقسيم التلقائي. |
upload_blob_from_url |
إنشاء كائن ثنائي كبير الحجم جديد للكتلة حيث تتم قراءة محتوى الكائن الثنائي كبير الحجم من عنوان URL معين. تتم الكتابة فوق محتوى كائن ثنائي كبير الحجم موجود باستخدام الكائن الثنائي كبير الحجم الجديد. |
upload_page |
تكتب عملية تحميل الصفحات مجموعة من الصفحات إلى كائن ثنائي كبير الحجم للصفحة. |
upload_pages_from_url |
تكتب عملية تحميل الصفحات مجموعة من الصفحات إلى كائن ثنائي كبير الحجم للصفحة حيث تتم قراءة المحتويات من عنوان URL. |
abort_copy
إجهاض عملية نسخ مستمرة.
سيؤدي ذلك إلى ترك كائن ثنائي كبير الحجم الوجهة مع طول صفري وبيانات تعريف كاملة. سيؤدي ذلك إلى ظهور خطأ إذا انتهت عملية النسخ بالفعل.
abort_copy(copy_id: str | Dict[str, Any] | BlobProperties, **kwargs: Any) -> None
المعلمات
- copy_id
- str أو BlobProperties
عملية النسخ إلى إجهاض. يمكن أن يكون هذا إما سلسلة معرف، أو مثيل BlobProperties.
نوع الإرجاع
acquire_lease
يطلب عقد إيجار جديد.
إذا لم يكن للكائن الثنائي كبير الحجم عقد إيجار نشط، تقوم خدمة Blob بإنشاء عقد إيجار على الكائن الثنائي كبير الحجم وإرجاع عقد إيجار جديد.
acquire_lease(lease_duration: int = -1, lease_id: str | None = None, **kwargs: Any) -> BlobLeaseClient
المعلمات
- lease_duration
- int
يحدد مدة عقد الإيجار، بالثوان، أو القيمة السالبة (-1) لعقد إيجار لا تنتهي صلاحيته أبدا. يمكن أن يتراوح عقد الإيجار غير اللانهائي بين 15 و60 ثانية. لا يمكن تغيير مدة الإيجار باستخدام التجديد أو التغيير. الافتراضي هو -1 (عقد إيجار لا نهائي).
- 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. لا يتم تعقب هذه القيمة أو التحقق من صحتها على العميل. لتكوين مهلات الشبكة من جانب العميل، راجع هنا.
المرتجعات
كائن BlobLeaseClient.
نوع الإرجاع
append_block
تثبيت كتلة جديدة من البيانات إلى نهاية الكائن الثنائي كبير الحجم الموجود للإلحاق.
append_block(data: bytes | str | Iterable[AnyStr] | IO[AnyStr], length: int | None = None, **kwargs) -> Dict[str, str | datetime | int]
المعلمات
محتوى الكتلة. يمكن أن يكون هذا بايت أو نصا أو عنصرا قابلا للتكسير أو كائنا يشبه الملف.
- validate_content
- bool
إذا كان صحيحا، تحسب تجزئة MD5 لمحتوى الكتلة. تتحقق خدمة التخزين من تجزئة المحتوى الذي وصل مع التجزئة التي تم إرسالها. هذا مهم في المقام الأول للكشف عن bitflips على السلك إذا كان استخدام http بدلا من https، كما https (الافتراضي)، سيتم التحقق من صحته بالفعل. لاحظ أن تجزئة MD5 هذه غير مخزنة مع الكائن الثنائي كبير الحجم.
- maxsize_condition
- int
عنوان شرطي اختياري. الحد الأقصى للطول بالبايت المسموح به لكائن ثنائي كبير الحجم للإلحاق. إذا كانت عملية Append Block قد تتسبب في تجاوز الكائن الثنائي كبير الحجم لهذا الحد أو إذا كان حجم الكائن الثنائي كبير الحجم أكبر بالفعل من القيمة المحددة في هذا العنوان، فسيفشل الطلب مع خطأ MaxBlobSizeConditionNotMet (رمز حالة HTTP 412 - فشل الشرط المسبق).
- appendpos_condition
- int
عنوان شرطي اختياري، يستخدم فقط لعملية إلحاق كتلة. رقم يشير إلى إزاحة البايت المراد مقارنتها. لن ينجح إلحاق كتلة إلا إذا كان موضع الإلحاق مساويا لهذا الرقم. إذا لم يكن كذلك، فسيفشل الطلب مع خطأ AppendPositionConditionNotMet (رمز حالة HTTP 412 - فشل الشرط المسبق).
- lease
- BlobLeaseClient أو str
مطلوب إذا كان الكائن الثنائي كبير الحجم لديه عقد إيجار نشط. يمكن أن تكون القيمة كائن BlobLeaseClient أو معرف التأجير كسلسلة.
- 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.
- encoding
- str
الإعدادات الافتراضية ل UTF-8.
تشفير البيانات على جانب الخدمة باستخدام المفتاح المحدد. يجب استخدام المفاتيح التي يوفرها العميل عبر HTTPS. كما يتم توفير مفتاح التشفير نفسه في الطلب، يجب إنشاء اتصال آمن لنقل المفتاح.
- encryption_scope
- str
نطاق تشفير معرف مسبقا يستخدم لتشفير البيانات على الخدمة. يمكن إنشاء نطاق تشفير باستخدام واجهة برمجة تطبيقات الإدارة والإشارة إليه هنا بالاسم. إذا تم تعريف نطاق تشفير افتراضي في الحاوية، فستتجاوزه هذه القيمة إذا تم تكوين نطاق مستوى الحاوية للسماح بالتجاوزات. وإلا سيتم رفع خطأ.
جديد في الإصدار 12.2.0.
- timeout
- int
تعيين المهلة من جانب الخادم للعملية بالثوان. لمزيد من التفاصيل، راجع https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. لا يتم تعقب هذه القيمة أو التحقق من صحتها على العميل. لتكوين مهلات الشبكة من جانب العميل، راجع هنا.
المرتجعات
إملاء الخاصية المحدثة للكائن الثنائي كبير الحجم (Etag، التعديل الأخير، إزاحة الإلحاق، عدد الكتل الملتزم بها).
نوع الإرجاع
append_block_from_url
إنشاء كتلة جديدة ليتم الالتزام بها كجزء من كائن ثنائي كبير الحجم، حيث تتم قراءة المحتويات من عنوان url المصدر.
append_block_from_url(copy_source_url: str, source_offset: int | None = None, source_length: int | None = None, **kwargs) -> Dict[str, str | datetime | int]
المعلمات
- copy_source_url
- str
عنوان URL للبيانات المصدر. يمكن أن يشير إلى أي Azure Blob أو ملف، إما عام أو يحتوي على توقيع وصول مشترك مرفق.
- source_offset
- int
يشير هذا إلى بداية نطاق وحدات البايت (الشاملة) التي يجب أخذها من مصدر النسخ.
- source_content_md5
- bytearray
إذا تم منحها، فستحسب الخدمة تجزئة MD5 لمحتوى الكتلة وتقارن مقابل هذه القيمة.
- maxsize_condition
- int
رأس شرطي اختياري. الحد الأقصى للطول بالبايت المسموح به لكائن ثنائي كبير الحجم للإلحاق. إذا كانت عملية Append Block قد تتسبب في تجاوز الكائن الثنائي كبير الحجم لهذا الحد أو إذا كان حجم الكائن الثنائي كبير الحجم أكبر بالفعل من القيمة المحددة في هذا العنوان، فسيفشل الطلب مع خطأ MaxBlobSizeConditionNotMet (رمز حالة HTTP 412 - فشل الشرط المسبق).
- appendpos_condition
- int
عنوان شرطي اختياري، يستخدم فقط لعملية Append Block. رقم يشير إلى إزاحة البايت للمقارنة. لن ينجح إلحاق كتلة إلا إذا كان موضع الإلحاق مساويا لهذا الرقم. إذا لم يكن كذلك، فسيفشل الطلب مع خطأ AppendPositionConditionNotMet (رمز حالة HTTP 412 - فشل الشرط المسبق).
- lease
- BlobLeaseClient أو str
مطلوب إذا كان الكائن الثنائي كبير الحجم لديه عقد إيجار نشط. يمكن أن تكون القيمة كائن BlobLeaseClient أو معرف التأجير كسلسلة.
- 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.
- source_if_modified_since
- datetime
قيمة DateTime. يتوقع Azure أن تكون قيمة التاريخ التي تم تمريرها UTC. إذا تم تضمين المنطقة الزمنية، فسيتم تحويل أي تواريخ غير UTC إلى UTC. إذا تم تمرير تاريخ بدون معلومات المنطقة الزمنية، فمن المفترض أن يكون UTC. حدد هذا العنوان لتنفيذ العملية فقط إذا تم تعديل المورد المصدر منذ الوقت المحدد.
- source_if_unmodified_since
- datetime
قيمة DateTime. يتوقع Azure أن تكون قيمة التاريخ التي تم تمريرها UTC. إذا تم تضمين المنطقة الزمنية، فسيتم تحويل أي تواريخ غير UTC إلى UTC. إذا تم تمرير تاريخ بدون معلومات المنطقة الزمنية، فمن المفترض أن يكون UTC. حدد هذا العنوان لتنفيذ العملية فقط إذا لم يتم تعديل المورد المصدر منذ التاريخ/الوقت المحدد.
- source_etag
- str
قيمة ETag المصدر، أو حرف البدل (*). يستخدم للتحقق مما إذا كان المورد قد تغير، والعمل وفقا للشرط المحدد بواسطة المعلمة match_condition .
- source_match_condition
- MatchConditions
شرط مطابقة المصدر لاستخدامه على etag.
تشفير البيانات على جانب الخدمة باستخدام المفتاح المحدد. يجب استخدام المفاتيح التي يوفرها العميل عبر HTTPS. كما يتم توفير مفتاح التشفير نفسه في الطلب، يجب إنشاء اتصال آمن لنقل المفتاح.
- encryption_scope
- str
نطاق تشفير معرف مسبقا يستخدم لتشفير البيانات على الخدمة. يمكن إنشاء نطاق تشفير باستخدام واجهة برمجة تطبيقات الإدارة والإشارة إليه هنا بالاسم. إذا تم تعريف نطاق تشفير افتراضي في الحاوية، فستتجاوزه هذه القيمة إذا تم تكوين نطاق مستوى الحاوية للسماح بالتجاوزات. وإلا سيتم رفع خطأ.
جديد في الإصدار 12.2.0.
- timeout
- int
تعيين المهلة من جانب الخادم للعملية بالثوان. لمزيد من التفاصيل، راجع https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. لا يتم تعقب هذه القيمة أو التحقق من صحتها على العميل. لتكوين مهلات الشبكة من جانب العميل، راجع هنا.
- source_authorization
- str
المصادقة ككيان خدمة باستخدام سر العميل للوصول إلى كائن ثنائي كبير الحجم مصدر. تأكد من أن "الحامل" هو بادئة سلسلة source_authorization.
clear_page
مسح مجموعة من الصفحات.
clear_page(offset: int, length: int, **kwargs: Any) -> Dict[str, str | datetime]
المعلمات
- offset
- int
بداية نطاق البايت المراد استخدامه للكتابة إلى مقطع من الكائن الثنائي كبير الحجم. يجب محاذاة الصفحات مع حدود 512 بايت، ويجب أن تكون إزاحة البدء معامل 512 ويجب أن يكون الطول معامل 512.
- length
- int
عدد وحدات البايت التي يجب استخدامها للكتابة إلى مقطع من الكائن الثنائي كبير الحجم. يجب محاذاة الصفحات مع حدود 512 بايت، ويجب أن تكون إزاحة البدء معامل 512 ويجب أن يكون الطول معامل 512.
- lease
- BlobLeaseClient أو str
مطلوب إذا كان الكائن الثنائي كبير الحجم لديه عقد إيجار نشط. يمكن أن تكون القيمة كائن BlobLeaseClient أو معرف التأجير كسلسلة.
- if_sequence_number_lte
- int
إذا كان رقم تسلسل الكائن الثنائي كبير الحجم أقل من القيمة المحددة أو مساويا لها، يستمر الطلب؛ وإلا فإنه يفشل.
- if_sequence_number_lt
- int
إذا كان رقم تسلسل الكائن الثنائي كبير الحجم أقل من القيمة المحددة، يتم متابعة الطلب؛ وإلا فإنه يفشل.
- if_sequence_number_eq
- int
إذا كان رقم تسلسل الكائن الثنائي كبير الحجم مساويا للقيمة المحددة، يتم متابعة الطلب؛ وإلا فإنه يفشل.
- 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.
تشفير البيانات على جانب الخدمة باستخدام المفتاح المحدد. يجب استخدام المفاتيح التي يوفرها العميل عبر HTTPS. نظرا لتوفير مفتاح التشفير نفسه في الطلب، يجب إنشاء اتصال آمن لنقل المفتاح.
- timeout
- int
تعيين المهلة من جانب الخادم للعملية بالثوان. لمزيد من التفاصيل، راجع https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. لا يتم تعقب هذه القيمة أو التحقق من صحتها على العميل. لتكوين مهلات الشبكة من جانب العميل، راجع هنا.
المرتجعات
لوحة الخصائص المحدثة لكائن ثنائي كبير الحجم (Etag وآخر تعديل).
نوع الإرجاع
close
هذا الأسلوب هو إغلاق مآخذ التوصيل التي يفتحها العميل. لا يلزم استخدامه عند استخدام مع مدير سياق.
close()
commit_block_list
تكتب عملية Commit Block List كائنا ثنائيا كبير الحجم عن طريق تحديد قائمة معرفات الكتلة التي تشكل الكائن الثنائي كبير الحجم.
commit_block_list(block_list: List[BlobBlock], content_settings: ContentSettings | None = None, metadata: Dict[str, str] | None = None, **kwargs) -> Dict[str, str | datetime]
المعلمات
- content_settings
- ContentSettings
عنصر ContentSettings المستخدم لتعيين خصائص الكائن الثنائي كبير الحجم. يستخدم لتعيين نوع المحتوى والترميز واللغة والتصرف وmd5 والتحكم في ذاكرة التخزين المؤقت.
أزواج قيمة الاسم المقترنة بكائن ثنائي كبير الحجم كعلامة. العلامات حساسة لحالة الأحرف.
قد تحتوي مجموعة العلامات على 10 علامات على الأكثر. يجب أن تتراوح مفاتيح العلامات بين 1 و128 حرفا، ويجب أن تتراوح قيم العلامات بين 0 و256 حرفا.
يتضمن مفتاح العلامة الصالح وأحرف القيمة ما يلي: أحرف صغيرة وأحرف كبيرة، وأرقام (0-9)، ومسافة ( >>
<<)، بالإضافة إلى (+)، وطرح (-)، ونقطة (.)، وصلابة (/)، وعلامة النقطتين (:)، والتساوي (=)، وتسطير سفلي (_)
جديد في الإصدار 12.4.0.
- lease
- BlobLeaseClient أو str
مطلوب إذا كان الكائن الثنائي كبير الحجم لديه عقد إيجار نشط. يمكن أن تكون القيمة كائن BlobLeaseClient أو معرف الإيجار كسلسلة.
- immutability_policy
- ImmutabilityPolicy
يحدد نهج الثبات لكائن ثنائي كبير الحجم أو لقطة كائن ثنائي كبير الحجم أو إصدار كائن ثنائي كبير الحجم.
جديد في الإصدار 12.10.0: تم تقديم هذا في إصدار واجهة برمجة التطبيقات "2020-10-02".
- legal_hold
- bool
تحديد ما إذا كان يجب تعيين تعليق قانوني على الكائن الثنائي كبير الحجم.
جديد في الإصدار 12.10.0: تم تقديم هذا في إصدار واجهة برمجة التطبيقات "2020-10-02".
- validate_content
- bool
إذا كان صحيحا، تحسب تجزئة MD5 لمحتوى الصفحة. تتحقق خدمة التخزين من تجزئة المحتوى الذي وصل مع التجزئة التي تم إرسالها. هذا مهم في المقام الأول للكشف عن bitflips على السلك إذا كان استخدام http بدلا من https، كما https (الافتراضي)، سيتم التحقق من صحته بالفعل. لاحظ أن تجزئة MD5 هذه غير مخزنة مع الكائن الثنائي كبير الحجم.
- 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 حيث عبارة على علامات الكائن الثنائي كبير الحجم للعمل فقط على الكائن الثنائي كبير الحجم الوجهة بقيمة مطابقة.
جديد في الإصدار 12.4.0.
- standard_blob_tier
- StandardBlobTier
قيمة طبقة كائن ثنائي كبير الحجم قياسية لتعيين الكائن الثنائي كبير الحجم إليها. بالنسبة لهذا الإصدار من المكتبة، ينطبق هذا فقط على حظر الكائنات الثنائية كبيرة الحجم على حسابات التخزين القياسية.
تشفير البيانات على جانب الخدمة باستخدام المفتاح المحدد. يجب استخدام المفاتيح التي يوفرها العميل عبر HTTPS. نظرا لتوفير مفتاح التشفير نفسه في الطلب، يجب إنشاء اتصال آمن لنقل المفتاح.
- encryption_scope
- str
نطاق تشفير محدد مسبقا يستخدم لتشفير البيانات على الخدمة. يمكن إنشاء نطاق تشفير باستخدام Management API والإشارة إليه هنا بالاسم. إذا تم تعريف نطاق تشفير افتراضي في الحاوية، فستتجاوزه هذه القيمة إذا تم تكوين النطاق على مستوى الحاوية للسماح بالتجاوزات. وإلا سيتم رفع خطأ.
جديد في الإصدار 12.2.0.
- timeout
- int
تعيين المهلة من جانب الخادم للعملية بالثوان. لمزيد من التفاصيل، راجع https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. لا يتم تعقب هذه القيمة أو التحقق من صحتها على العميل. لتكوين مهلات الشبكة من جانب العميل، راجع هنا.
المرتجعات
لوحة الخصائص المحدثة لكائن ثنائي كبير الحجم (Etag وآخر تعديل).
نوع الإرجاع
create_append_blob
إنشاء Append Blob جديد. تنشئ هذه العملية كائنا ثنائيا كبير الحجم ملحقا جديدا بطول 0. تتم الكتابة فوق محتوى أي كائن ثنائي كبير الحجم موجود مع كائن ثنائي كبير الحجم للإلحاق الذي تم تهيئته حديثا. لإضافة محتوى إلى الكائن الثنائي كبير الحجم للإلحاق، اتصل بالأسلوب append_block أو append_block_from_url .
create_append_blob(content_settings: ContentSettings | None = None, metadata: Dict[str, str] | None = None, **kwargs: Any) -> Dict[str, str | datetime]
المعلمات
- content_settings
- ContentSettings
عنصر ContentSettings المستخدم لتعيين خصائص الكائن الثنائي كبير الحجم. يستخدم لتعيين نوع المحتوى والترميز واللغة والتصرف وmd5 والتحكم في ذاكرة التخزين المؤقت.
أزواج قيمة الاسم المقترنة بكائن ثنائي كبير الحجم كعلامة. العلامات حساسة لحالة الأحرف.
قد تحتوي مجموعة العلامات على 10 علامات على الأكثر. يجب أن تتراوح مفاتيح العلامات بين 1 و128 حرفا، ويجب أن تتراوح قيم العلامات بين 0 و256 حرفا.
يتضمن مفتاح العلامة الصالح وأحرف القيمة ما يلي: أحرف صغيرة وأحرف كبيرة، وأرقام (0-9)، ومسافة ( >>
<<)، بالإضافة إلى (+)، وطرح (-)، ونقطة (.)، وصلابة (/)، وعلامة النقطتين (:)، والتساوي (=)، وتسطير سفلي (_)
جديد في الإصدار 12.4.0.
- lease
- BlobLeaseClient أو str
مطلوب إذا كان الكائن الثنائي كبير الحجم لديه عقد إيجار نشط. يمكن أن تكون القيمة كائن BlobLeaseClient أو معرف الإيجار كسلسلة.
- immutability_policy
- ImmutabilityPolicy
يحدد نهج الثبات لكائن ثنائي كبير الحجم أو لقطة كائن ثنائي كبير الحجم أو إصدار كائن ثنائي كبير الحجم.
جديد في الإصدار 12.10.0: تم تقديم هذا في إصدار واجهة برمجة التطبيقات "2020-10-02".
- legal_hold
- bool
تحديد ما إذا كان يجب تعيين تعليق قانوني على الكائن الثنائي كبير الحجم.
جديد في الإصدار 12.10.0: تم تقديم هذا في إصدار واجهة برمجة التطبيقات "2020-10-02".
- 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.
تشفير البيانات على جانب الخدمة باستخدام المفتاح المحدد. يجب استخدام المفاتيح التي يوفرها العميل عبر HTTPS. كما يتم توفير مفتاح التشفير نفسه في الطلب، يجب إنشاء اتصال آمن لنقل المفتاح.
- encryption_scope
- str
نطاق تشفير معرف مسبقا يستخدم لتشفير البيانات على الخدمة. يمكن إنشاء نطاق تشفير باستخدام واجهة برمجة تطبيقات الإدارة والإشارة إليه هنا بالاسم. إذا تم تعريف نطاق تشفير افتراضي في الحاوية، فستتجاوزه هذه القيمة إذا تم تكوين نطاق مستوى الحاوية للسماح بالتجاوزات. وإلا سيتم رفع خطأ.
جديد في الإصدار 12.2.0.
- timeout
- int
تعيين المهلة من جانب الخادم للعملية بالثوان. لمزيد من التفاصيل، راجع https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. لا يتم تعقب هذه القيمة أو التحقق من صحتها على العميل. لتكوين مهلات الشبكة من جانب العميل، راجع هنا.
المرتجعات
إملاء الخاصية المحدثة للكائنات الثنائية كبيرة الحجم (Etag وآخر تعديل).
نوع الإرجاع
create_page_blob
إنشاء كائن ثنائي كبير الحجم جديد للصفحة بالحجم المحدد.
create_page_blob(size: int, content_settings: ContentSettings | None = None, metadata: Dict[str, str] | None = None, premium_page_blob_tier: str | PremiumPageBlobTier | None = None, **kwargs) -> Dict[str, str | datetime]
المعلمات
- size
- int
يحدد هذا الحد الأقصى لحجم كائن ثنائي كبير الحجم للصفحة، حتى 1 تيرابايت. يجب محاذاة حجم كائن ثنائي كبير الحجم للصفحة إلى حد 512 بايت.
- content_settings
- ContentSettings
عنصر ContentSettings المستخدم لتعيين خصائص الكائن الثنائي كبير الحجم. يستخدم لتعيين نوع المحتوى والترميز واللغة والتصرف وmd5 والتحكم في ذاكرة التخزين المؤقت.
أزواج الاسم والقيمة المقترنة بالكائنات الثنائية كبيرة الحجم كبيانات تعريف.
- premium_page_blob_tier
- PremiumPageBlobTier
قيمة طبقة كائن ثنائي كبير الحجم للصفحة لتعيين الكائن الثنائي كبير الحجم إليها. يرتبط المستوى بحجم الكائن الثنائي كبير الحجم وعدد عمليات الإدخال والإخراج في الثانية المسموح بها. ينطبق هذا فقط على الكائنات الثنائية كبيرة الحجم للصفحة على حسابات التخزين المتميزة.
أزواج قيمة الاسم المقترنة ب الكائن الثنائي كبير الحجم كعلامة. العلامات حساسة لحالة الأحرف.
قد تحتوي مجموعة العلامات على 10 علامات على الأكثر. يجب أن تتراوح مفاتيح العلامات بين 1 و128 حرفا، ويجب أن تتراوح قيم العلامات بين 0 و256 حرفا.
تتضمن أحرف مفتاح العلامة والقيمة الصالحة: الأحرف الصغيرة والأحرف الكبيرة، والأرقام (0-9)، والمساحة ( >>
<<)، بالإضافة إلى (+)، والطرح (-)، والنقطة (.)، والصلبة (/)، والنقطتين (:)، والتساوي (=)، وتسطير سفلي (_)
جديد في الإصدار 12.4.0.
- sequence_number
- int
فقط لكائنات ثنائية كبيرة الحجم للصفحة. رقم التسلسل هو قيمة يتحكم فيها المستخدم يمكنك استخدامها لتعقب الطلبات. يجب أن تتراوح قيمة رقم التسلسل بين 0 و2^63 - 1.القيمة الافتراضية هي 0.
- lease
- BlobLeaseClient أو str
مطلوب إذا كان الكائن الثنائي كبير الحجم لديه عقد إيجار نشط. يمكن أن تكون القيمة كائن BlobLeaseClient أو معرف التأجير كسلسلة.
- immutability_policy
- ImmutabilityPolicy
يحدد نهج الثبات للكائن الثنائي كبير الحجم أو لقطة كائن ثنائي كبير الحجم أو إصدار كائن ثنائي كبير الحجم.
جديد في الإصدار 12.10.0: تم تقديم هذا في إصدار واجهة برمجة التطبيقات "2020-10-02".
- legal_hold
- bool
تحديد ما إذا كان يجب تعيين تعليق قانوني على الكائن الثنائي كبير الحجم.
جديد في الإصدار 12.10.0: تم تقديم هذا في إصدار واجهة برمجة التطبيقات "2020-10-02".
- 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.
تشفير البيانات على جانب الخدمة باستخدام المفتاح المحدد. يجب استخدام المفاتيح التي يوفرها العميل عبر HTTPS. كما يتم توفير مفتاح التشفير نفسه في الطلب، يجب إنشاء اتصال آمن لنقل المفتاح.
- encryption_scope
- str
نطاق تشفير معرف مسبقا يستخدم لتشفير البيانات على الخدمة. يمكن إنشاء نطاق تشفير باستخدام واجهة برمجة تطبيقات الإدارة والإشارة إليه هنا بالاسم. إذا تم تعريف نطاق تشفير افتراضي في الحاوية، فستتجاوزه هذه القيمة إذا تم تكوين نطاق مستوى الحاوية للسماح بالتجاوزات. وإلا سيتم رفع خطأ.
جديد في الإصدار 12.2.0.
- timeout
- int
تعيين المهلة من جانب الخادم للعملية بالثوان. لمزيد من التفاصيل، راجع https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. لا يتم تعقب هذه القيمة أو التحقق من صحتها على العميل. لتكوين مهلات الشبكة من جانب العميل، راجع هنا.
المرتجعات
إملاء الخاصية المحدثة للكائنات الثنائية كبيرة الحجم (Etag وآخر تعديل).
نوع الإرجاع
create_snapshot
إنشاء لقطة للكائن الثنائي كبير الحجم.
اللقطة هي نسخة للقراءة فقط من كائن ثنائي كبير الحجم يتم التقاطه في وقت معين. يمكن قراءته أو نسخه أو حذفه، ولكن لا يمكن تعديله. توفر النسخ المطابقة طريقة لعمل نسخة احتياطية من نقطة كما تظهر في لحظة من الزمن.
تحتوي لقطة الكائن الثنائي كبير الحجم على نفس اسم الكائن الثنائي كبير الحجم الأساسي الذي يتم أخذ اللقطة منه، مع إلحاق قيمة DateTime للإشارة إلى الوقت الذي تم أخذ اللقطة فيه.
create_snapshot(metadata: Dict[str, str] | None = None, **kwargs: Any) -> Dict[str, str | datetime]
المعلمات
أزواج الاسم والقيمة المقترنة بالكائنات الثنائية كبيرة الحجم كبيانات تعريف.
- 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 حيث تعمل على علامات الكائن الثنائي كبير الحجم فقط على الكائن الثنائي كبير الحجم الوجهة بقيمة مطابقة.
جديد في الإصدار 12.4.0.
- lease
- BlobLeaseClient أو str
مطلوب إذا كان الكائن الثنائي كبير الحجم لديه عقد إيجار نشط. يمكن أن تكون القيمة كائن BlobLeaseClient أو معرف التأجير كسلسلة.
تشفير البيانات على جانب الخدمة باستخدام المفتاح المحدد. يجب استخدام المفاتيح التي يوفرها العميل عبر HTTPS. كما يتم توفير مفتاح التشفير نفسه في الطلب، يجب إنشاء اتصال آمن لنقل المفتاح.
- encryption_scope
- str
نطاق تشفير معرف مسبقا يستخدم لتشفير البيانات على الخدمة. يمكن إنشاء نطاق تشفير باستخدام واجهة برمجة تطبيقات الإدارة والإشارة إليه هنا بالاسم. إذا تم تعريف نطاق تشفير افتراضي في الحاوية، فستتجاوزه هذه القيمة إذا تم تكوين نطاق مستوى الحاوية للسماح بالتجاوزات. وإلا سيتم رفع خطأ.
جديد في الإصدار 12.2.0.
- timeout
- int
تعيين المهلة من جانب الخادم للعملية بالثوان. لمزيد من التفاصيل، راجع https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. لا يتم تعقب هذه القيمة أو التحقق من صحتها على العميل. لتكوين مهلات الشبكة من جانب العميل، راجع هنا.
المرتجعات
تم تحديث الكائنات الثنائية كبيرة الحجم لخاصية (معرف اللقطة، Etag، وآخر تعديل).
نوع الإرجاع
delete_blob
وضع علامة على الكائن الثنائي كبير الحجم المحدد للحذف.
يتم حذف الكائن الثنائي كبير الحجم لاحقا أثناء تجميع البيانات المهملة. لاحظ أنه لحذف كائن ثنائي كبير الحجم، يجب حذف جميع اللقطات الخاصة به. يمكنك حذف كليهما في نفس الوقت باستخدام عملية delete_blob().
إذا تم تمكين نهج استبقاء حذف للخدمة، فإن هذه العملية تحذف النقطة بشكل مبدئي وتحتفظ بالكائنات الثنائية كبيرة الحجم لعدد محدد من الأيام. بعد عدد الأيام المحدد، تتم إزالة بيانات الكائن الثنائي كبير الحجم من الخدمة أثناء تجميع البيانات المهملة. يمكن الوصول إلى الكائن الثنائي كبير الحجم المحذوف مبدئيا من خلال list_blobs تحديد خيار include=['deleted']. يمكن استعادة الكائن الثنائي كبير الحجم المحذوف مبدئيا باستخدام <xref:azure.storage.blob.undelete> العملية.
delete_blob(delete_snapshots: str = None, **kwargs: Any) -> None
المعلمات
- delete_snapshots
- str
مطلوب إذا كان الكائن الثنائي كبير الحجم يحتوي على لقطات مقترنة. تتضمن القيم ما يلي:
"فقط": يحذف لقطات الكائنات الثنائية كبيرة الحجم فقط.
"include": يحذف الكائن الثنائي كبير الحجم مع جميع اللقطات.
- version_id
- str
معلمة معرف الإصدار هي قيمة DateTime مبهمة تحدد، عند وجودها، إصدار الكائن الثنائي كبير الحجم المراد حذفه.
جديد في الإصدار 12.4.0.
تم تقديم وسيطة الكلمة الأساسية هذه في إصدار واجهة برمجة التطبيقات '2019-12-12'.
- lease
- BlobLeaseClient أو str
مطلوب إذا كان الكائن الثنائي كبير الحجم لديه عقد إيجار نشط. إذا تم تحديده، delete_blob ينجح فقط إذا كان عقد إيجار الكائن الثنائي كبير الحجم نشطا ويطابق هذا المعرف. يمكن أن تكون القيمة كائن BlobLeaseClient أو معرف الإيجار كسلسلة.
- 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. لا يتم تعقب هذه القيمة أو التحقق من صحتها على العميل. لتكوين مهلات الشبكة من جانب العميل، راجع هنا.
نوع الإرجاع
delete_immutability_policy
تحذف عملية Delete Immutability Policy نهج الثبات على الكائن الثنائي كبير الحجم.
جديد في الإصدار 12.10.0: تم تقديم هذه العملية في إصدار واجهة برمجة التطبيقات "2020-10-02".
delete_immutability_policy(**kwargs: Any) -> None
المعلمات
- timeout
- int
تعيين المهلة من جانب الخادم للعملية بالثوان. لمزيد من التفاصيل، راجع https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. لا يتم تعقب هذه القيمة أو التحقق من صحتها على العميل. لتكوين مهلات الشبكة من جانب العميل، راجع هنا.
المرتجعات
أزواج القيمة الرئيسية لعلامات الكائن الثنائي كبير الحجم.
نوع الإرجاع
download_blob
تنزيل كائن ثنائي كبير الحجم إلى StorageStreamDownloader. يجب استخدام أسلوب readall() لقراءة كل المحتوى أو يجب استخدام readinto() لتنزيل الكائن الثنائي كبير الحجم في دفق. يؤدي استخدام القطع () إلى إرجاع مكرر يسمح للمستخدم بالتكرار عبر المحتوى في مجموعات.
download_blob(offset: int = None, length: int = None, *, encoding: str, **kwargs) -> StorageStreamDownloader[str]
المعلمات
- offset
- int
بداية نطاق البايت لاستخدامه لتنزيل مقطع من الكائن الثنائي كبير الحجم. يجب تعيين إذا تم توفير الطول.
- length
- int
عدد وحدات البايت المراد قراءتها من الدفق. هذا اختياري، ولكن يجب توفيره للحصول على الأداء الأمثل.
- version_id
- str
معلمة معرف الإصدار هي قيمة DateTime مبهمة تحدد، عند وجودها، إصدار الكائن الثنائي كبير الحجم المراد تنزيله.
جديد في الإصدار 12.4.0.
تم تقديم وسيطة الكلمة الأساسية هذه في إصدار واجهة برمجة التطبيقات '2019-12-12'.
- validate_content
- bool
إذا كان صحيحا، يحسب تجزئة MD5 لكل جزء من الكائن الثنائي كبير الحجم. تتحقق خدمة التخزين من تجزئة المحتوى الذي وصل مع التجزئة التي تم إرسالها. هذا مهم في المقام الأول للكشف عن bitflips على السلك إذا كان استخدام http بدلا من https، كما https (الافتراضي)، سيتم التحقق من صحته بالفعل. لاحظ أن تجزئة MD5 هذه غير مخزنة مع الكائن الثنائي كبير الحجم. لاحظ أيضا أنه إذا تم تمكينها، فلن يتم استخدام خوارزمية التحميل الفعالة للذاكرة لأن حساب تجزئة MD5 يتطلب تخزين كتل كاملة مؤقتا، وبذلك يهزم الغرض من الخوارزمية الفعالة للذاكرة.
- lease
- BlobLeaseClient أو str
مطلوب إذا كان الكائن الثنائي كبير الحجم لديه عقد إيجار نشط. إذا تم تحديده، download_blob ينجح فقط إذا كان عقد إيجار الكائن الثنائي كبير الحجم نشطا ويطابق هذا المعرف. يمكن أن تكون القيمة كائن BlobLeaseClient أو معرف الإيجار كسلسلة.
- 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.
تشفير البيانات على جانب الخدمة باستخدام المفتاح المحدد. يجب استخدام المفاتيح التي يوفرها العميل عبر HTTPS. نظرا لتوفير مفتاح التشفير نفسه في الطلب، يجب إنشاء اتصال آمن لنقل المفتاح.
- max_concurrency
- int
عدد الاتصالات المتوازية التي يجب تنزيلها.
- encoding
- str
الترميز لفك ترميز وحدات البايت التي تم تنزيلها. الافتراضي هو بلا، أي عدم فك التشفير.
رد اتصال لتتبع تقدم التنزيل طويل الأمد. التوقيع هو دالة (الحالية: int، الإجمالي: int) حيث الحالي هو عدد وحدات البايت المنقولة حتى الآن، والإجمالي هو الحجم الإجمالي للتنزيل.
- timeout
- int
تعيين المهلة من جانب الخادم للعملية بالثوان. لمزيد من التفاصيل، راجع https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. لا يتم تعقب هذه القيمة أو التحقق من صحتها على العميل. لتكوين مهلات الشبكة من جانب العميل، راجع هنا. قد يقوم هذا الأسلوب بإجراء مكالمات متعددة إلى الخدمة وسيتم تطبيق المهلة على كل مكالمة على حدة. سيتم تطبيق مكالمات متعددة إلى خدمة Azure والمهلة على كل مكالمة على حدة.
المرتجعات
كائن دفق (StorageStreamDownloader)
نوع الإرجاع
exists
إرجاع True إذا كان هناك كائن ثنائي كبير الحجم مع المعلمات المحددة، وإرجاع False بخلاف ذلك.
exists(**kwargs: Any) -> bool
المعلمات
- version_id
- str
معلمة معرف الإصدار هي قيمة DateTime مبهمة تحدد، عند وجودها، إصدار الكائن الثنائي كبير الحجم للتحقق مما إذا كان موجودا.
- timeout
- int
تعيين المهلة من جانب الخادم للعملية بالثوان. لمزيد من التفاصيل، راجع https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. لا يتم تعقب هذه القيمة أو التحقق من صحتها على العميل. لتكوين مهلات الشبكة من جانب العميل، راجع هنا.
المرتجعات
منطقي
نوع الإرجاع
from_blob_url
إنشاء BlobClient من عنوان url لكائن ثنائي كبير الحجم. لا يدعم هذا عنوان url للكائن الثنائي كبير الحجم المخصص مع '/' في اسم الكائن الثنائي كبير الحجم.
from_blob_url(blob_url: str, credential: str | Dict[str, str] | AzureNamedKeyCredential | AzureSasCredential | TokenCredential | None = None, snapshot: str | Dict[str, Any] | None = None, **kwargs: Any) -> Self
المعلمات
- blob_url
- str
عنوان URL الكامل لنقطة النهاية إلى Blob، بما في ذلك رمز SAS المميز واللقطة إذا تم استخدامها. قد تكون هذه إما نقطة النهاية الأساسية أو نقطة النهاية الثانوية اعتمادا على location_mode الحالية.
- credential
- Optional[Union[str, Dict[str, str], <xref:"AzureNamedKeyCredential">, <xref:"AzureSasCredential">, <xref:"TokenCredential">]] <xref:./>
بيانات الاعتماد التي يجب المصادقة بها. هذا اختياري إذا كان عنوان URL للحساب يحتوي بالفعل على رمز SAS المميز، أو كان سلسلة الاتصال يحتوي بالفعل على قيم مفتاح وصول مشترك. يمكن أن تكون القيمة سلسلة رمز SAS المميز أو مثيل AzureSasCredential أو AzureNamedKeyCredential من azure.core.credentials أو مفتاح وصول مشترك للحساب أو مثيل لفئة TokenCredentials من azure.identity. إذا كان عنوان URI للمورد يحتوي بالفعل على رمز SAS المميز، فسيتم تجاهل هذا لصالح بيانات اعتماد صريحة
- باستثناء حالة AzureSasCredential، حيث سترفع رموز SAS المميزة المتعارضة ValueError. في حالة استخدام مثيل AzureNamedKeyCredential، يجب أن يكون "الاسم" هو اسم حساب التخزين، ويجب أن يكون "المفتاح" هو مفتاح حساب التخزين.
- snapshot
- str
لقطة الكائن الثنائي كبير الحجم الاختيارية التي يجب العمل عليها. يمكن أن تكون هذه سلسلة معرف اللقطة أو الاستجابة التي تم إرجاعها من create_snapshot. إذا تم تحديده، فسيتجاوز هذا اللقطة في عنوان url.
- version_id
- str
معلمة معرف الإصدار هي قيمة DateTime مبهمة تحدد، عند وجودها، إصدار الكائن الثنائي كبير الحجم للعمل عليه.
المرتجعات
عميل كائن ثنائي كبير الحجم.
نوع الإرجاع
from_connection_string
إنشاء BlobClient من سلسلة اتصال.
from_connection_string(conn_str: str, container_name: str, blob_name: str, snapshot: str | Dict[str, Any] | None = None, credential: str | Dict[str, str] | AzureNamedKeyCredential | AzureSasCredential | TokenCredential | None = None, **kwargs: Any) -> Self
المعلمات
- snapshot
- str
لقطة الكائن الثنائي كبير الحجم الاختيارية التي يجب العمل عليها. يمكن أن تكون هذه سلسلة معرف اللقطة أو الاستجابة التي تم إرجاعها من create_snapshot.
- credential
- Optional[Union[str, Dict[str, str], <xref:"AzureNamedKeyCredential">, <xref:"AzureSasCredential">, <xref:"TokenCredential">]] <xref:./>
بيانات الاعتماد التي يجب المصادقة بها. هذا اختياري إذا كان عنوان URL للحساب يحتوي بالفعل على رمز SAS المميز، أو كان سلسلة الاتصال يحتوي بالفعل على قيم مفتاح وصول مشترك. يمكن أن تكون القيمة سلسلة رمز SAS المميز أو مثيل AzureSasCredential أو AzureNamedKeyCredential من azure.core.credentials أو مفتاح وصول مشترك للحساب أو مثيل لفئة TokenCredentials من azure.identity. ستكون لبيانات الاعتماد المقدمة هنا الأسبقية على تلك الموجودة في سلسلة الاتصال. في حالة استخدام مثيل AzureNamedKeyCredential، يجب أن يكون "الاسم" هو اسم حساب التخزين، ويجب أن يكون "المفتاح" هو مفتاح حساب التخزين.
- version_id
- str
معلمة معرف الإصدار هي قيمة DateTime مبهمة تحدد، عند وجودها، إصدار الكائن الثنائي كبير الحجم للعمل عليه.
المرتجعات
عميل كائن ثنائي كبير الحجم.
نوع الإرجاع
get_account_information
يحصل على معلومات تتعلق بحساب التخزين الذي يوجد فيه الكائن الثنائي كبير الحجم.
يمكن أيضا استرداد المعلومات إذا كان لدى المستخدم SAS إلى حاوية أو كائن ثنائي كبير الحجم. تتضمن المفاتيح الموجودة في القاموس الذي تم إرجاعه "sku_name" و"account_kind".
get_account_information(**kwargs: Any) -> Dict[str, str]
المرتجعات
لوحة معلومات الحساب (SKU ونوع الحساب).
نوع الإرجاع
get_blob_properties
إرجاع جميع بيانات التعريف المعرفة من قبل المستخدم وخصائص HTTP القياسية وخصائص النظام للكائن الثنائي كبير الحجم. لا يرجع محتوى الكائن الثنائي كبير الحجم.
get_blob_properties(**kwargs: Any) -> BlobProperties
المعلمات
- lease
- BlobLeaseClient أو str
مطلوب إذا كان الكائن الثنائي كبير الحجم لديه عقد إيجار نشط. يمكن أن تكون القيمة كائن BlobLeaseClient أو معرف التأجير كسلسلة.
- version_id
- str
معلمة معرف الإصدار هي قيمة DateTime مبهمة تحدد، عند وجودها، إصدار الكائن الثنائي كبير الحجم للحصول على الخصائص.
جديد في الإصدار 12.4.0.
تم تقديم وسيطة الكلمة الأساسية هذه في إصدار واجهة برمجة التطبيقات "2019-12-12".
- 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.
تشفير البيانات على جانب الخدمة باستخدام المفتاح المحدد. يجب استخدام المفاتيح التي يوفرها العميل عبر HTTPS. كما يتم توفير مفتاح التشفير نفسه في الطلب، يجب إنشاء اتصال آمن لنقل المفتاح.
- timeout
- int
تعيين المهلة من جانب الخادم للعملية بالثوان. لمزيد من التفاصيل، راجع https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. لا يتم تعقب هذه القيمة أو التحقق من صحتها على العميل. لتكوين مهلات الشبكة من جانب العميل، راجع هنا.
المرتجعات
BlobProperties
نوع الإرجاع
get_blob_tags
تمكن عملية Get Tags المستخدمين من الحصول على علامات على كائن ثنائي كبير الحجم أو إصدار كائن ثنائي كبير الحجم معين أو لقطة.
جديد في الإصدار 12.4.0: تم تقديم هذه العملية في إصدار واجهة برمجة التطبيقات "2019-12-12".
get_blob_tags(**kwargs: Any) -> Dict[str, str]
المعلمات
- version_id
- str
معلمة معرف الإصدار هي قيمة DateTime مبهمة تحدد، عند وجودها، إصدار الكائن الثنائي كبير الحجم لإضافة علامات إليه.
- if_tags_match_condition
- str
حدد عبارة SQL حيث تعمل على علامات الكائن الثنائي كبير الحجم فقط على الكائن الثنائي كبير الحجم الوجهة بقيمة مطابقة.
مثل. "\"tagname\"='my tag'"
- lease
- BlobLeaseClient أو str
مطلوب إذا كان الكائن الثنائي كبير الحجم لديه عقد إيجار نشط. يمكن أن تكون القيمة كائن BlobLeaseClient أو معرف التأجير كسلسلة.
- timeout
- int
تعيين المهلة من جانب الخادم للعملية بالثوان. لمزيد من التفاصيل، راجع https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. لا يتم تعقب هذه القيمة أو التحقق من صحتها على العميل. لتكوين مهلات الشبكة من جانب العميل، راجع هنا.
المرتجعات
أزواج القيمة الرئيسية لعلامات الكائن الثنائي كبير الحجم.
نوع الإرجاع
get_block_list
تسترد عملية Get Block List قائمة الكتل التي تم تحميلها كجزء من كائن ثنائي كبير الحجم للكتلة.
get_block_list(block_list_type: str | None = 'committed', **kwargs: Any) -> Tuple[List[BlobBlock], List[BlobBlock]]
المعلمات
- block_list_type
- str
يحدد ما إذا كنت تريد إرجاع قائمة الكتل الملتزم بها أو قائمة الكتل غير الملتزم بها أو كلتا القائمتين معا. تتضمن القيم المحتملة: "ملتزم" و"غير ملتزم" و"الكل"
- lease
- BlobLeaseClient أو str
مطلوب إذا كان الكائن الثنائي كبير الحجم لديه عقد إيجار نشط. يمكن أن تكون القيمة كائن BlobLeaseClient أو معرف التأجير كسلسلة.
- if_tags_match_condition
- str
حدد عبارة SQL حيث تعمل على علامات الكائن الثنائي كبير الحجم فقط على الكائن الثنائي كبير الحجم الوجهة بقيمة مطابقة.
جديد في الإصدار 12.4.0.
- timeout
- int
تعيين المهلة من جانب الخادم للعملية بالثوان. لمزيد من التفاصيل، راجع https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. لا يتم تعقب هذه القيمة أو التحقق من صحتها على العميل. لتكوين مهلات الشبكة من جانب العميل، راجع هنا.
المرتجعات
مجموعة من قائمتين - كتل ملتزمة وغير ملتزمة
نوع الإرجاع
get_page_range_diff_for_managed_disk
إرجاع قائمة نطاقات الصفحات الصالحة لقرص أو لقطة مدارة.
ملاحظة
تتوفر هذه العملية فقط لحسابات القرص المدارة.
جديد في الإصدار 12.2.0: تم تقديم هذه العملية في إصدار واجهة برمجة التطبيقات "2019-07-07".
get_page_range_diff_for_managed_disk(previous_snapshot_url: str, offset: int | None = None, length: int | None = None, **kwargs) -> Tuple[List[Dict[str, int]], List[Dict[str, int]]]
المعلمات
- previous_snapshot_url
يحدد عنوان URL للقطة سابقة من القرص المدار. ستحتوي الاستجابة فقط على صفحات تم تغييرها بين الكائن الثنائي كبير الحجم الهدف ولقطته السابقة.
- offset
- int
بداية نطاق البايت لاستخدامه للحصول على نطاقات صفحات صالحة. إذا لم يتم إعطاء أي طول، فسيتم البحث في جميع وحدات البايت بعد الإزاحة. يجب محاذاة الصفحات مع حدود 512 بايت، ويجب أن تكون إزاحة البدء معامل 512 ويجب أن يكون الطول معامل 512.
- length
- int
عدد وحدات البايت التي يجب استخدامها للحصول على نطاقات صفحات صالحة. إذا تم إعطاء الطول، يجب توفير الإزاحة. سيرجع هذا النطاق نطاقات صفحات صالحة من بدء الإزاحة إلى الطول المحدد. يجب محاذاة الصفحات مع حدود 512 بايت، ويجب أن تكون إزاحة البدء معامل 512 ويجب أن يكون الطول معامل 512.
- lease
- BlobLeaseClient أو str
مطلوب إذا كان الكائن الثنائي كبير الحجم لديه عقد إيجار نشط. يمكن أن تكون القيمة كائن BlobLeaseClient أو معرف التأجير كسلسلة.
- 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.
- timeout
- int
تعيين المهلة من جانب الخادم للعملية بالثوان. لمزيد من التفاصيل، راجع https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. لا يتم تعقب هذه القيمة أو التحقق من صحتها على العميل. لتكوين مهلات الشبكة من جانب العميل، راجع هنا.
المرتجعات
مجموعة من قائمتين من نطاقات الصفحات كقواميس مع مفاتيح "البدء" و"النهاية". العنصر الأول هو نطاقات صفحات مملوءة، ويتم مسح العنصر الثاني نطاقات الصفحات.
نوع الإرجاع
get_page_ranges
DEPRECATED: إرجاع قائمة نطاقات الصفحات الصالحة لكائن ثنائي كبير الحجم للصفحة أو لقطة لكائن ثنائي كبير الحجم للصفحة.
get_page_ranges(offset: int | None = None, length: int | None = None, previous_snapshot_diff: str | Dict[str, Any] | None = None, **kwargs) -> Tuple[List[Dict[str, int]], List[Dict[str, int]]]
المعلمات
- offset
- int
بداية نطاق البايت لاستخدامه للحصول على نطاقات صفحات صالحة. إذا لم يتم إعطاء أي طول، فسيتم البحث في جميع وحدات البايت بعد الإزاحة. يجب محاذاة الصفحات مع حدود 512 بايت، ويجب أن تكون إزاحة البدء معامل 512 ويجب أن يكون الطول معامل 512.
- length
- int
عدد وحدات البايت التي يجب استخدامها للحصول على نطاقات صفحات صالحة. إذا تم إعطاء الطول، يجب توفير الإزاحة. سيرجع هذا النطاق نطاقات صفحات صالحة من بدء الإزاحة إلى الطول المحدد. يجب محاذاة الصفحات مع حدود 512 بايت، ويجب أن تكون إزاحة البدء معامل 512 ويجب أن يكون الطول معامل 512.
- previous_snapshot_diff
- str
معلمة شم اللقطة التي تحتوي على قيمة DateTime مبهمة تحدد لقطة كائن ثنائي كبير الحجم سابقة ليتم مقارنتها مقابل لقطة أحدث أو الكائن الثنائي كبير الحجم الحالي.
- lease
- BlobLeaseClient أو str
مطلوب إذا كان الكائن الثنائي كبير الحجم لديه عقد إيجار نشط. يمكن أن تكون القيمة كائن BlobLeaseClient أو معرف التأجير كسلسلة.
- 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. لا يتم تعقب هذه القيمة أو التحقق من صحتها على العميل. لتكوين مهلات الشبكة من جانب العميل، راجع هنا.
المرتجعات
مجموعة من قائمتين من نطاقات الصفحات كقواميس مع مفاتيح "البدء" و"النهاية". العنصر الأول هو نطاقات صفحات مملوءة، ويتم مسح العنصر الثاني نطاقات الصفحات.
نوع الإرجاع
list_page_ranges
إرجاع قائمة نطاقات الصفحات الصالحة لكائن ثنائي كبير الحجم للصفحة أو لقطة لكائن ثنائي كبير الحجم للصفحة. إذا تم تحديد previous_snapshot ، ستكون النتيجة فرزا للتغييرات بين الكائن الثنائي كبير الحجم الهدف واللقطة السابقة.
list_page_ranges(*, offset: int | None = None, length: int | None = None, previous_snapshot: str | Dict[str, Any] | None = None, **kwargs: Any) -> ItemPaged[PageRange]
المعلمات
- offset
- int
بداية نطاق البايت لاستخدامه للحصول على نطاقات صفحات صالحة. إذا لم يتم إعطاء أي طول، فسيتم البحث في جميع وحدات البايت بعد الإزاحة. يجب محاذاة الصفحات مع حدود 512 بايت، ويجب أن تكون إزاحة البدء معامل 512 ويجب أن يكون الطول معامل 512.
- length
- int
عدد وحدات البايت التي يجب استخدامها للحصول على نطاقات صفحات صالحة. إذا تم إعطاء الطول، يجب توفير الإزاحة. سيرجع هذا النطاق نطاقات صفحات صالحة من بدء الإزاحة إلى الطول المحدد. يجب محاذاة الصفحات مع حدود 512 بايت، ويجب أن تكون إزاحة البدء معامل 512 ويجب أن يكون الطول معامل 512.
قيمة لقطة تحدد أن الاستجابة ستحتوي فقط على الصفحات التي تم تغييرها بين الكائن الثنائي كبير الحجم الهدف واللقطة السابقة. تتضمن الصفحات التي تم تغييرها كلا من الصفحات المحدثة والملغاة. قد يكون الكائن الثنائي كبير الحجم الهدف لقطة، طالما أن اللقطة المحددة بواسطة previous_snapshot هي الأقدم من الاثنين.
- lease
- BlobLeaseClient أو str
مطلوب إذا كان الكائن الثنائي كبير الحجم لديه عقد إيجار نشط. يمكن أن تكون القيمة كائن BlobLeaseClient أو معرف التأجير كسلسلة.
- 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.
- results_per_page
- int
الحد الأقصى لعدد نطاقات الصفحات المراد استردادها لكل استدعاء API.
- timeout
- int
تعيين المهلة من جانب الخادم للعملية بالثوان. لمزيد من التفاصيل، راجع https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. لا يتم تعقب هذه القيمة أو التحقق من صحتها على العميل. لتكوين مهلات الشبكة من جانب العميل، راجع هنا.
المرتجعات
قابل للتكبير (ترحيل تلقائي) ل PageRange.
نوع الإرجاع
query_blob
تمكين المستخدمين من تحديد/مشروع على بيانات لقطة كائن ثنائي كبير الحجم/أو كائن ثنائي كبير الحجم من خلال توفير تعبيرات استعلام بسيطة. ترجع هذه العمليات BlobQueryReader، يحتاج المستخدمون إلى استخدام readall() أو readinto() للحصول على بيانات الاستعلام.
query_blob(query_expression: str, **kwargs: Any) -> BlobQueryReader
المعلمات
- query_expression
- str
مطلوب عبارة استعلام. لمزيد من التفاصيل، راجع https://learn.microsoft.com/azure/storage/blobs/query-acceleration-sql-reference.
- on_error
- Callable[BlobQueryError]
دالة ليتم استدعاؤها على أي أخطاء معالجة يتم إرجاعها بواسطة الخدمة.
- blob_format
- DelimitedTextDialect أو DelimitedJsonDialect أو QuickQueryDialect أو str
اختياري. يحدد تسلسل البيانات المخزنة حاليا في الكائن الثنائي كبير الحجم. الافتراضي هو التعامل مع بيانات الكائن الثنائي كبير الحجم على أنها بيانات CSV منسقة باللهجة الافتراضية. يمكن تجاوز هذا باستخدام DelimitedTextDialect مخصص، أو DelimitedJsonDialect أو "ParquetDialect" (تم تمريره كسلسلة أو قائمة تعداد). يمكن تمرير هذه اللهجات عبر الفئات الخاصة بها، أو قائمة تعداد QuickQueryDialect أو كسلسلة
- output_format
- DelimitedTextDialect أو DelimitedJsonDialect أو list[ArrowDialect] أو QuickQueryDialect أو str
اختياري. يحدد تسلسل الإخراج لتدفق البيانات. بشكل افتراضي، سيتم إرجاع البيانات كما يتم تمثيلها في الكائن الثنائي كبير الحجم (تنسيقات Parquet الافتراضية إلى DelimitedTextDialect). من خلال توفير تنسيق إخراج، ستتم إعادة تنسيق بيانات الكائن الثنائي كبير الحجم وفقا لملف التعريف هذا. يمكن أن تكون هذه القيمة محددةTextDialect أو DelimitedJsonDialect أو ArrowDialect. يمكن تمرير هذه اللهجات عبر الفئات الخاصة بها، أو قائمة تعداد QuickQueryDialect أو كسلسلة
- lease
- BlobLeaseClient أو str
مطلوب إذا كان الكائن الثنائي كبير الحجم لديه عقد إيجار نشط. يمكن أن تكون القيمة كائن BlobLeaseClient أو معرف التأجير كسلسلة.
- 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.
تشفير البيانات على جانب الخدمة باستخدام المفتاح المحدد. يجب استخدام المفاتيح التي يوفرها العميل عبر HTTPS. كما يتم توفير مفتاح التشفير نفسه في الطلب، يجب إنشاء اتصال آمن لنقل المفتاح.
- timeout
- int
تعيين المهلة من جانب الخادم للعملية بالثوان. لمزيد من التفاصيل، راجع https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. لا يتم تعقب هذه القيمة أو التحقق من صحتها على العميل. لتكوين مهلات الشبكة من جانب العميل، راجع هنا.
المرتجعات
كائن دفق (BlobQueryReader)
نوع الإرجاع
resize_blob
تغيير حجم كائن ثنائي كبير الحجم للصفحة إلى الحجم المحدد.
إذا كانت القيمة المحددة أقل من الحجم الحالي للكائن الثنائي كبير الحجم، فسيتم مسح جميع الصفحات فوق القيمة المحددة.
resize_blob(size: int, **kwargs: Any) -> Dict[str, str | datetime]
المعلمات
- size
- int
الحجم المستخدم لتغيير حجم الكائن الثنائي كبير الحجم. الحد الأقصى لحجم كائن ثنائي كبير الحجم للصفحة يصل إلى 1 تيرابايت. يجب محاذاة حجم كائن ثنائي كبير الحجم للصفحة إلى حد 512 بايت.
- lease
- BlobLeaseClient أو str
مطلوب إذا كان الكائن الثنائي كبير الحجم لديه عقد إيجار نشط. يمكن أن تكون القيمة كائن BlobLeaseClient أو معرف التأجير كسلسلة.
- 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.
- premium_page_blob_tier
- PremiumPageBlobTier
قيمة طبقة كائن ثنائي كبير الحجم للصفحة لتعيين الكائن الثنائي كبير الحجم إليها. يرتبط المستوى بحجم الكائن الثنائي كبير الحجم وعدد عمليات الإدخال والإخراج في الثانية المسموح بها. ينطبق هذا فقط على الكائنات الثنائية كبيرة الحجم للصفحة على حسابات التخزين المتميزة.
- timeout
- int
تعيين المهلة من جانب الخادم للعملية بالثوان. لمزيد من التفاصيل، راجع https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. لا يتم تعقب هذه القيمة أو التحقق من صحتها على العميل. لتكوين مهلات الشبكة من جانب العميل، راجع هنا.
المرتجعات
إملاء الخاصية المحدثة للكائنات الثنائية كبيرة الحجم (Etag وآخر تعديل).
نوع الإرجاع
seal_append_blob
تختم عملية Seal الكائن الثنائي كبير الحجم الملحق لجعله للقراءة فقط.
جديد في الإصدار 12.4.0.
seal_append_blob(**kwargs) -> Dict[str, str | datetime | int]
المعلمات
- appendpos_condition
- int
عنوان شرطي اختياري، يستخدم فقط لعملية Append Block. رقم يشير إلى إزاحة البايت للمقارنة. لن ينجح إلحاق كتلة إلا إذا كان موضع الإلحاق مساويا لهذا الرقم. إذا لم يكن كذلك، فسيفشل الطلب مع خطأ AppendPositionConditionNotMet (رمز حالة HTTP 412 - فشل الشرط المسبق).
- lease
- BlobLeaseClient أو str
مطلوب إذا كان الكائن الثنائي كبير الحجم لديه عقد إيجار نشط. يمكن أن تكون القيمة كائن BlobLeaseClient أو معرف التأجير كسلسلة.
- 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.
- timeout
- int
تعيين المهلة من جانب الخادم للعملية بالثوان. لمزيد من التفاصيل، راجع https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. لا يتم تعقب هذه القيمة أو التحقق من صحتها على العميل. لتكوين مهلات الشبكة من جانب العميل، راجع هنا.
المرتجعات
إملاء الخاصية المحدثة للكائن الثنائي كبير الحجم (Etag، التعديل الأخير، إزاحة الإلحاق، عدد الكتل الملتزم بها).
نوع الإرجاع
set_blob_metadata
تعيين بيانات التعريف المعرفة من قبل المستخدم للكائن الثنائي كبير الحجم كزوج واحد أو أكثر من أزواج قيمة الاسم.
set_blob_metadata(metadata: Dict[str, str] | None = None, **kwargs: Any) -> Dict[str, str | datetime]
المعلمات
إملاء يحتوي على أزواج الاسم والقيمة. يحل كل استدعاء لهذه العملية محل جميع بيانات التعريف الموجودة المرفقة بالكائن الثنائي كبير الحجم. لإزالة جميع بيانات التعريف من الكائن الثنائي كبير الحجم، قم باستدعاء هذه العملية بدون رؤوس بيانات التعريف.
- lease
- BlobLeaseClient أو str
مطلوب إذا كان الكائن الثنائي كبير الحجم لديه عقد إيجار نشط. يمكن أن تكون القيمة كائن BlobLeaseClient أو معرف التأجير كسلسلة.
- 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.
تشفير البيانات على جانب الخدمة باستخدام المفتاح المحدد. يجب استخدام المفاتيح التي يوفرها العميل عبر HTTPS. كما يتم توفير مفتاح التشفير نفسه في الطلب، يجب إنشاء اتصال آمن لنقل المفتاح.
- encryption_scope
- str
نطاق تشفير معرف مسبقا يستخدم لتشفير البيانات على الخدمة. يمكن إنشاء نطاق تشفير باستخدام واجهة برمجة تطبيقات الإدارة والإشارة إليه هنا بالاسم. إذا تم تعريف نطاق تشفير افتراضي في الحاوية، فستتجاوزه هذه القيمة إذا تم تكوين نطاق مستوى الحاوية للسماح بالتجاوزات. وإلا سيتم رفع خطأ.
جديد في الإصدار 12.2.0.
- timeout
- int
تعيين المهلة من جانب الخادم للعملية بالثوان. لمزيد من التفاصيل، راجع https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. لا يتم تعقب هذه القيمة أو التحقق من صحتها على العميل. لتكوين مهلات الشبكة من جانب العميل، راجع هنا.
المرتجعات
إملاء الخاصية المحدثة للكائن الثنائي كبير الحجم (Etag وآخر تعديل)
set_blob_tags
تمكن عملية تعيين العلامات المستخدمين من تعيين علامات على كائن ثنائي كبير الحجم أو إصدار كائن ثنائي كبير الحجم محدد، ولكن ليس لقطة. يحل كل استدعاء لهذه العملية محل جميع العلامات الموجودة المرفقة بالكائن الثنائي كبير الحجم. لإزالة جميع العلامات من الكائن الثنائي كبير الحجم، قم باستدعاء هذه العملية دون تعيين علامات.
جديد في الإصدار 12.4.0: تم تقديم هذه العملية في إصدار واجهة برمجة التطبيقات "2019-12-12".
set_blob_tags(tags: Dict[str, str] | None = None, **kwargs: Any) -> Dict[str, Any]
المعلمات
أزواج قيمة الاسم المقترنة ب الكائن الثنائي كبير الحجم كعلامة. العلامات حساسة لحالة الأحرف.
قد تحتوي مجموعة العلامات على 10 علامات على الأكثر. يجب أن تتراوح مفاتيح العلامات بين 1 و128 حرفا، ويجب أن تتراوح قيم العلامات بين 0 و256 حرفا.
تتضمن أحرف مفتاح العلامة والقيمة الصالحة: الأحرف الصغيرة والأحرف الكبيرة، والأرقام (0-9)، والمساحة ( >>
<<)، بالإضافة إلى (+)، والطرح (-)، والنقطة (.)، والصلبة (/)، والنقطتين (:)، والتساوي (=)، وتسطير سفلي (_)
- version_id
- str
معلمة معرف الإصدار هي قيمة DateTime مبهمة تحدد، عند وجودها، إصدار الكائن الثنائي كبير الحجم لإضافة علامات إليه.
- validate_content
- bool
إذا كان صحيحا، تحسب تجزئة MD5 لمحتوى العلامات. تتحقق خدمة التخزين من تجزئة المحتوى الذي وصل مع التجزئة التي تم إرسالها. هذا مهم في المقام الأول للكشف عن bitflips على السلك إذا كان استخدام http بدلا من https، كما https (الافتراضي)، سيتم التحقق من صحته بالفعل. لاحظ أن تجزئة MD5 هذه غير مخزنة مع الكائن الثنائي كبير الحجم.
- if_tags_match_condition
- str
حدد عبارة SQL حيث تعمل على علامات الكائن الثنائي كبير الحجم فقط على الكائن الثنائي كبير الحجم الوجهة بقيمة مطابقة.
مثل. "\"tagname\"='my tag'"
- lease
- BlobLeaseClient أو str
مطلوب إذا كان الكائن الثنائي كبير الحجم لديه عقد إيجار نشط. يمكن أن تكون القيمة كائن BlobLeaseClient أو معرف التأجير كسلسلة.
- timeout
- int
تعيين المهلة من جانب الخادم للعملية بالثوان. لمزيد من التفاصيل، راجع https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. لا يتم تعقب هذه القيمة أو التحقق من صحتها على العميل. لتكوين مهلات الشبكة من جانب العميل، راجع هنا.
المرتجعات
إملاء الخاصية المحدثة للكائن الثنائي كبير الحجم (Etag وآخر تعديل)
نوع الإرجاع
set_http_headers
تعيين خصائص النظام على الكائن الثنائي كبير الحجم.
إذا تم تعيين خاصية واحدة content_settings، فسيتم تجاوز جميع الخصائص.
set_http_headers(content_settings: ContentSettings | None = None, **kwargs: Any) -> None
المعلمات
- content_settings
- ContentSettings
عنصر ContentSettings المستخدم لتعيين خصائص الكائن الثنائي كبير الحجم. يستخدم لتعيين نوع المحتوى والترميز واللغة والتصرف وmd5 والتحكم في ذاكرة التخزين المؤقت.
- lease
- BlobLeaseClient أو str
مطلوب إذا كان الكائن الثنائي كبير الحجم لديه عقد إيجار نشط. يمكن أن تكون القيمة كائن BlobLeaseClient أو معرف التأجير كسلسلة.
- 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. لا يتم تعقب هذه القيمة أو التحقق من صحتها على العميل. لتكوين مهلات الشبكة من جانب العميل، راجع هنا.
المرتجعات
إملاء الخاصية المحدثة للكائن الثنائي كبير الحجم (Etag وآخر تعديل)
نوع الإرجاع
set_immutability_policy
تعين عملية تعيين نهج الثبات نهج الثبات على الكائن الثنائي كبير الحجم.
جديد في الإصدار 12.10.0: تم تقديم هذه العملية في إصدار واجهة برمجة التطبيقات "2020-10-02".
set_immutability_policy(immutability_policy: ImmutabilityPolicy, **kwargs: Any) -> Dict[str, str]
المعلمات
- immutability_policy
- ImmutabilityPolicy
يحدد نهج الثبات للكائن الثنائي كبير الحجم أو لقطة كائن ثنائي كبير الحجم أو إصدار كائن ثنائي كبير الحجم.
جديد في الإصدار 12.10.0: تم تقديم هذا في إصدار واجهة برمجة التطبيقات "2020-10-02".
- timeout
- int
تعيين المهلة من جانب الخادم للعملية بالثوان. لمزيد من التفاصيل، راجع https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. لا يتم تعقب هذه القيمة أو التحقق من صحتها على العميل. لتكوين مهلات الشبكة من جانب العميل، راجع هنا.
المرتجعات
أزواج القيمة الرئيسية لعلامات الكائن الثنائي كبير الحجم.
نوع الإرجاع
set_legal_hold
تعين عملية Set Legal Hold تعليقا قانونيا على الكائن الثنائي كبير الحجم.
جديد في الإصدار 12.10.0: تم تقديم هذه العملية في إصدار واجهة برمجة التطبيقات "2020-10-02".
set_legal_hold(legal_hold: bool, **kwargs: Any) -> Dict[str, str | datetime | bool]
المعلمات
- timeout
- int
تعيين المهلة من جانب الخادم للعملية بالثوان. لمزيد من التفاصيل، راجع https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. لا يتم تعقب هذه القيمة أو التحقق من صحتها على العميل. لتكوين مهلات الشبكة من جانب العميل، راجع هنا.
المرتجعات
أزواج القيمة الرئيسية لعلامات الكائن الثنائي كبير الحجم.
نوع الإرجاع
set_premium_page_blob_tier
تعيين طبقات كائن ثنائي كبير الحجم للصفحة على الكائن الثنائي كبير الحجم. يتم دعم واجهة برمجة التطبيقات هذه فقط لكائنات ثنائية كبيرة الحجم للصفحة على الحسابات المتميزة.
set_premium_page_blob_tier(premium_page_blob_tier: str | PremiumPageBlobTier, **kwargs: Any) -> None
المعلمات
- premium_page_blob_tier
- PremiumPageBlobTier
قيمة طبقة كائن ثنائي كبير الحجم للصفحة لتعيين الكائن الثنائي كبير الحجم إليها. يرتبط المستوى بحجم الكائن الثنائي كبير الحجم وعدد عمليات الإدخال والإخراج في الثانية المسموح بها. ينطبق هذا فقط على الكائنات الثنائية كبيرة الحجم للصفحة على حسابات التخزين المتميزة.
- 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. لا يتم تعقب هذه القيمة أو التحقق من صحتها على العميل. لتكوين مهلات الشبكة من جانب العميل، راجع هنا.
- lease
- BlobLeaseClient أو str
مطلوب إذا كان الكائن الثنائي كبير الحجم لديه عقد إيجار نشط. يمكن أن تكون القيمة كائن BlobLeaseClient أو معرف التأجير كسلسلة.
نوع الإرجاع
set_sequence_number
تعيين رقم تسلسل الكائن الثنائي كبير الحجم.
set_sequence_number(sequence_number_action: str | SequenceNumberAction, sequence_number: str | None = None, **kwargs: Any) -> Dict[str, str | datetime]
المعلمات
- sequence_number_action
- str
تشير هذه الخاصية إلى كيفية تعديل الخدمة لرقم تسلسل الكائن الثنائي كبير الحجم. راجع SequenceNumberAction لمزيد من المعلومات.
- sequence_number
- str
تعين هذه الخاصية رقم تسلسل الكائن الثنائي كبير الحجم. رقم التسلسل هو خاصية يتحكم فيها المستخدم يمكنك استخدامها لتعقب الطلبات وإدارة مشكلات التزامن.
- lease
- BlobLeaseClient أو str
مطلوب إذا كان الكائن الثنائي كبير الحجم لديه عقد إيجار نشط. يمكن أن تكون القيمة كائن BlobLeaseClient أو معرف التأجير كسلسلة.
- 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. لا يتم تعقب هذه القيمة أو التحقق من صحتها على العميل. لتكوين مهلات الشبكة من جانب العميل، راجع هنا.
المرتجعات
إملاء الخاصية المحدثة للكائنات الثنائية كبيرة الحجم (Etag وآخر تعديل).
نوع الإرجاع
set_standard_blob_tier
تعين هذه العملية الطبقة على كائن ثنائي كبير الحجم للكتلة.
تحدد طبقة كائن ثنائي كبير الحجم للكتلة نوع التخزين Hot/Cool/Archive. لا تقوم هذه العملية بتحديث ETag للكائن الثنائي كبير الحجم.
set_standard_blob_tier(standard_blob_tier: str | StandardBlobTier, **kwargs: Any) -> None
المعلمات
- standard_blob_tier
- str أو StandardBlobTier
يشير إلى الطبقة التي سيتم تعيينها على الكائن الثنائي كبير الحجم. تتضمن الخيارات "Hot" و"Cool" و"Archive". تم تحسين الطبقة الفعالة لتخزين البيانات التي يتم الوصول إليها بشكل متكرر. تم تحسين طبقة التخزين الباردة لتخزين البيانات التي يتم الوصول إليها وتخزينها بشكل غير متكرر لمدة شهر على الأقل. تم تحسين مستوى الأرشيف لتخزين البيانات التي نادرا ما يتم الوصول إليها وتخزينها لمدة ستة أشهر على الأقل مع متطلبات زمن انتقال مرنة.
- rehydrate_priority
- RehydratePriority
يشير إلى الأولوية التي يتم بها إعادة ترطيب كائن ثنائي كبير الحجم مؤرشف
- version_id
- str
معلمة معرف الإصدار هي قيمة DateTime مبهمة تحدد، عند وجودها، إصدار الكائن الثنائي كبير الحجم المراد تنزيله.
جديد في الإصدار 12.4.0.
تم تقديم وسيطة الكلمة الأساسية هذه في إصدار واجهة برمجة التطبيقات "2019-12-12".
- 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. لا يتم تعقب هذه القيمة أو التحقق من صحتها على العميل. لتكوين مهلات الشبكة من جانب العميل، راجع هنا.
- lease
- BlobLeaseClient أو str
مطلوب إذا كان الكائن الثنائي كبير الحجم لديه عقد إيجار نشط. يمكن أن تكون القيمة كائن BlobLeaseClient أو معرف التأجير كسلسلة.
نوع الإرجاع
stage_block
إنشاء كتلة جديدة ليتم الالتزام بها كجزء من كائن ثنائي كبير الحجم.
stage_block(block_id: str, data: Iterable | IO, length: int | None = None, **kwargs) -> Dict[str, Any]
المعلمات
- block_id
- str
قيمة سلسلة تحدد الكتلة. يجب أن تكون السلسلة أقل من أو تساوي 64 بايت في الحجم. بالنسبة لكائن ثنائي كبير الحجم معين، يجب أن يكون block_id بنفس الحجم لكل كتلة.
- data
بيانات الكائن الثنائي كبير الحجم.
- validate_content
- bool
إذا كان صحيحا، تحسب تجزئة MD5 لكل جزء من الكائن الثنائي كبير الحجم. تتحقق خدمة التخزين من تجزئة المحتوى الذي وصل مع التجزئة التي تم إرسالها. هذا مهم في المقام الأول للكشف عن bitflips على السلك إذا كان استخدام http بدلا من https، كما https (الافتراضي)، سيتم التحقق من صحته بالفعل. لاحظ أن تجزئة MD5 هذه غير مخزنة مع الكائن الثنائي كبير الحجم. لاحظ أيضا أنه إذا تم تمكينها، فلن يتم استخدام خوارزمية التحميل الفعالة للذاكرة لأن حساب تجزئة MD5 يتطلب تخزين كتل كاملة مؤقتا، وبذلك يهزم الغرض من الخوارزمية الفعالة للذاكرة.
- lease
- BlobLeaseClient أو str
مطلوب إذا كان الكائن الثنائي كبير الحجم لديه عقد إيجار نشط. يمكن أن تكون القيمة كائن BlobLeaseClient أو معرف التأجير كسلسلة.
- encoding
- str
الإعدادات الافتراضية ل UTF-8.
تشفير البيانات على جانب الخدمة باستخدام المفتاح المحدد. يجب استخدام المفاتيح التي يوفرها العميل عبر HTTPS. كما يتم توفير مفتاح التشفير نفسه في الطلب، يجب إنشاء اتصال آمن لنقل المفتاح.
- encryption_scope
- str
نطاق تشفير معرف مسبقا يستخدم لتشفير البيانات على الخدمة. يمكن إنشاء نطاق تشفير باستخدام واجهة برمجة تطبيقات الإدارة والإشارة إليه هنا بالاسم. إذا تم تعريف نطاق تشفير افتراضي في الحاوية، فستتجاوزه هذه القيمة إذا تم تكوين نطاق مستوى الحاوية للسماح بالتجاوزات. وإلا سيتم رفع خطأ.
جديد في الإصدار 12.2.0.
- timeout
- int
تعيين المهلة من جانب الخادم للعملية بالثوان. لمزيد من التفاصيل، راجع https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. لا يتم تعقب هذه القيمة أو التحقق من صحتها على العميل. لتكوين مهلات الشبكة من جانب العميل، راجع هنا.
المرتجعات
إملاء خاصية كائن ثنائي كبير الحجم.
نوع الإرجاع
stage_block_from_url
إنشاء كتلة جديدة ليتم تثبيتها كجزء من كائن ثنائي كبير الحجم حيث تتم قراءة المحتويات من عنوان URL.
stage_block_from_url(block_id: str | int, source_url: str, source_offset: int | None = None, source_length: int | None = None, source_content_md5: bytes | bytearray | None = None, **kwargs) -> Dict[str, Any]
المعلمات
- block_id
- str
قيمة سلسلة تحدد الكتلة. يجب أن تكون السلسلة أقل من أو تساوي 64 بايت في الحجم. بالنسبة لكائن ثنائي كبير الحجم معين، يجب أن يكون block_id بنفس الحجم لكل كتلة.
- source_content_md5
- bytearray
حدد md5 المحسوب لنطاق وحدات البايت التي يجب قراءتها من مصدر النسخ.
- lease
- BlobLeaseClient أو str
مطلوب إذا كان الكائن الثنائي كبير الحجم لديه عقد إيجار نشط. يمكن أن تكون القيمة كائن BlobLeaseClient أو معرف التأجير كسلسلة.
تشفير البيانات على جانب الخدمة باستخدام المفتاح المحدد. يجب استخدام المفاتيح التي يوفرها العميل عبر HTTPS. كما يتم توفير مفتاح التشفير نفسه في الطلب، يجب إنشاء اتصال آمن لنقل المفتاح.
- encryption_scope
- str
نطاق تشفير معرف مسبقا يستخدم لتشفير البيانات على الخدمة. يمكن إنشاء نطاق تشفير باستخدام واجهة برمجة تطبيقات الإدارة والإشارة إليه هنا بالاسم. إذا تم تعريف نطاق تشفير افتراضي في الحاوية، فستتجاوزه هذه القيمة إذا تم تكوين نطاق مستوى الحاوية للسماح بالتجاوزات. وإلا سيتم رفع خطأ.
جديد في الإصدار 12.2.0.
- timeout
- int
تعيين المهلة من جانب الخادم للعملية بالثوان. لمزيد من التفاصيل، راجع https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. لا يتم تعقب هذه القيمة أو التحقق من صحتها على العميل. لتكوين مهلات الشبكة من جانب العميل، راجع هنا.
- source_authorization
- str
المصادقة ككيان خدمة باستخدام سر العميل للوصول إلى كائن ثنائي كبير الحجم مصدر. تأكد من أن "الحامل" هو بادئة سلسلة source_authorization.
المرتجعات
إملاء خاصية كائن ثنائي كبير الحجم.
نوع الإرجاع
start_copy_from_url
نسخ كائن ثنائي كبير الحجم من عنوان URL المحدد.
ترجع هذه العملية قاموسا يحتوي على copy_statuscopy_id، والذي يمكن استخدامه للتحقق من حالة عملية النسخ أو إجهاضها. سيكون copy_status "ناجحا" إذا اكتملت النسخة بشكل متزامن أو "معلق" إذا تم بدء النسخة بشكل غير متزامن. بالنسبة للنسخ غير المتزامنة، يمكن التحقق من الحالة عن طريق التحقق من get_blob_properties الأسلوب والتحقق من حالة النسخ. قم بتعيين requires_sync إلى True لفرض أن تكون النسخة متزامنة. تنسخ خدمة Blob الكائنات الثنائية كبيرة الحجم على أساس أفضل جهد.
قد يكون الكائن الثنائي كبير الحجم المصدر لعملية نسخ كائن ثنائي كبير الحجم للكتلة أو كائن ثنائي كبير الحجم للإلحاق أو كائن ثنائي كبير الحجم للصفحة. إذا كان الكائن الثنائي كبير الحجم في الوجهة موجودة بالفعل، يجب أن يكون من نفس نوع الكائن الثنائي كبير الحجم الموجود في المصدر. سيتم استبدال أي كائن ثنائي كبير الحجم وجهة موجود. لا يمكن تعديل الكائن الثنائي كبير الحجم الوجهة أثناء عملية النسخ قيد التقدم.
عند النسخ من كائن ثنائي كبير الحجم للصفحة، تقوم خدمة Blob بإنشاء كائن ثنائي كبير الحجم للصفحة الوجهة لطول الكائن الثنائي كبير الحجم المصدر، يحتوي في البداية على جميع الأصفار. ثم يتم تعداد نطاقات الصفحات المصدر، ويتم نسخ النطاقات غير الفارغة.
بالنسبة لكائن ثنائي كبير الحجم للكتلة أو كائن ثنائي كبير الحجم ملحق، تنشئ خدمة Blob كائن ثنائي كبير الحجم ملتزما بطول صفري قبل العودة من هذه العملية. عند النسخ من كائن ثنائي كبير الحجم للكتلة، يتم نسخ جميع الكتل الملتزم بها ومعرفات الكتلة الخاصة بها. لا يتم نسخ الكتل غير الملتزم بها. في نهاية عملية النسخ، سيكون للكائن الثنائي كبير الحجم الوجهة نفس عدد الكتل الملتزم بها مثل المصدر.
عند النسخ من كائن ثنائي كبير الحجم للإلحاق، يتم نسخ جميع الكتل الملتزم بها. في نهاية عملية النسخ، سيكون للكائن الثنائي كبير الحجم الوجهة نفس عدد الكتل الملتزم بها مثل المصدر.
start_copy_from_url(source_url: str, metadata: Dict[str, str] | None = None, incremental_copy: bool = False, **kwargs: Any) -> Dict[str, str | datetime]
المعلمات
- source_url
- str
عنوان URL يصل طوله إلى 2 كيلوبايت يحدد ملفا أو كائنا ثنائيا كبير الحجم. يجب أن تكون القيمة مشفرة بعنوان URL كما ستظهر في عنوان URI للطلب. إذا كان المصدر في حساب آخر، فيجب أن يكون المصدر عاما أو يجب مصادقته عبر توقيع وصول مشترك. إذا كان المصدر عاما، فلن تكون هناك حاجة إلى مصادقة. أمثلة: https://myaccount.blob.core.windows.net/mycontainer/myblob
https://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot=
https://otheraccount.blob.core.windows.net/mycontainer/myblob?sastoken
أزواج الاسم والقيمة المقترنة بالكائنات الثنائية كبيرة الحجم كبيانات تعريف. إذا لم يتم تحديد أزواج قيمة الاسم، فستنسخ العملية بيانات التعريف من الكائن الثنائي كبير الحجم المصدر أو الملف إلى الكائن الثنائي كبير الحجم الوجهة. إذا تم تحديد زوج واحد أو أكثر من أزواج قيمة الاسم، يتم إنشاء الكائن الثنائي كبير الحجم الوجهة ببيانات التعريف المحددة، ولا يتم نسخ بيانات التعريف من الكائن الثنائي كبير الحجم المصدر أو الملف.
- incremental_copy
- bool
ينسخ لقطة كائن ثنائي كبير الحجم للصفحة المصدر إلى كائن ثنائي كبير الحجم للصفحة الوجهة. يتم نسخ اللقطة بحيث يتم نقل التغييرات التفاضلية فقط بين اللقطة المنسخة مسبقا إلى الوجهة. اللقطات المنسخة هي نسخ كاملة من اللقطة الأصلية ويمكن قراءتها أو نسخها منها كالمعتاد. الإعدادات الافتراضية معينة على False.
أزواج قيمة الاسم المقترنة ب الكائن الثنائي كبير الحجم كعلامة. العلامات حساسة لحالة الأحرف.
قد تحتوي مجموعة العلامات على 10 علامات على الأكثر. يجب أن تتراوح مفاتيح العلامات بين 1 و128 حرفا، ويجب أن تتراوح قيم العلامات بين 0 و256 حرفا.
تتضمن أحرف مفتاح العلامة والقيمة الصالحة ما يلي: أحرف صغيرة وأحرف كبيرة وأرقام (0-9) ومساحة ( >>
<<) بالإضافة إلى (+) وطرح (-) ونقطة (.) وs solidus (/) ونقاط النقطتين (:) والتساوي (=) وتسطير سفلي (_).
يمكن بدلا من ذلك تمرير "COPY" الحرفي (الحساس لحالة الأحرف) لنسخ العلامات من الكائن الثنائي كبير الحجم المصدر. يتوفر هذا الخيار فقط عند incremental_copy=False و requires_sync=True.
جديد في الإصدار 12.4.0.
- immutability_policy
- ImmutabilityPolicy
يحدد نهج الثبات للكائن الثنائي كبير الحجم أو لقطة كائن ثنائي كبير الحجم أو إصدار كائن ثنائي كبير الحجم.
جديد في الإصدار 12.10.0: تم تقديم هذا في إصدار واجهة برمجة التطبيقات "2020-10-02".
- legal_hold
- bool
تحديد ما إذا كان يجب تعيين تعليق قانوني على الكائن الثنائي كبير الحجم.
جديد في الإصدار 12.10.0: تم تقديم هذا في إصدار واجهة برمجة التطبيقات "2020-10-02".
- source_if_modified_since
- datetime
قيمة DateTime. يتوقع Azure أن تكون قيمة التاريخ التي تم تمريرها UTC. إذا تم تضمين المنطقة الزمنية، فسيتم تحويل أي تواريخ غير UTC إلى UTC. إذا تم تمرير تاريخ بدون معلومات المنطقة الزمنية، فمن المفترض أن يكون UTC. حدد هذا العنوان الشرطي لنسخ الكائن الثنائي كبير الحجم فقط إذا تم تعديل الكائن الثنائي كبير الحجم المصدر منذ التاريخ/الوقت المحدد.
- source_if_unmodified_since
- datetime
قيمة DateTime. يتوقع Azure أن تكون قيمة التاريخ التي تم تمريرها UTC. إذا تم تضمين المنطقة الزمنية، فسيتم تحويل أي تواريخ غير UTC إلى UTC. إذا تم تمرير تاريخ بدون معلومات المنطقة الزمنية، فمن المفترض أن يكون UTC. حدد هذا العنوان الشرطي لنسخ الكائن الثنائي كبير الحجم فقط إذا لم يتم تعديل الكائن الثنائي كبير الحجم المصدر منذ التاريخ/الوقت المحدد.
- source_etag
- str
قيمة ETag المصدر، أو حرف البدل (*). يستخدم للتحقق مما إذا كان المورد قد تغير، والعمل وفقا للشرط المحدد بواسطة المعلمة match_condition .
- source_match_condition
- MatchConditions
شرط مطابقة المصدر لاستخدامه على etag.
- if_modified_since
- datetime
قيمة DateTime. يتوقع Azure أن تكون قيمة التاريخ التي تم تمريرها UTC. إذا تم تضمين المنطقة الزمنية، فسيتم تحويل أي تواريخ غير UTC إلى UTC. إذا تم تمرير تاريخ بدون معلومات المنطقة الزمنية، فمن المفترض أن يكون UTC. حدد هذا العنوان الشرطي لنسخ الكائن الثنائي كبير الحجم فقط إذا تم تعديل الكائن الثنائي كبير الحجم الوجهة منذ التاريخ/الوقت المحدد. إذا لم يتم تعديل الكائن الثنائي كبير الحجم الوجهة، تقوم خدمة Blob بإرجاع رمز الحالة 412 (فشل الشرط المسبق).
- if_unmodified_since
- datetime
قيمة DateTime. يتوقع Azure أن تكون قيمة التاريخ التي تم تمريرها UTC. إذا تم تضمين المنطقة الزمنية، فسيتم تحويل أي تواريخ غير UTC إلى UTC. إذا تم تمرير تاريخ بدون معلومات المنطقة الزمنية، فمن المفترض أن يكون UTC. حدد هذا العنوان الشرطي لنسخ الكائن الثنائي كبير الحجم فقط إذا لم يتم تعديل الكائن الثنائي كبير الحجم الوجهة منذ التاريخ/الوقت المحدد. إذا تم تعديل الكائن الثنائي كبير الحجم الوجهة، تقوم خدمة Blob بإرجاع رمز الحالة 412 (فشل الشرط المسبق).
- etag
- str
قيمة ETag الوجهة أو حرف البدل (*). يستخدم للتحقق مما إذا كان المورد قد تغير، والعمل وفقا للشرط المحدد بواسطة المعلمة match_condition .
- match_condition
- MatchConditions
شرط مطابقة الوجهة لاستخدامه على etag.
- destination_lease
- BlobLeaseClient أو str
يجب أن يتطابق معرف الإيجار المحدد لهذا العنوان مع معرف التأجير للكائن الثنائي كبير الحجم الوجهة. إذا لم يتضمن الطلب معرف التأجير أو لم يكن صالحا، تفشل العملية مع رمز الحالة 412 (فشل الشرط المسبق).
- source_lease
- BlobLeaseClient أو str
حدد هذا لتنفيذ عملية Copy Blob فقط إذا كان معرف الإيجار المحدد يطابق معرف الإيجار النشط للكائن الثنائي كبير الحجم المصدر.
- timeout
- int
تعيين المهلة من جانب الخادم للعملية بالثوان. لمزيد من التفاصيل، راجع https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. لا يتم تعقب هذه القيمة أو التحقق من صحتها على العميل. لتكوين مهلات الشبكة من جانب العميل، راجع هنا.
- premium_page_blob_tier
- PremiumPageBlobTier
قيمة طبقة كائن ثنائي كبير الحجم للصفحة لتعيين الكائن الثنائي كبير الحجم إليها. يرتبط المستوى بحجم الكائن الثنائي كبير الحجم وعدد عمليات الإدخال والإخراج في الثانية المسموح بها. ينطبق هذا فقط على الكائنات الثنائية كبيرة الحجم للصفحة على حسابات التخزين المتميزة.
- standard_blob_tier
- StandardBlobTier
قيمة طبقة كائن ثنائي كبير الحجم قياسية لتعيين الكائن الثنائي كبير الحجم إليها. بالنسبة لهذا الإصدار من المكتبة، ينطبق هذا فقط على حظر الكائنات الثنائية كبيرة الحجم على حسابات التخزين القياسية.
- rehydrate_priority
- RehydratePriority
يشير إلى الأولوية التي يتم بها إعادة ترطيب كائن ثنائي كبير الحجم مؤرشف
- seal_destination_blob
- bool
أغلق الكائن الثنائي كبير الحجم للإلحاق الوجهة. هذه العملية مخصصة فقط لكائن ثنائي كبير الحجم للإلحاق.
جديد في الإصدار 12.4.0.
- requires_sync
- bool
يفرض أن الخدمة لن ترجع استجابة حتى تكتمل النسخة.
- source_authorization
- str
المصادقة ككيان خدمة باستخدام سر العميل للوصول إلى كائن ثنائي كبير الحجم مصدر. تأكد من أن "الحامل" هو بادئة سلسلة source_authorization. يتوفر هذا الخيار فقط عند تعيين incremental_copy إلى False ويتم تعيين requires_sync إلى True.
جديد في الإصدار 12.9.0.
- encryption_scope
- str
نطاق تشفير معرف مسبقا يستخدم لتشفير البيانات على الكائن الثنائي كبير الحجم المنسوخ للمزامنة. يمكن إنشاء نطاق تشفير باستخدام واجهة برمجة تطبيقات الإدارة والإشارة إليه هنا بالاسم. إذا تم تعريف نطاق تشفير افتراضي في الحاوية، فستتجاوزه هذه القيمة إذا تم تكوين نطاق مستوى الحاوية للسماح بالتجاوزات. وإلا سيتم رفع خطأ.
جديد في الإصدار 12.10.0.
المرتجعات
قاموس لخصائص النسخ (etag، last_modified، copy_id، copy_status).
نوع الإرجاع
undelete_blob
استعادة الكائنات الثنائية كبيرة الحجم أو اللقطات المحذوفة مبدئيا.
لن تنجح العملية إلا إذا تم استخدامها ضمن عدد الأيام المحدد المحدد في نهج استبقاء الحذف.
إذا تم تمكين تعيين إصدار كائن ثنائي كبير الحجم، فلا يمكن استعادة الكائن الثنائي كبير الحجم الأساسي باستخدام هذا الأسلوب. بدلا من ذلك، استخدم start_copy_from_url مع عنوان URL لإصدار الكائن الثنائي كبير الحجم الذي ترغب في ترقيته إلى الإصدار الحالي.
undelete_blob(**kwargs: Any) -> None
المعلمات
- timeout
- int
تعيين المهلة من جانب الخادم للعملية بالثوان. لمزيد من التفاصيل، راجع https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. لا يتم تعقب هذه القيمة أو التحقق من صحتها على العميل. لتكوين مهلات الشبكة من جانب العميل، راجع هنا.
نوع الإرجاع
upload_blob
إنشاء كائن ثنائي كبير الحجم جديد من مصدر بيانات مع التقسيم التلقائي.
upload_blob(data: bytes | str | Iterable | IO, blob_type: str | BlobType = BlobType.BLOCKBLOB, length: int | None = None, metadata: Dict[str, str] | None = None, **kwargs) -> Dict[str, Any]
المعلمات
- data
بيانات الكائن الثنائي كبير الحجم لتحميلها.
- blob_type
- BlobType
نوع الكائن الثنائي كبير الحجم. يمكن أن يكون هذا إما BlockBlob أو PageBlob أو AppendBlob. القيمة الافتراضية هي BlockBlob.
- length
- int
عدد وحدات البايت المراد قراءتها من الدفق. هذا اختياري، ولكن يجب توفيره للأداء الأمثل.
أزواج الاسم والقيمة المقترنة بالكائنات الثنائية كبيرة الحجم كبيانات تعريف.
أزواج قيمة الاسم المقترنة ب الكائن الثنائي كبير الحجم كعلامة. العلامات حساسة لحالة الأحرف.
قد تحتوي مجموعة العلامات على 10 علامات على الأكثر. يجب أن تتراوح مفاتيح العلامات بين 1 و128 حرفا، ويجب أن تتراوح قيم العلامات بين 0 و256 حرفا.
تتضمن أحرف مفتاح العلامة والقيمة الصالحة: الأحرف الصغيرة والأحرف الكبيرة، والأرقام (0-9)، والمساحة ( >>
<<)، بالإضافة إلى (+)، والطرح (-)، والنقطة (.)، والصلبة (/)، والنقطتين (:)، والتساوي (=)، وتسطير سفلي (_)
جديد في الإصدار 12.4.0.
- overwrite
- bool
ما إذا كان يجب أن يقوم الكائن الثنائي كبير الحجم الذي سيتم تحميله بالكتابة فوق البيانات الحالية. إذا كان True، فسيستبدل upload_blob البيانات الموجودة. إذا تم تعيينها إلى False، فستفشل العملية مع ResourceExistsError. الاستثناء لما سبق هو مع أنواع الكائنات الثنائية كبيرة الحجم الملحقة: إذا تم تعيينها إلى False والبيانات موجودة بالفعل، فلن يتم رفع خطأ وسيتم إلحاق البيانات بالكائن الثنائي كبير الحجم الموجود. إذا تم تعيين overwrite=True، فسيتم حذف الكائن الثنائي كبير الحجم الموجود للإلحاق، وإنشاء كائن جديد. الإعدادات الافتراضية معينة على False.
- content_settings
- ContentSettings
عنصر ContentSettings المستخدم لتعيين خصائص الكائن الثنائي كبير الحجم. يستخدم لتعيين نوع المحتوى والترميز واللغة والتصرف وmd5 والتحكم في ذاكرة التخزين المؤقت.
- validate_content
- bool
إذا كان صحيحا، تحسب تجزئة MD5 لكل جزء من الكائن الثنائي كبير الحجم. تتحقق خدمة التخزين من تجزئة المحتوى الذي وصل مع التجزئة التي تم إرسالها. هذا مهم في المقام الأول للكشف عن bitflips على السلك إذا كان استخدام http بدلا من https، كما https (الافتراضي)، سيتم التحقق من صحته بالفعل. لاحظ أن تجزئة MD5 هذه غير مخزنة مع الكائن الثنائي كبير الحجم. لاحظ أيضا أنه إذا تم تمكينها، فلن يتم استخدام خوارزمية التحميل الفعالة للذاكرة لأن حساب تجزئة MD5 يتطلب تخزين كتل كاملة مؤقتا، وبذلك يهزم الغرض من الخوارزمية الفعالة للذاكرة.
- lease
- BlobLeaseClient أو str
مطلوب إذا كان الكائن الثنائي كبير الحجم لديه عقد إيجار نشط. إذا تم تحديده، upload_blob ينجح فقط إذا كان عقد إيجار الكائن الثنائي كبير الحجم نشطا ويطابق هذا المعرف. يمكن أن تكون القيمة كائن BlobLeaseClient أو معرف التأجير كسلسلة.
- 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.
- premium_page_blob_tier
- PremiumPageBlobTier
قيمة طبقة كائن ثنائي كبير الحجم للصفحة لتعيين الكائن الثنائي كبير الحجم إليها. يرتبط المستوى بحجم الكائن الثنائي كبير الحجم وعدد عمليات الإدخال والإخراج في الثانية المسموح بها. ينطبق هذا فقط على الكائنات الثنائية كبيرة الحجم للصفحة على حسابات التخزين المتميزة.
- standard_blob_tier
- StandardBlobTier
قيمة طبقة كائن ثنائي كبير الحجم قياسية لتعيين الكائن الثنائي كبير الحجم إليها. بالنسبة لهذا الإصدار من المكتبة، ينطبق هذا فقط على حظر الكائنات الثنائية كبيرة الحجم على حسابات التخزين القياسية.
- immutability_policy
- ImmutabilityPolicy
يحدد نهج الثبات للكائن الثنائي كبير الحجم أو لقطة كائن ثنائي كبير الحجم أو إصدار كائن ثنائي كبير الحجم. حاليا هذه المعلمة من upload_blob() API مخصصة ل BlockBlob فقط.
جديد في الإصدار 12.10.0: تم تقديم هذا في إصدار واجهة برمجة التطبيقات "2020-10-02".
- legal_hold
- bool
تحديد ما إذا كان يجب تعيين تعليق قانوني على الكائن الثنائي كبير الحجم. حاليا هذه المعلمة من upload_blob() API مخصصة ل BlockBlob فقط.
جديد في الإصدار 12.10.0: تم تقديم هذا في إصدار واجهة برمجة التطبيقات "2020-10-02".
- maxsize_condition
- int
رأس شرطي اختياري. الحد الأقصى للطول بالبايت المسموح به لكائن ثنائي كبير الحجم للإلحاق. إذا كانت عملية Append Block قد تتسبب في تجاوز الكائن الثنائي كبير الحجم لهذا الحد أو إذا كان حجم الكائن الثنائي كبير الحجم أكبر بالفعل من القيمة المحددة في هذا العنوان، فسيفشل الطلب مع خطأ MaxBlobSizeConditionNotMet (رمز حالة HTTP 412 - فشل الشرط المسبق).
- max_concurrency
- int
الحد الأقصى لعدد الاتصالات المتوازية التي يجب استخدامها عندما يتجاوز حجم الكائن الثنائي كبير الحجم 64 ميغابايت.
تشفير البيانات على جانب الخدمة باستخدام المفتاح المحدد. يجب استخدام المفاتيح التي يوفرها العميل عبر HTTPS. كما يتم توفير مفتاح التشفير نفسه في الطلب، يجب إنشاء اتصال آمن لنقل المفتاح.
- encryption_scope
- str
نطاق تشفير معرف مسبقا يستخدم لتشفير البيانات على الخدمة. يمكن إنشاء نطاق تشفير باستخدام واجهة برمجة تطبيقات الإدارة والإشارة إليه هنا بالاسم. إذا تم تعريف نطاق تشفير افتراضي في الحاوية، فستتجاوزه هذه القيمة إذا تم تكوين نطاق مستوى الحاوية للسماح بالتجاوزات. وإلا سيتم رفع خطأ.
جديد في الإصدار 12.2.0.
- encoding
- str
الإعدادات الافتراضية ل UTF-8.
رد اتصال لتعقب تقدم التحميل طويل الأمد. التوقيع هو دالة(current: int, total: Optional[int]) حيث الحالي هو عدد وحدات البايت المنقولة حتى الآن، والإجمالي هو حجم الكائن الثنائي كبير الحجم أو بلا إذا كان الحجم غير معروف.
- timeout
- int
تعيين المهلة من جانب الخادم للعملية بالثوان. لمزيد من التفاصيل، راجع https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. لا يتم تعقب هذه القيمة أو التحقق من صحتها على العميل. لتكوين مهلات الشبكة من جانب العميل، راجع هنا. قد يقوم هذا الأسلوب بإجراء مكالمات متعددة إلى الخدمة وسيتم تطبيق المهلة على كل مكالمة على حدة.
المرتجعات
إملاء الخاصية المحدثة لكائن ثنائي كبير الحجم (Etag وآخر تعديل)
نوع الإرجاع
upload_blob_from_url
إنشاء كائن ثنائي كبير الحجم جديد للكتلة حيث تتم قراءة محتوى الكائن الثنائي كبير الحجم من عنوان URL معين. تتم الكتابة فوق محتوى كائن ثنائي كبير الحجم موجود باستخدام الكائن الثنائي كبير الحجم الجديد.
upload_blob_from_url(source_url: str, **kwargs: Any) -> Dict[str, Any]
المعلمات
- source_url
- str
عنوان URL يصل إلى 2 كيلوبايت في الطول يحدد ملفا أو كائنا ثنائيا كبير الحجم. يجب أن تكون القيمة مشفرة بعنوان URL كما تظهر في طلب URI. إذا كان المصدر في حساب آخر، فيجب أن يكون المصدر عاما أو يجب مصادقته عبر توقيع وصول مشترك. إذا كان المصدر عاما، فلن تكون هناك حاجة إلى مصادقة. أمثلة: https://myaccount.blob.core.windows.net/mycontainer/myblob
https://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot=
https://otheraccount.blob.core.windows.net/mycontainer/myblob?sastoken
- overwrite
- bool
ما إذا كان يجب أن يقوم الكائن الثنائي كبير الحجم الذي سيتم تحميله بالكتابة فوق البيانات الحالية. إذا كان True، فسيستبدل upload_blob البيانات الموجودة. إذا تم تعيينها إلى False، فستفشل العملية مع ResourceExistsError.
- include_source_blob_properties
- bool
يشير إلى ما إذا كان يجب نسخ الخصائص من الكائن الثنائي كبير الحجم المصدر. الإعدادات الافتراضية إلى True.
أزواج قيمة الاسم المقترنة بكائن ثنائي كبير الحجم كعلامة. العلامات حساسة لحالة الأحرف.
قد تحتوي مجموعة العلامات على 10 علامات على الأكثر. يجب أن تتراوح مفاتيح العلامات بين 1 و128 حرفا، ويجب أن تتراوح قيم العلامات بين 0 و256 حرفا.
يتضمن مفتاح العلامة الصالح وأحرف القيمة ما يلي: أحرف صغيرة وأحرف كبيرة، وأرقام (0-9)، ومسافة ( >>
<<)، بالإضافة إلى (+)، وطرح (-)، ونقطة (.)، وصلابة (/)، وعلامة النقطتين (:)، والتساوي (=)، وتسطير سفلي (_)
- source_content_md5
- bytearray
حدد md5 المستخدم للتحقق من تكامل وحدات البايت المصدر.
- source_if_modified_since
- datetime
قيمة DateTime. يتوقع Azure أن تكون قيمة التاريخ التي تم تمريرها UTC. إذا تم تضمين المنطقة الزمنية، فسيتم تحويل أي تواريخ غير UTC إلى UTC. إذا تم تمرير تاريخ بدون معلومات المنطقة الزمنية، فمن المفترض أن يكون UTC. حدد هذا العنوان لتنفيذ العملية فقط إذا تم تعديل المورد المصدر منذ الوقت المحدد.
- source_if_unmodified_since
- datetime
قيمة DateTime. يتوقع Azure أن تكون قيمة التاريخ التي تم تمريرها UTC. إذا تم تضمين المنطقة الزمنية، فسيتم تحويل أي تواريخ غير UTC إلى UTC. إذا تم تمرير تاريخ بدون معلومات المنطقة الزمنية، فمن المفترض أن يكون UTC. حدد هذا العنوان لتنفيذ العملية فقط إذا لم يتم تعديل المورد المصدر منذ التاريخ/الوقت المحدد.
- source_etag
- str
قيمة ETag المصدر أو حرف البدل (*). يستخدم للتحقق مما إذا كان المورد قد تغير، ويعمل وفقا للشرط المحدد بواسطة المعلمة match_condition .
- source_match_condition
- MatchConditions
شرط مطابقة المصدر لاستخدامه على etag.
- 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.
- destination_lease
- BlobLeaseClient أو str
يجب أن يتطابق معرف الإيجار المحدد لهذا العنوان مع معرف الإيجار للكائن الثنائي كبير الحجم الوجهة. إذا لم يتضمن الطلب معرف الإيجار أو لم يكن صالحا، تفشل العملية مع رمز الحالة 412 (فشل الشرط المسبق).
- timeout
- int
تعيين المهلة من جانب الخادم للعملية بالثوان. لمزيد من التفاصيل، راجع https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. لا يتم تعقب هذه القيمة أو التحقق من صحتها على العميل. لتكوين مهلات الشبكة من جانب العميل، راجع هنا.
- content_settings
- ContentSettings
عنصر ContentSettings المستخدم لتعيين خصائص الكائن الثنائي كبير الحجم. يستخدم لتعيين نوع المحتوى والترميز واللغة والتصرف وmd5 والتحكم في ذاكرة التخزين المؤقت.
تشفير البيانات على جانب الخدمة باستخدام المفتاح المحدد. يجب استخدام المفاتيح التي يوفرها العميل عبر HTTPS. نظرا لتوفير مفتاح التشفير نفسه في الطلب، يجب إنشاء اتصال آمن لنقل المفتاح.
- encryption_scope
- str
نطاق تشفير محدد مسبقا يستخدم لتشفير البيانات على الخدمة. يمكن إنشاء نطاق تشفير باستخدام Management API والإشارة إليه هنا بالاسم. إذا تم تعريف نطاق تشفير افتراضي في الحاوية، فستتجاوزه هذه القيمة إذا تم تكوين النطاق على مستوى الحاوية للسماح بالتجاوزات. وإلا سيتم رفع خطأ.
- standard_blob_tier
- StandardBlobTier
قيمة طبقة كائن ثنائي كبير الحجم قياسية لتعيين الكائن الثنائي كبير الحجم إليها. بالنسبة لهذا الإصدار من المكتبة، ينطبق هذا فقط على حظر الكائنات الثنائية كبيرة الحجم على حسابات التخزين القياسية.
- source_authorization
- str
المصادقة ككيان خدمة باستخدام سر العميل للوصول إلى كائن ثنائي كبير الحجم المصدر. تأكد من أن "الحامل" هو بادئة سلسلة source_authorization.
upload_page
تكتب عملية تحميل الصفحات مجموعة من الصفحات إلى كائن ثنائي كبير الحجم للصفحة.
upload_page(page: bytes, offset: int, length: int, **kwargs) -> Dict[str, str | datetime]
المعلمات
- offset
- int
بداية نطاق البايت لاستخدامه للكتابة إلى قسم من الكائن الثنائي كبير الحجم. يجب محاذاة الصفحات مع حدود 512 بايت، ويجب أن تكون إزاحة البدء معامل 512 ويجب أن يكون الطول معامل 512.
- length
- int
عدد وحدات البايت التي يجب استخدامها للكتابة إلى مقطع من الكائن الثنائي كبير الحجم. يجب محاذاة الصفحات مع حدود 512 بايت، ويجب أن تكون إزاحة البدء معامل 512 ويجب أن يكون الطول معامل 512.
- lease
- BlobLeaseClient أو str
مطلوب إذا كان الكائن الثنائي كبير الحجم لديه عقد إيجار نشط. يمكن أن تكون القيمة كائن BlobLeaseClient أو معرف الإيجار كسلسلة.
- validate_content
- bool
إذا كان صحيحا، تحسب تجزئة MD5 لمحتوى الصفحة. تتحقق خدمة التخزين من تجزئة المحتوى الذي وصل مع التجزئة التي تم إرسالها. هذا مهم في المقام الأول للكشف عن bitflips على السلك إذا كان استخدام http بدلا من https، كما https (الافتراضي)، سيتم التحقق من صحته بالفعل. لاحظ أن تجزئة MD5 هذه غير مخزنة مع الكائن الثنائي كبير الحجم.
- if_sequence_number_lte
- int
إذا كان رقم تسلسل الكائن الثنائي كبير الحجم أقل من أو يساوي القيمة المحددة، يتم متابعة الطلب؛ وإلا فإنه يفشل.
- if_sequence_number_lt
- int
إذا كان رقم تسلسل الكائن الثنائي كبير الحجم أقل من القيمة المحددة، يتم متابعة الطلب؛ وإلا فإنه يفشل.
- if_sequence_number_eq
- int
إذا كان رقم تسلسل الكائن الثنائي كبير الحجم مساويا للقيمة المحددة، يتم متابعة الطلب؛ وإلا فإنه يفشل.
- 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.
تشفير البيانات على جانب الخدمة باستخدام المفتاح المحدد. يجب استخدام المفاتيح التي يوفرها العميل عبر HTTPS. كما يتم توفير مفتاح التشفير نفسه في الطلب، يجب إنشاء اتصال آمن لنقل المفتاح.
- encryption_scope
- str
نطاق تشفير معرف مسبقا يستخدم لتشفير البيانات على الخدمة. يمكن إنشاء نطاق تشفير باستخدام واجهة برمجة تطبيقات الإدارة والإشارة إليه هنا بالاسم. إذا تم تعريف نطاق تشفير افتراضي في الحاوية، فستتجاوزه هذه القيمة إذا تم تكوين نطاق مستوى الحاوية للسماح بالتجاوزات. وإلا سيتم رفع خطأ.
جديد في الإصدار 12.2.0.
- encoding
- str
الإعدادات الافتراضية ل UTF-8.
- timeout
- int
تعيين المهلة من جانب الخادم للعملية بالثوان. لمزيد من التفاصيل، راجع https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. لا يتم تعقب هذه القيمة أو التحقق من صحتها على العميل. لتكوين مهلات الشبكة من جانب العميل، راجع هنا.
المرتجعات
إملاء الخاصية المحدثة للكائنات الثنائية كبيرة الحجم (Etag وآخر تعديل).
نوع الإرجاع
upload_pages_from_url
تكتب عملية تحميل الصفحات مجموعة من الصفحات إلى كائن ثنائي كبير الحجم للصفحة حيث تتم قراءة المحتويات من عنوان URL.
upload_pages_from_url(source_url: str, offset: int, length: int, source_offset: int, **kwargs) -> Dict[str, Any]
المعلمات
- source_url
- str
عنوان URL للبيانات المصدر. يمكن أن يشير إلى أي Azure Blob أو ملف، إما عام أو يحتوي على توقيع وصول مشترك مرفق.
- offset
- int
بداية نطاق البايت المراد استخدامه للكتابة إلى مقطع من الكائن الثنائي كبير الحجم. يجب محاذاة الصفحات مع حدود 512 بايت، ويجب أن تكون إزاحة البدء معامل 512 ويجب أن يكون الطول معامل 512.
- length
- int
عدد وحدات البايت التي يجب استخدامها للكتابة إلى مقطع من الكائن الثنائي كبير الحجم. يجب محاذاة الصفحات مع حدود 512 بايت، ويجب أن تكون إزاحة البدء معامل 512 ويجب أن يكون الطول معامل 512.
- source_offset
- int
يشير هذا إلى بداية نطاق البايت (الشامل) الذي يجب أخذه من مصدر النسخ. ستقرأ الخدمة نفس عدد وحدات البايت مثل نطاق الوجهة (إزاحة الطول).
- source_content_md5
- bytes
إذا تم منحها، فستحسب الخدمة تجزئة MD5 لمحتوى الكتلة وتقارن مقابل هذه القيمة.
- source_if_modified_since
- datetime
قيمة DateTime. يتوقع Azure أن تكون قيمة التاريخ التي تم تمريرها UTC. إذا تم تضمين المنطقة الزمنية، فسيتم تحويل أي تواريخ غير UTC إلى UTC. إذا تم تمرير تاريخ بدون معلومات المنطقة الزمنية، فمن المفترض أن يكون UTC. حدد هذا العنوان لتنفيذ العملية فقط إذا تم تعديل المورد المصدر منذ الوقت المحدد.
- source_if_unmodified_since
- datetime
قيمة DateTime. يتوقع Azure أن تكون قيمة التاريخ التي تم تمريرها UTC. إذا تم تضمين المنطقة الزمنية، فسيتم تحويل أي تواريخ غير UTC إلى UTC. إذا تم تمرير تاريخ بدون معلومات المنطقة الزمنية، فمن المفترض أن يكون UTC. حدد هذا العنوان لتنفيذ العملية فقط إذا لم يتم تعديل المورد المصدر منذ التاريخ/الوقت المحدد.
- source_etag
- str
قيمة ETag المصدر، أو حرف البدل (*). يستخدم للتحقق مما إذا كان المورد قد تغير، والعمل وفقا للشرط المحدد بواسطة المعلمة match_condition .
- source_match_condition
- MatchConditions
شرط مطابقة المصدر لاستخدامه على etag.
- lease
- BlobLeaseClient أو str
مطلوب إذا كان الكائن الثنائي كبير الحجم لديه عقد إيجار نشط. يمكن أن تكون القيمة كائن BlobLeaseClient أو معرف التأجير كسلسلة.
- if_sequence_number_lte
- int
إذا كان رقم تسلسل الكائن الثنائي كبير الحجم أقل من القيمة المحددة أو مساويا لها، يستمر الطلب؛ وإلا فإنه يفشل.
- if_sequence_number_lt
- int
إذا كان رقم تسلسل الكائن الثنائي كبير الحجم أقل من القيمة المحددة، يتم متابعة الطلب؛ وإلا فإنه يفشل.
- if_sequence_number_eq
- int
إذا كان رقم تسلسل الكائن الثنائي كبير الحجم مساويا للقيمة المحددة، يستمر الطلب؛ وإلا فإنه يفشل.
- 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.
تشفير البيانات على جانب الخدمة باستخدام المفتاح المحدد. يجب استخدام المفاتيح التي يوفرها العميل عبر HTTPS. كما يتم توفير مفتاح التشفير نفسه في الطلب، يجب إنشاء اتصال آمن لنقل المفتاح.
- encryption_scope
- str
نطاق تشفير معرف مسبقا يستخدم لتشفير البيانات على الخدمة. يمكن إنشاء نطاق تشفير باستخدام واجهة برمجة تطبيقات الإدارة والإشارة إليه هنا بالاسم. إذا تم تعريف نطاق تشفير افتراضي في الحاوية، فستتجاوزه هذه القيمة إذا تم تكوين نطاق مستوى الحاوية للسماح بالتجاوزات. وإلا سيتم رفع خطأ.
جديد في الإصدار 12.2.0.
- timeout
- int
تعيين المهلة من جانب الخادم للعملية بالثوان. لمزيد من التفاصيل، راجع https://learn.microsoft.com/rest/api/storageservices/setting-timeouts-for-blob-service-operations. لا يتم تعقب هذه القيمة أو التحقق من صحتها على العميل. لتكوين مهلات الشبكة من جانب العميل، راجع هنا.
- source_authorization
- str
المصادقة ككيان خدمة باستخدام سر العميل للوصول إلى كائن ثنائي كبير الحجم مصدر. تأكد من أن "الحامل" هو بادئة سلسلة source_authorization.
السمات
api_version
إصدار واجهة برمجة تطبيقات التخزين المستخدمة للطلبات.
location_mode
وضع الموقع الذي يستخدمه العميل حاليا.
بشكل افتراضي، سيكون هذا "أساسي". تتضمن الخيارات "الأساسي" و"الثانوي".
primary_endpoint
عنوان URL الكامل لنقطة النهاية الأساسية.
primary_hostname
اسم مضيف نقطة النهاية الأساسية.
secondary_endpoint
عنوان URL لنقطة النهاية الثانوية الكاملة إذا تم تكوينه.
إذا لم يكن متوفرا، فسيتم رفع ValueError. لتحديد اسم مضيف ثانوي بشكل صريح، استخدم وسيطة الكلمة الأساسية secondary_hostname الاختيارية عند إنشاء مثيل.
استثناءات
secondary_hostname
اسم مضيف نقطة النهاية الثانوية.
إذا لم يكن متوفرا، فسيكون هذا بلا. لتحديد اسم مضيف ثانوي بشكل صريح، استخدم وسيطة الكلمة الأساسية secondary_hostname الاختيارية عند إنشاء مثيل.
url
عنوان URL الكامل لنقطة النهاية لهذا الكيان، بما في ذلك رمز SAS المميز إذا تم استخدامه.
قد تكون هذه إما نقطة النهاية الأساسية، أو نقطة النهاية الثانوية اعتمادا على الحالي location_mode. :returns: عنوان URL الكامل لنقطة النهاية لهذا الكيان، بما في ذلك رمز SAS المميز إذا تم استخدامه. :rtype: str
Azure SDK for Python