azure.storage.blob.BlobClient class

إجهاض عملية نسخ مستمرة.

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

abort_copy(copy_id: str | Dict[str, Any] | BlobProperties, **kwargs: Any) -> None

المعلمات

copy_id: str أو BlobProperties

مطلوب

عملية النسخ إلى إجهاض. يمكن أن يكون هذا إما سلسلة معرف، أو مثيل BlobProperties.

نوع الإرجاع

None

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

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

acquire_lease(lease_duration: int = -1, lease_id: str | None = None, **kwargs: Any) -> BlobLeaseClient

المعلمات

lease_duration: int

مطلوب

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

lease_id: str

مطلوب

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

if_modified_since: datetime

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

if_unmodified_since: datetime

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

etag: str

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

match_condition: MatchConditions

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

if_tags_match_condition: str

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

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

timeout: int

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

المرتجعات

كائن BlobLeaseClient.

نوع الإرجاع

BlobLeaseClient

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

append_block(data: bytes | str | Iterable[AnyStr] | IO[AnyStr], length: int | None = None, **kwargs) -> Dict[str, str | datetime | int]

المعلمات

data: bytes أو str أو Iterable

مطلوب

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

length: int

مطلوب

حجم الكتلة بالبايت.

validate_content: bool

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

maxsize_condition: int

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

appendpos_condition: int

عنوان شرطي اختياري، يستخدم فقط لعملية إلحاق كتلة. رقم يشير إلى إزاحة البايت المراد مقارنتها. لن ينجح إلحاق كتلة إلا إذا كان موضع الإلحاق مساويا لهذا الرقم. إذا لم يكن كذلك، فسيفشل الطلب مع خطأ AppendPositionConditionNotMet (رمز حالة HTTP 412 - فشل الشرط المسبق).

lease: BlobLeaseClient أو str

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

if_modified_since: datetime

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

if_unmodified_since: datetime

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

etag: str

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

match_condition: MatchConditions

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

if_tags_match_condition: str

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

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

encoding: str

الإعدادات الافتراضية ل UTF-8.

cpk: CustomerProvidedEncryptionKey

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

encryption_scope: str

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

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

timeout: int

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

المرتجعات

إملاء الخاصية المحدثة للكائن الثنائي كبير الحجم (Etag، التعديل الأخير، إزاحة الإلحاق، عدد الكتل الملتزم بها).

نوع الإرجاع

dict(str, Any)

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

append_block_from_url(copy_source_url: str, source_offset: int | None = None, source_length: int | None = None, **kwargs) -> Dict[str, str | datetime | int]

المعلمات

copy_source_url: str

مطلوب

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

source_offset: int

مطلوب

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

source_length: int

مطلوب

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

source_content_md5: bytearray

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

maxsize_condition: int

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

appendpos_condition: int

عنوان شرطي اختياري، يستخدم فقط لعملية Append Block. رقم يشير إلى إزاحة البايت للمقارنة. لن ينجح إلحاق كتلة إلا إذا كان موضع الإلحاق مساويا لهذا الرقم. إذا لم يكن كذلك، فسيفشل الطلب مع خطأ AppendPositionConditionNotMet (رمز حالة HTTP 412 - فشل الشرط المسبق).

lease: BlobLeaseClient أو str

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

if_modified_since: datetime

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

if_unmodified_since: datetime

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

etag: str

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

match_condition: MatchConditions

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

if_tags_match_condition: str

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

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

source_if_modified_since: datetime

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

source_if_unmodified_since: datetime

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

source_etag: str

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

source_match_condition: MatchConditions

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

cpk: CustomerProvidedEncryptionKey

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

encryption_scope: str

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

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

timeout: int

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

source_authorization: str

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

مسح مجموعة من الصفحات.

clear_page(offset: int, length: int, **kwargs: Any) -> Dict[str, str | datetime]

المعلمات

offset: int

مطلوب

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

length: int

مطلوب

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

lease: BlobLeaseClient أو str

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

if_sequence_number_lte: int

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

if_sequence_number_lt: int

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

if_sequence_number_eq: int

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

if_modified_since: datetime

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

if_unmodified_since: datetime

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

etag: str

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

match_condition: MatchConditions

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

if_tags_match_condition: str

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

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

cpk: CustomerProvidedEncryptionKey

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

timeout: int

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

المرتجعات

لوحة الخصائص المحدثة لكائن ثنائي كبير الحجم (Etag وآخر تعديل).

نوع الإرجاع

dict(str, Any)

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

close()

تكتب عملية Commit Block List كائنا ثنائيا كبير الحجم عن طريق تحديد قائمة معرفات الكتلة التي تشكل الكائن الثنائي كبير الحجم.

commit_block_list(block_list: List[BlobBlock], content_settings: ContentSettings | None = None, metadata: Dict[str, str] | None = None, **kwargs) -> Dict[str, str | datetime]

المعلمات

block_list: list

مطلوب

قائمة Blockblobs.

content_settings: ContentSettings

مطلوب

عنصر ContentSettings المستخدم لتعيين خصائص الكائن الثنائي كبير الحجم. يستخدم لتعيين نوع المحتوى والترميز واللغة والتصرف وmd5 والتحكم في ذاكرة التخزين المؤقت.

metadata: dict[str, str]

مطلوب

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

tags: dict(str, str)

أزواج قيمة الاسم المقترنة بكائن ثنائي كبير الحجم كعلامة. العلامات حساسة لحالة الأحرف. قد تحتوي مجموعة العلامات على 10 علامات على الأكثر. يجب أن تتراوح مفاتيح العلامات بين 1 و128 حرفا، ويجب أن تتراوح قيم العلامات بين 0 و256 حرفا. يتضمن مفتاح العلامة الصالح وأحرف القيمة ما يلي: أحرف صغيرة وأحرف كبيرة، وأرقام (0-9)، ومسافة ( >><<)، بالإضافة إلى (+)، وطرح (-)، ونقطة (.)، وصلابة (/)، وعلامة النقطتين (:)، والتساوي (=)، وتسطير سفلي (_)

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

lease: BlobLeaseClient أو str

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

immutability_policy: ImmutabilityPolicy

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

جديد في الإصدار 12.10.0: تم تقديم هذا في إصدار واجهة برمجة التطبيقات "2020-10-02".

legal_hold: bool

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

جديد في الإصدار 12.10.0: تم تقديم هذا في إصدار واجهة برمجة التطبيقات "2020-10-02".

validate_content: bool

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

if_modified_since: datetime

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

if_unmodified_since: datetime

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

etag: str

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

match_condition: MatchConditions

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

if_tags_match_condition: str

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

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

standard_blob_tier: StandardBlobTier

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

cpk: CustomerProvidedEncryptionKey

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

encryption_scope: str

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

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

timeout: int

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

المرتجعات

لوحة الخصائص المحدثة لكائن ثنائي كبير الحجم (Etag وآخر تعديل).

نوع الإرجاع

dict(str, Any)

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

create_append_blob(content_settings: ContentSettings | None = None, metadata: Dict[str, str] | None = None, **kwargs: Any) -> Dict[str, str | datetime]

المعلمات

content_settings: ContentSettings

مطلوب

عنصر ContentSettings المستخدم لتعيين خصائص الكائن الثنائي كبير الحجم. يستخدم لتعيين نوع المحتوى والترميز واللغة والتصرف وmd5 والتحكم في ذاكرة التخزين المؤقت.

metadata: dict(str, str)

مطلوب

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

tags: dict(str, str)

أزواج قيمة الاسم المقترنة بكائن ثنائي كبير الحجم كعلامة. العلامات حساسة لحالة الأحرف. قد تحتوي مجموعة العلامات على 10 علامات على الأكثر. يجب أن تتراوح مفاتيح العلامات بين 1 و128 حرفا، ويجب أن تتراوح قيم العلامات بين 0 و256 حرفا. يتضمن مفتاح العلامة الصالح وأحرف القيمة ما يلي: أحرف صغيرة وأحرف كبيرة، وأرقام (0-9)، ومسافة ( >><<)، بالإضافة إلى (+)، وطرح (-)، ونقطة (.)، وصلابة (/)، وعلامة النقطتين (:)، والتساوي (=)، وتسطير سفلي (_)

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

