BlockBlobService الفصل

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

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

توريث

BaseBlobService

BlockBlobService

الدالمنشئ

BlockBlobService(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_PUT_SIZE

int

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

MAX_BLOCK_SIZE

int

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

MIN_LARGE_BLOCK_UPLOAD_THRESHOLD

int

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

الأساليب

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
batch_set_standard_blob_tier	يرسل دفعة من طلبات طبقات كائن ثنائي كبير الحجم للكتلة متعددة المجموعة. يتم دعم واجهة برمجة التطبيقات هذه فقط لكتل الكائنات الثنائية كبيرة الحجم على حسابات التخزين القياسية.
break_blob_lease	يكسر عقد الإيجار، إذا كان للكائن الثنائي كبير الحجم عقد إيجار نشط. بمجرد قطع عقد الإيجار، لا يمكن تجديده. يمكن لأي طلب مصرح به قطع عقد الإيجار؛ الطلب غير مطلوب لتحديد معرف عقد إيجار مطابق. عند قطع عقد الإيجار، يسمح بفترة توقف التأجير بالانقضاء، وخلال هذه الفترة لا يمكن إجراء أي عملية تأجير باستثناء التوقف والإصدار على الكائن الثنائي كبير الحجم. عند قطع عقد الإيجار بنجاح، تشير الاستجابة إلى الفاصل الزمني بالثوان حتى يمكن الحصول على عقد إيجار جديد. يمكن أيضا إصدار عقد إيجار تم قطعه، وفي هذه الحالة قد يحصل عميل آخر على عقد الإيجار على الكائن الثنائي كبير الحجم على الفور.
break_container_lease	اكسر عقد الإيجار، إذا كانت الحاوية لديها عقد إيجار نشط. بمجرد قطع عقد الإيجار، لا يمكن تجديده. يمكن لأي طلب مصرح به قطع عقد الإيجار؛ الطلب غير مطلوب لتحديد معرف عقد إيجار مطابق. عند قطع عقد الإيجار، يسمح بفترة توقف التأجير بالانقضاء، وخلال هذه الفترة لا يمكن إجراء أي عملية تأجير باستثناء التوقف والإصدار على الحاوية. عند قطع عقد الإيجار بنجاح، تشير الاستجابة إلى الفاصل الزمني بالثوان حتى يمكن الحصول على عقد إيجار جديد.
change_blob_lease	تغيير معرف عقد الإيجار لعقد إيجار نشط. يجب أن يتضمن التغيير معرف التأجير الحالي ومعرف التأجير الجديد.
change_container_lease	تغيير معرف عقد الإيجار لعقد إيجار نشط. يجب أن يتضمن التغيير معرف التأجير الحالي ومعرف التأجير الجديد.
copy_blob	نسخ كائن ثنائي كبير الحجم. تقوم هذه العملية بإرجاع كائن خصائص عملية النسخ. قد تكون عملية النسخ إما عملية غير متزامنة أو أفضل جهد أو عملية متزامنة. يجب أن يكون المصدر كائن ثنائي كبير الحجم للكتلة إذا كان requires_sync صحيحا. سيتم استبدال أي كائن ثنائي كبير الحجم وجهة موجود. لا يمكن تعديل الكائن الثنائي كبير الحجم الوجهة أثناء عملية النسخ قيد التقدم. عند النسخ من كائن ثنائي كبير الحجم للكتلة، يتم نسخ جميع الكتل الملتزم بها ومعرفات الكتلة الخاصة بها. لا يتم نسخ الكتل غير الملتزم بها. في نهاية عملية النسخ، سيكون للكائن الثنائي كبير الحجم الوجهة نفس عدد الكتل الملتزم بها مثل المصدر. يمكنك استدعاء get_blob_properties على الكائن الثنائي كبير الحجم الوجهة للتحقق من حالة عملية النسخ. سيتم تثبيت الكائن الثنائي كبير الحجم النهائي عند اكتمال النسخ. اسم الحاوية الوجهة. يجب أن تكون الحاوية موجودة. blob_name :p aram str: اسم الكائن الثنائي كبير الحجم الوجهة. إذا كان الكائن الثنائي كبير الحجم الوجهة موجودا، فسيتم الكتابة فوقه. وإلا، سيتم إنشاؤه. :p aram str copy_source: عنوان 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 :p aram metadata: أزواج الاسم والقيمة المقترنة ب blob كبيانات تعريف. إذا لم يتم تحديد أزواج قيمة الاسم، فستنسخ العملية بيانات التعريف من الكائن الثنائي كبير الحجم المصدر أو الملف إلى الكائن الثنائي كبير الحجم الوجهة. إذا تم تحديد زوج واحد أو أكثر من أزواج قيمة الاسم، يتم إنشاء الكائن الثنائي كبير الحجم الوجهة ببيانات التعريف المحددة، ولا يتم نسخ بيانات التعريف من الكائن الثنائي كبير الحجم المصدر أو الملف. :اكتب بيانات التعريف: dict(str, str) :p aram datetime source_if_modified_since: قيمة DateTime. يتوقع Azure أن تكون قيمة التاريخ التي تم تمريرها UTC. إذا تم تضمين المنطقة الزمنية، فسيتم تحويل أي تواريخ غير UTC إلى UTC. إذا تم تمرير تاريخ بدون معلومات المنطقة الزمنية، فمن المفترض أن يكون UTC. حدد هذا العنوان الشرطي لنسخ الكائن الثنائي كبير الحجم فقط إذا تم تعديل الكائن الثنائي كبير الحجم المصدر منذ التاريخ/الوقت المحدد. source_if_unmodified_since التاريخ :p أرام: قيمة DateTime. يتوقع Azure أن تكون قيمة التاريخ التي تم تمريرها UTC. إذا تم تضمين المنطقة الزمنية، فسيتم تحويل أي تواريخ غير UTC إلى UTC. إذا تم تمرير تاريخ بدون معلومات المنطقة الزمنية، فمن المفترض أن يكون UTC. حدد هذا العنوان الشرطي لنسخ الكائن الثنائي كبير الحجم فقط إذا لم يتم تعديل الكائن الثنائي كبير الحجم المصدر منذ التاريخ/الوقت المحدد. :p aram ETag source_if_match: قيمة ETag أو حرف البدل (). حدد هذا العنوان الشرطي لنسخ الكائن الثنائي كبير الحجم المصدر فقط إذا كان ETag الخاص به يطابق القيمة المحددة. إذا لم تتطابق قيم ETag، فترجع خدمة Blob رمز الحالة 412 (فشل الشرط المسبق). لا يمكن تحديد هذا العنوان إذا كان المصدر هو ملف Azure. :p aram ETag source_if_none_match: قيمة ETag أو حرف البدل (). حدد هذا العنوان الشرطي لنسخ الكائن الثنائي كبير الحجم فقط إذا لم يتطابق ETag الخاص به مع القيمة المحددة. إذا كانت القيم متطابقة، فترجع خدمة Blob رمز الحالة 412 (فشل الشرط المسبق). لا يمكن تحديد هذا العنوان إذا كان المصدر هو ملف Azure. :p أرام التاريخ والوقت destination_if_modified_since: قيمة DateTime. يتوقع Azure أن تكون قيمة التاريخ التي تم تمريرها UTC. إذا تم تضمين المنطقة الزمنية، فسيتم تحويل أي تواريخ غير UTC إلى UTC. إذا تم تمرير تاريخ بدون معلومات المنطقة الزمنية، فمن المفترض أن يكون UTC. حدد هذا العنوان الشرطي لنسخ الكائن الثنائي كبير الحجم فقط إذا تم تعديل الكائن الثنائي كبير الحجم الوجهة منذ التاريخ/الوقت المحدد. إذا لم يتم تعديل الكائن الثنائي كبير الحجم الوجهة، تقوم خدمة Blob بإرجاع رمز الحالة 412 (فشل الشرط المسبق). :p أرام التاريخ والوقت destination_if_unmodified_since: قيمة DateTime. يتوقع Azure أن تكون قيمة التاريخ التي تم تمريرها UTC. إذا تم تضمين المنطقة الزمنية، فسيتم تحويل أي تواريخ غير UTC إلى UTC. إذا تم تمرير تاريخ بدون معلومات المنطقة الزمنية، فمن المفترض أن يكون UTC. حدد هذا العنوان الشرطي لنسخ الكائن الثنائي كبير الحجم فقط إذا لم يتم تعديل الكائن الثنائي كبير الحجم الوجهة منذ التاريخ/الوقت المحدد. إذا تم تعديل الكائن الثنائي كبير الحجم الوجهة، تقوم خدمة Blob بإرجاع رمز الحالة 412 (فشل الشرط المسبق). destination_if_match :p aram ETag: قيمة ETag أو حرف البدل (). حدد قيمة ETag لهذا العنوان الشرطي لنسخ الكائن الثنائي كبير الحجم فقط إذا كانت قيمة ETag المحددة تطابق قيمة ETag لكائن ثنائي كبير الحجم وجهة موجود. إذا لم يتطابق ETag للكائن الثنائي كبير الحجم الوجهة مع ETag المحدد ل If-Match، فترجع خدمة Blob رمز الحالة 412 (فشل الشرط المسبق). destination_if_none_match :p aram ETag: قيمة ETag أو حرف البدل (). حدد قيمة ETag لهذا العنوان الشرطي لنسخ الكائن الثنائي كبير الحجم فقط إذا كانت قيمة ETag المحددة لا تتطابق مع قيمة ETag للكائن الثنائي كبير الحجم الوجهة. حدد حرف البدل (*) لتنفيذ العملية فقط إذا لم يكن الكائن الثنائي كبير الحجم الوجهة موجودا. إذا لم يتم استيفاء الشرط المحدد، تقوم خدمة Blob بإرجاع رمز الحالة 412 (فشل الشرط المسبق). :p aram str destination_lease_id: يجب أن يتطابق معرف التأجير المحدد لهذا العنوان مع معرف التأجير للكائن الثنائي كبير الحجم الوجهة. إذا لم يتضمن الطلب معرف التأجير أو لم يكن صالحا، تفشل العملية مع رمز الحالة 412 (فشل الشرط المسبق). :p aram str source_lease_id: حدد هذا لتنفيذ عملية Copy Blob فقط إذا كان معرف الإيجار المحدد يطابق معرف الإيجار النشط للكائن الثنائي كبير الحجم المصدر. مهلة :p aram int: يتم التعبير عن معلمة المهلة بالثوان. :p aram bool requires_sync: يفرض أن الخدمة لن ترجع استجابة حتى تكتمل النسخة. standard_blob_tier :p aram StandardBlobTier: قيمة طبقة كائن ثنائي كبير الحجم قياسية لتعيين الكائن الثنائي كبير الحجم إليها. بالنسبة لهذا الإصدار من المكتبة، ينطبق هذا فقط على حظر الكائنات الثنائية كبيرة الحجم على حسابات التخزين القياسية. :p aram RehydratePriority rehydrate_priority: يشير إلى الأولوية التي يتم بها إعادة ترطيب كائن ثنائي كبير الحجم مؤرشف :return: نسخ خصائص العملية مثل الحالة والمصدر والمعرف. :rtype: CopyProperties
create_blob_from_bytes	إنشاء كائن ثنائي كبير الحجم جديد من صفيف من وحدات البايت، أو تحديث محتوى كائن ثنائي كبير الحجم موجود، مع التقسيم التلقائي وإعلامات التقدم.
create_blob_from_path	إنشاء كائن ثنائي كبير الحجم جديد من مسار ملف، أو تحديث محتوى كائن ثنائي كبير الحجم موجود، مع التقسيم التلقائي وإعلامات التقدم.
create_blob_from_stream	إنشاء كائن ثنائي كبير الحجم جديد من ملف/دفق، أو تحديث محتوى كائن ثنائي كبير الحجم موجود، مع التقسيم التلقائي وإعلامات التقدم.
create_blob_from_text	إنشاء كائن ثنائي كبير الحجم جديد من str/unicode، أو تحديث محتوى كائن ثنائي كبير الحجم موجود، مع التقسيم التلقائي وإعلامات التقدم.
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 و dict بيانات التعريف.
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_block_list	استرداد قائمة الكتل التي تم تحميلها كجزء من كائن ثنائي كبير الحجم للكتلة. هناك قائمتان للكتلة يتم الاحتفاظ بها لكائن ثنائي كبير الحجم: قائمة الكتل الملتزم بها: قائمة الكتل التي تم تثبيتها بنجاح إلى كائن ثنائي كبير الحجم معين باستخدام Put Block List. قائمة كتل غير ملتزم بها: قائمة الكتل التي تم تحميلها لكائن ثنائي كبير الحجم باستخدام Put Block، ولكن لم يتم تثبيتها بعد. يتم تخزين هذه الكتل في Azure بالاشتراك مع كائن ثنائي كبير الحجم، ولكنها لا تشكل بعد جزءا من الكائن الثنائي كبير الحجم.
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 للوصول إلى حاوية.
put_block	إنشاء كتلة جديدة ليتم تثبيتها كجزء من كائن ثنائي كبير الحجم.
put_block_from_url	إنشاء كتلة جديدة ليتم تثبيتها كجزء من كائن ثنائي كبير الحجم.
put_block_list	يكتب كائن ثنائي كبير الحجم عن طريق تحديد قائمة معرفات الكتلة التي تشكل الكائن الثنائي كبير الحجم. لكي تتم كتابتها كجزء من كائن ثنائي كبير الحجم، يجب أن تكون كتلة قد تمت كتابتها بنجاح إلى الخادم في عملية Put Block سابقة. يمكنك استدعاء Put Block List لتحديث كائن ثنائي كبير الحجم عن طريق تحميل الكتل التي تغيرت فقط، ثم تثبيت الكتل الجديدة والحالية معا. يمكنك القيام بذلك عن طريق تحديد ما إذا كنت تريد تثبيت كتلة من قائمة الحظر الملتزم بها أو من قائمة الحظر غير الملتزم بها، أو تثبيت أحدث إصدار تم تحميله من الكتلة، أيا كانت القائمة التي قد تنتمي إليها.
release_blob_lease	إصدار عقد الإيجار. قد يتم إصدار عقد الإيجار إذا كان معرف التأجير المحدد في الطلب يطابق ذلك المقترن ب blob. يسمح إصدار عقد الإيجار لعميل آخر بالحصول على عقد الإيجار على الفور للكائن الثنائي كبير الحجم بمجرد اكتمال الإصدار.
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.
set_standard_blob_tier	تعيين طبقات كائن ثنائي كبير الحجم للكتلة على الكائن الثنائي كبير الحجم. واجهة برمجة التطبيقات هذه مدعومة فقط لكائنات ثنائية كبيرة الحجم للكتلة على حسابات التخزين القياسية. :p aram RehydratePriority rehydrate_priority: يشير إلى الأولوية التي يتم بها إعادة ترطيب كائن ثنائي كبير الحجم مؤرشف
snapshot_blob	إنشاء لقطة للقراءة فقط لكائن ثنائي كبير الحجم.
undelete_blob	تستعيد عملية إلغاء حذف 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

batch_set_standard_blob_tier

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

batch_set_standard_blob_tier(batch_set_blob_tier_sub_requests, timeout=None)

المعلمات

batch_set_blob_tier_sub_requests

list(BatchSetBlobTierSubRequest)

مطلوب

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

timeout

int

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

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

المرتجعات

استجابة 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

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

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

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

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

اسم الحاوية الوجهة. يجب أن تكون الحاوية موجودة. blob_name :p aram str: اسم الكائن الثنائي كبير الحجم الوجهة. إذا كان الكائن الثنائي كبير الحجم الوجهة موجودا، فسيتم الكتابة فوقه. وإلا، سيتم إنشاؤه. :p aram str copy_source: عنوان 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 :p aram metadata: أزواج الاسم والقيمة المقترنة ب blob كبيانات تعريف. إذا لم يتم تحديد أزواج قيمة الاسم، فستنسخ العملية بيانات التعريف من الكائن الثنائي كبير الحجم المصدر أو الملف إلى الكائن الثنائي كبير الحجم الوجهة. إذا تم تحديد زوج واحد أو أكثر من أزواج قيمة الاسم، يتم إنشاء الكائن الثنائي كبير الحجم الوجهة ببيانات التعريف المحددة، ولا يتم نسخ بيانات التعريف من الكائن الثنائي كبير الحجم المصدر أو الملف. :اكتب بيانات التعريف: dict(str, str) :p aram datetime source_if_modified_since: قيمة DateTime. يتوقع Azure أن تكون قيمة التاريخ التي تم تمريرها UTC. إذا تم تضمين المنطقة الزمنية، فسيتم تحويل أي تواريخ غير UTC إلى UTC. إذا تم تمرير تاريخ بدون معلومات المنطقة الزمنية، فمن المفترض أن يكون UTC. حدد هذا العنوان الشرطي لنسخ الكائن الثنائي كبير الحجم فقط إذا تم تعديل الكائن الثنائي كبير الحجم المصدر منذ التاريخ/الوقت المحدد. source_if_unmodified_since التاريخ :p أرام: قيمة DateTime. يتوقع Azure أن تكون قيمة التاريخ التي تم تمريرها UTC. إذا تم تضمين المنطقة الزمنية، فسيتم تحويل أي تواريخ غير UTC إلى UTC. إذا تم تمرير تاريخ بدون معلومات المنطقة الزمنية، فمن المفترض أن يكون UTC. حدد هذا العنوان الشرطي لنسخ الكائن الثنائي كبير الحجم فقط إذا لم يتم تعديل الكائن الثنائي كبير الحجم المصدر منذ التاريخ/الوقت المحدد. :p aram ETag source_if_match: قيمة ETag أو حرف البدل (). حدد هذا العنوان الشرطي لنسخ الكائن الثنائي كبير الحجم المصدر فقط إذا كان ETag الخاص به يطابق القيمة المحددة. إذا لم تتطابق قيم ETag، فترجع خدمة Blob رمز الحالة 412 (فشل الشرط المسبق). لا يمكن تحديد هذا العنوان إذا كان المصدر هو ملف Azure. :p aram ETag source_if_none_match: قيمة ETag أو حرف البدل (). حدد هذا العنوان الشرطي لنسخ الكائن الثنائي كبير الحجم فقط إذا لم يتطابق ETag الخاص به مع القيمة المحددة. إذا كانت القيم متطابقة، فترجع خدمة Blob رمز الحالة 412 (فشل الشرط المسبق). لا يمكن تحديد هذا العنوان إذا كان المصدر هو ملف Azure. :p أرام التاريخ والوقت destination_if_modified_since: قيمة DateTime. يتوقع Azure أن تكون قيمة التاريخ التي تم تمريرها UTC. إذا تم تضمين المنطقة الزمنية، فسيتم تحويل أي تواريخ غير UTC إلى UTC. إذا تم تمرير تاريخ بدون معلومات المنطقة الزمنية، فمن المفترض أن يكون UTC. حدد هذا العنوان الشرطي لنسخ الكائن الثنائي كبير الحجم فقط إذا تم تعديل الكائن الثنائي كبير الحجم الوجهة منذ التاريخ/الوقت المحدد. إذا لم يتم تعديل الكائن الثنائي كبير الحجم الوجهة، تقوم خدمة Blob بإرجاع رمز الحالة 412 (فشل الشرط المسبق). :p أرام التاريخ والوقت destination_if_unmodified_since: قيمة DateTime. يتوقع Azure أن تكون قيمة التاريخ التي تم تمريرها UTC. إذا تم تضمين المنطقة الزمنية، فسيتم تحويل أي تواريخ غير UTC إلى UTC. إذا تم تمرير تاريخ بدون معلومات المنطقة الزمنية، فمن المفترض أن يكون UTC. حدد هذا العنوان الشرطي لنسخ الكائن الثنائي كبير الحجم فقط إذا لم يتم تعديل الكائن الثنائي كبير الحجم الوجهة منذ التاريخ/الوقت المحدد. إذا تم تعديل الكائن الثنائي كبير الحجم الوجهة، تقوم خدمة Blob بإرجاع رمز الحالة 412 (فشل الشرط المسبق). destination_if_match :p aram ETag: قيمة ETag أو حرف البدل (). حدد قيمة ETag لهذا العنوان الشرطي لنسخ الكائن الثنائي كبير الحجم فقط إذا كانت قيمة ETag المحددة تطابق قيمة ETag لكائن ثنائي كبير الحجم وجهة موجود. إذا لم يتطابق ETag للكائن الثنائي كبير الحجم الوجهة مع ETag المحدد ل If-Match، فترجع خدمة Blob رمز الحالة 412 (فشل الشرط المسبق). destination_if_none_match :p aram ETag: قيمة ETag أو حرف البدل (). حدد قيمة ETag لهذا العنوان الشرطي لنسخ الكائن الثنائي كبير الحجم فقط إذا كانت قيمة ETag المحددة لا تتطابق مع قيمة ETag للكائن الثنائي كبير الحجم الوجهة. حدد حرف البدل (*) لتنفيذ العملية فقط إذا لم يكن الكائن الثنائي كبير الحجم الوجهة موجودا. إذا لم يتم استيفاء الشرط المحدد، تقوم خدمة Blob بإرجاع رمز الحالة 412 (فشل الشرط المسبق). :p aram str destination_lease_id: يجب أن يتطابق معرف التأجير المحدد لهذا العنوان مع معرف التأجير للكائن الثنائي كبير الحجم الوجهة. إذا لم يتضمن الطلب معرف التأجير أو لم يكن صالحا، تفشل العملية مع رمز الحالة 412 (فشل الشرط المسبق). :p aram str source_lease_id: حدد هذا لتنفيذ عملية Copy Blob فقط إذا كان معرف الإيجار المحدد يطابق معرف الإيجار النشط للكائن الثنائي كبير الحجم المصدر. مهلة :p aram int: يتم التعبير عن معلمة المهلة بالثوان. :p aram bool requires_sync: يفرض أن الخدمة لن ترجع استجابة حتى تكتمل النسخة. standard_blob_tier :p aram StandardBlobTier: قيمة طبقة كائن ثنائي كبير الحجم قياسية لتعيين الكائن الثنائي كبير الحجم إليها. بالنسبة لهذا الإصدار من المكتبة، ينطبق هذا فقط على حظر الكائنات الثنائية كبيرة الحجم على حسابات التخزين القياسية. :p aram RehydratePriority rehydrate_priority: يشير إلى الأولوية التي يتم بها إعادة ترطيب كائن ثنائي كبير الحجم مؤرشف :return: نسخ خصائص العملية مثل الحالة والمصدر والمعرف. :rtype: CopyProperties

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, requires_sync=None, standard_blob_tier=None, rehydrate_priority=None)

