BlobServiceClient الفصل

عميل للتفاعل مع خدمة Blob على مستوى الحساب.

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

لمزيد من التكوين الاختياري، يرجى النقر هنا.

توريث

azure.storage.blob._shared.base_client.StorageAccountHostsMixin

BlobServiceClient

azure.storage.blob._encryption.StorageEncryptionMixin

BlobServiceClient

الدالمنشئ

BlobServiceClient(account_url: str, credential: str | Dict[str, str] | AzureNamedKeyCredential | AzureSasCredential | TokenCredential | None = None, **kwargs: Any)

المعلمات

account_url

str

مطلوب

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

credential

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

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

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

api_version

str

إصدار Storage API لاستخدامه للطلبات. القيمة الافتراضية هي أحدث إصدار خدمة متوافق مع SDK الحالي. قد يؤدي الإعداد إلى إصدار أقدم إلى تقليل توافق الميزات.

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

secondary_hostname

str

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

max_block_size

int

الحد الأقصى لحجم المجموعة لتحميل كائن ثنائي كبير الحجم للكتلة في مجموعات. الإعدادات الافتراضية إلى 4*1024*1024 أو 4 ميغابايت.

max_single_put_size

int

إذا كان حجم الكائن الثنائي كبير الحجم أقل من أو يساوي max_single_put_size، فسيتم تحميل الكائن الثنائي كبير الحجم مع طلب http PUT واحد فقط. إذا كان حجم الكائن الثنائي كبير الحجم أكبر من max_single_put_size، فسيتم تحميل الكائن الثنائي كبير الحجم في مجموعات. الإعدادات الافتراضية إلى 64*1024*1024 أو 64 ميغابايت.

min_large_block_upload_threshold

int

الحد الأدنى لحجم المجموعة المطلوب لاستخدام خوارزمية الذاكرة الفعالة عند تحميل كائن ثنائي كبير الحجم للكتلة. الإعدادات الافتراضية إلى 4*1024*1024+1.

use_byte_buffer

bool

استخدم مخزنا مؤقتا بايت لتحميلات كائن ثنائي كبير الحجم للكتلة. الإعدادات الافتراضية معينة على False.

max_page_size

int

الحد الأقصى لحجم المجموعة لتحميل كائن ثنائي كبير الحجم للصفحة. الإعدادات الافتراضية إلى 4*1024*1024 أو 4 ميغابايت.

max_single_get_size

int

الحد الأقصى لحجم الكائن الثنائي كبير الحجم الذي سيتم تنزيله في مكالمة واحدة، سيتم تنزيل الجزء الذي تم تجاوزه في مجموعات (يمكن أن يكون متوازيا). الإعدادات الافتراضية إلى 32*1024*1024 أو 32 ميغابايت.

max_chunk_get_size

int

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

الأساليب