lease: BlobLeaseClient أو str

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

immutability_policy: ImmutabilityPolicy

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

جديد في الإصدار 12.10.0: تم تقديم هذا في إصدار واجهة برمجة التطبيقات "2020-10-02".

legal_hold: bool

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

جديد في الإصدار 12.10.0: تم تقديم هذا في إصدار واجهة برمجة التطبيقات "2020-10-02".

if_modified_since: datetime

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

if_unmodified_since: datetime

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

etag: str

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

match_condition: MatchConditions

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

cpk: CustomerProvidedEncryptionKey

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

encryption_scope: str

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

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

timeout: int

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

المرتجعات

إملاء الخاصية المحدثة للكائنات الثنائية كبيرة الحجم (Etag وآخر تعديل).

نوع الإرجاع

dict[str, Any]

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

create_page_blob(size: int, content_settings: ContentSettings | None = None, metadata: Dict[str, str] | None = None, premium_page_blob_tier: str | PremiumPageBlobTier | None = None, **kwargs) -> Dict[str, str | datetime]

المعلمات

size: int

مطلوب

يحدد هذا الحد الأقصى لحجم كائن ثنائي كبير الحجم للصفحة، حتى 1 تيرابايت. يجب محاذاة حجم كائن ثنائي كبير الحجم للصفحة إلى حد 512 بايت.

content_settings: ContentSettings

مطلوب

عنصر ContentSettings المستخدم لتعيين خصائص الكائن الثنائي كبير الحجم. يستخدم لتعيين نوع المحتوى والترميز واللغة والتصرف وmd5 والتحكم في ذاكرة التخزين المؤقت.

metadata: dict(str, str)

مطلوب

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

premium_page_blob_tier: PremiumPageBlobTier

مطلوب

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

tags: dict(str, str)

أزواج قيمة الاسم المقترنة ب الكائن الثنائي كبير الحجم كعلامة. العلامات حساسة لحالة الأحرف. قد تحتوي مجموعة العلامات على 10 علامات على الأكثر. يجب أن تتراوح مفاتيح العلامات بين 1 و128 حرفا، ويجب أن تتراوح قيم العلامات بين 0 و256 حرفا. تتضمن أحرف مفتاح العلامة والقيمة الصالحة: الأحرف الصغيرة والأحرف الكبيرة، والأرقام (0-9)، والمساحة ( >><<)، بالإضافة إلى (+)، والطرح (-)، والنقطة (.)، والصلبة (/)، والنقطتين (:)، والتساوي (=)، وتسطير سفلي (_)

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

sequence_number: int

فقط لكائنات ثنائية كبيرة الحجم للصفحة. رقم التسلسل هو قيمة يتحكم فيها المستخدم يمكنك استخدامها لتعقب الطلبات. يجب أن تتراوح قيمة رقم التسلسل بين 0 و2^63 - 1.القيمة الافتراضية هي 0.

lease: BlobLeaseClient أو str

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

immutability_policy: ImmutabilityPolicy

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

جديد في الإصدار 12.10.0: تم تقديم هذا في إصدار واجهة برمجة التطبيقات "2020-10-02".

legal_hold: bool

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

جديد في الإصدار 12.10.0: تم تقديم هذا في إصدار واجهة برمجة التطبيقات "2020-10-02".

if_modified_since: datetime

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

if_unmodified_since: datetime

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

etag: str

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

match_condition: MatchConditions

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

cpk: CustomerProvidedEncryptionKey

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

encryption_scope: str

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

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

timeout: int

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

المرتجعات

إملاء الخاصية المحدثة للكائنات الثنائية كبيرة الحجم (Etag وآخر تعديل).

نوع الإرجاع

dict[str, Any]

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

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

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

create_snapshot(metadata: Dict[str, str] | None = None, **kwargs: Any) -> Dict[str, str | datetime]

المعلمات

metadata: dict(str, str)

مطلوب

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

if_modified_since: datetime

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

if_unmodified_since: datetime

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

etag: str

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

match_condition: MatchConditions

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

if_tags_match_condition: str

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

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

lease: BlobLeaseClient أو str

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

cpk: CustomerProvidedEncryptionKey

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

encryption_scope: str

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

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

timeout: int

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

المرتجعات

تم تحديث الكائنات الثنائية كبيرة الحجم لخاصية (معرف اللقطة، Etag، وآخر تعديل).

نوع الإرجاع

dict[str, Any]

وضع علامة على الكائن الثنائي كبير الحجم المحدد للحذف.

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

إذا تم تمكين نهج استبقاء حذف للخدمة، فإن هذه العملية تحذف النقطة بشكل مبدئي وتحتفظ بالكائنات الثنائية كبيرة الحجم لعدد محدد من الأيام. بعد عدد الأيام المحدد، تتم إزالة بيانات الكائن الثنائي كبير الحجم من الخدمة أثناء تجميع البيانات المهملة. يمكن الوصول إلى الكائن الثنائي كبير الحجم المحذوف مبدئيا من خلال list_blobs تحديد خيار include=['deleted']. يمكن استعادة الكائن الثنائي كبير الحجم المحذوف مبدئيا باستخدام <xref:azure.storage.blob.undelete> العملية.

delete_blob(delete_snapshots: str = None, **kwargs: Any) -> None

المعلمات

delete_snapshots: str

مطلوب

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

"فقط": يحذف لقطات الكائنات الثنائية كبيرة الحجم فقط.
"include": يحذف الكائن الثنائي كبير الحجم مع جميع اللقطات.

version_id: str

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

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

تم تقديم وسيطة الكلمة الأساسية هذه في إصدار واجهة برمجة التطبيقات '2019-12-12'.

lease: BlobLeaseClient أو str

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

if_modified_since: datetime

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

if_unmodified_since: datetime

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

etag: str

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

match_condition: MatchConditions

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

if_tags_match_condition: str

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

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

timeout: int

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

نوع الإرجاع

None

تحذف عملية Delete Immutability Policy نهج الثبات على الكائن الثنائي كبير الحجم.

جديد في الإصدار 12.10.0: تم تقديم هذه العملية في إصدار واجهة برمجة التطبيقات "2020-10-02".

delete_immutability_policy(**kwargs: Any) -> None

المعلمات

timeout: int

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

المرتجعات

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

نوع الإرجاع

Dict[str, str]

تنزيل كائن ثنائي كبير الحجم إلى StorageStreamDownloader. يجب استخدام أسلوب readall() لقراءة كل المحتوى أو يجب استخدام readinto() لتنزيل الكائن الثنائي كبير الحجم في دفق. يؤدي استخدام القطع () إلى إرجاع مكرر يسمح للمستخدم بالتكرار عبر المحتوى في مجموعات.

download_blob(offset: int = None, length: int = None, *, encoding: str, **kwargs) -> StorageStreamDownloader[str]

المعلمات

offset: int

مطلوب

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

length: int

مطلوب

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

version_id: str

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

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

تم تقديم وسيطة الكلمة الأساسية هذه في إصدار واجهة برمجة التطبيقات '2019-12-12'.

validate_content: bool

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

lease: BlobLeaseClient أو str

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

if_modified_since: datetime

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

if_unmodified_since: datetime

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

etag: str

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

match_condition: MatchConditions

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

if_tags_match_condition: str

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

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

cpk: CustomerProvidedEncryptionKey

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

max_concurrency: int

عدد الاتصالات المتوازية التي يجب تنزيلها.

encoding: str

الترميز لفك ترميز وحدات البايت التي تم تنزيلها. الافتراضي هو بلا، أي عدم فك التشفير.

progress_hook: Callable[[int, int], None]

رد اتصال لتتبع تقدم التنزيل طويل الأمد. التوقيع هو دالة (الحالية: int، الإجمالي: int) حيث الحالي هو عدد وحدات البايت المنقولة حتى الآن، والإجمالي هو الحجم الإجمالي للتنزيل.

timeout: int

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

المرتجعات

كائن دفق (StorageStreamDownloader)

نوع الإرجاع

StorageStreamDownloader

إرجاع True إذا كان هناك كائن ثنائي كبير الحجم مع المعلمات المحددة، وإرجاع False بخلاف ذلك.

exists(**kwargs: Any) -> bool

المعلمات

version_id: str

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