المعلمات

container_name

str

مطلوب

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

requires_sync

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

standard_blob_tier

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

rehydrate_priority

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

create_blob_from_bytes

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

create_blob_from_bytes(container_name, blob_name, blob, index=0, count=None, content_settings=None, metadata=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, standard_blob_tier=None, cpk=None)

المعلمات

container_name

str

مطلوب

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

blob_name

str

مطلوب

اسم الكائن الثنائي كبير الحجم المراد إنشاؤه أو تحديثه.

blob

bytes

مطلوب

محتوى الكائن الثنائي كبير الحجم كصفيف من وحدات البايت.

index

int

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

بدء الفهرس في صفيف وحدات البايت.

count

int

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

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

content_settings

ContentSettings

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

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

metadata

dict(str, str)

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

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

validate_content

bool

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

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

progress_callback

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

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

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

max_connections

int

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

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

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 وسيتم تطبيق المهلة على كل استدعاء على حدة.

standard_blob_tier

StandardBlobTier

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

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

المرتجعات

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

نوع الإرجاع

ResourceProperties

create_blob_from_path

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

create_blob_from_path(container_name, blob_name, file_path, content_settings=None, metadata=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, standard_blob_tier=None, cpk=None)

المعلمات

container_name

str

مطلوب

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

blob_name

