FileDownloadHeaders interface

الحزمة:

@azure/storage-file

تعريف رؤوس عملية التنزيل.

الخصائص

acceptRanges	يشير إلى أن الخدمة تدعم طلبات محتوى الملف الجزئي.
cacheControl	يتم إرجاعه إذا تم تحديده مسبقا للملف.
contentDisposition	ترجع القيمة التي تم تحديدها لعنوان "x-ms-content-disposition" وتحدد كيفية معالجة الاستجابة.
contentEncoding	إرجاع القيمة التي تم تحديدها لعنوان طلب ترميز المحتوى.
contentLanguage	إرجاع القيمة التي تم تحديدها لعنوان طلب لغة المحتوى.
contentLength	عدد وحدات البايت الموجودة في نص الاستجابة.
contentMD5	إذا كان الملف يحتوي على تجزئة MD5 وكان الطلب هو قراءة الملف الكامل، يتم إرجاع عنوان الاستجابة هذا بحيث يمكن للعميل التحقق من تكامل محتوى الرسالة. إذا كان الطلب هو قراءة نطاق محدد وتعيين "x-ms-range-get-content-md5" إلى صحيح، فإن الطلب يرجع تجزئة MD5 للنطاق، طالما أن حجم النطاق أقل من أو يساوي 4 ميغابايت. إذا لم تكن أي من مجموعات الشروط هذه صحيحة، فلن يتم إرجاع أي قيمة لعنوان "Content-MD5".
contentRange	يشير إلى نطاق وحدات البايت التي تم إرجاعها إذا طلب العميل مجموعة فرعية من الملف عن طريق تعيين عنوان طلب النطاق.
contentType	نوع المحتوى المحدد للملف. نوع المحتوى الافتراضي هو "application/octet-stream"
copyCompletionTime	وقت الانتهاء من آخر محاولة لعملية نسخ الملف حيث كان هذا الملف هو الملف الوجهة. يمكن لهذه القيمة تحديد وقت محاولة النسخ المكتملة أو الفاشلة أو التي تم إجهاضها.
copyId	معرف السلسلة لآخر محاولة لعملية نسخ الملف حيث كان هذا الملف هو الملف الوجهة.
copyProgress	يحتوي على عدد وحدات البايت المنسوخة وإجمالي وحدات البايت في المصدر في آخر محاولة لعملية نسخ الملف حيث كان هذا الملف هو الملف الوجهة. يمكن أن يظهر بين 0 وبايت طول المحتوى المنسخ.
copySource	URL يصل إلى 2 كيلوبايت في الطول الذي يحدد الملف المصدر المستخدم في آخر محاولة لعملية نسخ الملف حيث كان هذا الملف هو الملف الوجهة.
copyStatus	حالة عملية النسخ المحددة بواسطة "x-ms-copy-id". تتضمن القيم المحتملة: "معلق" و"نجاح" و"تم إجهاضه" و"فشل"
copyStatusDescription	يظهر فقط عند فشل حالة x-ms-copy-status أو تعليقها. يصف سبب فشل عملية النسخ القاتلة أو غير القاتلة.
date	قيمة تاريخ/وقت UTC تم إنشاؤها بواسطة الخدمة تشير إلى الوقت الذي تم فيه بدء الاستجابة.
errorCode
eTag	يحتوي ETag على قيمة يمكنك استخدامها لتنفيذ العمليات بشكل مشروط، في علامات الاقتباس.
fileAttributes	السمات المعينة للملف.
fileChangeTime	تغيير وقت الملف.
fileContentMD5	إذا كان الملف يحتوي على تجزئة MD5، وإذا كان الطلب يحتوي على رأس نطاق (نطاق أو x-ms-range)، إرجاع عنوان الاستجابة هذا بقيمة MD5 للملف بأكمله. قد تكون هذه القيمة أو لا تساوي القيمة التي تم إرجاعها في رأس Content-MD5، مع حساب هذا الأخير من النطاق المطلوب.
fileCreationTime	وقت إنشاء الملف.
fileId	fileId للملف.
fileLastWriteTime	وقت الكتابة الأخير للملف.
fileParentId	معرف الملف الأصل للملف.
filePermissionKey	مفتاح مجموعة الأذونات للملف.
isServerEncrypted	يتم تعيين قيمة هذا العنوان إلى true إذا تم تشفير بيانات الملف وبيانات تعريف التطبيق بالكامل باستخدام الخوارزمية المحددة. وإلا، يتم تعيين القيمة إلى false (عندما يكون الملف غير مشفر، أو إذا تم تشفير أجزاء فقط من بيانات تعريف الملف/التطبيق).
lastModified	إرجاع تاريخ ووقت آخر تعديل للملف. تقوم أي عملية تقوم بتعديل الملف أو خصائصه بتحديث آخر مرة تم تعديلها.
metadata
requestId	يحدد هذا العنوان بشكل فريد الطلب الذي تم إجراؤه ويمكن استخدامه لاستكشاف أخطاء الطلب وإصلاحها.
version	يشير إلى إصدار خدمة الملفات المستخدمة لتنفيذ الطلب.

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

acceptRanges

يشير إلى أن الخدمة تدعم طلبات محتوى الملف الجزئي.

acceptRanges?: undefined | string

قيمة الخاصية

undefined | string