timeout: int

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

المرتجعات

منطقي

نوع الإرجاع

bool

إنشاء BlobClient من عنوان url لكائن ثنائي كبير الحجم. لا يدعم هذا عنوان url للكائن الثنائي كبير الحجم المخصص مع '/' في اسم الكائن الثنائي كبير الحجم.

from_blob_url(blob_url: str, credential: str | Dict[str, str] | AzureNamedKeyCredential | AzureSasCredential | TokenCredential | None = None, snapshot: str | Dict[str, Any] | None = None, **kwargs: Any) -> Self

المعلمات

blob_url: str

مطلوب

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

credential: Optional[Union[str, Dict[str, str], <xref:"AzureNamedKeyCredential">, <xref:"AzureSasCredential">, <xref:"TokenCredential">]] <xref:./>

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

بيانات الاعتماد التي يجب المصادقة بها. هذا اختياري إذا كان عنوان URL للحساب يحتوي بالفعل على رمز SAS المميز، أو كان سلسلة الاتصال يحتوي بالفعل على قيم مفتاح وصول مشترك. يمكن أن تكون القيمة سلسلة رمز SAS المميز أو مثيل AzureSasCredential أو AzureNamedKeyCredential من azure.core.credentials أو مفتاح وصول مشترك للحساب أو مثيل لفئة TokenCredentials من azure.identity. إذا كان عنوان URI للمورد يحتوي بالفعل على رمز SAS المميز، فسيتم تجاهل هذا لصالح بيانات اعتماد صريحة

باستثناء حالة AzureSasCredential، حيث سترفع رموز SAS المميزة المتعارضة ValueError. في حالة استخدام مثيل AzureNamedKeyCredential، يجب أن يكون "الاسم" هو اسم حساب التخزين، ويجب أن يكون "المفتاح" هو مفتاح حساب التخزين.

snapshot: str

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

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

version_id: str

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

المرتجعات

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

نوع الإرجاع

BlobClient

إنشاء BlobClient من سلسلة اتصال.

from_connection_string(conn_str: str, container_name: str, blob_name: str, snapshot: str | Dict[str, Any] | None = None, credential: str | Dict[str, str] | AzureNamedKeyCredential | AzureSasCredential | TokenCredential | None = None, **kwargs: Any) -> Self

المعلمات

conn_str: str

مطلوب

سلسلة الاتصال إلى حساب Azure Storage.

container_name: str

مطلوب

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

blob_name: str

مطلوب

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

snapshot: str

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

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

credential: Optional[Union[str, Dict[str, str], <xref:"AzureNamedKeyCredential">, <xref:"AzureSasCredential">, <xref:"TokenCredential">]] <xref:./>

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

بيانات الاعتماد التي يجب المصادقة بها. هذا اختياري إذا كان عنوان URL للحساب يحتوي بالفعل على رمز SAS المميز، أو كان سلسلة الاتصال يحتوي بالفعل على قيم مفتاح وصول مشترك. يمكن أن تكون القيمة سلسلة رمز SAS المميز أو مثيل AzureSasCredential أو AzureNamedKeyCredential من azure.core.credentials أو مفتاح وصول مشترك للحساب أو مثيل لفئة TokenCredentials من azure.identity. ستكون لبيانات الاعتماد المقدمة هنا الأسبقية على تلك الموجودة في سلسلة الاتصال. في حالة استخدام مثيل AzureNamedKeyCredential، يجب أن يكون "الاسم" هو اسم حساب التخزين، ويجب أن يكون "المفتاح" هو مفتاح حساب التخزين.

version_id: str

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

المرتجعات

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

نوع الإرجاع

BlobClient

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

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

get_account_information(**kwargs: Any) -> Dict[str, str]

المرتجعات

لوحة معلومات الحساب (SKU ونوع الحساب).

نوع الإرجاع

dict(str, str)

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

get_blob_properties(**kwargs: Any) -> BlobProperties

المعلمات

lease: BlobLeaseClient أو str

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

version_id: str

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

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

تم تقديم وسيطة الكلمة الأساسية هذه في إصدار واجهة برمجة التطبيقات "2019-12-12".

if_modified_since: datetime

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

if_unmodified_since: datetime

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

etag: str

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

match_condition: MatchConditions

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

if_tags_match_condition: str

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

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

cpk: CustomerProvidedEncryptionKey

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

timeout: int

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

المرتجعات

BlobProperties

نوع الإرجاع

BlobProperties

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

جديد في الإصدار 12.4.0: تم تقديم هذه العملية في إصدار واجهة برمجة التطبيقات "2019-12-12".

get_blob_tags(**kwargs: Any) -> Dict[str, str]

المعلمات

version_id: str

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

if_tags_match_condition: str

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

lease: BlobLeaseClient أو str

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

timeout: int

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

المرتجعات

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

نوع الإرجاع

Dict[str, str]

تسترد عملية Get Block List قائمة الكتل التي تم تحميلها كجزء من كائن ثنائي كبير الحجم للكتلة.

get_block_list(block_list_type: str | None = 'committed', **kwargs: Any) -> Tuple[List[BlobBlock], List[BlobBlock]]

المعلمات

block_list_type: str

مطلوب

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

lease: BlobLeaseClient أو str

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

if_tags_match_condition: str

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

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

timeout: int

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

المرتجعات

مجموعة من قائمتين - كتل ملتزمة وغير ملتزمة

نوع الإرجاع

tuple(list(BlobBlock), list(BlobBlock))

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

ملاحظة

تتوفر هذه العملية فقط لحسابات القرص المدارة.

جديد في الإصدار 12.2.0: تم تقديم هذه العملية في إصدار واجهة برمجة التطبيقات "2019-07-07".

get_page_range_diff_for_managed_disk(previous_snapshot_url: str, offset: int | None = None, length: int | None = None, **kwargs) -> Tuple[List[Dict[str, int]], List[Dict[str, int]]]

المعلمات

previous_snapshot_url

مطلوب

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

offset: int

مطلوب

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

length: int

مطلوب

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

lease: BlobLeaseClient أو str

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

if_modified_since: datetime

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

if_unmodified_since: datetime

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

etag: str

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

match_condition: MatchConditions

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

timeout: int

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

المرتجعات

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

نوع الإرجاع