str

مطلوب

اسم الكائن الثنائي كبير الحجم المراد إنشاؤه أو تحديثه.

file_path

str

مطلوب

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

content_settings

ContentSettings

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

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

metadata

dict(str, str)

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

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

validate_content

bool

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

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

progress_callback

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

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

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

max_connections

int

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

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

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 وسيتم تطبيق المهلة على كل استدعاء على حدة.

standard_blob_tier

StandardBlobTier

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

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

المرتجعات

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

نوع الإرجاع

ResourceProperties

create_blob_from_stream

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

create_blob_from_stream(container_name, blob_name, stream, count=None, content_settings=None, metadata=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, use_byte_buffer=False, standard_blob_tier=None, cpk=None)

المعلمات

container_name

str

مطلوب

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

blob_name

str

مطلوب

اسم الكائن الثنائي كبير الحجم المراد إنشاؤه أو تحديثه.

stream

IOBase

مطلوب

فتح ملف/دفق لتحميله كمحتوى كائن ثنائي كبير الحجم.

count

int

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

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

content_settings

ContentSettings

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

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

metadata

dict(str, str)

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

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

validate_content

bool

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

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

progress_callback

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

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

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

max_connections

int

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

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

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 وسيتم تطبيق المهلة على كل استدعاء على حدة.

