BaseBlobService الفصل

هذه هي الفئة الرئيسية التي تدير موارد Blob.

تخزن خدمة Blob النص والبيانات الثنائية ككائنات ثنائية كبيرة الحجم في السحابة. توفر خدمة Blob الموارد الثلاثة التالية: حساب التخزين والحاويات والكائنات الثنائية كبيرة الحجم. داخل حساب التخزين الخاص بك، توفر الحاويات طريقة لتنظيم مجموعات من الكائنات الثنائية كبيرة الحجم. لمزيد من المعلومات، يرجى مراجعة: https://msdn.microsoft.com/en-us/library/azure/ee691964.aspx

:اكتب ~azure.storage.common.TokenCredential

توريث

StorageClient

BaseBlobService

الدالمنشئ

BaseBlobService(account_name=None, account_key=None, sas_token=None, is_emulated=False, protocol='https', endpoint_suffix='core.windows.net', custom_domain=None, request_session=None, connection_string=None, socket_timeout=None, token_credential=None)

المعلمات

account_name

str

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

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

account_key

str

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

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

sas_token

str

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

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

is_emulated

bool

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

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

protocol

str

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

البروتوكول المراد استخدامه للطلبات. الإعدادات الافتراضية ل https.

endpoint_suffix

str

القيمة الافتراضية: core.windows.net

المكون الأساسي المضيف لعنصر url، مطروحا منه اسم الحساب. الإعدادات الافتراضية ل Azure (core.windows.net). تجاوز هذا لاستخدام سحابة الصين (core.chinacloudapi.cn).

custom_domain

str

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

المجال المخصص المراد استخدامه. يمكن تعيين هذا في مدخل Microsoft Azure. على سبيل المثال، "www.mydomain.com".

request_session

<xref:requests.Session>

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

كائن جلسة العمل المراد استخدامه لطلبات http.

connection_string

str

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

إذا تم تحديده، فسيتجاوز هذا جميع المعلمات الأخرى إلى جانب جلسة الطلب. راجع http://azure.microsoft.com/en-us/documentation/articles/storage-configure-connection-string/ للحصول على تنسيق سلسلة الاتصال

socket_timeout

int

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

إذا تم تحديده، فسيتجاوز هذا مهلة مأخذ التوصيل الافتراضية. المهلة المحددة بالثوان. راجع DEFAULT_SOCKET_TIMEOUT في _constants.py للقيمة الافتراضية.

token_credential

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

بيانات اعتماد الرمز المميز المستخدمة لمصادقة طلبات HTTPS. يجب تحديث قيمة الرمز المميز قبل انتهاء صلاحيتها.

المتغيرات

MAX_SINGLE_GET_SIZE

int

يتم تنفيذ حجم النطاق الأول بواسطة أساليب get_blob_to_* إذا كان max_connections أكبر من 1. سيتم إرجاع بيانات أقل إذا كان الكائن الثنائي كبير الحجم أصغر من هذا.

MAX_CHUNK_GET_SIZE

int

يتم تنفيذ حجم النطاق اللاحق بواسطة أساليب get_blob_to_* إذا كان max_connections أكبر من 1 وكان الكائن الثنائي كبير الحجم أكبر من MAX_SINGLE_GET_SIZE. سيتم إرجاع بيانات أقل إذا كان باقي الكائن الثنائي كبير الحجم أصغر من هذا. إذا تم تعيين هذا إلى أكبر من 4 ميغابايت، فسيطرح content_validation خطأ إذا تم تمكينه. ومع ذلك، إذا لم يكن content_validation مطلوبا، فقد يكون حجم أكبر من 4 ميغابايت هو الأمثل. لا يوصى بتعيين هذا أقل من 4 ميغابايت.

key_encryption_key

object

مفتاح تشفير المفتاح الذي يوفره المستخدم اختياريا. إذا تم توفيره، فسيتم استخدامه لتشفير/فك التشفير بالطرق المدعومة. بالنسبة للأساليب التي تتطلب فك التشفير، يجب توفير key_encryption_key أو المحلل. إذا تم توفير كليهما، فسيكون للمحلل الأسبقية. يجب تنفيذ الأساليب التالية لواجهات برمجة التطبيقات التي تتطلب التشفير: wrap_key (المفتاح)-يلتف المفتاح المحدد (البايت) باستخدام خوارزمية من اختيار المستخدم. إرجاع المفتاح المشفر كوحدات بايت. get_key_wrap_algorithm()-إرجاع الخوارزمية المستخدمة لالتفاف المفتاح المتماثل المحدد. get_kid()-إرجاع معرف مفتاح سلسلة لمفتاح تشفير المفتاح هذا. يجب تنفيذ الأساليب التالية لواجهات برمجة التطبيقات التي تتطلب فك التشفير: unwrap_key(مفتاح، خوارزمية)-إرجاع النموذج غير المتراخي للمفتاح المتماثل المحدد باستخدام الخوارزمية المحددة بالسلسلة. get_kid()-إرجاع معرف مفتاح سلسلة لمفتاح تشفير المفتاح هذا.

key_resolver_function