close	هذا الأسلوب هو إغلاق مآخذ التوصيل التي فتحها العميل. لا يلزم استخدامه عند استخدام مع مدير سياق.
create_container	إنشاء حاوية جديدة ضمن الحساب المحدد. إذا كانت الحاوية بنفس الاسم موجودة بالفعل، فسيتم رفع ResourceExistsError. يقوم هذا الأسلوب بإرجاع عميل للتفاعل مع الحاوية التي تم إنشاؤها حديثا.
delete_container	وضع علامة على الحاوية المحددة للحذف. يتم حذف الحاوية وأي كائنات ثنائية كبيرة الحجم موجودة داخلها لاحقا أثناء تجميع البيانات المهملة. إذا لم يتم العثور على الحاوية، فسيتم رفع ResourceNotFoundError.
find_blobs_by_tags	تمكن عملية تصفية الكائنات الثنائية كبيرة الحجم المتصلين من سرد الكائنات الثنائية كبيرة الحجم عبر جميع الحاويات التي تتطابق علاماتها مع تعبير بحث معين. تصفية عمليات البحث عن الكائنات الثنائية كبيرة الحجم عبر جميع الحاويات داخل حساب تخزين ولكن يمكن تحديد نطاقها داخل التعبير إلى حاوية واحدة.
from_connection_string	إنشاء BlobServiceClient من سلسلة اتصال.
get_account_information	يحصل على معلومات تتعلق بحساب التخزين. يمكن أيضا استرداد المعلومات إذا كان لدى المستخدم SAS إلى حاوية أو كائن ثنائي كبير الحجم. تتضمن المفاتيح الموجودة في القاموس الذي تم إرجاعه "sku_name" و"account_kind".
get_blob_client	احصل على عميل للتفاعل مع الكائن الثنائي كبير الحجم المحدد. الكائن الثنائي كبير الحجم غير موجود بالفعل.
get_container_client	احصل على عميل للتفاعل مع الحاوية المحددة. الحاوية غير موجودة بالفعل.
get_service_properties	يحصل على خصائص خدمة Blob لحساب التخزين، بما في ذلك Azure Storage Analytics.
get_service_stats	استرداد الإحصائيات المتعلقة بالنسخ المتماثل لخدمة Blob. يتوفر فقط عند تمكين النسخ المتماثل المتكرر جغرافيا للوصول إلى القراءة لحساب التخزين. مع النسخ المتماثل الجغرافي المتكرر، يحافظ Azure Storage على بياناتك الدائمة في موقعين. في كلا الموقعين، يحتفظ Azure Storage باستمرار بنسخ متماثلة صحية متعددة من بياناتك. الموقع الذي تقرأ فيه البيانات أو تنشئها أو تحدثها أو تحذفها هو موقع حساب التخزين الأساسي. يوجد الموقع الأساسي في المنطقة التي تختارها في الوقت الذي تنشئ فيه حسابا عبر مدخل Azure Management Azure الكلاسيكي، على سبيل المثال، شمال وسط الولايات المتحدة. الموقع الذي يتم نسخ بياناتك إليه هو الموقع الثانوي. يتم تحديد الموقع الثانوي تلقائيا استنادا إلى موقع الأساسي؛ وهو في مركز بيانات ثان موجود في نفس المنطقة مثل الموقع الأساسي. يتوفر الوصول للقراءة فقط من الموقع الثانوي، إذا تم تمكين النسخ المتماثل المتكرر جغرافيا للوصول للقراءة لحساب التخزين الخاص بك.
get_user_delegation_key	احصل على مفتاح تفويض مستخدم لغرض توقيع رموز SAS المميزة. يجب أن تكون بيانات اعتماد الرمز المميز موجودة على كائن الخدمة حتى ينجح هذا الطلب.
list_containers	إرجاع منشئ لسرد الحاويات ضمن الحساب المحدد. سيتبع المولد ببطء الرموز المميزة للاستمرار التي تم إرجاعها بواسطة الخدمة ويتوقف عند إرجاع جميع الحاويات.
set_service_properties	تعيين خصائص خدمة Blob لحساب التخزين، بما في ذلك Azure Storage Analytics. إذا تم ترك عنصر (على سبيل المثال analytics_logging) ك بلا، يتم الاحتفاظ بالإعدادات الموجودة على الخدمة لتلك الوظيفة.
undelete_container	استعادة الحاوية المحذوفة مبدئيا. لن تنجح العملية إلا إذا تم استخدامها خلال عدد الأيام المحدد المحدد في نهج استبقاء الحذف. جديد في الإصدار 12.4.0: تم تقديم هذه العملية في إصدار واجهة برمجة التطبيقات "2019-12-12".

close

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

close()

create_container

إنشاء حاوية جديدة ضمن الحساب المحدد.

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

create_container(name: str, metadata: Dict[str, str] | None = None, public_access: PublicAccess | str | None = None, **kwargs) -> ContainerClient

المعلمات

name

str

مطلوب

اسم الحاوية المراد إنشاؤها.

metadata

dict(str, str)

مطلوب

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

public_access

str أو PublicAccess

مطلوب

تتضمن القيم المحتملة: 'container'، 'blob'.

container_encryption_scope

dict أو ContainerEncryptionScope

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

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

timeout

int

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

نوع الإرجاع

ContainerClient

delete_container

وضع علامة على الحاوية المحددة للحذف.

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

delete_container(container: ContainerProperties | str, lease: BlobLeaseClient | str | None = None, **kwargs) -> None

المعلمات

container

str أو ContainerProperties

مطلوب

الحاوية المراد حذفها. يمكن أن يكون هذا إما اسم الحاوية، أو مثيل ContainerProperties.

lease

مطلوب

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

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. لا يتم تعقب هذه القيمة أو التحقق من صحتها على العميل. لتكوين مهلات الشبكة من جانب العميل، راجع هنا.

نوع الإرجاع

None

find_blobs_by_tags

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

find_blobs_by_tags(filter_expression: str, **kwargs: Any) -> ItemPaged[FilteredBlob]

المعلمات

filter_expression

str

مطلوب

التعبير للعثور على الكائنات الثنائية كبيرة الحجم التي تتطابق علاماتها مع الشرط المحدد. مثل. ""yourtagname"="firsttag" و"yourtagname2"="secondtag"" لتحديد حاوية، على سبيل المثال. "@container="containerName" و"Name"="C""

results_per_page

int

الحد الأقصى للنتيجة لكل صفحة عند ترقيم الصفحات.

timeout

int

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

المرتجعات