use_byte_buffer

bool

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

إذا كان True، فسيفرض ذلك استخدام مسار تحميل التخزين المؤقت للكتلة الكاملة الأصلية. بشكل افتراضي، هذه القيمة هي False وستستخدم خوارزمية تحميل دفق فعالة من حيث الذاكرة في ظل الشروط التالية: الدفق المتوفر قابل للبحث، و"require_encryption" هو False، MAX_BLOCK_SIZE >= MIN_LARGE_BLOCK_UPLOAD_THRESHOLD. وينبغي للمرء أن ينظر في عيوب استخدام هذا النهج. من أجل تحقيق كفاءة الذاكرة، يتم تقسيم دفق IOBase أو كائن يشبه الملف إلى كتل منطقية باستخدام برنامج تضمين SubStream. لقراءة البيانات الصحيحة، يجب أن يحصل كل SubStream على تأمين حتى يتمكن من البحث بأمان عن الموضع الصحيح في الدفق الأساسي المشترك. إذا max_connections > 1، فإن التزامن سيؤدي إلى قدر كبير من البحث عن الدفق الأساسي. بالنسبة إلى المدخلات الأكثر شيوعا مثل كائن دفق يشبه الملف، فإن البحث هو عملية غير مكلفة وهذا ليس مصدر قلق كبير. ومع ذلك، بالنسبة للمتغيرات الأخرى من التدفقات، قد لا يكون هذا هو الحال. يجب الموازنة بين مفاضلة كفاءة الذاكرة وتكلفة البحث عن دفق الإدخال الخاص بك. ستحاول فئة SubStream تخزين ما يصل إلى 4 ميغابايت داخليا لتقليل كمية الاستدعاءات للبحث عن الدفق الأساسي وقراءتها. هذا مفيد بشكل خاص عند تحميل كتل أكبر.

