StorageClient الفصل

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

توريث

builtins.object

StorageClient

الدالمنشئ

StorageClient(connection_params)

المعلمات

connection_params

<xref:obj>

مطلوب

المعلمات التي يجب استخدامها لإنشاء العميل.

المتغيرات

account_name

str

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

account_key

str

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

sas_token

str

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

primary_endpoint

str

نقطة النهاية لإرسال طلبات التخزين إليها.

secondary_endpoint

str

نقطة النهاية الثانوية لقراءة بيانات التخزين منها. ستكون هذه نقطة نهاية صالحة فقط إذا كان حساب التخزين المستخدم هو RA-GRS وبالتالي يسمح بالقراءة من الثانوي.

retry

<xref:function>(<xref:context>)

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

location_mode

LocationMode

موقع المضيف الذي يجب استخدامه لتقديم الطلبات. الإعدادات الافتراضية ل LocationMode.PRIMARY. لاحظ أن هذا الإعداد ينطبق فقط على حسابات RA-GRS لأن أنواع الحسابات الأخرى لا تسمح بالقراءة من الثانوي. إذا تم تعيين location_mode إلى LocationMode.SECONDARY، فسيتم إرسال طلبات القراءة إلى نقطة النهاية الثانوية. سيستمر إرسال طلبات الكتابة إلى الأساسي.

protocol

str

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

request_session

<xref:requests.Session>

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

request_callback

<xref:function>(<xref:request>)

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

response_callback

<xref:function>()

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

retry_callback

<xref:function>()

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

الأساليب

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

extract_date_and_request_id

static extract_date_and_request_id(retry_context)

المعلمات

retry_context

مطلوب

set_proxy

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

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

المعلمات

host

str

مطلوب

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

port

int

مطلوب

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

user

str

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

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

password

str

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

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

السمات

protocol

request_session

socket_timeout