cacheControl

يتم إرجاعه إذا تم تحديده مسبقا للملف.

cacheControl?: undefined | string

قيمة الخاصية

undefined | string

contentDisposition

ترجع القيمة التي تم تحديدها لعنوان "x-ms-content-disposition" وتحدد كيفية معالجة الاستجابة.

contentDisposition?: undefined | string

قيمة الخاصية

undefined | string

contentEncoding

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

contentEncoding?: undefined | string

قيمة الخاصية

undefined | string

contentLanguage

إرجاع القيمة التي تم تحديدها لعنوان طلب لغة المحتوى.

contentLanguage?: undefined | string

قيمة الخاصية

undefined | string

contentLength

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

contentLength?: undefined | number

قيمة الخاصية

undefined | number

contentMD5

إذا كان الملف يحتوي على تجزئة MD5 وكان الطلب هو قراءة الملف الكامل، يتم إرجاع عنوان الاستجابة هذا بحيث يمكن للعميل التحقق من تكامل محتوى الرسالة. إذا كان الطلب هو قراءة نطاق محدد وتعيين "x-ms-range-get-content-md5" إلى صحيح، فإن الطلب يرجع تجزئة MD5 للنطاق، طالما أن حجم النطاق أقل من أو يساوي 4 ميغابايت. إذا لم تكن أي من مجموعات الشروط هذه صحيحة، فلن يتم إرجاع أي قيمة لعنوان "Content-MD5".

contentMD5?: Uint8Array

قيمة الخاصية

Uint8Array

contentRange

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

contentRange?: undefined | string

قيمة الخاصية

undefined | string

contentType

نوع المحتوى المحدد للملف. نوع المحتوى الافتراضي هو "application/octet-stream"

contentType?: undefined | string

قيمة الخاصية

undefined | string

copyCompletionTime

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

copyCompletionTime?: Date

قيمة الخاصية

Date

copyId

معرف السلسلة لآخر محاولة لعملية نسخ الملف حيث كان هذا الملف هو الملف الوجهة.

copyId?: undefined | string

قيمة الخاصية

undefined | string

copyProgress

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

copyProgress?: undefined | string

قيمة الخاصية

undefined | string

copySource

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

copySource?: undefined | string

قيمة الخاصية

undefined | string

copyStatus

حالة عملية النسخ المحددة بواسطة "x-ms-copy-id". تتضمن القيم المحتملة: "معلق" و"نجاح" و"تم إجهاضه" و"فشل"

copyStatus?: CopyStatusType

قيمة الخاصية

CopyStatusType

copyStatusDescription

يظهر فقط عند فشل حالة x-ms-copy-status أو تعليقها. يصف سبب فشل عملية النسخ القاتلة أو غير القاتلة.

copyStatusDescription?: undefined | string

قيمة الخاصية

undefined | string

date

قيمة تاريخ/وقت UTC تم إنشاؤها بواسطة الخدمة تشير إلى الوقت الذي تم فيه بدء الاستجابة.

date?: Date

قيمة الخاصية

Date

errorCode

errorCode?: undefined | string

قيمة الخاصية

undefined | string

eTag

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

eTag?: undefined | string

قيمة الخاصية

undefined | string

fileAttributes

السمات المعينة للملف.

fileAttributes?: undefined | string

قيمة الخاصية

undefined | string

fileChangeTime

تغيير وقت الملف.

fileChangeTime?: Date

قيمة الخاصية

Date

fileContentMD5

إذا كان الملف يحتوي على تجزئة MD5، وإذا كان الطلب يحتوي على رأس نطاق (نطاق أو x-ms-range)، إرجاع عنوان الاستجابة هذا بقيمة MD5 للملف بأكمله. قد تكون هذه القيمة أو لا تساوي القيمة التي تم إرجاعها في رأس Content-MD5، مع حساب هذا الأخير من النطاق المطلوب.

fileContentMD5?: Uint8Array

قيمة الخاصية

Uint8Array

fileCreationTime

وقت إنشاء الملف.

fileCreationTime?: Date

قيمة الخاصية

Date

fileId

fileId للملف.

fileId?: undefined | string

قيمة الخاصية

undefined | string

fileLastWriteTime

وقت الكتابة الأخير للملف.

fileLastWriteTime?: Date

قيمة الخاصية

Date

fileParentId

معرف الملف الأصل للملف.

fileParentId?: undefined | string

قيمة الخاصية

undefined | string

filePermissionKey

مفتاح مجموعة الأذونات للملف.

filePermissionKey?: undefined | string

قيمة الخاصية

undefined | string

isServerEncrypted

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

isServerEncrypted?: undefined | false | true

قيمة الخاصية

undefined | false | true

lastModified

إرجاع تاريخ ووقت آخر تعديل للملف. تقوم أي عملية تقوم بتعديل الملف أو خصائصه بتحديث آخر مرة تم تعديلها.

lastModified?: Date

قيمة الخاصية

Date

metadata

metadata?: undefined | [key: string]: string

قيمة الخاصية

undefined | [key: string]: string

requestId

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

requestId?: undefined | string

قيمة الخاصية

undefined | string

version

يشير إلى إصدار خدمة الملفات المستخدمة لتنفيذ الطلب.

version?: undefined | string

قيمة الخاصية

undefined | string