standard_blob_tier

StandardBlobTier

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

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

المرتجعات

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

نوع الإرجاع

ResourceProperties

create_blob_from_text

إنشاء كائن ثنائي كبير الحجم جديد من str/unicode، أو تحديث محتوى كائن ثنائي كبير الحجم موجود، مع التقسيم التلقائي وإعلامات التقدم.

create_blob_from_text(container_name, blob_name, text, encoding='utf-8', content_settings=None, metadata=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, standard_blob_tier=None, cpk=None)

المعلمات

container_name

str

مطلوب

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

blob_name

str

مطلوب

اسم الكائن الثنائي كبير الحجم المراد إنشاؤه أو تحديثه.

text

str

مطلوب

نص لتحميله إلى الكائن الثنائي كبير الحجم.

encoding

str

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

ترميز Python لاستخدامه لتحويل النص إلى بايت.

content_settings

ContentSettings

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

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

metadata

dict(str, str)

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

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

validate_content

bool

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

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

progress_callback

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

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

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

max_connections

int

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

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

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 وسيتم تطبيق المهلة على كل استدعاء على حدة.

standard_blob_tier

StandardBlobTier

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

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

المرتجعات

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

نوع الإرجاع

ResourceProperties

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

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

المرتجعات

صحيح إذا تم حذف الحاوية، فإن الحاوية 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_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 و dict بيانات التعريف.

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_block_list

