مشاركة عبر


BlobDownloadOptions interface

خيارات لتكوين عملية تنزيل .

يمتد

الخصائص

abortSignal

تنفيذ واجهة AbortSignalLike للإشارة إلى طلب إلغاء العملية. على سبيل المثال، استخدم وحدة التحكم @azure/abort لإنشاء AbortSignal.

conditions

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

customerProvidedKey

معلومات المفتاح المقدمة من العميل.

maxRetryRequests

اختياري. متوفر فقط في NODE.JS.

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

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

القيمة الافتراضية هي 5، يرجى تعيين قيمة أكبر عند تحميل الملفات الكبيرة في شبكة ضعيفة.

onProgress

اتصل مرة أخرى لتلقي الأحداث حول تقدم عملية التنزيل.

rangeGetContentCrc64

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

لا يمكن تعيين rangeGetContentCrc64 و rangeGetContentMD5 في نفس الوقت.

rangeGetContentMD5

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

لا يمكن تعيين rangeGetContentCrc64 و rangeGetContentMD5 في نفس الوقت.

snapshot

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

الخصائص الموروثة

tracingOptions

خيارات لتكوين الامتدادات التي تم إنشاؤها عند تمكين التتبع.

تفاصيل الخاصية

abortSignal

تنفيذ واجهة AbortSignalLike للإشارة إلى طلب إلغاء العملية. على سبيل المثال، استخدم وحدة التحكم @azure/abort لإنشاء AbortSignal.

abortSignal?: AbortSignalLike

قيمة الخاصية

conditions

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

conditions?: BlobRequestConditions

قيمة الخاصية

customerProvidedKey

معلومات المفتاح المقدمة من العميل.

customerProvidedKey?: CpkInfo

قيمة الخاصية

maxRetryRequests

اختياري. متوفر فقط في NODE.JS.

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

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

القيمة الافتراضية هي 5، يرجى تعيين قيمة أكبر عند تحميل الملفات الكبيرة في شبكة ضعيفة.

maxRetryRequests?: number

قيمة الخاصية

number

onProgress

اتصل مرة أخرى لتلقي الأحداث حول تقدم عملية التنزيل.

onProgress?: (progress: TransferProgressEvent) => void

قيمة الخاصية

(progress: TransferProgressEvent) => void

rangeGetContentCrc64

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

لا يمكن تعيين rangeGetContentCrc64 و rangeGetContentMD5 في نفس الوقت.

rangeGetContentCrc64?: boolean

قيمة الخاصية

boolean

rangeGetContentMD5

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

لا يمكن تعيين rangeGetContentCrc64 و rangeGetContentMD5 في نفس الوقت.

rangeGetContentMD5?: boolean

قيمة الخاصية

boolean

snapshot

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

snapshot?: string

قيمة الخاصية

string

تفاصيل الخاصية الموروثة

tracingOptions

خيارات لتكوين الامتدادات التي تم إنشاؤها عند تمكين التتبع.

tracingOptions?: OperationTracingOptions

قيمة الخاصية

موروث منCommonOptions.tracingOptions