استجابة قابلة للتكسير (ترحيل تلقائي) ل BlobProperties.

نوع الإرجاع

ItemPaged[FilteredBlob]

from_connection_string

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

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

المعلمات

conn_str

str

مطلوب

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

credential

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

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

المرتجعات

عميل خدمة Blob.

نوع الإرجاع

BlobServiceClient

get_account_information

يحصل على معلومات تتعلق بحساب التخزين.

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

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

المرتجعات

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

نوع الإرجاع

dict(str, str)

get_blob_client

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

الكائن الثنائي كبير الحجم غير موجود بالفعل.

get_blob_client(container: ContainerProperties | str, blob: BlobProperties | str, snapshot: Dict[str, Any] | str | None = None, *, version_id: str | None = None) -> BlobClient

المعلمات

container

str أو ContainerProperties

مطلوب

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

blob

str أو BlobProperties

مطلوب

الكائن الثنائي كبير الحجم الذي يجب التفاعل معه. يمكن أن يكون هذا إما اسم الكائن الثنائي كبير الحجم، أو مثيل BlobProperties.

snapshot

str أو dict(str, Any)

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

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

version_id

str

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

المرتجعات

A BlobClient.

نوع الإرجاع

BlobClient

get_container_client

احصل على عميل للتفاعل مع الحاوية المحددة.

الحاوية غير موجودة بالفعل.

get_container_client(container: ContainerProperties | str) -> ContainerClient

المعلمات

container

str أو ContainerProperties

مطلوب

الحاوية. يمكن أن يكون هذا إما اسم الحاوية، أو مثيل ContainerProperties.

المرتجعات

A ContainerClient.

نوع الإرجاع

ContainerClient

get_service_properties

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

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

المعلمات

timeout

int

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

المرتجعات

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

نوع الإرجاع

Dict[str, Any]

get_service_stats

استرداد الإحصائيات المتعلقة بالنسخ المتماثل لخدمة Blob.

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

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

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

المعلمات

timeout

int

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

المرتجعات

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

نوع الإرجاع

Dict[str, Any]

get_user_delegation_key

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

get_user_delegation_key(key_start_time: datetime, key_expiry_time: datetime, **kwargs: Any) -> UserDelegationKey

المعلمات

key_start_time

datetime

مطلوب

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

key_expiry_time

datetime

مطلوب

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

timeout

int

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

المرتجعات

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

نوع الإرجاع

UserDelegationKey

list_containers

إرجاع منشئ لسرد الحاويات ضمن الحساب المحدد.

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

list_containers(name_starts_with: str | None = None, include_metadata: bool | None = False, **kwargs) -> ItemPaged[ContainerProperties]

المعلمات

name_starts_with

str

مطلوب

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

include_metadata

bool

مطلوب

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

include_deleted

bool

يحدد الحاويات المحذوفة التي سيتم إرجاعها في الاستجابة. هذا للحساب الممكن لاستعادة الحاوية. القيمة الافتراضية هي False. .. تمت إضافة الإصدار: 12.4.0

include_system

bool

علامة تحدد أنه يجب تضمين حاويات النظام. .. تمت إضافة الإصدار: 12.10.0

results_per_page

int

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

timeout

int

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

المرتجعات

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

نوع الإرجاع

ItemPaged[ContainerProperties]

set_service_properties

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

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

set_service_properties(analytics_logging: BlobAnalyticsLogging | None = None, hour_metrics: Metrics | None = None, minute_metrics: Metrics | None = None, cors: List[CorsRule] | None = None, target_version: str | None = None, delete_retention_policy: RetentionPolicy | None = None, static_website: StaticWebsite | None = None, **kwargs) -> None

المعلمات

analytics_logging

BlobAnalyticsLogging

مطلوب

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

hour_metrics

Metrics

مطلوب

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

minute_metrics

Metrics

مطلوب

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

cors

list[CorsRule]

مطلوب

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

target_version

str

مطلوب

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

delete_retention_policy

RetentionPolicy

مطلوب

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

static_website

StaticWebsite

مطلوب

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

timeout

int

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

نوع الإرجاع

None

undelete_container

استعادة الحاوية المحذوفة مبدئيا.

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

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

undelete_container(deleted_container_name: str, deleted_container_version: str, **kwargs: Any) -> ContainerClient

المعلمات

deleted_container_name

str

مطلوب

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

deleted_container_version

str

مطلوب

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

timeout

int

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

المرتجعات

ContainerClient غير المحذوأ.

نوع الإرجاع

ContainerClient

السمات

api_version

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

location_mode

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

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

primary_endpoint

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

primary_hostname

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

secondary_endpoint

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

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

استثناءات

ValueError

secondary_hostname

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

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

url

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

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