kid) (<xref:function>

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

require_encryption

bool

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

الأساليب

abort_copy_blob	إحباط عملية copy_blob معلقة، وترك كائن ثنائي كبير الحجم وجهة مع صفر طول وبيانات تعريف كاملة.
acquire_blob_lease	يطلب عقد إيجار جديد. إذا لم يكن للكائن الثنائي كبير الحجم عقد إيجار نشط، تقوم خدمة Blob بإنشاء عقد إيجار على الكائن الثنائي كبير الحجم وإرجاع معرف عقد إيجار جديد.
acquire_container_lease	يطلب عقد إيجار جديد. إذا لم يكن للحاوية عقد إيجار نشط، تقوم خدمة Blob بإنشاء عقد إيجار على الحاوية وإرجاع معرف إيجار جديد.
batch_delete_blobs	يرسل دفعة من طلبات حذف كائن ثنائي كبير الحجم متعددة. يحذف أسلوب حذف الكائن الثنائي كبير الحجم الكائن الثنائي كبير الحجم المحدد أو اللقطة. لاحظ أن حذف كائن ثنائي كبير الحجم يؤدي أيضا إلى حذف جميع لقطاته. لمزيد من المعلومات، راجع https://docs.microsoft.com/rest/api/storageservices/delete-blob
break_blob_lease	يكسر عقد الإيجار، إذا كان للكائن الثنائي كبير الحجم عقد إيجار نشط. بمجرد قطع عقد الإيجار، لا يمكن تجديده. يمكن لأي طلب مصرح به قطع عقد الإيجار؛ الطلب غير مطلوب لتحديد معرف عقد إيجار مطابق. عند قطع عقد الإيجار، يسمح بفترة توقف التأجير بالانقضاء، وخلال هذه الفترة لا يمكن إجراء أي عملية تأجير باستثناء التوقف والإصدار على الكائن الثنائي كبير الحجم. عند قطع عقد الإيجار بنجاح، تشير الاستجابة إلى الفاصل الزمني بالثوان حتى يمكن الحصول على عقد إيجار جديد. يمكن أيضا إصدار عقد إيجار تم قطعه، وفي هذه الحالة قد يحصل عميل آخر على عقد الإيجار على الكائن الثنائي كبير الحجم على الفور.
break_container_lease	اكسر عقد الإيجار، إذا كانت الحاوية لديها عقد إيجار نشط. بمجرد قطع عقد الإيجار، لا يمكن تجديده. يمكن لأي طلب مصرح به قطع عقد الإيجار؛ الطلب غير مطلوب لتحديد معرف عقد إيجار مطابق. عند قطع عقد الإيجار، يسمح بفترة توقف التأجير بالانقضاء، وخلال هذه الفترة لا يمكن إجراء أي عملية تأجير باستثناء التوقف والإصدار على الحاوية. عند قطع عقد الإيجار بنجاح، تشير الاستجابة إلى الفاصل الزمني بالثوان حتى يمكن الحصول على عقد إيجار جديد.
change_blob_lease	تغيير معرف عقد الإيجار لعقد إيجار نشط. يجب أن يتضمن التغيير معرف التأجير الحالي ومعرف التأجير الجديد.
change_container_lease	تغيير معرف عقد الإيجار لعقد إيجار نشط. يجب أن يتضمن التغيير معرف التأجير الحالي ومعرف التأجير الجديد.
copy_blob	نسخ كائن ثنائي كبير الحجم بشكل غير متزامن. تقوم هذه العملية بإرجاع كائن خصائص عملية النسخ، بما في ذلك معرف النسخ الذي يمكنك استخدامه للتحقق من عملية النسخ أو إجهاضها. تنسخ خدمة Blob الكائنات الثنائية كبيرة الحجم على أساس أفضل جهد. قد يكون الكائن الثنائي كبير الحجم المصدر لعملية نسخ كائن ثنائي كبير الحجم للكتلة أو كائن ثنائي كبير الحجم للإلحاق أو كائن ثنائي كبير الحجم للصفحة. إذا كان الكائن الثنائي كبير الحجم في الوجهة موجودة بالفعل، يجب أن يكون من نفس نوع الكائن الثنائي كبير الحجم الموجود في المصدر. سيتم استبدال أي كائن ثنائي كبير الحجم وجهة موجود. لا يمكن تعديل الكائن الثنائي كبير الحجم الوجهة أثناء عملية النسخ قيد التقدم. عند النسخ من كائن ثنائي كبير الحجم للصفحة، تقوم خدمة Blob بإنشاء كائن ثنائي كبير الحجم للصفحة الوجهة لطول الكائن الثنائي كبير الحجم المصدر، يحتوي في البداية على جميع الأصفار. ثم يتم تعداد نطاقات الصفحات المصدر، ويتم نسخ النطاقات غير الفارغة. بالنسبة لكائن ثنائي كبير الحجم للكتلة أو كائن ثنائي كبير الحجم ملحق، تنشئ خدمة Blob كائن ثنائي كبير الحجم ملتزما بطول صفري قبل العودة من هذه العملية. عند النسخ من كائن ثنائي كبير الحجم للكتلة، يتم نسخ جميع الكتل الملتزم بها ومعرفات الكتلة الخاصة بها. لا يتم نسخ الكتل غير الملتزم بها. في نهاية عملية النسخ، سيكون للكائن الثنائي كبير الحجم الوجهة نفس عدد الكتل الملتزم بها مثل المصدر. عند النسخ من كائن ثنائي كبير الحجم للإلحاق، يتم نسخ جميع الكتل الملتزم بها. في نهاية عملية النسخ، سيكون للكائن الثنائي كبير الحجم الوجهة نفس عدد الكتل الملتزم بها مثل المصدر. بالنسبة لجميع أنواع الكائنات الثنائية كبيرة الحجم، يمكنك استدعاء get_blob_properties على الكائن الثنائي كبير الحجم الوجهة للتحقق من حالة عملية النسخ. سيتم تثبيت الكائن الثنائي كبير الحجم النهائي عند اكتمال النسخ.
create_container	إنشاء حاوية جديدة ضمن الحساب المحدد. إذا كانت الحاوية بنفس الاسم موجودة بالفعل، تفشل العملية إذا كانت fail_on_exist True.
delete_blob	وضع علامة على الكائن الثنائي كبير الحجم أو اللقطة المحددة للحذف. يتم حذف الكائن الثنائي كبير الحجم لاحقا أثناء تجميع البيانات المهملة. لاحظ أنه من أجل حذف كائن ثنائي كبير الحجم، يجب حذف جميع لقطاته. يمكنك حذف كليهما في نفس الوقت باستخدام عملية حذف كائن ثنائي كبير الحجم. إذا تم تمكين نهج استبقاء الحذف للخدمة، فإن هذه العملية تحذف مبدئيا الكائن الثنائي كبير الحجم أو اللقطة وتحتفظ بالكائنات الثنائية كبيرة الحجم أو اللقطة لعدد محدد من الأيام. بعد عدد محدد من الأيام، تتم إزالة بيانات الكائن الثنائي كبير الحجم من الخدمة أثناء تجميع البيانات المهملة. يمكن الوصول إلى الكائن الثنائي كبير الحجم أو اللقطة المحذوفة مبدئيا من خلال قائمة Blobs API التي تحدد خيار include=Include.Deleted. يمكن استعادة الكائن الثنائي كبير الحجم أو اللقطة المحذوفة مبدئيا باستخدام واجهة برمجة تطبيقات Undelete.
delete_container	وضع علامة على الحاوية المحددة للحذف. يتم حذف الحاوية وأي كائنات ثنائية كبيرة الحجم موجودة داخلها لاحقا أثناء تجميع البيانات المهملة.
exists	إرجاع قيمة منطقية تشير إلى ما إذا كانت الحاوية موجودة (إذا كانت blob_name هي None)، أو قيمة منطقية تشير إلى ما إذا كان الكائن الثنائي كبير الحجم موجودا أم لا.
extract_date_and_request_id
generate_account_shared_access_signature	إنشاء توقيع وصول مشترك لخدمة الكائن الثنائي كبير الحجم. استخدم التوقيع الذي تم إرجاعه مع المعلمة sas_token لأي BlobService.
generate_blob_shared_access_signature	إنشاء توقيع وصول مشترك للكائن الثنائي كبير الحجم أو إحدى اللقطات الخاصة به. استخدم التوقيع الذي تم إرجاعه مع المعلمة sas_token لأي BlobService.
generate_container_shared_access_signature	إنشاء توقيع وصول مشترك للحاوية. استخدم التوقيع الذي تم إرجاعه مع المعلمة sas_token لأي BlobService.
get_blob_account_information	يحصل على معلومات تتعلق بحساب التخزين. يمكن أيضا استرداد المعلومات إذا كان لدى المستخدم SAS إلى حاوية أو كائن ثنائي كبير الحجم.
get_blob_metadata	إرجاع جميع بيانات التعريف المعرفة من قبل المستخدم للكائن الثنائي كبير الحجم أو اللقطة المحددة.
get_blob_properties	إرجاع جميع بيانات التعريف المعرفة من قبل المستخدم وخصائص HTTP القياسية وخصائص النظام للكائن الثنائي كبير الحجم. لا يرجع محتوى الكائن الثنائي كبير الحجم. إرجاع Blob مع BlobProperties ومهمة بيانات التعريف.
get_blob_service_properties	يحصل على خصائص خدمة Blob لحساب التخزين، بما في ذلك Azure Storage Analytics.
get_blob_service_stats	استرداد الإحصائيات المتعلقة بالنسخ المتماثل لخدمة Blob. لا يتوفر إلا عند تمكين النسخ المتماثل المتكرر جغرافيا للوصول إلى القراءة لحساب التخزين. مع النسخ المتماثل المتكرر جغرافيا، يحافظ Azure Storage على استمرارية بياناتك في موقعين. في كلا الموقعين، يحتفظ Azure Storage باستمرار بنسخ متماثلة صحية متعددة من بياناتك. الموقع الذي تقرأ فيه البيانات أو تنشئها أو تحدثها أو تحذفها هو موقع حساب التخزين الأساسي. الموقع الأساسي موجود في المنطقة التي تختارها في وقت إنشاء حساب عبر مدخل Azure Management Azure الكلاسيكي، على سبيل المثال، شمال وسط الولايات المتحدة. الموقع الذي يتم نسخ بياناتك إليه هو الموقع الثانوي. يتم تحديد الموقع الثانوي تلقائيا استنادا إلى موقع الأساسي؛ إنه في مركز بيانات ثان موجود في نفس المنطقة مثل الموقع الأساسي. يتوفر الوصول للقراءة فقط من الموقع الثانوي، إذا تم تمكين النسخ المتماثل المتكرر جغرافيا للوصول للقراءة لحساب التخزين الخاص بك.
get_blob_to_bytes	تنزيل كائن ثنائي كبير الحجم كصفيف من وحدات البايت، مع التقسيم التلقائي وإعلامات التقدم. إرجاع مثيل مع Blob الخصائص وبيانات التعريف والمحتوى.
get_blob_to_path	تنزيل كائن ثنائي كبير الحجم إلى مسار ملف، مع التقسيم التلقائي وإعلامات التقدم. إرجاع مثيل مع Blob الخصائص وبيانات التعريف.
get_blob_to_stream	تنزيل كائن ثنائي كبير الحجم إلى دفق، مع التقسيم التلقائي وإعلامات التقدم. إرجاع مثيل مع Blob الخصائص وبيانات التعريف.
get_blob_to_text	تنزيل كائن ثنائي كبير الحجم كنص unicode، مع التقسيم التلقائي وإعلامات التقدم. إرجاع مثيل مع Blob الخصائص وبيانات التعريف والمحتوى.
get_container_acl	الحصول على أذونات الحاوية المحددة. تشير الأذونات إلى ما إذا كان يمكن الوصول إلى بيانات الحاوية بشكل عام.
get_container_metadata	إرجاع كافة بيانات التعريف المعرفة من قبل المستخدم للحاوية المحددة.
get_container_properties	إرجاع جميع بيانات التعريف المعرفة من قبل المستخدم وخصائص النظام للحاوية المحددة. لا تتضمن البيانات التي تم إرجاعها قائمة الكائنات الثنائية كبيرة الحجم للحاوية.
get_user_delegation_key	احصل على مفتاح تفويض مستخدم لغرض توقيع رموز SAS المميزة. يجب أن تكون بيانات اعتماد الرمز المميز موجودة على عنصر الخدمة حتى ينجح هذا الطلب.
list_blob_names	إرجاع منشئ لسرد أسماء الكائنات الثنائية كبيرة الحجم ضمن الحاوية المحددة. سيتبع المولد ببطء الرموز المميزة للمتابعة التي تم إرجاعها بواسطة الخدمة ويتوقف عند إرجاع جميع الكائنات الثنائية كبيرة الحجم أو الوصول إلى num_results. إذا تم تحديد num_results وكان الحساب يحتوي على أكثر من هذا العدد من الكائنات الثنائية كبيرة الحجم، فسيكون للمنشئ حقل next_marker مملوء بمجرد الانتهاء. يمكن استخدام هذه العلامة لإنشاء منشئ جديد إذا رغبت في الحصول على المزيد من النتائج.
list_blobs	إرجاع منشئ لسرد الكائنات الثنائية كبيرة الحجم ضمن الحاوية المحددة. سيتبع المولد ببطء الرموز المميزة للمتابعة التي تم إرجاعها بواسطة الخدمة ويتوقف عند إرجاع جميع الكائنات الثنائية كبيرة الحجم أو الوصول إلى num_results. إذا تم تحديد num_results وكان الحساب يحتوي على أكثر من هذا العدد من الكائنات الثنائية كبيرة الحجم، فسيكون للمنشئ حقل next_marker مملوء بمجرد الانتهاء. يمكن استخدام هذه العلامة لإنشاء منشئ جديد إذا رغبت في الحصول على المزيد من النتائج.
list_containers	إرجاع منشئ لسرد الحاويات ضمن الحساب المحدد. سيتبع المولد ببطء الرموز المميزة للاستمرار التي تم إرجاعها بواسطة الخدمة ويتوقف عند إرجاع جميع الحاويات أو الوصول إلى num_results. إذا تم تحديد num_results وكان الحساب يحتوي على أكثر من هذا العدد من الحاويات، فسيكون للمنشئ حقل next_marker مملوء بمجرد الانتهاء. يمكن استخدام هذه العلامة لإنشاء منشئ جديد إذا رغبت في الحصول على المزيد من النتائج.
make_blob_url	إنشاء عنوان url للوصول إلى كائن ثنائي كبير الحجم.
make_container_url	إنشاء عنوان url للوصول إلى حاوية.
release_blob_lease	إصدار عقد الإيجار. قد يتم تحرير عقد الإيجار إذا كان معرف التأجير المحدد في الطلب يتطابق مع الكائن الثنائي كبير الحجم. يسمح إصدار عقد الإيجار لعميل آخر بالحصول على عقد الإيجار على الفور للكائن الثنائي كبير الحجم بمجرد اكتمال الإصدار.
release_container_lease	حرر عقد الإيجار. قد يتم إصدار عقد الإيجار إذا كان lease_id المحدد يتطابق مع الحاوية. يسمح إصدار عقد الإيجار لعميل آخر بالحصول على عقد الإيجار للحاوية فورا بمجرد اكتمال الإصدار.
renew_blob_lease	تجديد عقد الإيجار. يمكن تجديد عقد الإيجار إذا كان معرف التأجير المحدد في الطلب يتطابق مع ذلك المقترن بكائن ثنائي كبير الحجم. لاحظ أنه قد يتم تجديد عقد الإيجار حتى إذا انتهت صلاحيته طالما لم يتم تعديل الكائن الثنائي كبير الحجم أو تأجيره مرة أخرى منذ انتهاء عقد الإيجار هذا. عند تجديد عقد إيجار، يتم إعادة تعيين ساعة مدة الإيجار.
renew_container_lease	تجديد عقد الإيجار. يمكن تجديد عقد الإيجار إذا كان معرف الإيجار المحدد يتطابق مع الحاوية. لاحظ أنه قد يتم تجديد عقد الإيجار حتى إذا انتهت صلاحيته طالما لم يتم تأجير الحاوية مرة أخرى منذ انتهاء عقد الإيجار هذا. عند تجديد عقد إيجار، يتم إعادة تعيين ساعة مدة الإيجار.
set_blob_metadata	تعيين بيانات التعريف المعرفة من قبل المستخدم للكائن الثنائي كبير الحجم المحدد كزوج واحد أو أكثر من أزواج قيمة الاسم.
set_blob_properties	تعيين خصائص النظام على الكائن الثنائي كبير الحجم. إذا تم تعيين خاصية واحدة content_settings، فسيتم تجاوز جميع الخصائص.
set_blob_service_properties	تعيين خصائص خدمة Blob لحساب التخزين، بما في ذلك Azure Storage Analytics. إذا تم ترك عنصر (على سبيل المثال التسجيل) ك بلا، يتم الاحتفاظ بالإعدادات الموجودة على الخدمة لتلك الوظيفة.
set_container_acl	تعيين أذونات الحاوية المحددة أو نهج الوصول المخزنة التي يمكن استخدامها مع توقيعات الوصول المشترك. تشير الأذونات إلى ما إذا كان يمكن الوصول إلى الكائنات الثنائية كبيرة الحجم في حاوية بشكل عام.
set_container_metadata	تعيين زوج واحد أو أكثر من أزواج الاسم والقيم المعرفة من قبل المستخدم للحاوية المحددة. يحل كل استدعاء لهذه العملية محل جميع بيانات التعريف الموجودة المرفقة بالحاوية. لإزالة جميع بيانات التعريف من الحاوية، قم باستدعاء هذه العملية بدون إملاء بيانات التعريف.
set_proxy	تعيين مضيف الخادم الوكيل والمنفذ ل HTTP CONNECT Tunnelling.
snapshot_blob	إنشاء لقطة للقراءة فقط لكائن ثنائي كبير الحجم.
undelete_blob	تستعيد عملية إلغاء حذف كائن ثنائي كبير الحجم محتويات وبيانات التعريف للكائن الثنائي كبير الحجم أو اللقطة المحذوفة مبدئيا. ستنجح محاولة إلغاء حذف كائن ثنائي كبير الحجم أو لقطة لم يتم حذفها مبدئيا دون أي تغييرات.

abort_copy_blob

إحباط عملية copy_blob معلقة، وترك كائن ثنائي كبير الحجم وجهة مع صفر طول وبيانات تعريف كاملة.

abort_copy_blob(container_name, blob_name, copy_id, lease_id=None, timeout=None)

المعلمات

container_name

str

مطلوب

اسم حاوية الوجهة.

blob_name

str

مطلوب

اسم الكائن الثنائي كبير الحجم الوجهة.

copy_id

str

مطلوب

معرف النسخ المتوفر في copy.id لعملية copy_blob الأصلية.

lease_id

str

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

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

timeout

int

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

يتم التعبير عن معلمة المهلة بالثوان.

acquire_blob_lease

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

acquire_blob_lease(container_name, blob_name, lease_duration=-1, proposed_lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None)

المعلمات

container_name

str

مطلوب

اسم الحاوية الموجودة.

blob_name

str

مطلوب

اسم الكائن الثنائي كبير الحجم الموجود.

lease_duration

int

القيمة الافتراضية: -1

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

proposed_lease_id

str

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

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

if_modified_since

datetime

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

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

if_unmodified_since

datetime

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

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

if_match

str

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

قيمة ETag أو حرف البدل (*). حدد هذا العنوان لتنفيذ العملية فقط إذا تطابق ETag للمورد مع القيمة المحددة.

if_none_match

str

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

قيمة ETag أو حرف البدل (). حدد هذا العنوان لتنفيذ العملية فقط إذا لم يتطابق ETag للمورد مع القيمة المحددة. حدد حرف البدل () لتنفيذ العملية فقط إذا لم يكن المورد موجودا، وفشل العملية إذا كانت موجودة.

timeout

int

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

يتم التعبير عن معلمة المهلة بالثوان.

المرتجعات

شارع

acquire_container_lease

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

acquire_container_lease(container_name, lease_duration=-1, proposed_lease_id=None, if_modified_since=None, if_unmodified_since=None, timeout=None)

المعلمات

container_name

str

مطلوب

اسم الحاوية الموجودة.

lease_duration

int

القيمة الافتراضية: -1

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

proposed_lease_id

str

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

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

if_modified_since

datetime

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

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

if_unmodified_since

datetime

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

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

timeout

int

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

يتم التعبير عن معلمة المهلة بالثوان.

المرتجعات

شارع

batch_delete_blobs

يرسل دفعة من طلبات حذف كائن ثنائي كبير الحجم متعددة.

يحذف أسلوب حذف الكائن الثنائي كبير الحجم الكائن الثنائي كبير الحجم المحدد أو اللقطة. لاحظ أن حذف كائن ثنائي كبير الحجم يؤدي أيضا إلى حذف جميع لقطاته. لمزيد من المعلومات، راجع https://docs.microsoft.com/rest/api/storageservices/delete-blob

batch_delete_blobs(batch_delete_sub_requests, timeout=None)

المعلمات

batch_delete_sub_requests

list(BatchDeleteSubRequest)

مطلوب

طلبات حذف الكائن الثنائي كبير الحجم لإرسالها كدفعة.

timeout

int

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

يتم التعبير عن معلمة المهلة بالثوان.

المرتجعات

استجابة HTTP لحذف الدفعة التي تم تحليلها

نوع الإرجاع

list <xref:of> BatchSubResponse

break_blob_lease

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

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

break_blob_lease(container_name, blob_name, lease_break_period=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None)

المعلمات

container_name

str

مطلوب

اسم الحاوية الموجودة.

blob_name

str

مطلوب

اسم الكائن الثنائي كبير الحجم الموجود.

lease_break_period

int

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

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

if_modified_since

datetime

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

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

if_unmodified_since

datetime

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

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

if_match

str

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

قيمة ETag أو حرف البدل (*). حدد هذا العنوان لتنفيذ العملية فقط إذا كان ETag الخاص بالمورد يطابق القيمة المحددة.

if_none_match

str

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

قيمة ETag، أو حرف البدل (). حدد هذا العنوان لتنفيذ العملية فقط إذا لم يتطابق ETag للمورد مع القيمة المحددة. حدد حرف البدل () لتنفيذ العملية فقط إذا لم يكن المورد موجودا، وفشل العملية إذا كانت موجودة.

timeout

int

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

يتم التعبير عن معلمة المهلة بالثوان.

المرتجعات

int

break_container_lease

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

break_container_lease(container_name, lease_break_period=None, if_modified_since=None, if_unmodified_since=None, timeout=None)

المعلمات

container_name

str

مطلوب

اسم الحاوية الموجودة.

lease_break_period

int

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

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

if_modified_since

datetime

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

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

if_unmodified_since

datetime

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

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

timeout

int

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

يتم التعبير عن معلمة المهلة بالثوان.

المرتجعات

int

change_blob_lease

تغيير معرف عقد الإيجار لعقد إيجار نشط. يجب أن يتضمن التغيير معرف التأجير الحالي ومعرف التأجير الجديد.

change_blob_lease(container_name, blob_name, lease_id, proposed_lease_id, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None)

المعلمات

container_name

str

مطلوب

اسم الحاوية الموجودة.

blob_name

str

مطلوب

اسم الكائن الثنائي كبير الحجم الموجود.

lease_id

str

مطلوب

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

proposed_lease_id

str

مطلوب

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

if_modified_since

datetime

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

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

if_unmodified_since

datetime

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

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

if_match

str

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

قيمة ETag أو حرف البدل (*). حدد هذا العنوان لتنفيذ العملية فقط إذا كان ETag الخاص بالمورد يطابق القيمة المحددة.

if_none_match

str

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

قيمة ETag، أو حرف البدل (). حدد هذا العنوان لتنفيذ العملية فقط إذا لم يتطابق ETag للمورد مع القيمة المحددة. حدد حرف البدل () لتنفيذ العملية فقط إذا لم يكن المورد موجودا، وفشل العملية إذا كانت موجودة.

timeout

int

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

يتم التعبير عن معلمة المهلة بالثوان.

change_container_lease

تغيير معرف عقد الإيجار لعقد إيجار نشط. يجب أن يتضمن التغيير معرف التأجير الحالي ومعرف التأجير الجديد.

change_container_lease(container_name, lease_id, proposed_lease_id, if_modified_since=None, if_unmodified_since=None, timeout=None)

المعلمات

container_name

str

مطلوب

اسم الحاوية الموجودة.

lease_id

str

مطلوب

معرف التأجير للتأجير النشط.

proposed_lease_id

str

مطلوب

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

if_modified_since

datetime

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

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

if_unmodified_since

datetime

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

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

timeout

int

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

يتم التعبير عن معلمة المهلة بالثوان.

copy_blob

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

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

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

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

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

بالنسبة لجميع أنواع الكائنات الثنائية كبيرة الحجم، يمكنك استدعاء get_blob_properties على الكائن الثنائي كبير الحجم الوجهة للتحقق من حالة عملية النسخ. سيتم تثبيت الكائن الثنائي كبير الحجم النهائي عند اكتمال النسخ.

copy_blob(container_name, blob_name, copy_source, metadata=None, source_if_modified_since=None, source_if_unmodified_since=None, source_if_match=None, source_if_none_match=None, destination_if_modified_since=None, destination_if_unmodified_since=None, destination_if_match=None, destination_if_none_match=None, destination_lease_id=None, source_lease_id=None, timeout=None)

المعلمات

container_name

str

مطلوب

اسم الحاوية الوجهة. يجب أن تكون الحاوية موجودة.

blob_name

str

مطلوب

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

copy_source

str

مطلوب

عنوان URL يصل طوله إلى 2 كيلوبايت يحدد ملف Azure أو كائن ثنائي كبير الحجم. يجب أن تكون القيمة مشفرة بعنوان URL كما ستظهر في عنوان URI للطلب. إذا كان المصدر في حساب آخر، فيجب أن يكون المصدر عاما أو يجب مصادقته عبر توقيع وصول مشترك. إذا كان المصدر عاما، فلن تكون هناك حاجة إلى مصادقة. أمثلة: https://myaccount.blob.core.windows.net/mycontainer/myblobhttps://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot= https://otheraccount.blob.core.windows.net/mycontainer/myblob?sastoken

metadata

dict(str, str)

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

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

source_if_modified_since

datetime

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

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

source_if_unmodified_since

datetime

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

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

source_if_match

<xref:ETag>

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

قيمة ETag أو حرف البدل (*). حدد هذا العنوان الشرطي لنسخ الكائن الثنائي كبير الحجم المصدر فقط إذا كان ETag الخاص به يطابق القيمة المحددة. إذا لم تتطابق قيم ETag، فترجع خدمة Blob رمز الحالة 412 (فشل الشرط المسبق). لا يمكن تحديد هذا العنوان إذا كان المصدر هو ملف Azure.

source_if_none_match

<xref:ETag>

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

قيمة ETag أو حرف البدل (*). حدد هذا العنوان الشرطي لنسخ الكائن الثنائي كبير الحجم فقط إذا لم يتطابق ETag الخاص به مع القيمة المحددة. إذا كانت القيم متطابقة، فترجع خدمة Blob رمز الحالة 412 (فشل الشرط المسبق). لا يمكن تحديد هذا العنوان إذا كان المصدر هو ملف Azure.

destination_if_modified_since

datetime

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

قيمة DateTime. يتوقع Azure أن تكون قيمة التاريخ التي تم تمريرها UTC. إذا تم تضمين المنطقة الزمنية، فسيتم تحويل أي تواريخ غير UTC إلى UTC. إذا تم تمرير تاريخ بدون معلومات المنطقة الزمنية، فمن المفترض أن يكون UTC. حدد هذا العنوان الشرطي لنسخ الكائن الثنائي كبير الحجم فقط إذا تم تعديل الكائن الثنائي كبير الحجم الوجهة منذ التاريخ/الوقت المحدد. إذا لم يتم تعديل الكائن الثنائي كبير الحجم الوجهة، تقوم خدمة Blob بإرجاع رمز الحالة 412 (فشل الشرط المسبق).

destination_if_unmodified_since

datetime

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

قيمة DateTime. يتوقع Azure أن تكون قيمة التاريخ التي تم تمريرها UTC. إذا تم تضمين المنطقة الزمنية، فسيتم تحويل أي تواريخ غير UTC إلى UTC. إذا تم تمرير تاريخ بدون معلومات المنطقة الزمنية، فمن المفترض أن يكون UTC. حدد هذا العنوان الشرطي لنسخ الكائن الثنائي كبير الحجم فقط إذا لم يتم تعديل الكائن الثنائي كبير الحجم الوجهة منذ التاريخ/الوقت المحدد. إذا تم تعديل الكائن الثنائي كبير الحجم الوجهة، تقوم خدمة Blob بإرجاع رمز الحالة 412 (فشل الشرط المسبق).

destination_if_match

<xref:ETag>

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

قيمة ETag أو حرف البدل (*). حدد قيمة ETag لهذا العنوان الشرطي لنسخ الكائن الثنائي كبير الحجم فقط إذا كانت قيمة ETag المحددة تطابق قيمة ETag لكائن ثنائي كبير الحجم وجهة موجود. إذا لم يتطابق ETag للكائن الثنائي كبير الحجم الوجهة مع ETag المحدد ل If-Match، فترجع خدمة Blob رمز الحالة 412 (فشل الشرط المسبق).

destination_if_none_match

<xref:ETag>

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

قيمة ETag، أو حرف البدل (). حدد قيمة ETag لهذا العنوان الشرطي لنسخ الكائن الثنائي كبير الحجم فقط إذا كانت قيمة ETag المحددة لا تتطابق مع قيمة ETag للكائن الثنائي كبير الحجم الوجهة. حدد حرف البدل () لتنفيذ العملية فقط إذا لم يكن الكائن الثنائي كبير الحجم الوجهة موجودا. إذا لم يتم استيفاء الشرط المحدد، تقوم خدمة Blob بإرجاع رمز الحالة 412 (فشل الشرط المسبق).

destination_lease_id

str

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

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

source_lease_id

str

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

حدد هذا لتنفيذ عملية Copy Blob فقط إذا كان معرف الإيجار المحدد يطابق معرف الإيجار النشط للكائن الثنائي كبير الحجم المصدر.

timeout

int

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

يتم التعبير عن معلمة المهلة بالثوان.

المرتجعات

نسخ خصائص العملية مثل الحالة والمصدر والمعرف.

نوع الإرجاع

CopyProperties

create_container

إنشاء حاوية جديدة ضمن الحساب المحدد. إذا كانت الحاوية بنفس الاسم موجودة بالفعل، تفشل العملية إذا كانت fail_on_exist True.

create_container(container_name, metadata=None, public_access=None, fail_on_exist=False, timeout=None)

المعلمات

container_name

str

مطلوب

اسم الحاوية المراد إنشاؤها. قد يحتوي اسم الحاوية على أحرف صغيرة وأرقام وواصلات فقط، ويجب أن يبدأ بحرف أو رقم. يجب أن يُسبق كل واصلة ويتبعها حرف غير واصلة. يجب أن يتراوح طول الاسم أيضاً بين 3 و63 حرفاً.

metadata

dict(str, str)

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

إملاء مع أزواج name_value لإقرانها بالحاوية كبيانات تعريف. مثال:{'Category':'test'}

public_access

PublicAccess

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

تتضمن القيم المحتملة: الحاوية، الكائن الثنائي كبير الحجم.

fail_on_exist

bool

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

حدد ما إذا كنت تريد طرح استثناء عند وجود الحاوية.

timeout

int

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

يتم التعبير عن معلمة المهلة بالثوان.

المرتجعات

صحيح إذا تم إنشاء الحاوية، خطأ إذا كانت الحاوية موجودة بالفعل.

نوع الإرجاع

bool

delete_blob

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

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

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

delete_blob(container_name, blob_name, snapshot=None, lease_id=None, delete_snapshots=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None)

المعلمات

container_name

str

مطلوب

اسم الحاوية الموجودة.

blob_name

str

مطلوب

اسم الكائن الثنائي كبير الحجم الموجود.

snapshot

str

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

معلمة اللقطة هي قيمة DateTime مبهمة تحدد لقطة الكائن الثنائي كبير الحجم لحذفها عند وجودها.

lease_id

str

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

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

delete_snapshots

DeleteSnapshot

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

مطلوب إذا كان الكائن الثنائي كبير الحجم يحتوي على لقطات مقترنة.

if_modified_since

datetime

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

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

if_unmodified_since

datetime

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

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

if_match

str

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

قيمة ETag أو حرف البدل (*). حدد هذا العنوان لتنفيذ العملية فقط إذا كان ETag الخاص بالمورد يطابق القيمة المحددة.

if_none_match

str

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

قيمة ETag، أو حرف البدل (). حدد هذا العنوان لتنفيذ العملية فقط إذا لم يتطابق ETag للمورد مع القيمة المحددة. حدد حرف البدل () لتنفيذ العملية فقط إذا لم يكن المورد موجودا، وفشل العملية إذا كانت موجودة.

timeout

int

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

يتم التعبير عن معلمة المهلة بالثوان.

delete_container

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

delete_container(container_name, fail_not_exist=False, lease_id=None, if_modified_since=None, if_unmodified_since=None, timeout=None)

المعلمات

container_name

str

مطلوب

اسم الحاوية المراد حذفها.

fail_not_exist

bool

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

حدد ما إذا كنت تريد طرح استثناء عندما لا تكون الحاوية موجودة.

lease_id

str

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

إذا تم تحديده، delete_container ينجح فقط إذا كان عقد إيجار الحاوية نشطا ويطابق هذا المعرف. مطلوب إذا كانت الحاوية لديها عقد إيجار نشط.

if_modified_since

datetime

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

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

if_unmodified_since

datetime

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

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

timeout

int

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

يتم التعبير عن معلمة المهلة بالثوان.

المرتجعات

True إذا تم حذف الحاوية، فإن حاوية False غير موجودة.

نوع الإرجاع

bool

exists

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

exists(container_name, blob_name=None, snapshot=None, timeout=None)

المعلمات

container_name

str

مطلوب

اسم الحاوية.

blob_name

str

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

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

snapshot

str

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

معلمة اللقطة هي قيمة DateTime مبهمة تحدد اللقطة عند وجودها.

timeout

int

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

يتم التعبير عن معلمة المهلة بالثوان.

المرتجعات

قيمة منطقية تشير إلى ما إذا كان المورد موجودا أم لا.

نوع الإرجاع

bool

extract_date_and_request_id

static extract_date_and_request_id(retry_context)

المعلمات

retry_context

مطلوب

generate_account_shared_access_signature

إنشاء توقيع وصول مشترك لخدمة الكائن الثنائي كبير الحجم. استخدم التوقيع الذي تم إرجاعه مع المعلمة sas_token لأي BlobService.

generate_account_shared_access_signature(resource_types, permission, expiry, start=None, ip=None, protocol=None)

المعلمات

resource_types

<xref:ResourceTypes>

مطلوب

يحدد أنواع الموارد التي يمكن الوصول إليها باستخدام SAS للحساب.

permission

<xref:AccountPermissions>

مطلوب

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

expiry

datetime أو str

مطلوب

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

start

datetime أو str

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

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

ip

str

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

يحدد عنوان IP أو نطاق عناوين IP التي يمكن قبول الطلبات منها. إذا كان عنوان IP الذي ينشأ منه الطلب لا يتطابق مع عنوان IP أو نطاق العنوان المحدد على رمز SAS المميز، فلن تتم مصادقة الطلب. على سبيل المثال، يؤدي تحديد sip=168.1.5.65 أو sip=168.1.5.60-168.1.5.70 على SAS إلى تقييد الطلب إلى عناوين IP هذه.

protocol

str

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

يحدد البروتوكول المسموح به لطلب تم إجراؤه. القيمة الافتراضية هي https,http. راجع Protocol للقيم المحتملة.

المرتجعات

رمز مميز لتوقيع الوصول المشترك (sas).

نوع الإرجاع

str

generate_blob_shared_access_signature

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

generate_blob_shared_access_signature(container_name, blob_name, snapshot=None, permission=None, expiry=None, start=None, id=None, ip=None, protocol=None, cache_control=None, content_disposition=None, content_encoding=None, content_language=None, content_type=None, user_delegation_key=None)

المعلمات

container_name

str

مطلوب

اسم الحاوية.

blob_name

str

مطلوب

اسم الكائن الثنائي كبير الحجم.

snapshot

str

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

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

permission

BlobPermissions

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

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

expiry

datetime أو str

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

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

start

datetime أو str

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

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

id

str

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

قيمة فريدة يصل طولها إلى 64 حرفا ترتبط بنهج وصول مخزن. لإنشاء نهج وصول مخزن، استخدم set_container_acl.

ip

str

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

يحدد عنوان IP أو نطاق عناوين IP التي يمكن قبول الطلبات منها. إذا كان عنوان IP الذي ينشأ منه الطلب لا يتطابق مع عنوان IP أو نطاق العنوان المحدد على رمز SAS المميز، فلن تتم مصادقة الطلب. على سبيل المثال، يؤدي تحديد sip=168.1.5.65 أو sip=168.1.5.60-168.1.5.70 على SAS إلى تقييد الطلب إلى عناوين IP هذه.

protocol

str

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

يحدد البروتوكول المسموح به لطلب تم إجراؤه. القيمة الافتراضية هي https,http. راجع Protocol للقيم المحتملة.

cache_control

str

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

قيمة عنوان الاستجابة Cache-Control عند الوصول إلى المورد باستخدام توقيع الوصول المشترك هذا.

content_disposition

str

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

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

content_encoding

str

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

قيمة عنوان الاستجابة لترميز المحتوى عند الوصول إلى المورد باستخدام توقيع الوصول المشترك هذا.

content_language

str

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

قيمة عنوان الاستجابة ل Content-Language عند الوصول إلى المورد باستخدام توقيع الوصول المشترك هذا.

content_type

str

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

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

user_delegation_key

UserDelegationKey

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

بدلا من مفتاح حساب، يمكن للمستخدم تمرير مفتاح تفويض مستخدم. يمكن الحصول على مفتاح تفويض مستخدم من الخدمة عن طريق المصادقة بهوية AAD؛ يمكن تحقيق ذلك عن طريق استدعاء get_user_delegation_key. عند وجوده، يتم توقيع SAS باستخدام مفتاح تفويض المستخدم بدلا من ذلك.

المرتجعات

رمز مميز لتوقيع الوصول المشترك (sas).

نوع الإرجاع

str

generate_container_shared_access_signature

إنشاء توقيع وصول مشترك للحاوية. استخدم التوقيع الذي تم إرجاعه مع المعلمة sas_token لأي BlobService.

generate_container_shared_access_signature(container_name, permission=None, expiry=None, start=None, id=None, ip=None, protocol=None, cache_control=None, content_disposition=None, content_encoding=None, content_language=None, content_type=None, user_delegation_key=None)

المعلمات

container_name

str

مطلوب

اسم الحاوية.

permission

ContainerPermissions

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

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

expiry

datetime أو str

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

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

start

datetime أو str

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

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

id

str

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

قيمة فريدة يصل طولها إلى 64 حرفا ترتبط بنهج وصول مخزن. لإنشاء نهج وصول مخزن، استخدم set_blob_service_properties.

ip

str

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

تحديد عنوان IP أو نطاق من عناوين IP التي يمكن قبول الطلبات منها. إذا كان عنوان IP الذي ينشأ منه الطلب لا يتطابق مع عنوان IP أو نطاق العنوان المحدد على رمز SAS المميز، فلن تتم مصادقة الطلب. على سبيل المثال، يؤدي تحديد sip=168.1.5.65 أو sip=168.1.5.60-168.1.5.70 على SAS إلى تقييد الطلب على عناوين IP هذه.

protocol

str

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

يحدد البروتوكول المسموح به لطلب تم إجراؤه. القيمة الافتراضية هي https,http. راجع Protocol للقيم المحتملة.

cache_control

str

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

قيمة عنوان الاستجابة Cache-Control عند الوصول إلى المورد باستخدام توقيع الوصول المشترك هذا.

content_disposition

str

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

قيمة عنوان الاستجابة ل Content-Disposition عند الوصول إلى المورد باستخدام توقيع الوصول المشترك هذا.

content_encoding

str

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

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

content_language

str

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

قيمة عنوان الاستجابة ل Content-Language عند الوصول إلى المورد باستخدام توقيع الوصول المشترك هذا.

content_type

str

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

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

user_delegation_key

UserDelegationKey

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

بدلا من مفتاح حساب، يمكن للمستخدم تمرير مفتاح تفويض مستخدم. يمكن الحصول على مفتاح تفويض المستخدم من الخدمة عن طريق المصادقة باستخدام هوية AAD؛ يمكن تحقيق ذلك عن طريق استدعاء get_user_delegation_key. عند الحضور، يتم توقيع SAS باستخدام مفتاح تفويض المستخدم بدلا من ذلك.

المرتجعات

رمز مميز لتوقيع الوصول المشترك (sas).

نوع الإرجاع

str

get_blob_account_information

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

get_blob_account_information(container_name=None, blob_name=None, timeout=None)

المعلمات

container_name

str

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

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

blob_name

str

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

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

timeout

int

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

يتم التعبير عن معلمة المهلة بالثوان.

المرتجعات

الـ ⁧AccountInformation⁩.

get_blob_metadata

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

get_blob_metadata(container_name, blob_name, snapshot=None, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)

المعلمات

container_name

str

مطلوب

اسم الحاوية الموجودة.

blob_name

str

مطلوب

اسم الكائن الثنائي كبير الحجم الموجود.

snapshot

str

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

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

lease_id

str

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

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

if_modified_since

datetime

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

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

if_unmodified_since

datetime

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

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

if_match

str

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

قيمة ETag أو حرف البدل (*). حدد هذا العنوان لتنفيذ العملية فقط إذا كان ETag الخاص بالمورد يطابق القيمة المحددة.

if_none_match

str

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

قيمة ETag، أو حرف البدل (). حدد هذا العنوان لتنفيذ العملية فقط إذا لم يتطابق ETag للمورد مع القيمة المحددة. حدد حرف البدل () لتنفيذ العملية فقط إذا لم يكن المورد موجودا، وفشل العملية إذا كانت موجودة.

cpk

CustomerProvidedEncryptionKey

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

فك تشفير البيانات على جانب الخدمة باستخدام المفتاح المحدد. يجب استخدام المفاتيح التي يوفرها العميل عبر HTTPS. كما يتم توفير مفتاح التشفير نفسه في الطلب، يجب إنشاء اتصال آمن لنقل المفتاح.

timeout

int

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

يتم التعبير عن معلمة المهلة بالثوان.

المرتجعات

قاموس يمثل اسم بيانات تعريف الكائن الثنائي كبير الحجم وأزواج القيم.

نوع الإرجاع

dict(str, str)

get_blob_properties

إرجاع جميع بيانات التعريف المعرفة من قبل المستخدم وخصائص HTTP القياسية وخصائص النظام للكائن الثنائي كبير الحجم. لا يرجع محتوى الكائن الثنائي كبير الحجم. إرجاع Blob مع BlobProperties ومهمة بيانات التعريف.

get_blob_properties(container_name, blob_name, snapshot=None, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)

المعلمات

container_name

str

مطلوب

اسم الحاوية الموجودة.

blob_name

str

مطلوب

اسم الكائن الثنائي كبير الحجم الموجود.

snapshot

str

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

معلمة اللقطة هي قيمة DateTime مبهمة تحدد لقطة الكائن الثنائي كبير الحجم لاستردادها عند وجودها.

lease_id

str

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

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

if_modified_since

datetime

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

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

if_unmodified_since

datetime

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

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

if_match

str

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

قيمة ETag أو حرف البدل (*). حدد هذا العنوان لتنفيذ العملية فقط إذا كان ETag الخاص بالمورد يطابق القيمة المحددة.

if_none_match

str

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

قيمة ETag، أو حرف البدل (). حدد هذا العنوان لتنفيذ العملية فقط إذا لم يتطابق ETag للمورد مع القيمة المحددة. حدد حرف البدل () لتنفيذ العملية فقط إذا لم يكن المورد موجودا، وفشل العملية إذا كانت موجودة.

cpk

CustomerProvidedEncryptionKey

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

فك تشفير البيانات على جانب الخدمة باستخدام المفتاح المحدد. يجب استخدام المفاتيح التي يوفرها العميل عبر HTTPS. كما يتم توفير مفتاح التشفير نفسه في الطلب، يجب إنشاء اتصال آمن لنقل المفتاح.

timeout

int

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

يتم التعبير عن معلمة المهلة بالثوان.

المرتجعات

كائن كائن ثنائي كبير الحجم بما في ذلك الخصائص وبيانات التعريف.

نوع الإرجاع

Blob

get_blob_service_properties

يحصل على خصائص خدمة Blob لحساب التخزين، بما في ذلك Azure Storage Analytics.

get_blob_service_properties(timeout=None)

المعلمات

timeout

int

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

يتم التعبير عن معلمة المهلة بالثوان.

المرتجعات

الكائن الثنائي كبير الحجم ServiceProperties مع خاصية target_version مرفقة.

get_blob_service_stats

استرداد الإحصائيات المتعلقة بالنسخ المتماثل لخدمة Blob. لا يتوفر إلا عند تمكين النسخ المتماثل المتكرر جغرافيا للوصول إلى القراءة لحساب التخزين.

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

get_blob_service_stats(timeout=None)

المعلمات

timeout

int

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

يتم التعبير عن معلمة المهلة بالثوان.

المرتجعات

إحصائيات خدمة كائن ثنائي كبير الحجم.

نوع الإرجاع

ServiceStats

get_blob_to_bytes

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

get_blob_to_bytes(container_name, blob_name, snapshot=None, start_range=None, end_range=None, validate_content=False, progress_callback=None, max_connections=2, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)

المعلمات

container_name

str

مطلوب

اسم الحاوية الموجودة.

blob_name

str

مطلوب

اسم الكائن الثنائي كبير الحجم الموجود.

snapshot

str

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

معلمة اللقطة هي قيمة DateTime مبهمة تحدد لقطة الكائن الثنائي كبير الحجم لاستردادها عند وجودها.

start_range

int

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

بداية نطاق البايت لاستخدامه لتنزيل مقطع من الكائن الثنائي كبير الحجم. إذا لم يتم إعطاء أي end_range، فسيتم تنزيل جميع وحدات البايت بعد start_range. start_range و params end_range شاملة. على سبيل المثال: سيقوم start_range=0، end_range=511 بتنزيل أول 512 بايت من الكائن الثنائي كبير الحجم.

end_range

int

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

نهاية نطاق البايت المراد استخدامه لتنزيل مقطع من الكائن الثنائي كبير الحجم. إذا تم إعطاء end_range، يجب توفير start_range. start_range و params end_range شاملة. على سبيل المثال: سيقوم start_range=0، end_range=511 بتنزيل أول 512 بايت من الكائن الثنائي كبير الحجم.

validate_content

bool

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

إذا تم تعيينه إلى صحيح، يتحقق من صحة تجزئة MD5 لكل جزء تم استرداده من الكائن الثنائي كبير الحجم. هذا مهم في المقام الأول للكشف عن bitflips على السلك إذا كان استخدام http بدلا من https ك https (الافتراضي) سيتم التحقق من صحته بالفعل. لاحظ أن الخدمة ستعيد فقط MD5s للمعاملات للأجزاء 4 ميغابايت أو أقل بحيث يكون طلب الحصول الأول ذاتي الحجم. MAX_CHUNK_GET_SIZE بدلا من النفس. MAX_SINGLE_GET_SIZE. إذا كان ذاتي. MAX_CHUNK_GET_SIZE تم تعيينه إلى أكبر من 4 ميغابايت سيتم طرح خطأ. نظرا لأن حوسبة MD5 تستغرق وقت المعالجة وستحتاج إلى إجراء المزيد من الطلبات بسبب انخفاض حجم المجموعة، فقد يكون هناك بعض الزيادة في زمن الانتقال.

progress_callback

<xref:func>(<xref:current>, <xref:total>)

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

رد الاتصال للتقدم مع دالة التوقيع (الحالي، الإجمالي) حيث الحالي هو عدد وحدات البايت المنقولة حتى الآن، والإجمالي هو حجم الكائن الثنائي كبير الحجم إذا كان معروفا.

max_connections

int

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

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

lease_id

str

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

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

if_modified_since

datetime

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

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

if_unmodified_since

datetime

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

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

if_match

str

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

قيمة ETag أو حرف البدل (*). حدد هذا العنوان لتنفيذ العملية فقط إذا تطابق ETag للمورد مع القيمة المحددة.

if_none_match

str

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

قيمة ETag أو حرف البدل (). حدد هذا العنوان لتنفيذ العملية فقط إذا لم يتطابق ETag للمورد مع القيمة المحددة. حدد حرف البدل () لتنفيذ العملية فقط إذا لم يكن المورد موجودا، وفشل العملية إذا كانت موجودة.

cpk

CustomerProvidedEncryptionKey

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

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

timeout

int

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

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

المرتجعات

كائن ثنائي كبير الحجم مع خصائص وبيانات تعريف. إذا كان max_connections أكبر من 1، فلن يتم إرجاع content_md5 (إذا تم تعيينه على الكائن الثنائي كبير الحجم). إذا كنت بحاجة إلى هذه القيمة، فاستخدم get_blob_properties أو قم بتعيين max_connections إلى 1.

نوع الإرجاع

Blob

get_blob_to_path

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

get_blob_to_path(container_name, blob_name, file_path, open_mode='wb', snapshot=None, start_range=None, end_range=None, validate_content=False, progress_callback=None, max_connections=2, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)

المعلمات

container_name

str

مطلوب

اسم الحاوية الموجودة.

blob_name

str

مطلوب

اسم الكائن الثنائي كبير الحجم الموجود.

file_path

str

مطلوب

مسار الملف للكتابة إليه.

open_mode

str

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

الوضع المراد استخدامه عند فتح الملف. لاحظ أن تحديد open_mode الإلحاق فقط يمنع التنزيل المتوازي. لذلك، يجب تعيين max_connections إلى 1 إذا تم استخدام هذا open_mode.

snapshot

str

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

معلمة اللقطة هي قيمة DateTime مبهمة تحدد لقطة الكائن الثنائي كبير الحجم لاستردادها عند وجودها.

start_range

int

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

بداية نطاق البايت لاستخدامه لتنزيل مقطع من الكائن الثنائي كبير الحجم. إذا لم يتم إعطاء أي end_range، فسيتم تنزيل جميع وحدات البايت بعد start_range. start_range و params end_range شاملة. على سبيل المثال: سيقوم start_range=0، end_range=511 بتنزيل أول 512 بايت من الكائن الثنائي كبير الحجم.

end_range

int

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

نهاية نطاق البايت المراد استخدامه لتنزيل مقطع من الكائن الثنائي كبير الحجم. إذا تم إعطاء end_range، يجب توفير start_range. start_range و params end_range شاملة. على سبيل المثال: سيقوم start_range=0، end_range=511 بتنزيل أول 512 بايت من الكائن الثنائي كبير الحجم.

validate_content

bool

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

إذا تم تعيينه إلى صحيح، يتحقق من صحة تجزئة MD5 لكل جزء تم استرداده من الكائن الثنائي كبير الحجم. هذا مهم في المقام الأول للكشف عن bitflips على السلك إذا كان استخدام http بدلا من https ك https (الافتراضي) سيتم التحقق من صحته بالفعل. لاحظ أن الخدمة ستعيد فقط MD5s للمعاملات للأجزاء 4 ميغابايت أو أقل بحيث يكون طلب الحصول الأول ذاتي الحجم. MAX_CHUNK_GET_SIZE بدلا من النفس. MAX_SINGLE_GET_SIZE. إذا كان ذاتي. MAX_CHUNK_GET_SIZE تم تعيينه إلى أكبر من 4 ميغابايت سيتم طرح خطأ. نظرا لأن حوسبة MD5 تستغرق وقت المعالجة وستحتاج إلى إجراء المزيد من الطلبات بسبب انخفاض حجم المجموعة، فقد يكون هناك بعض الزيادة في زمن الانتقال.

progress_callback

<xref:func>(<xref:current>, <xref:total>)

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

رد الاتصال للتقدم مع دالة التوقيع (الحالي، الإجمالي) حيث الحالي هو عدد وحدات البايت المنقولة حتى الآن، والإجمالي هو حجم الكائن الثنائي كبير الحجم إذا كان معروفا.

max_connections

int

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

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

lease_id

str

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

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

if_modified_since

datetime

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

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

if_unmodified_since

datetime

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

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

if_match

str

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

قيمة ETag أو حرف البدل (*). حدد هذا العنوان لتنفيذ العملية فقط إذا تطابق ETag للمورد مع القيمة المحددة.

if_none_match

str

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

قيمة ETag أو حرف البدل (). حدد هذا العنوان لتنفيذ العملية فقط إذا لم يتطابق ETag للمورد مع القيمة المحددة. حدد حرف البدل () لتنفيذ العملية فقط إذا لم يكن المورد موجودا، وفشل العملية إذا كانت موجودة.

cpk

CustomerProvidedEncryptionKey

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

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

timeout

int

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

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

المرتجعات

كائن ثنائي كبير الحجم مع خصائص وبيانات تعريف. إذا كان max_connections أكبر من 1، فلن يتم إرجاع content_md5 (إذا تم تعيينه على الكائن الثنائي كبير الحجم). إذا كنت بحاجة إلى هذه القيمة، فاستخدم get_blob_properties أو قم بتعيين max_connections إلى 1.

نوع الإرجاع

Blob

get_blob_to_stream

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

get_blob_to_stream(container_name, blob_name, stream, snapshot=None, start_range=None, end_range=None, validate_content=False, progress_callback=None, max_connections=2, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)

المعلمات

container_name

str

مطلوب

اسم الحاوية الموجودة.

blob_name

str

مطلوب

اسم الكائن الثنائي كبير الحجم الموجود.

stream

IOBase

مطلوب

دفق مفتوح للكتابة إليه.

snapshot

str

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

معلمة اللقطة هي قيمة DateTime مبهمة تحدد لقطة الكائن الثنائي كبير الحجم لاستردادها عند وجودها.

start_range

int

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

بداية نطاق البايت لاستخدامه لتنزيل مقطع من الكائن الثنائي كبير الحجم. إذا لم يتم إعطاء أي end_range، فسيتم تنزيل جميع وحدات البايت بعد start_range. start_range و params end_range شاملة. على سبيل المثال: سيقوم start_range=0، end_range=511 بتنزيل أول 512 بايت من الكائن الثنائي كبير الحجم.

end_range

int

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

نهاية نطاق البايت المراد استخدامه لتنزيل مقطع من الكائن الثنائي كبير الحجم. إذا تم إعطاء end_range، يجب توفير start_range. start_range و params end_range شاملة. على سبيل المثال: سيقوم start_range=0، end_range=511 بتنزيل أول 512 بايت من الكائن الثنائي كبير الحجم.

validate_content

bool

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

إذا تم تعيينه إلى صحيح، يتحقق من صحة تجزئة MD5 لكل جزء تم استرداده من الكائن الثنائي كبير الحجم. هذا مهم في المقام الأول للكشف عن bitflips على السلك إذا كان استخدام http بدلا من https ك https (الافتراضي) سيتم التحقق من صحته بالفعل. لاحظ أن الخدمة ستعيد فقط MD5s للمعاملات للمجموعات 4 ميغابايت أو أقل بحيث يكون طلب الحصول الأول ذاتي الحجم. MAX_CHUNK_GET_SIZE بدلا من النفس. MAX_SINGLE_GET_SIZE. إذا كانت ذاتية. تم تعيين MAX_CHUNK_GET_SIZE إلى أكبر من 4 ميغابايت سيتم طرح خطأ. نظرا لأن حوسبة MD5 تستغرق وقت المعالجة وستحتاج إلى إجراء المزيد من الطلبات بسبب انخفاض حجم المجموعة، فقد تكون هناك بعض الزيادة في زمن الانتقال.

progress_callback

<xref:func>(<xref:current>, <xref:total>)

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

رد الاتصال للتقدم مع دالة التوقيع (الحالية، الإجمالي) حيث الحالي هو عدد وحدات البايت المنقولة حتى الآن، والإجمالي هو حجم الكائن الثنائي كبير الحجم إذا كان معروفا.

max_connections

int

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

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

lease_id

str

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

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

if_modified_since

datetime

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

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

if_unmodified_since

datetime

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

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

if_match

str

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

قيمة ETag أو حرف البدل (*). حدد هذا العنوان لتنفيذ العملية فقط إذا كان ETag الخاص بالمورد يطابق القيمة المحددة.

if_none_match

str

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

قيمة ETag، أو حرف البدل (). حدد هذا العنوان لتنفيذ العملية فقط إذا لم يتطابق ETag للمورد مع القيمة المحددة. حدد حرف البدل () لتنفيذ العملية فقط إذا لم يكن المورد موجودا، وفشل العملية إذا كانت موجودة.

cpk

CustomerProvidedEncryptionKey

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

فك تشفير البيانات على جانب الخدمة باستخدام المفتاح المحدد. يجب استخدام المفاتيح التي يوفرها العميل عبر HTTPS. كما يتم توفير مفتاح التشفير نفسه في الطلب، يجب إنشاء اتصال آمن لنقل المفتاح.

timeout

int

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

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

المرتجعات

كائن ثنائي كبير الحجم مع خصائص وبيانات تعريف. إذا كان max_connections أكبر من 1، فلن يتم إرجاع content_md5 (إذا تم تعيينه على الكائن الثنائي كبير الحجم). إذا كنت بحاجة إلى هذه القيمة، فاستخدم get_blob_properties أو قم بتعيين max_connections إلى 1.

نوع الإرجاع

Blob

get_blob_to_text

تنزيل كائن ثنائي كبير الحجم كنص unicode، مع التقسيم التلقائي وإعلامات التقدم. إرجاع مثيل مع Blob الخصائص وبيانات التعريف والمحتوى.

get_blob_to_text(container_name, blob_name, encoding='utf-8', snapshot=None, start_range=None, end_range=None, validate_content=False, progress_callback=None, max_connections=2, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)

المعلمات

container_name

str

مطلوب

اسم الحاوية الموجودة.

blob_name

str

مطلوب

اسم الكائن الثنائي كبير الحجم الموجود.

encoding

str

القيمة الافتراضية: utf-8

ترميز Python لاستخدامه عند فك تشفير بيانات الكائن الثنائي كبير الحجم.

snapshot

str

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

معلمة اللقطة هي قيمة DateTime مبهمة تحدد لقطة الكائن الثنائي كبير الحجم لاستردادها عند وجودها.

start_range

int

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

بداية نطاق البايت لاستخدامه لتنزيل مقطع من الكائن الثنائي كبير الحجم. إذا لم يتم إعطاء أي end_range، فسيتم تنزيل جميع وحدات البايت بعد start_range. start_range و params end_range شاملة. على سبيل المثال: سيقوم start_range=0، end_range=511 بتنزيل أول 512 بايت من الكائن الثنائي كبير الحجم.

end_range

int

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

نهاية نطاق البايت المراد استخدامه لتنزيل مقطع من الكائن الثنائي كبير الحجم. إذا تم إعطاء end_range، يجب توفير start_range. start_range و params end_range شاملة. على سبيل المثال: سيقوم start_range=0، end_range=511 بتنزيل أول 512 بايت من الكائن الثنائي كبير الحجم.

validate_content

bool

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

إذا تم تعيينه إلى صحيح، يتحقق من صحة تجزئة MD5 لكل جزء تم استرداده من الكائن الثنائي كبير الحجم. هذا مهم في المقام الأول للكشف عن bitflips على السلك إذا كان استخدام http بدلا من https ك https (الافتراضي) سيتم التحقق من صحته بالفعل. لاحظ أن الخدمة ستعيد فقط MD5s للمعاملات للمجموعات 4 ميغابايت أو أقل بحيث يكون طلب الحصول الأول ذاتي الحجم. MAX_CHUNK_GET_SIZE بدلا من النفس. MAX_SINGLE_GET_SIZE. إذا كانت ذاتية. تم تعيين MAX_CHUNK_GET_SIZE إلى أكبر من 4 ميغابايت سيتم طرح خطأ. نظرا لأن حوسبة MD5 تستغرق وقت المعالجة وستحتاج إلى إجراء المزيد من الطلبات بسبب انخفاض حجم المجموعة، فقد تكون هناك بعض الزيادة في زمن الانتقال.

progress_callback

<xref:func>(<xref:current>, <xref:total>)

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

رد الاتصال للتقدم مع دالة التوقيع (الحالية، الإجمالي) حيث الحالي هو عدد وحدات البايت المنقولة حتى الآن، والإجمالي هو حجم الكائن الثنائي كبير الحجم إذا كان معروفا.

max_connections

int

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

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

lease_id

str

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

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

if_modified_since

datetime

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

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

if_unmodified_since

datetime

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

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

if_match

str

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

قيمة ETag أو حرف البدل (*). حدد هذا العنوان لتنفيذ العملية فقط إذا كان ETag الخاص بالمورد يطابق القيمة المحددة.

if_none_match

str

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

قيمة ETag، أو حرف البدل (). حدد هذا العنوان لتنفيذ العملية فقط إذا لم يتطابق ETag للمورد مع القيمة المحددة. حدد حرف البدل () لتنفيذ العملية فقط إذا لم يكن المورد موجودا، وفشل العملية إذا كانت موجودة.

cpk

CustomerProvidedEncryptionKey

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

فك تشفير البيانات على جانب الخدمة باستخدام المفتاح المحدد. يجب استخدام المفاتيح التي يوفرها العميل عبر HTTPS. كما يتم توفير مفتاح التشفير نفسه في الطلب، يجب إنشاء اتصال آمن لنقل المفتاح.

timeout

int

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

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

المرتجعات

كائن ثنائي كبير الحجم مع خصائص وبيانات تعريف. إذا كان max_connections أكبر من 1، فلن يتم إرجاع content_md5 (إذا تم تعيينه على الكائن الثنائي كبير الحجم). إذا كنت بحاجة إلى هذه القيمة، فاستخدم get_blob_properties أو قم بتعيين max_connections إلى 1.

نوع الإرجاع

Blob

get_container_acl

الحصول على أذونات الحاوية المحددة. تشير الأذونات إلى ما إذا كان يمكن الوصول إلى بيانات الحاوية بشكل عام.

get_container_acl(container_name, lease_id=None, timeout=None)

المعلمات

container_name

str

مطلوب

اسم الحاوية الموجودة.

lease_id

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

إذا تم تحديده، get_container_acl ينجح فقط إذا كان عقد إيجار الحاوية نشطا ويطابق هذا المعرف.

timeout

int

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

يتم التعبير عن معلمة المهلة بالثوان.

المرتجعات

قاموس لنهج الوصول المقترنة بالحاوية. لوحة من str إلى AccessPolicy وخاصية public_access إذا كان الوصول العام قيد التشغيل

get_container_metadata

إرجاع كافة بيانات التعريف المعرفة من قبل المستخدم للحاوية المحددة.

get_container_metadata(container_name, lease_id=None, timeout=None)

المعلمات

container_name

str

مطلوب

اسم الحاوية الموجودة.

lease_id

str

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

إذا تم تحديده، get_container_metadata ينجح فقط إذا كان عقد إيجار الحاوية نشطا ويطابق هذا المعرف.

timeout

int

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

يتم التعبير عن معلمة المهلة بالثوان.

المرتجعات

قاموس يمثل اسم بيانات تعريف الحاوية وأزواج القيم.

نوع الإرجاع

dict(str, str)

get_container_properties

إرجاع جميع بيانات التعريف المعرفة من قبل المستخدم وخصائص النظام للحاوية المحددة. لا تتضمن البيانات التي تم إرجاعها قائمة الكائنات الثنائية كبيرة الحجم للحاوية.

get_container_properties(container_name, lease_id=None, timeout=None)

المعلمات

container_name

str

مطلوب

اسم الحاوية الموجودة.

lease_id

str

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

إذا تم تحديده، get_container_properties ينجح فقط إذا كان عقد إيجار الحاوية نشطا ويطابق هذا المعرف.

timeout

int

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

يتم التعبير عن معلمة المهلة بالثوان.

المرتجعات

خصائص الحاوية المحددة داخل كائن حاوية.

نوع الإرجاع

Container

get_user_delegation_key

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

get_user_delegation_key(key_start_time, key_expiry_time, timeout=None)

المعلمات

key_start_time

datetime

مطلوب

قيمة DateTime. يشير إلى متى يصبح المفتاح صالحا.

key_expiry_time

datetime

مطلوب

قيمة DateTime. يشير إلى متى يتوقف المفتاح عن كونه صالحا.

timeout

int

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

يتم التعبير عن معلمة المهلة بالثوان.

المرتجعات

مفتاح تفويض المستخدم.

نوع الإرجاع

UserDelegationKey

list_blob_names

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

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

list_blob_names(container_name, prefix=None, num_results=None, include=None, delimiter=None, marker=None, timeout=None)

المعلمات

container_name

str

مطلوب

اسم الحاوية الموجودة.

prefix

str

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

تصفية النتائج لإرجاع الكائنات الثنائية كبيرة الحجم التي تبدأ أسماؤها بالبادئة المحددة فقط.

num_results

int

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

يحدد الحد الأقصى لعدد الكائنات الثنائية كبيرة الحجم المراد إرجاعها، بما في ذلك جميع <xref:azure.storage.blob.baseblobservice.BlobPrefix> العناصر. إذا لم يحدد الطلب num_results أو يحدد قيمة أكبر من 5000، فسيرجع الخادم ما يصل إلى 5000 عنصر. يؤدي تعيين num_results إلى قيمة أقل من أو تساوي صفرا إلى ظهور رمز استجابة الخطأ 400 (طلب غير صحيح).

include

Include

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

يحدد مجموعة بيانات إضافية واحدة أو أكثر لتضمينها في الاستجابة.

delimiter

str

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

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

marker

str

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

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

timeout

int

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

يتم التعبير عن معلمة المهلة بالثوان.

list_blobs

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

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

list_blobs(container_name, prefix=None, num_results=None, include=None, delimiter=None, marker=None, timeout=None)

المعلمات

container_name

str

مطلوب

اسم الحاوية الموجودة.

prefix

str

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

تصفية النتائج لإرجاع الكائنات الثنائية كبيرة الحجم التي تبدأ أسماؤها بالبادئة المحددة فقط.

num_results

int

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

يحدد الحد الأقصى لعدد الكائنات الثنائية كبيرة الحجم المراد إرجاعها، بما في ذلك جميع <xref:azure.storage.blob.baseblobservice.BlobPrefix> العناصر. إذا لم يحدد الطلب num_results أو يحدد قيمة أكبر من 5000، فسيرجع الخادم ما يصل إلى 5000 عنصر. يؤدي تعيين num_results إلى قيمة أقل من أو تساوي صفرا إلى ظهور رمز استجابة الخطأ 400 (طلب غير صحيح).

include

Include

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

يحدد مجموعة بيانات إضافية واحدة أو أكثر لتضمينها في الاستجابة.

delimiter

str

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

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

marker

str

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

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

timeout

int

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

يتم التعبير عن معلمة المهلة بالثوان.

list_containers

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

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

list_containers(prefix=None, num_results=None, include_metadata=False, marker=None, timeout=None)

المعلمات

prefix

str

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

تصفية النتائج لإرجاع الحاويات التي تبدأ أسماؤها بالبادئة المحددة فقط.

num_results

int

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

يحدد الحد الأقصى لعدد الحاويات المراد إرجاعها. قد يرجع طلب قائمة واحدة ما يصل إلى 1000 contianers وربما رمز استمرار مميز يجب اتباعه للحصول على قوالب إعادة تشغيل إضافية.

include_metadata

bool

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

يحدد إرجاع بيانات تعريف الحاوية في الاستجابة.

marker

str

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

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

timeout

int

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

يتم التعبير عن معلمة المهلة بالثوان.

make_blob_url

إنشاء عنوان url للوصول إلى كائن ثنائي كبير الحجم.

make_blob_url(container_name, blob_name, protocol=None, sas_token=None, snapshot=None)

المعلمات

container_name

str

مطلوب

اسم الحاوية.

blob_name

str

مطلوب

اسم الكائن الثنائي كبير الحجم.

protocol

str

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

البروتوكول المراد استخدامه: 'http' أو 'https'. إذا لم يتم تحديده، يستخدم البروتوكول المحدد عند تهيئة BaseBlobService.

sas_token

str

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

الرمز المميز لتوقيع الوصول المشترك الذي تم إنشاؤه باستخدام generate_shared_access_signature.

snapshot

str

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

قيمة سلسلة تعرف اللقطة بشكل فريد. تشير قيمة معلمة الاستعلام هذه إلى إصدار اللقطة.

المرتجعات

عنوان URL للوصول إلى كائن ثنائي كبير الحجم.

نوع الإرجاع

str

make_container_url

إنشاء عنوان url للوصول إلى حاوية.

make_container_url(container_name, protocol=None, sas_token=None)

المعلمات

container_name

str

مطلوب

اسم الحاوية.

protocol

str

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

البروتوكول المراد استخدامه: 'http' أو 'https'. إذا لم يتم تحديده، يستخدم البروتوكول المحدد عند تهيئة BaseBlobService.

sas_token

str

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

الرمز المميز لتوقيع الوصول المشترك الذي تم إنشاؤه باستخدام generate_shared_access_signature.

المرتجعات

عنوان URL للوصول إلى الحاوية.

نوع الإرجاع

str

release_blob_lease

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

release_blob_lease(container_name, blob_name, lease_id, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None)

المعلمات

container_name

str

مطلوب

اسم الحاوية الموجودة.

blob_name

str

مطلوب

اسم الكائن الثنائي كبير الحجم الموجود.

lease_id

str

مطلوب

معرف التأجير للتأجير النشط.

if_modified_since

datetime

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

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

if_unmodified_since

datetime

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

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

if_match

str

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

قيمة ETag أو حرف البدل (*). حدد هذا العنوان لتنفيذ العملية فقط إذا كان ETag الخاص بالمورد يطابق القيمة المحددة.

if_none_match

str

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

قيمة ETag، أو حرف البدل (). حدد هذا العنوان لتنفيذ العملية فقط إذا لم يتطابق ETag للمورد مع القيمة المحددة. حدد حرف البدل () لتنفيذ العملية فقط إذا لم يكن المورد موجودا، وفشل العملية إذا كانت موجودة.

timeout

int

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

يتم التعبير عن معلمة المهلة بالثوان.

release_container_lease

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

release_container_lease(container_name, lease_id, if_modified_since=None, if_unmodified_since=None, timeout=None)

المعلمات

container_name

str

مطلوب

اسم الحاوية الموجودة.

lease_id

str

مطلوب

معرف التأجير للتأجير النشط.

if_modified_since

datetime

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

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

if_unmodified_since

datetime

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

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

timeout

int

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

يتم التعبير عن معلمة المهلة بالثوان.

renew_blob_lease

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

renew_blob_lease(container_name, blob_name, lease_id, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None)

المعلمات

container_name

str

مطلوب

اسم الحاوية الموجودة.

blob_name

str

مطلوب

اسم الكائن الثنائي كبير الحجم الموجود.

lease_id

str

مطلوب

معرف التأجير للتأجير النشط.

if_modified_since

datetime

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

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

if_unmodified_since

datetime

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

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

if_match

str

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

قيمة ETag أو حرف البدل (*). حدد هذا العنوان لتنفيذ العملية فقط إذا تطابق ETag للمورد مع القيمة المحددة.

if_none_match

str

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

قيمة ETag أو حرف البدل (). حدد هذا العنوان لتنفيذ العملية فقط إذا لم يتطابق ETag للمورد مع القيمة المحددة. حدد حرف البدل () لتنفيذ العملية فقط إذا لم يكن المورد موجودا، وفشل العملية إذا كانت موجودة.

timeout

int

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

يتم التعبير عن معلمة المهلة بالثوان.

المرتجعات

شارع

renew_container_lease

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

renew_container_lease(container_name, lease_id, if_modified_since=None, if_unmodified_since=None, timeout=None)

المعلمات

container_name

str

مطلوب

اسم الحاوية الموجودة.

lease_id

str

مطلوب

معرف التأجير للتأجير النشط.

if_modified_since

datetime

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

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

if_unmodified_since

datetime

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

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

timeout

int

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

يتم التعبير عن معلمة المهلة بالثوان.

المرتجعات

شارع

set_blob_metadata

تعيين بيانات التعريف المعرفة من قبل المستخدم للكائن الثنائي كبير الحجم المحدد كزوج واحد أو أكثر من أزواج قيمة الاسم.

set_blob_metadata(container_name, blob_name, metadata=None, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)

المعلمات

container_name

str

مطلوب

اسم الحاوية الموجودة.

blob_name

str

مطلوب

اسم الكائن الثنائي كبير الحجم الموجود.

metadata

dict(str, str)

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

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

lease_id

str

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

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

if_modified_since

datetime

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

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

if_unmodified_since

datetime

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

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

if_match

str

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

قيمة ETag أو حرف البدل (*). حدد هذا العنوان لتنفيذ العملية فقط إذا تطابق ETag للمورد مع القيمة المحددة.

if_none_match

str

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

قيمة ETag أو حرف البدل (). حدد هذا العنوان لتنفيذ العملية فقط إذا لم يتطابق ETag للمورد مع القيمة المحددة. حدد حرف البدل () لتنفيذ العملية فقط إذا لم يكن المورد موجودا، وفشل العملية إذا كانت موجودة.

cpk

CustomerProvidedEncryptionKey

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

تشفير البيانات على جانب الخدمة باستخدام المفتاح المحدد. يجب استخدام المفاتيح التي يوفرها العميل عبر HTTPS. نظرا لتوفير مفتاح التشفير نفسه في الطلب، يجب إنشاء اتصال آمن لنقل المفتاح.

timeout

int

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

يتم التعبير عن معلمة المهلة بالثوان.

المرتجعات

ETag وآخر خصائص معدلة للكائن الثنائي كبير الحجم المحدث

نوع الإرجاع

ResourceProperties

set_blob_properties

تعيين خصائص النظام على الكائن الثنائي كبير الحجم. إذا تم تعيين خاصية واحدة content_settings، فسيتم تجاوز جميع الخصائص.

set_blob_properties(container_name, blob_name, content_settings=None, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, cpk=None)

المعلمات

container_name

str

مطلوب

اسم الحاوية الموجودة.

blob_name

str

مطلوب

اسم الكائن الثنائي كبير الحجم الموجود.

content_settings

ContentSettings

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

عنصر ContentSettings المستخدم لتعيين خصائص الكائن الثنائي كبير الحجم.

lease_id

str

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

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

if_modified_since

datetime

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

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

if_unmodified_since

datetime

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

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

if_match

str

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

قيمة ETag أو حرف البدل (*). حدد هذا العنوان لتنفيذ العملية فقط إذا تطابق ETag للمورد مع القيمة المحددة.

if_none_match

str

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

قيمة ETag أو حرف البدل (). حدد هذا العنوان لتنفيذ العملية فقط إذا لم يتطابق ETag للمورد مع القيمة المحددة. حدد حرف البدل () لتنفيذ العملية فقط إذا لم يكن المورد موجودا، وفشل العملية إذا كانت موجودة.

cpk

CustomerProvidedEncryptionKey

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

تشفير البيانات على جانب الخدمة باستخدام المفتاح المحدد. يجب استخدام المفاتيح التي يوفرها العميل عبر HTTPS. نظرا لتوفير مفتاح التشفير نفسه في الطلب، يجب إنشاء اتصال آمن لنقل المفتاح.

timeout

int

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

يتم التعبير عن معلمة المهلة بالثوان.

المرتجعات

ETag وآخر خصائص معدلة للكائن الثنائي كبير الحجم المحدث

نوع الإرجاع

ResourceProperties

set_blob_service_properties

تعيين خصائص خدمة Blob لحساب التخزين، بما في ذلك Azure Storage Analytics. إذا تم ترك عنصر (على سبيل المثال التسجيل) ك بلا، يتم الاحتفاظ بالإعدادات الموجودة على الخدمة لتلك الوظيفة.

set_blob_service_properties(logging=None, hour_metrics=None, minute_metrics=None, cors=None, target_version=None, timeout=None, delete_retention_policy=None, static_website=None)

المعلمات

logging

Logging

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

تجميع إعدادات تسجيل Azure Analytics.

hour_metrics

Metrics

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

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

minute_metrics

Metrics

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

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

cors

list(CorsRule)

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

يمكنك تضمين ما يصل إلى خمسة عناصر CorsRule في القائمة. إذا تم تحديد قائمة فارغة، فسيتم حذف جميع قواعد CORS، وسيتم تعطيل CORS للخدمة.

target_version

str

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

يشير إلى الإصدار الافتراضي الذي يجب استخدامه للطلبات إذا لم يتم تحديد إصدار الطلب الوارد.

timeout

int

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

يتم التعبير عن معلمة المهلة بالثوان.

delete_retention_policy

DeleteRetentionPolicy

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

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

static_website

StaticWebsite

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

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

set_container_acl

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

set_container_acl(container_name, signed_identifiers=None, public_access=None, lease_id=None, if_modified_since=None, if_unmodified_since=None, timeout=None)

المعلمات

container_name

str

مطلوب

اسم الحاوية الموجودة.

signed_identifiers

dict(str, AccessPolicy)

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

قاموس لنهج الوصول لإقرانه بالحاوية. قد يحتوي القاموس على ما يصل إلى 5 عناصر. سيقوم القاموس الفارغ بمسح نهج الوصول المعينة على الخدمة.

public_access

PublicAccess

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

تتضمن القيم المحتملة: الحاوية، الكائن الثنائي كبير الحجم.

lease_id

str

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

إذا تم تحديده، set_container_acl ينجح فقط إذا كان عقد إيجار الحاوية نشطا ويطابق هذا المعرف.

if_modified_since

datetime

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

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

if_unmodified_since

datetime

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

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

timeout

int

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

يتم التعبير عن معلمة المهلة بالثوان.

المرتجعات

ETag وآخر خصائص معدلة للحاوية المحدثة

نوع الإرجاع

ResourceProperties

set_container_metadata

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

set_container_metadata(container_name, metadata=None, lease_id=None, if_modified_since=None, timeout=None)

المعلمات

container_name

str

مطلوب

اسم الحاوية الموجودة.

metadata

dict(str, str)

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

إملاء يحتوي على أزواج الاسم والقيمة لإقرانها بالحاوية كبيانات تعريف. مثال: {'category':'test'}

lease_id

str

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

إذا تم تحديده، set_container_metadata ينجح فقط إذا كان عقد إيجار الحاوية نشطا ويطابق هذا المعرف.

if_modified_since

datetime

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

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

timeout

int

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

يتم التعبير عن معلمة المهلة بالثوان.

المرتجعات

ETag وآخر خصائص معدلة للحاوية المحدثة

نوع الإرجاع

ResourceProperties

set_proxy

تعيين مضيف الخادم الوكيل والمنفذ ل HTTP CONNECT Tunnelling.

set_proxy(host, port, user=None, password=None)

المعلمات

host

str

مطلوب

عنوان الوكيل. مثال: '192.168.0.100'

port

int

مطلوب

منفذ الوكيل. مثال: 6000

user

str

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

المستخدم لتخويل الوكيل.

password

str

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

كلمة المرور لتخويل الوكيل.

snapshot_blob

إنشاء لقطة للقراءة فقط لكائن ثنائي كبير الحجم.

snapshot_blob(container_name, blob_name, metadata=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, lease_id=None, timeout=None, cpk=None)

المعلمات

container_name

str

مطلوب

اسم الحاوية الموجودة.

blob_name

str

مطلوب

اسم الكائن الثنائي كبير الحجم الموجود.

metadata

dict(str, str)

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

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

if_modified_since

datetime

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

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

if_unmodified_since

datetime

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

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

if_match

str

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

قيمة ETag أو حرف البدل (*). حدد هذا العنوان لتنفيذ العملية فقط إذا كان ETag الخاص بالمورد يطابق القيمة المحددة.

if_none_match

str

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

قيمة ETag، أو حرف البدل (). حدد هذا العنوان لتنفيذ العملية فقط إذا لم يتطابق ETag للمورد مع القيمة المحددة. حدد حرف البدل () لتنفيذ العملية فقط إذا لم يكن المورد موجودا، وفشل العملية إذا كانت موجودة.

lease_id

str

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

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

cpk

CustomerProvidedEncryptionKey

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

تشفير البيانات على جانب الخدمة باستخدام المفتاح المحدد. يجب استخدام المفاتيح التي يوفرها العميل عبر HTTPS. كما يتم توفير مفتاح التشفير نفسه في الطلب، يجب إنشاء اتصال آمن لنقل المفتاح.

timeout

int

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

يتم التعبير عن معلمة المهلة بالثوان.

المرتجعات

خصائص اللقطة

نوع الإرجاع

Blob

undelete_blob

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

undelete_blob(container_name, blob_name, timeout=None)

المعلمات

container_name

str

مطلوب

اسم الحاوية الموجودة.

blob_name

str

مطلوب

اسم الكائن الثنائي كبير الحجم الموجود.

timeout

int

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

يتم التعبير عن معلمة المهلة بالثوان.

السمات

protocol

request_session

socket_timeout

MAX_CHUNK_GET_SIZE

MAX_CHUNK_GET_SIZE = 4194304

MAX_SINGLE_GET_SIZE

MAX_SINGLE_GET_SIZE = 33554432