استرداد قائمة الكتل التي تم تحميلها كجزء من كائن ثنائي كبير الحجم للكتلة. هناك قائمتان للكتلة يتم الاحتفاظ بها لكائن ثنائي كبير الحجم:

قائمة الكتل الملتزم بها: قائمة الكتل التي تم تثبيتها بنجاح إلى كائن ثنائي كبير الحجم معين باستخدام Put Block List.

قائمة كتل غير ملتزم بها: قائمة الكتل التي تم تحميلها لكائن ثنائي كبير الحجم باستخدام Put Block، ولكن لم يتم تثبيتها بعد. يتم تخزين هذه الكتل في Azure بالاشتراك مع كائن ثنائي كبير الحجم، ولكنها لا تشكل بعد جزءا من الكائن الثنائي كبير الحجم.

get_block_list(container_name, blob_name, snapshot=None, block_list_type=None, lease_id=None, timeout=None)

المعلمات

container_name

str

مطلوب

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

blob_name

str

مطلوب

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

snapshot

str

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

التاريخ والوقت لتحديد وقت استرداد الكتل.

block_list_type

str

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

يحدد ما إذا كان يجب إرجاع قائمة الكتل الملتزم بها أو قائمة الكتل غير الملتزم بها أو كلتا القائمتين معا. القيم الصالحة هي: ملتزمة أو غير ملتزمة أو كلها.

