BlobDownloadOptions interface

الحزمة:

@azure/storage-blob

خيارات لتكوين <xref:BlobClient.download> العملية.

Extends

CommonOptions

الخصائص

abortSignal	تنفيذ الواجهة AbortSignalLike للإشارة إلى طلب إلغاء العملية. على سبيل المثال، استخدم @azure/abort-controller لإنشاء AbortSignal.
conditions	الشروط التي يجب تلبيتها عند تنزيل الكائنات الثنائية كبيرة الحجم.
customerProvidedKey	معلومات المفتاح المقدمة من العميل.
maxRetryRequests	‏‏اختياري. متوفر فقط في NODE.JS. كم عدد عمليات إعادة المحاولة التي سيتم إجراؤها عند انتهاء دفق تنزيل النص الأصلي بشكل غير متوقع. لن يؤدي النوع أعلاه من الأطراف إلى تشغيل نهج إعادة المحاولة المحدد في البنية الأساسية لبرنامج ربط العمليات التجارية، لأنها لا تنبعث منها أخطاء في الشبكة. باستخدام هذا الخيار، تعني كل إعادة محاولة إضافية أنه سيتم تقديم طلب إضافي FileClient.download() من النقطة المقطوعة، حتى يتم تنزيل النطاق المطلوب بنجاح أو الوصول إلى maxRetryRequests. القيمة الافتراضية هي 5، يرجى تعيين قيمة أكبر عند تحميل الملفات الكبيرة في شبكة ضعيفة.
onProgress	اتصل مرة أخرى لتلقي الأحداث حول تقدم عملية التنزيل.
rangeGetContentCrc64	عند تعيين هذا إلى نطاق صحيح وتنزيل كائن ثنائي كبير الحجم، ترجع الخدمة تجزئة CRC64 للنطاق، طالما أن النطاق أقل من أو يساوي 4 ميغابايت في الحجم. لا يمكن تعيين rangeGetContentCrc64 و rangeGetContentMD5 في نفس الوقت.
rangeGetContentMD5	عند تعيين هذا إلى نطاق صحيح وتنزيل الكائن الثنائي كبير الحجم، ترجع الخدمة تجزئة MD5 للنطاق، طالما أن النطاق أقل من أو يساوي 4 ميغابايت في الحجم. لا يمكن تعيين rangeGetContentCrc64 و rangeGetContentMD5 في نفس الوقت.
snapshot	قيمة سلسلة DateTime غير شفافة تحدد لقطة الكائن الثنائي كبير الحجم لاستردادها عند وجودها.
tracingOptions	خيارات لتكوين الامتدادات التي تم إنشاؤها عند تمكين التتبع.

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

abortSignal

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

abortSignal?: AbortSignalLike

قيمة الخاصية

AbortSignalLike

conditions

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

conditions?: BlobRequestConditions

قيمة الخاصية

BlobRequestConditions

customerProvidedKey

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

customerProvidedKey?: CpkInfo

قيمة الخاصية

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

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

rangeGetContentMD5?: boolean

قيمة الخاصية

boolean

snapshot

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

snapshot?: string

قيمة الخاصية

string

tracingOptions

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

tracingOptions?: OperationTracingOptions

قيمة الخاصية

OperationTracingOptions