tuple(list(dict(str, str), list(dict(str, str))

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

get_page_ranges(offset: int | None = None, length: int | None = None, previous_snapshot_diff: str | Dict[str, Any] | None = None, **kwargs) -> Tuple[List[Dict[str, int]], List[Dict[str, int]]]

المعلمات

offset: int

مطلوب

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

length: int

مطلوب

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

previous_snapshot_diff: str

مطلوب

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

lease: BlobLeaseClient أو str

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

if_modified_since: datetime

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

if_unmodified_since: datetime

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

etag: str

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

match_condition: MatchConditions

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

if_tags_match_condition: str

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

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

timeout: int

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

المرتجعات

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

نوع الإرجاع

tuple(list(dict(str, str), list(dict(str, str))

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

list_page_ranges(*, offset: int | None = None, length: int | None = None, previous_snapshot: str | Dict[str, Any] | None = None, **kwargs: Any) -> ItemPaged[PageRange]

المعلمات

offset: int

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

length: int

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

previous_snapshot: str أو Dict[str, Any]

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

lease: BlobLeaseClient أو str

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

if_modified_since: datetime

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

if_unmodified_since: datetime

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

etag: str

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

match_condition: MatchConditions

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

if_tags_match_condition: str

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

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

results_per_page: int

الحد الأقصى لعدد نطاقات الصفحات المراد استردادها لكل استدعاء API.

timeout: int

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

المرتجعات

قابل للتكبير (ترحيل تلقائي) ل PageRange.

نوع الإرجاع

ItemPaged[PageRange]

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

query_blob(query_expression: str, **kwargs: Any) -> BlobQueryReader

المعلمات

query_expression: str

مطلوب

مطلوب عبارة استعلام. لمزيد من التفاصيل، راجع https://learn.microsoft.com/azure/storage/blobs/query-acceleration-sql-reference.

on_error: Callable[BlobQueryError]

دالة ليتم استدعاؤها على أي أخطاء معالجة يتم إرجاعها بواسطة الخدمة.

blob_format: DelimitedTextDialect أو DelimitedJsonDialect أو QuickQueryDialect أو str

‏‏اختياري. يحدد تسلسل البيانات المخزنة حاليا في الكائن الثنائي كبير الحجم. الافتراضي هو التعامل مع بيانات الكائن الثنائي كبير الحجم على أنها بيانات CSV منسقة باللهجة الافتراضية. يمكن تجاوز هذا باستخدام DelimitedTextDialect مخصص، أو DelimitedJsonDialect أو "ParquetDialect" (تم تمريره كسلسلة أو قائمة تعداد). يمكن تمرير هذه اللهجات عبر الفئات الخاصة بها، أو قائمة تعداد QuickQueryDialect أو كسلسلة

output_format: DelimitedTextDialect أو DelimitedJsonDialect أو list[ArrowDialect] أو QuickQueryDialect أو str

‏‏اختياري. يحدد تسلسل الإخراج لتدفق البيانات. بشكل افتراضي، سيتم إرجاع البيانات كما يتم تمثيلها في الكائن الثنائي كبير الحجم (تنسيقات Parquet الافتراضية إلى DelimitedTextDialect). من خلال توفير تنسيق إخراج، ستتم إعادة تنسيق بيانات الكائن الثنائي كبير الحجم وفقا لملف التعريف هذا. يمكن أن تكون هذه القيمة محددةTextDialect أو DelimitedJsonDialect أو ArrowDialect. يمكن تمرير هذه اللهجات عبر الفئات الخاصة بها، أو قائمة تعداد QuickQueryDialect أو كسلسلة

lease: BlobLeaseClient أو str

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

if_modified_since: datetime

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

if_unmodified_since: datetime

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

etag: str

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

match_condition: MatchConditions

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

if_tags_match_condition: str

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

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

cpk: CustomerProvidedEncryptionKey

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

timeout: int

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

المرتجعات

كائن دفق (BlobQueryReader)

نوع الإرجاع

BlobQueryReader

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

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

resize_blob(size: int, **kwargs: Any) -> Dict[str, str | datetime]

المعلمات

size: int

مطلوب

الحجم المستخدم لتغيير حجم الكائن الثنائي كبير الحجم. الحد الأقصى لحجم كائن ثنائي كبير الحجم للصفحة يصل إلى 1 تيرابايت. يجب محاذاة حجم كائن ثنائي كبير الحجم للصفحة إلى حد 512 بايت.

lease: BlobLeaseClient أو str

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

if_modified_since: datetime

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

if_unmodified_since: datetime

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

etag: str

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

match_condition: MatchConditions

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

if_tags_match_condition: str

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

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

premium_page_blob_tier: PremiumPageBlobTier

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

timeout: int

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

المرتجعات

إملاء الخاصية المحدثة للكائنات الثنائية كبيرة الحجم (Etag وآخر تعديل).

نوع الإرجاع

dict(str, Any)

تختم عملية Seal الكائن الثنائي كبير الحجم الملحق لجعله للقراءة فقط.

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

seal_append_blob(**kwargs) -> Dict[str, str | datetime | int]

المعلمات

appendpos_condition: int

عنوان شرطي اختياري، يستخدم فقط لعملية Append Block. رقم يشير إلى إزاحة البايت للمقارنة. لن ينجح إلحاق كتلة إلا إذا كان موضع الإلحاق مساويا لهذا الرقم. إذا لم يكن كذلك، فسيفشل الطلب مع خطأ AppendPositionConditionNotMet (رمز حالة HTTP 412 - فشل الشرط المسبق).

lease: BlobLeaseClient أو str

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

if_modified_since: datetime

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

if_unmodified_since: datetime

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

etag: str

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

match_condition: MatchConditions

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

timeout: int

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

المرتجعات

إملاء الخاصية المحدثة للكائن الثنائي كبير الحجم (Etag، التعديل الأخير، إزاحة الإلحاق، عدد الكتل الملتزم بها).

نوع الإرجاع

dict(str, Any)

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

set_blob_metadata(metadata: Dict[str, str] | None = None, **kwargs: Any) -> Dict[str, str | datetime]

المعلمات

metadata: dict(str, str)

مطلوب

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

lease: BlobLeaseClient أو str

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

if_modified_since: datetime

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

if_unmodified_since: datetime

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

etag: str

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

match_condition: MatchConditions

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

if_tags_match_condition: str

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

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

cpk: CustomerProvidedEncryptionKey

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

encryption_scope: str

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

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

timeout: int

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

المرتجعات

إملاء الخاصية المحدثة للكائن الثنائي كبير الحجم (Etag وآخر تعديل)

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

جديد في الإصدار 12.4.0: تم تقديم هذه العملية في إصدار واجهة برمجة التطبيقات "2019-12-12".

set_blob_tags(tags: Dict[str, str] | None = None, **kwargs: Any) -> Dict[str, Any]

المعلمات

tags: dict(str, str)

مطلوب

أزواج قيمة الاسم المقترنة ب الكائن الثنائي كبير الحجم كعلامة. العلامات حساسة لحالة الأحرف. قد تحتوي مجموعة العلامات على 10 علامات على الأكثر. يجب أن تتراوح مفاتيح العلامات بين 1 و128 حرفا، ويجب أن تتراوح قيم العلامات بين 0 و256 حرفا. تتضمن أحرف مفتاح العلامة والقيمة الصالحة: الأحرف الصغيرة والأحرف الكبيرة، والأرقام (0-9)، والمساحة ( >><<)، بالإضافة إلى (+)، والطرح (-)، والنقطة (.)، والصلبة (/)، والنقطتين (:)، والتساوي (=)، وتسطير سفلي (_)

version_id: str

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

validate_content: bool

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

if_tags_match_condition: str

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

lease: BlobLeaseClient أو str

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

timeout: int

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

المرتجعات

إملاء الخاصية المحدثة للكائن الثنائي كبير الحجم (Etag وآخر تعديل)

نوع الإرجاع

Dict[str, Any]

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

إذا تم تعيين خاصية واحدة content_settings، فسيتم تجاوز جميع الخصائص.

set_http_headers(content_settings: ContentSettings | None = None, **kwargs: Any) -> None

المعلمات

content_settings: ContentSettings

مطلوب

عنصر ContentSettings المستخدم لتعيين خصائص الكائن الثنائي كبير الحجم. يستخدم لتعيين نوع المحتوى والترميز واللغة والتصرف وmd5 والتحكم في ذاكرة التخزين المؤقت.

lease: BlobLeaseClient أو str

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

if_modified_since: datetime

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

if_unmodified_since: datetime

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

etag: str

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

match_condition: MatchConditions

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

if_tags_match_condition: str

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

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

timeout: int

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

المرتجعات

إملاء الخاصية المحدثة للكائن الثنائي كبير الحجم (Etag وآخر تعديل)

نوع الإرجاع

Dict[str, Any]

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

جديد في الإصدار 12.10.0: تم تقديم هذه العملية في إصدار واجهة برمجة التطبيقات "2020-10-02".

set_immutability_policy(immutability_policy: ImmutabilityPolicy, **kwargs: Any) -> Dict[str, str]

المعلمات

immutability_policy: ImmutabilityPolicy

مطلوب

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

جديد في الإصدار 12.10.0: تم تقديم هذا في إصدار واجهة برمجة التطبيقات "2020-10-02".

timeout: int

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

المرتجعات

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

نوع الإرجاع

Dict[str, str]

تعين عملية Set Legal Hold تعليقا قانونيا على الكائن الثنائي كبير الحجم.

جديد في الإصدار 12.10.0: تم تقديم هذه العملية في إصدار واجهة برمجة التطبيقات "2020-10-02".

set_legal_hold(legal_hold: bool, **kwargs: Any) -> Dict[str, str | datetime | bool]

المعلمات

legal_hold: bool

مطلوب

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

timeout: int

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

المرتجعات

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

نوع الإرجاع

Dict[str, Union[str, datetime, bool]]

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

set_premium_page_blob_tier(premium_page_blob_tier: str | PremiumPageBlobTier, **kwargs: Any) -> None

المعلمات

premium_page_blob_tier: PremiumPageBlobTier

مطلوب

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

if_tags_match_condition: str

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

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

timeout: int

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

lease: BlobLeaseClient أو str

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

نوع الإرجاع

None

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

set_sequence_number(sequence_number_action: str | SequenceNumberAction, sequence_number: str | None = None, **kwargs: Any) -> Dict[str, str | datetime]

المعلمات

sequence_number_action: str

مطلوب

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

sequence_number: str

مطلوب

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

lease: BlobLeaseClient أو str

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

if_modified_since: datetime

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

if_unmodified_since: datetime

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

etag: str

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

match_condition: MatchConditions

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

if_tags_match_condition: str

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

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

timeout: int

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

المرتجعات

إملاء الخاصية المحدثة للكائنات الثنائية كبيرة الحجم (Etag وآخر تعديل).

نوع الإرجاع

dict(str, Any)

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

تحدد طبقة كائن ثنائي كبير الحجم للكتلة نوع التخزين Hot/Cool/Archive. لا تقوم هذه العملية بتحديث ETag للكائن الثنائي كبير الحجم.

set_standard_blob_tier(standard_blob_tier: str | StandardBlobTier, **kwargs: Any) -> None

المعلمات

standard_blob_tier: str أو StandardBlobTier

مطلوب

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

rehydrate_priority: RehydratePriority

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

version_id: str

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

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

تم تقديم وسيطة الكلمة الأساسية هذه في إصدار واجهة برمجة التطبيقات "2019-12-12".

if_tags_match_condition: str

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

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

timeout: int

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

lease: BlobLeaseClient أو str

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

نوع الإرجاع

None

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

stage_block(block_id: str, data: Iterable | IO, length: int | None = None, **kwargs) -> Dict[str, Any]

المعلمات

block_id: str

مطلوب

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

data

مطلوب

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

length: int

مطلوب

حجم الكتلة.

validate_content: bool

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

lease: BlobLeaseClient أو str

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

encoding: str

الإعدادات الافتراضية ل UTF-8.

cpk: CustomerProvidedEncryptionKey

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

encryption_scope: str

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

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

timeout: int

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

المرتجعات

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

نوع الإرجاع

dict[str, Any]

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

stage_block_from_url(block_id: str | int, source_url: str, source_offset: int | None = None, source_length: int | None = None, source_content_md5: bytes | bytearray | None = None, **kwargs) -> Dict[str, Any]

المعلمات

block_id: str

مطلوب

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

source_url: str

مطلوب

عنوان URL.

source_offset: int

مطلوب

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

source_length: int

مطلوب

حجم الكتلة بالبايت.

source_content_md5: bytearray

مطلوب

حدد md5 المحسوب لنطاق وحدات البايت التي يجب قراءتها من مصدر النسخ.

lease: BlobLeaseClient أو str

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

cpk: CustomerProvidedEncryptionKey

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

encryption_scope: str

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

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

timeout: int

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

source_authorization: str

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

المرتجعات

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

نوع الإرجاع

dict[str, Any]

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

ترجع هذه العملية قاموسا يحتوي على copy_statuscopy_id، والذي يمكن استخدامه للتحقق من حالة عملية النسخ أو إجهاضها. سيكون copy_status "ناجحا" إذا اكتملت النسخة بشكل متزامن أو "معلق" إذا تم بدء النسخة بشكل غير متزامن. بالنسبة للنسخ غير المتزامنة، يمكن التحقق من الحالة عن طريق التحقق من get_blob_properties الأسلوب والتحقق من حالة النسخ. قم بتعيين requires_sync إلى True لفرض أن تكون النسخة متزامنة. تنسخ خدمة Blob الكائنات الثنائية كبيرة الحجم على أساس أفضل جهد.

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

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

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

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

start_copy_from_url(source_url: str, metadata: Dict[str, str] | None = None, incremental_copy: bool = False, **kwargs: Any) -> Dict[str, str | datetime]

المعلمات

source_url: str

مطلوب

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

https://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot=

https://otheraccount.blob.core.windows.net/mycontainer/myblob?sastoken

metadata: dict(str, str)

مطلوب

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

incremental_copy: bool

مطلوب

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

tags: dict(str, str) أو Literal["COPY"]

أزواج قيمة الاسم المقترنة ب الكائن الثنائي كبير الحجم كعلامة. العلامات حساسة لحالة الأحرف. قد تحتوي مجموعة العلامات على 10 علامات على الأكثر. يجب أن تتراوح مفاتيح العلامات بين 1 و128 حرفا، ويجب أن تتراوح قيم العلامات بين 0 و256 حرفا. تتضمن أحرف مفتاح العلامة والقيمة الصالحة ما يلي: أحرف صغيرة وأحرف كبيرة وأرقام (0-9) ومساحة ( >><<) بالإضافة إلى (+) وطرح (-) ونقطة (.) وs solidus (/) ونقاط النقطتين (:) والتساوي (=) وتسطير سفلي (_).

يمكن بدلا من ذلك تمرير "COPY" الحرفي (الحساس لحالة الأحرف) لنسخ العلامات من الكائن الثنائي كبير الحجم المصدر. يتوفر هذا الخيار فقط عند incremental_copy=False و requires_sync=True.

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

immutability_policy: ImmutabilityPolicy

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

جديد في الإصدار 12.10.0: تم تقديم هذا في إصدار واجهة برمجة التطبيقات "2020-10-02".

legal_hold: bool

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

جديد في الإصدار 12.10.0: تم تقديم هذا في إصدار واجهة برمجة التطبيقات "2020-10-02".

source_if_modified_since: datetime

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

source_if_unmodified_since: datetime

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

source_etag: str

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

source_match_condition: MatchConditions

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

if_modified_since: datetime

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

if_unmodified_since: datetime

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

etag: str

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

match_condition: MatchConditions

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

destination_lease: BlobLeaseClient أو str

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

source_lease: BlobLeaseClient أو str

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

timeout: int

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

premium_page_blob_tier: PremiumPageBlobTier

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

standard_blob_tier: StandardBlobTier

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

rehydrate_priority: RehydratePriority

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

seal_destination_blob: bool

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

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

requires_sync: bool

يفرض أن الخدمة لن ترجع استجابة حتى تكتمل النسخة.

source_authorization: str

المصادقة ككيان خدمة باستخدام سر العميل للوصول إلى كائن ثنائي كبير الحجم مصدر. تأكد من أن "الحامل" هو بادئة سلسلة source_authorization. يتوفر هذا الخيار فقط عند تعيين incremental_copy إلى False ويتم تعيين requires_sync إلى True.

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

encryption_scope: str

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

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

المرتجعات

قاموس لخصائص النسخ (etag، last_modified، copy_id، copy_status).

نوع الإرجاع

dict[str, Union[str, datetime]]

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

لن تنجح العملية إلا إذا تم استخدامها ضمن عدد الأيام المحدد المحدد في نهج استبقاء الحذف.

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

undelete_blob(**kwargs: Any) -> None

المعلمات

timeout: int

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

نوع الإرجاع

None

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

upload_blob(data: bytes | str | Iterable | IO, blob_type: str | BlobType = BlobType.BLOCKBLOB, length: int | None = None, metadata: Dict[str, str] | None = None, **kwargs) -> Dict[str, Any]

المعلمات

data

مطلوب

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

blob_type: BlobType

مطلوب

نوع الكائن الثنائي كبير الحجم. يمكن أن يكون هذا إما BlockBlob أو PageBlob أو AppendBlob. القيمة الافتراضية هي BlockBlob.

length: int

مطلوب

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

metadata: dict(str, str)

مطلوب

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

tags: dict(str, str)

أزواج قيمة الاسم المقترنة ب الكائن الثنائي كبير الحجم كعلامة. العلامات حساسة لحالة الأحرف. قد تحتوي مجموعة العلامات على 10 علامات على الأكثر. يجب أن تتراوح مفاتيح العلامات بين 1 و128 حرفا، ويجب أن تتراوح قيم العلامات بين 0 و256 حرفا. تتضمن أحرف مفتاح العلامة والقيمة الصالحة: الأحرف الصغيرة والأحرف الكبيرة، والأرقام (0-9)، والمساحة ( >><<)، بالإضافة إلى (+)، والطرح (-)، والنقطة (.)، والصلبة (/)، والنقطتين (:)، والتساوي (=)، وتسطير سفلي (_)

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

overwrite: bool

ما إذا كان يجب أن يقوم الكائن الثنائي كبير الحجم الذي سيتم تحميله بالكتابة فوق البيانات الحالية. إذا كان True، فسيستبدل upload_blob البيانات الموجودة. إذا تم تعيينها إلى False، فستفشل العملية مع ResourceExistsError. الاستثناء لما سبق هو مع أنواع الكائنات الثنائية كبيرة الحجم الملحقة: إذا تم تعيينها إلى False والبيانات موجودة بالفعل، فلن يتم رفع خطأ وسيتم إلحاق البيانات بالكائن الثنائي كبير الحجم الموجود. إذا تم تعيين overwrite=True، فسيتم حذف الكائن الثنائي كبير الحجم الموجود للإلحاق، وإنشاء كائن جديد. الإعدادات الافتراضية معينة على False.

content_settings: ContentSettings

عنصر ContentSettings المستخدم لتعيين خصائص الكائن الثنائي كبير الحجم. يستخدم لتعيين نوع المحتوى والترميز واللغة والتصرف وmd5 والتحكم في ذاكرة التخزين المؤقت.

validate_content: bool

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

lease: BlobLeaseClient أو str

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

if_modified_since: datetime

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

if_unmodified_since: datetime

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

etag: str

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

match_condition: MatchConditions

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

if_tags_match_condition: str

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

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

premium_page_blob_tier: PremiumPageBlobTier

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

standard_blob_tier: StandardBlobTier

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

immutability_policy: ImmutabilityPolicy

يحدد نهج الثبات للكائن الثنائي كبير الحجم أو لقطة كائن ثنائي كبير الحجم أو إصدار كائن ثنائي كبير الحجم. حاليا هذه المعلمة من upload_blob() API مخصصة ل BlockBlob فقط.

جديد في الإصدار 12.10.0: تم تقديم هذا في إصدار واجهة برمجة التطبيقات "2020-10-02".

legal_hold: bool

تحديد ما إذا كان يجب تعيين تعليق قانوني على الكائن الثنائي كبير الحجم. حاليا هذه المعلمة من upload_blob() API مخصصة ل BlockBlob فقط.

جديد في الإصدار 12.10.0: تم تقديم هذا في إصدار واجهة برمجة التطبيقات "2020-10-02".

maxsize_condition: int

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

max_concurrency: int

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

cpk: CustomerProvidedEncryptionKey

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

encryption_scope: str

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

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

encoding: str

الإعدادات الافتراضية ل UTF-8.

progress_hook: Callable[[int, Optional[int]], None]

رد اتصال لتعقب تقدم التحميل طويل الأمد. التوقيع هو دالة(current: int, total: Optional[int]) حيث الحالي هو عدد وحدات البايت المنقولة حتى الآن، والإجمالي هو حجم الكائن الثنائي كبير الحجم أو بلا إذا كان الحجم غير معروف.

timeout: int

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

المرتجعات

إملاء الخاصية المحدثة لكائن ثنائي كبير الحجم (Etag وآخر تعديل)

نوع الإرجاع

dict[str, Any]

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

upload_blob_from_url(source_url: str, **kwargs: Any) -> Dict[str, Any]

المعلمات

source_url: str

مطلوب

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

https://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot=

https://otheraccount.blob.core.windows.net/mycontainer/myblob?sastoken

overwrite: bool

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

include_source_blob_properties: bool

يشير إلى ما إذا كان يجب نسخ الخصائص من الكائن الثنائي كبير الحجم المصدر. الإعدادات الافتراضية إلى True.

tags: dict(str, str)

أزواج قيمة الاسم المقترنة بكائن ثنائي كبير الحجم كعلامة. العلامات حساسة لحالة الأحرف. قد تحتوي مجموعة العلامات على 10 علامات على الأكثر. يجب أن تتراوح مفاتيح العلامات بين 1 و128 حرفا، ويجب أن تتراوح قيم العلامات بين 0 و256 حرفا. يتضمن مفتاح العلامة الصالح وأحرف القيمة ما يلي: أحرف صغيرة وأحرف كبيرة، وأرقام (0-9)، ومسافة ( >><<)، بالإضافة إلى (+)، وطرح (-)، ونقطة (.)، وصلابة (/)، وعلامة النقطتين (:)، والتساوي (=)، وتسطير سفلي (_)

source_content_md5: bytearray

حدد md5 المستخدم للتحقق من تكامل وحدات البايت المصدر.

source_if_modified_since: datetime

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

source_if_unmodified_since: datetime

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

source_etag: str

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

source_match_condition: MatchConditions

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

if_modified_since: datetime

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

if_unmodified_since: datetime

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

etag: str

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

match_condition: MatchConditions

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

destination_lease: BlobLeaseClient أو str

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

timeout: int

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

content_settings: ContentSettings

عنصر ContentSettings المستخدم لتعيين خصائص الكائن الثنائي كبير الحجم. يستخدم لتعيين نوع المحتوى والترميز واللغة والتصرف وmd5 والتحكم في ذاكرة التخزين المؤقت.

cpk: CustomerProvidedEncryptionKey

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

encryption_scope: str

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

standard_blob_tier: StandardBlobTier

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

source_authorization: str

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

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

upload_page(page: bytes, offset: int, length: int, **kwargs) -> Dict[str, str | datetime]

المعلمات

page: bytes

مطلوب

محتوى الصفحة.

offset: int

مطلوب

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

length: int

مطلوب

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

lease: BlobLeaseClient أو str

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

validate_content: bool

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

if_sequence_number_lte: int

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

if_sequence_number_lt: int

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

if_sequence_number_eq: int

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

if_modified_since: datetime

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

if_unmodified_since: datetime

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

etag: str

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

match_condition: MatchConditions

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

if_tags_match_condition: str

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

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

cpk: CustomerProvidedEncryptionKey

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

encryption_scope: str

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

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

encoding: str

الإعدادات الافتراضية ل UTF-8.

timeout: int

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

المرتجعات

إملاء الخاصية المحدثة للكائنات الثنائية كبيرة الحجم (Etag وآخر تعديل).

نوع الإرجاع

dict(str, Any)

تكتب عملية تحميل الصفحات مجموعة من الصفحات إلى كائن ثنائي كبير الحجم للصفحة حيث تتم قراءة المحتويات من عنوان URL.

upload_pages_from_url(source_url: str, offset: int, length: int, source_offset: int, **kwargs) -> Dict[str, Any]

المعلمات

source_url: str

مطلوب

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

offset: int

مطلوب

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

length: int

مطلوب

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

source_offset: int

مطلوب

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

source_content_md5: bytes

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

source_if_modified_since: datetime

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

source_if_unmodified_since: datetime

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

source_etag: str

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

source_match_condition: MatchConditions

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

lease: BlobLeaseClient أو str

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

if_sequence_number_lte: int

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

if_sequence_number_lt: int

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

if_sequence_number_eq: int

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

if_modified_since: datetime

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

if_unmodified_since: datetime

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

etag: str

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

match_condition: MatchConditions

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

if_tags_match_condition: str

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

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

cpk: CustomerProvidedEncryptionKey

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

encryption_scope: str

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

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

timeout: int

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

source_authorization: str

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

إصدار واجهة برمجة تطبيقات التخزين المستخدمة للطلبات.

وضع الموقع الذي يستخدمه العميل حاليا.

بشكل افتراضي، سيكون هذا "أساسي". تتضمن الخيارات "الأساسي" و"الثانوي".

عنوان URL الكامل لنقطة النهاية الأساسية.

اسم مضيف نقطة النهاية الأساسية.

عنوان URL لنقطة النهاية الثانوية الكاملة إذا تم تكوينه.

إذا لم يكن متوفرا، فسيتم رفع ValueError. لتحديد اسم مضيف ثانوي بشكل صريح، استخدم وسيطة الكلمة الأساسية secondary_hostname الاختيارية عند إنشاء مثيل.

استثناءات

ValueError

اسم مضيف نقطة النهاية الثانوية.

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

عنوان URL الكامل لنقطة النهاية لهذا الكيان، بما في ذلك رمز SAS المميز إذا تم استخدامه.

قد تكون هذه إما نقطة النهاية الأساسية، أو نقطة النهاية الثانوية اعتمادا على الحالي location_mode. :returns: عنوان URL الكامل لنقطة النهاية لهذا الكيان، بما في ذلك رمز SAS المميز إذا تم استخدامه. :rtype: str

abort_copy	إجهاض عملية نسخ مستمرة. سيؤدي ذلك إلى ترك كائن ثنائي كبير الحجم الوجهة مع طول صفري وبيانات تعريف كاملة. سيؤدي ذلك إلى ظهور خطأ إذا انتهت عملية النسخ بالفعل.
acquire_lease	يطلب عقد إيجار جديد. إذا لم يكن للكائن الثنائي كبير الحجم عقد إيجار نشط، تقوم خدمة Blob بإنشاء عقد إيجار على الكائن الثنائي كبير الحجم وإرجاع عقد إيجار جديد.
append_block	تثبيت كتلة جديدة من البيانات إلى نهاية الكائن الثنائي كبير الحجم الموجود للإلحاق.
append_block_from_url	إنشاء كتلة جديدة ليتم الالتزام بها كجزء من كائن ثنائي كبير الحجم، حيث تتم قراءة المحتويات من عنوان url المصدر.
clear_page	مسح مجموعة من الصفحات.
close	هذا الأسلوب هو إغلاق مآخذ التوصيل التي يفتحها العميل. لا يلزم استخدامه عند استخدام مع مدير سياق.
commit_block_list	تكتب عملية Commit Block List كائنا ثنائيا كبير الحجم عن طريق تحديد قائمة معرفات الكتلة التي تشكل الكائن الثنائي كبير الحجم.
create_append_blob	إنشاء Append Blob جديد. تنشئ هذه العملية كائنا ثنائيا كبير الحجم ملحقا جديدا بطول 0. تتم الكتابة فوق محتوى أي كائن ثنائي كبير الحجم موجود مع كائن ثنائي كبير الحجم للإلحاق الذي تم تهيئته حديثا. لإضافة محتوى إلى الكائن الثنائي كبير الحجم للإلحاق، اتصل بالأسلوب append_block أو append_block_from_url .
create_page_blob	إنشاء كائن ثنائي كبير الحجم جديد للصفحة بالحجم المحدد.
create_snapshot	إنشاء لقطة للكائن الثنائي كبير الحجم. اللقطة هي نسخة للقراءة فقط من كائن ثنائي كبير الحجم يتم التقاطه في وقت معين. يمكن قراءته أو نسخه أو حذفه، ولكن لا يمكن تعديله. توفر النسخ المطابقة طريقة لعمل نسخة احتياطية من نقطة كما تظهر في لحظة من الزمن. تحتوي لقطة الكائن الثنائي كبير الحجم على نفس اسم الكائن الثنائي كبير الحجم الأساسي الذي يتم أخذ اللقطة منه، مع إلحاق قيمة DateTime للإشارة إلى الوقت الذي تم أخذ اللقطة فيه.
delete_blob	وضع علامة على الكائن الثنائي كبير الحجم المحدد للحذف. يتم حذف الكائن الثنائي كبير الحجم لاحقا أثناء تجميع البيانات المهملة. لاحظ أنه لحذف كائن ثنائي كبير الحجم، يجب حذف جميع اللقطات الخاصة به. يمكنك حذف كليهما في نفس الوقت باستخدام عملية delete_blob(). إذا تم تمكين نهج استبقاء حذف للخدمة، فإن هذه العملية تحذف النقطة بشكل مبدئي وتحتفظ بالكائنات الثنائية كبيرة الحجم لعدد محدد من الأيام. بعد عدد الأيام المحدد، تتم إزالة بيانات الكائن الثنائي كبير الحجم من الخدمة أثناء تجميع البيانات المهملة. يمكن الوصول إلى الكائن الثنائي كبير الحجم المحذوف مبدئيا من خلال list_blobs تحديد خيار include=['deleted']. يمكن استعادة الكائن الثنائي كبير الحجم المحذوف مبدئيا باستخدام <xref:azure.storage.blob.undelete> العملية.
delete_immutability_policy	تحذف عملية Delete Immutability Policy نهج الثبات على الكائن الثنائي كبير الحجم. جديد في الإصدار 12.10.0: تم تقديم هذه العملية في إصدار واجهة برمجة التطبيقات "2020-10-02".
download_blob	تنزيل كائن ثنائي كبير الحجم إلى StorageStreamDownloader. يجب استخدام أسلوب readall() لقراءة كل المحتوى أو يجب استخدام readinto() لتنزيل الكائن الثنائي كبير الحجم في دفق. يؤدي استخدام القطع () إلى إرجاع مكرر يسمح للمستخدم بالتكرار عبر المحتوى في مجموعات.
exists	إرجاع True إذا كان هناك كائن ثنائي كبير الحجم مع المعلمات المحددة، وإرجاع False بخلاف ذلك.
from_blob_url	إنشاء BlobClient من عنوان url لكائن ثنائي كبير الحجم. لا يدعم هذا عنوان url للكائن الثنائي كبير الحجم المخصص مع '/' في اسم الكائن الثنائي كبير الحجم.
from_connection_string	إنشاء BlobClient من سلسلة اتصال.
get_account_information	يحصل على معلومات تتعلق بحساب التخزين الذي يوجد فيه الكائن الثنائي كبير الحجم. يمكن أيضا استرداد المعلومات إذا كان لدى المستخدم SAS إلى حاوية أو كائن ثنائي كبير الحجم. تتضمن المفاتيح الموجودة في القاموس الذي تم إرجاعه "sku_name" و"account_kind".
get_blob_properties	إرجاع جميع بيانات التعريف المعرفة من قبل المستخدم وخصائص HTTP القياسية وخصائص النظام للكائن الثنائي كبير الحجم. لا يرجع محتوى الكائن الثنائي كبير الحجم.
get_blob_tags	تمكن عملية Get Tags المستخدمين من الحصول على علامات على كائن ثنائي كبير الحجم أو إصدار كائن ثنائي كبير الحجم معين أو لقطة. جديد في الإصدار 12.4.0: تم تقديم هذه العملية في إصدار واجهة برمجة التطبيقات "2019-12-12".
get_block_list	تسترد عملية Get Block List قائمة الكتل التي تم تحميلها كجزء من كائن ثنائي كبير الحجم للكتلة.
get_page_range_diff_for_managed_disk	إرجاع قائمة نطاقات الصفحات الصالحة لقرص أو لقطة مدارة. ملاحظة تتوفر هذه العملية فقط لحسابات القرص المدارة. جديد في الإصدار 12.2.0: تم تقديم هذه العملية في إصدار واجهة برمجة التطبيقات "2019-07-07".
get_page_ranges	DEPRECATED: إرجاع قائمة نطاقات الصفحات الصالحة لكائن ثنائي كبير الحجم للصفحة أو لقطة لكائن ثنائي كبير الحجم للصفحة.
list_page_ranges	إرجاع قائمة نطاقات الصفحات الصالحة لكائن ثنائي كبير الحجم للصفحة أو لقطة لكائن ثنائي كبير الحجم للصفحة. إذا تم تحديد previous_snapshot ، ستكون النتيجة فرزا للتغييرات بين الكائن الثنائي كبير الحجم الهدف واللقطة السابقة.
query_blob	تمكين المستخدمين من تحديد/مشروع على بيانات لقطة كائن ثنائي كبير الحجم/أو كائن ثنائي كبير الحجم من خلال توفير تعبيرات استعلام بسيطة. ترجع هذه العمليات BlobQueryReader، يحتاج المستخدمون إلى استخدام readall() أو readinto() للحصول على بيانات الاستعلام.
resize_blob	تغيير حجم كائن ثنائي كبير الحجم للصفحة إلى الحجم المحدد. إذا كانت القيمة المحددة أقل من الحجم الحالي للكائن الثنائي كبير الحجم، فسيتم مسح جميع الصفحات فوق القيمة المحددة.
seal_append_blob	تختم عملية Seal الكائن الثنائي كبير الحجم الملحق لجعله للقراءة فقط. جديد في الإصدار 12.4.0.
set_blob_metadata	تعيين بيانات التعريف المعرفة من قبل المستخدم للكائن الثنائي كبير الحجم كزوج واحد أو أكثر من أزواج قيمة الاسم.
set_blob_tags	تمكن عملية تعيين العلامات المستخدمين من تعيين علامات على كائن ثنائي كبير الحجم أو إصدار كائن ثنائي كبير الحجم محدد، ولكن ليس لقطة. يحل كل استدعاء لهذه العملية محل جميع العلامات الموجودة المرفقة بالكائن الثنائي كبير الحجم. لإزالة جميع العلامات من الكائن الثنائي كبير الحجم، قم باستدعاء هذه العملية دون تعيين علامات. جديد في الإصدار 12.4.0: تم تقديم هذه العملية في إصدار واجهة برمجة التطبيقات "2019-12-12".
set_http_headers	تعيين خصائص النظام على الكائن الثنائي كبير الحجم. إذا تم تعيين خاصية واحدة content_settings، فسيتم تجاوز جميع الخصائص.
set_immutability_policy	تعين عملية تعيين نهج الثبات نهج الثبات على الكائن الثنائي كبير الحجم. جديد في الإصدار 12.10.0: تم تقديم هذه العملية في إصدار واجهة برمجة التطبيقات "2020-10-02".
set_legal_hold	تعين عملية Set Legal Hold تعليقا قانونيا على الكائن الثنائي كبير الحجم. جديد في الإصدار 12.10.0: تم تقديم هذه العملية في إصدار واجهة برمجة التطبيقات "2020-10-02".
set_premium_page_blob_tier	تعيين طبقات كائن ثنائي كبير الحجم للصفحة على الكائن الثنائي كبير الحجم. يتم دعم واجهة برمجة التطبيقات هذه فقط لكائنات ثنائية كبيرة الحجم للصفحة على الحسابات المتميزة.
set_sequence_number	تعيين رقم تسلسل الكائن الثنائي كبير الحجم.
set_standard_blob_tier	تعين هذه العملية الطبقة على كائن ثنائي كبير الحجم للكتلة. تحدد طبقة كائن ثنائي كبير الحجم للكتلة نوع التخزين Hot/Cool/Archive. لا تقوم هذه العملية بتحديث ETag للكائن الثنائي كبير الحجم.
stage_block	إنشاء كتلة جديدة ليتم الالتزام بها كجزء من كائن ثنائي كبير الحجم.
stage_block_from_url	إنشاء كتلة جديدة ليتم تثبيتها كجزء من كائن ثنائي كبير الحجم حيث تتم قراءة المحتويات من عنوان URL.
start_copy_from_url	نسخ كائن ثنائي كبير الحجم من عنوان URL المحدد. ترجع هذه العملية قاموسا يحتوي على copy_statuscopy_id، والذي يمكن استخدامه للتحقق من حالة عملية النسخ أو إجهاضها. سيكون copy_status "ناجحا" إذا اكتملت النسخة بشكل متزامن أو "معلق" إذا تم بدء النسخة بشكل غير متزامن. بالنسبة للنسخ غير المتزامنة، يمكن التحقق من الحالة عن طريق التحقق من get_blob_properties الأسلوب والتحقق من حالة النسخ. قم بتعيين requires_sync إلى True لفرض أن تكون النسخة متزامنة. تنسخ خدمة Blob الكائنات الثنائية كبيرة الحجم على أساس أفضل جهد. قد يكون الكائن الثنائي كبير الحجم المصدر لعملية نسخ كائن ثنائي كبير الحجم للكتلة أو كائن ثنائي كبير الحجم للإلحاق أو كائن ثنائي كبير الحجم للصفحة. إذا كان الكائن الثنائي كبير الحجم في الوجهة موجودة بالفعل، يجب أن يكون من نفس نوع الكائن الثنائي كبير الحجم الموجود في المصدر. سيتم استبدال أي كائن ثنائي كبير الحجم وجهة موجود. لا يمكن تعديل الكائن الثنائي كبير الحجم الوجهة أثناء عملية النسخ قيد التقدم. عند النسخ من كائن ثنائي كبير الحجم للصفحة، تقوم خدمة Blob بإنشاء كائن ثنائي كبير الحجم للصفحة الوجهة لطول الكائن الثنائي كبير الحجم المصدر، يحتوي في البداية على جميع الأصفار. ثم يتم تعداد نطاقات الصفحات المصدر، ويتم نسخ النطاقات غير الفارغة. بالنسبة لكائن ثنائي كبير الحجم للكتلة أو كائن ثنائي كبير الحجم ملحق، تنشئ خدمة Blob كائن ثنائي كبير الحجم ملتزما بطول صفري قبل العودة من هذه العملية. عند النسخ من كائن ثنائي كبير الحجم للكتلة، يتم نسخ جميع الكتل الملتزم بها ومعرفات الكتلة الخاصة بها. لا يتم نسخ الكتل غير الملتزم بها. في نهاية عملية النسخ، سيكون للكائن الثنائي كبير الحجم الوجهة نفس عدد الكتل الملتزم بها مثل المصدر. عند النسخ من كائن ثنائي كبير الحجم للإلحاق، يتم نسخ جميع الكتل الملتزم بها. في نهاية عملية النسخ، سيكون للكائن الثنائي كبير الحجم الوجهة نفس عدد الكتل الملتزم بها مثل المصدر.
undelete_blob	استعادة الكائنات الثنائية كبيرة الحجم أو اللقطات المحذوفة مبدئيا. لن تنجح العملية إلا إذا تم استخدامها ضمن عدد الأيام المحدد المحدد في نهج استبقاء الحذف. إذا تم تمكين تعيين إصدار كائن ثنائي كبير الحجم، فلا يمكن استعادة الكائن الثنائي كبير الحجم الأساسي باستخدام هذا الأسلوب. بدلا من ذلك، استخدم start_copy_from_url مع عنوان URL لإصدار الكائن الثنائي كبير الحجم الذي ترغب في ترقيته إلى الإصدار الحالي.
upload_blob	إنشاء كائن ثنائي كبير الحجم جديد من مصدر بيانات مع التقسيم التلقائي.
upload_blob_from_url	إنشاء كائن ثنائي كبير الحجم جديد للكتلة حيث تتم قراءة محتوى الكائن الثنائي كبير الحجم من عنوان URL معين. تتم الكتابة فوق محتوى كائن ثنائي كبير الحجم موجود باستخدام الكائن الثنائي كبير الحجم الجديد.
upload_page	تكتب عملية تحميل الصفحات مجموعة من الصفحات إلى كائن ثنائي كبير الحجم للصفحة.
upload_pages_from_url	تكتب عملية تحميل الصفحات مجموعة من الصفحات إلى كائن ثنائي كبير الحجم للصفحة حيث تتم قراءة المحتويات من عنوان URL.

Share via

BlobClient الفصل

الدالمنشئ

المعلمات

الأساليب

abort_copy

المعلمات

نوع الإرجاع

acquire_lease

المعلمات

المرتجعات

نوع الإرجاع

append_block

المعلمات

المرتجعات

نوع الإرجاع

append_block_from_url

المعلمات

clear_page

المعلمات

المرتجعات

نوع الإرجاع

close

commit_block_list

المعلمات

المرتجعات

نوع الإرجاع

create_append_blob

المعلمات

المرتجعات

نوع الإرجاع

create_page_blob

المعلمات

المرتجعات

نوع الإرجاع

create_snapshot

المعلمات

المرتجعات

نوع الإرجاع

delete_blob

المعلمات

نوع الإرجاع

delete_immutability_policy

المعلمات

المرتجعات

نوع الإرجاع

download_blob

المعلمات

المرتجعات

نوع الإرجاع

exists

المعلمات

المرتجعات

نوع الإرجاع

from_blob_url

المعلمات

المرتجعات

نوع الإرجاع

from_connection_string

المعلمات

المرتجعات

نوع الإرجاع

get_account_information

المرتجعات

نوع الإرجاع

get_blob_properties

المعلمات

المرتجعات

نوع الإرجاع

get_blob_tags

المعلمات

المرتجعات

نوع الإرجاع

get_block_list

المعلمات

المرتجعات

نوع الإرجاع

get_page_range_diff_for_managed_disk

المعلمات

المرتجعات