lease_id

str

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

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

timeout

int

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

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

المرتجعات

قائمة الكتل الملتزم بها و/أو غير الملتزم بها لكتلة كائن ثنائي كبير الحجم

نوع الإرجاع

BlobBlockList

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.blockblobservice.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.blockblobservice.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

put_block

إنشاء كتلة جديدة ليتم تثبيتها كجزء من كائن ثنائي كبير الحجم.

put_block(container_name, blob_name, block, block_id, validate_content=False, lease_id=None, timeout=None, cpk=None)

المعلمات

container_name

str

مطلوب

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

blob_name

str

مطلوب

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

block

IOBase أو <xref:<xref:bytes Content> of <xref:the block.>>

مطلوب

محتوى الكتلة.

block_id

str

مطلوب

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

validate_content

bool

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

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

lease_id

str

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

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

cpk

CustomerProvidedEncryptionKey

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

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

timeout

int

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

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

put_block_from_url

إنشاء كتلة جديدة ليتم تثبيتها كجزء من كائن ثنائي كبير الحجم.

put_block_from_url(container_name, blob_name, copy_source_url, block_id, source_range_start=None, source_range_end=None, source_content_md5=None, lease_id=None, timeout=None, cpk=None)

المعلمات

container_name

str

مطلوب

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

blob_name

str

مطلوب

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

copy_source_url

str

مطلوب

عنوان URL للبيانات المصدر. يمكن أن يشير إلى أي Azure Blob أو ملف، إما عام أو يحتوي على توقيع وصول مشترك مرفق.

source_range_start

int

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

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

source_range_end

int

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

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

block_id

str

مطلوب

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

source_content_md5

str

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

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

lease_id

str

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

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

cpk

CustomerProvidedEncryptionKey

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

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

timeout

int

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

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

put_block_list

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

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

put_block_list(container_name, blob_name, block_list, content_settings=None, metadata=None, validate_content=False, lease_id=None, if_modified_since=None, if_unmodified_since=None, if_match=None, if_none_match=None, timeout=None, standard_blob_tier=None, cpk=None)

المعلمات

container_name

str

مطلوب

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

blob_name

str

مطلوب

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

block_list

list(BlobBlock)

مطلوب

قائمة <xref:azure.storeage.blob.models.BlobBlock> تحتوي على معرفات الكتلة وحالة الكتلة.

content_settings

ContentSettings

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

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

metadata

dict(str, str)

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

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

validate_content

bool

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

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

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

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

standard_blob_tier

StandardBlobTier

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

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

المرتجعات

ETag وآخر خصائص معدلة لكتلة Blob المحدثة

نوع الإرجاع

ResourceProperties

release_blob_lease

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

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

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

set_standard_blob_tier

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

:p aram RehydratePriority rehydrate_priority: يشير إلى الأولوية التي يتم بها إعادة ترطيب كائن ثنائي كبير الحجم مؤرشف

set_standard_blob_tier(container_name, blob_name, standard_blob_tier, timeout=None, rehydrate_priority=None)

المعلمات

container_name

str

مطلوب

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

blob_name

str

مطلوب

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

standard_blob_tier

StandardBlobTier

مطلوب

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

timeout

int

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

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

rehydrate_priority

القيمة الافتراضية: 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

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

undelete_blob(container_name, blob_name, timeout=None)

المعلمات

container_name

str

مطلوب

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

blob_name

str

مطلوب

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

timeout

int

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

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

السمات

protocol

request_session

socket_timeout

MAX_BLOCK_SIZE

MAX_BLOCK_SIZE = 4194304

MAX_CHUNK_GET_SIZE

MAX_CHUNK_GET_SIZE = 4194304

MAX_SINGLE_GET_SIZE

MAX_SINGLE_GET_SIZE = 33554432

MAX_SINGLE_PUT_SIZE

MAX_SINGLE_PUT_SIZE = 67108864

MIN_LARGE_BLOCK_UPLOAD_THRESHOLD

MIN_LARGE_BLOCK_UPLOAD_THRESHOLD = 4194305