BlobQueryHeaders interface

الحزمة:

@azure/storage-blob

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

الخصائص

acceptRanges	يشير إلى أن الخدمة تدعم طلبات محتوى كائن ثنائي كبير الحجم جزئي.
blobCommittedBlockCount	عدد الكتل الملتزم بها الموجودة في الكائن الثنائي كبير الحجم. يتم إرجاع هذا العنوان فقط لنقاط الإلحاق.
blobContentMD5	إذا كان الكائن الثنائي كبير الحجم يحتوي على تجزئة MD5، وإذا كان الطلب يحتوي على عنوان النطاق (النطاق أو x-ms-range)، يتم إرجاع عنوان الاستجابة هذا بقيمة MD5 للكائن الثنائي كبير الحجم بالكامل. قد تكون هذه القيمة أو لا تساوي القيمة التي تم إرجاعها في رأس Content-MD5، مع حساب الأخير من النطاق المطلوب
blobSequenceNumber	رقم التسلسل الحالي لكائن ثنائي كبير الحجم للصفحة. لا يتم إرجاع هذا العنوان لكائنات ثنائية كبيرة الحجم للكتلة أو إلحاق الكائنات الثنائية كبيرة الحجم
blobType	نوع الكائن الثنائي كبير الحجم.
cacheControl	يتم إرجاع هذا العنوان إذا تم تحديده مسبقا للكائن الثنائي كبير الحجم.
clientRequestId	إذا تم إرسال عنوان معرف طلب عميل في الطلب، فسيكون هذا العنوان موجودا في الاستجابة بنفس القيمة.
contentCrc64	إذا كان الطلب هو قراءة نطاق محدد وتعيين x-ms-range-get-content-crc64 إلى true، فإن الطلب يرجع crc64 للنطاق، طالما أن حجم النطاق أقل من أو يساوي 4 ميغابايت. إذا تم تحديد كل من x-ms-range-get-content-crc64 & x-ms-range-get-content-md5 في نفس الطلب، فسيفشل مع 400 (طلب غير صحيح).
contentDisposition	يقوم هذا العنوان بإرجاع القيمة التي تم تحديدها لعنوان "x-ms-blob-content-disposition". ينقل حقل عنوان استجابة ترتيب المحتوى معلومات إضافية حول كيفية معالجة حمولة الاستجابة، ويمكن أيضا استخدامه لإرفاق بيانات تعريف إضافية. على سبيل المثال، إذا تم تعيينه إلى مرفق، فإنه يشير إلى أنه يجب ألا يعرض عامل المستخدم الاستجابة، ولكن بدلا من ذلك يظهر مربع حوار حفظ باسم باسم ملف آخر غير اسم الكائن الثنائي كبير الحجم المحدد.
contentEncoding	يقوم هذا العنوان بإرجاع القيمة التي تم تحديدها لعنوان طلب ترميز المحتوى
contentLanguage	يقوم هذا العنوان بإرجاع القيمة التي تم تحديدها لعنوان طلب Content-Language.
contentLength	عدد وحدات البايت الموجودة في نص الاستجابة.
contentMD5	إذا كان الكائن الثنائي كبير الحجم يحتوي على تجزئة MD5 وكانت هذه العملية لقراءة الكائن الثنائي كبير الحجم الكامل، يتم إرجاع رأس الاستجابة هذا بحيث يمكن للعميل التحقق من تكامل محتوى الرسالة.
contentRange	يشير إلى نطاق وحدات البايت التي تم إرجاعها في حالة طلب العميل مجموعة فرعية من الكائن الثنائي كبير الحجم عن طريق تعيين عنوان طلب "النطاق".
contentType	نوع وسائط نص الاستجابة. لتنزيل Blob هذا هو "application/octet-stream"
copyCompletionTime	وقت الانتهاء من آخر محاولة لعملية نسخ Blob حيث كان هذا الكائن الثنائي كبير الحجم الوجهة. يمكن لهذه القيمة تحديد وقت محاولة النسخ المكتملة أو الفاشلة أو التي تم إجهاضها. لا يظهر هذا العنوان إذا كانت النسخة معلقة، أو إذا لم تكن هذه النقطة أبدا الوجهة في عملية Copy Blob، أو إذا تم تعديل هذا الكائن الثنائي كبير الحجم بعد عملية نسخ Blob منتهي باستخدام تعيين خصائص Blob أو Put Blob أو Put Block List.
copyId	معرف السلسلة لعملية النسخ هذه. استخدم مع Get Blob Properties للتحقق من حالة عملية النسخ هذه، أو قم بالتمرير إلى Abort Copy Blob لإجهاض نسخة معلقة.
copyProgress	يحتوي على عدد وحدات البايت المنسوخة وإجمالي وحدات البايت في المصدر في آخر محاولة لعملية نسخ Blob حيث كان هذا الكائن الثنائي كبير الحجم الوجهة. يمكن أن يظهر بين 0 وبايت طول المحتوى المنسخ. لا يظهر هذا العنوان إذا لم يكن هذا الكائن الثنائي كبير الحجم هو الوجهة في عملية Copy Blob، أو إذا تم تعديل هذا الكائن الثنائي كبير الحجم بعد عملية نسخ Blob مختتمة باستخدام تعيين خصائص Blob أو Put Blob أو Put Block List
copySource	URL يصل إلى 2 كيلوبايت في الطول الذي يحدد الكائن الثنائي كبير الحجم المصدر أو الملف المستخدم في آخر محاولة عملية نسخ Blob حيث كان هذا الكائن الثنائي كبير الحجم الوجهة. لا يظهر هذا العنوان إذا لم يكن هذا الكائن الثنائي كبير الحجم هو الوجهة في عملية Copy Blob، أو إذا تم تعديل هذا الكائن الثنائي كبير الحجم بعد عملية نسخ Blob منتهي باستخدام تعيين خصائص Blob أو Put Blob أو Put Block List.
copyStatus	حالة عملية النسخ المحددة بواسطة x-ms-copy-id.
copyStatusDescription	يظهر فقط عند فشل حالة x-ms-copy-status أو تعليقها. يصف سبب آخر فشل عملية نسخ فادح أو غير فادح. لا يظهر هذا العنوان إذا لم يكن هذا الكائن الثنائي كبير الحجم هو الوجهة في عملية Copy Blob، أو إذا تم تعديل هذا الكائن الثنائي كبير الحجم بعد عملية نسخ Blob مختتمة باستخدام تعيين خصائص Blob أو Put Blob أو Put Block List
date	قيمة التاريخ/الوقت UTC التي تم إنشاؤها بواسطة الخدمة التي تشير إلى الوقت الذي تم فيه بدء الاستجابة
encryptionKeySha256	تجزئة SHA-256 لمفتاح التشفير المستخدم لتشفير الكائن الثنائي كبير الحجم. يتم إرجاع هذا العنوان فقط عند تشفير الكائن الثنائي كبير الحجم باستخدام مفتاح يوفره العميل.
encryptionScope	إرجاع اسم نطاق التشفير المستخدم لتشفير محتويات الكائن الثنائي كبير الحجم وبيانات تعريف التطبيق. لاحظ أن عدم وجود هذا العنوان يعني استخدام نطاق تشفير الحساب الافتراضي.
errorCode	رمز الخطأ
etag	يحتوي ETag على قيمة يمكنك استخدامها لتنفيذ العمليات بشكل مشروط. إذا كان إصدار الطلب هو 2011-08-18 أو أحدث، ستكون قيمة ETag في علامات الاقتباس.
isServerEncrypted	يتم تعيين قيمة هذا العنوان إلى true إذا تم تشفير بيانات الكائن الثنائي كبير الحجم وبيانات تعريف التطبيق بالكامل باستخدام الخوارزمية المحددة. وإلا، يتم تعيين القيمة إلى خطأ (عندما يكون الكائن الثنائي كبير الحجم غير مشفر، أو إذا تم تشفير أجزاء فقط من البيانات الوصفية للكائن الثنائي كبير الحجم/التطبيق).
lastModified	إرجاع تاريخ ووقت آخر تعديل للحاوية. أي عملية تقوم بتعديل الكائن الثنائي كبير الحجم، بما في ذلك تحديث بيانات تعريف الكائن الثنائي كبير الحجم أو خصائصه، تغير وقت آخر تعديل للكائن الثنائي كبير الحجم.
leaseDuration	عند تأجير كائن ثنائي كبير الحجم، يحدد ما إذا كان التأجير لمدة لا نهائية أو ثابتة.
leaseState	حالة التأجير للكائن الثنائي كبير الحجم.
leaseStatus	حالة التأجير الحالية للكائن الثنائي كبير الحجم.
metadata
requestId	يحدد هذا العنوان بشكل فريد الطلب الذي تم إجراؤه ويمكن استخدامه لاستكشاف أخطاء الطلب وإصلاحها.
version	يشير إلى إصدار خدمة Blob المستخدمة لتنفيذ الطلب. يتم إرجاع هذا العنوان للطلبات المقدمة مقابل الإصدار 2009-09-19 والإصدارات الأحدث.

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

acceptRanges

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

acceptRanges?: string

قيمة الخاصية

string

blobCommittedBlockCount

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

blobCommittedBlockCount?: number

قيمة الخاصية

number

blobContentMD5

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

blobContentMD5?: Uint8Array

قيمة الخاصية

Uint8Array

blobSequenceNumber

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

blobSequenceNumber?: number

قيمة الخاصية

number

blobType

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

blobType?: BlobType

قيمة الخاصية

BlobType

cacheControl

يتم إرجاع هذا العنوان إذا تم تحديده مسبقا للكائن الثنائي كبير الحجم.

cacheControl?: string

قيمة الخاصية

string

clientRequestId

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

clientRequestId?: string

قيمة الخاصية

string

contentCrc64

إذا كان الطلب هو قراءة نطاق محدد وتعيين x-ms-range-get-content-crc64 إلى true، فإن الطلب يرجع crc64 للنطاق، طالما أن حجم النطاق أقل من أو يساوي 4 ميغابايت. إذا تم تحديد كل من x-ms-range-get-content-crc64 & x-ms-range-get-content-md5 في نفس الطلب، فسيفشل مع 400 (طلب غير صحيح).

contentCrc64?: Uint8Array

قيمة الخاصية

Uint8Array

contentDisposition

يقوم هذا العنوان بإرجاع القيمة التي تم تحديدها لعنوان "x-ms-blob-content-disposition". ينقل حقل عنوان استجابة ترتيب المحتوى معلومات إضافية حول كيفية معالجة حمولة الاستجابة، ويمكن أيضا استخدامه لإرفاق بيانات تعريف إضافية. على سبيل المثال، إذا تم تعيينه إلى مرفق، فإنه يشير إلى أنه يجب ألا يعرض عامل المستخدم الاستجابة، ولكن بدلا من ذلك يظهر مربع حوار حفظ باسم باسم ملف آخر غير اسم الكائن الثنائي كبير الحجم المحدد.

contentDisposition?: string

قيمة الخاصية

string

contentEncoding

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

contentEncoding?: string

قيمة الخاصية

string

contentLanguage

يقوم هذا العنوان بإرجاع القيمة التي تم تحديدها لعنوان طلب Content-Language.

contentLanguage?: string

قيمة الخاصية

string

contentLength

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

contentLength?: number

قيمة الخاصية

number

contentMD5

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

contentMD5?: Uint8Array

قيمة الخاصية

Uint8Array

contentRange

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

contentRange?: string

قيمة الخاصية

string

contentType

نوع وسائط نص الاستجابة. لتنزيل Blob هذا هو "application/octet-stream"

contentType?: string

قيمة الخاصية

string

copyCompletionTime

وقت الانتهاء من آخر محاولة لعملية نسخ Blob حيث كان هذا الكائن الثنائي كبير الحجم الوجهة. يمكن لهذه القيمة تحديد وقت محاولة النسخ المكتملة أو الفاشلة أو التي تم إجهاضها. لا يظهر هذا العنوان إذا كانت النسخة معلقة، أو إذا لم تكن هذه النقطة أبدا الوجهة في عملية Copy Blob، أو إذا تم تعديل هذا الكائن الثنائي كبير الحجم بعد عملية نسخ Blob منتهي باستخدام تعيين خصائص Blob أو Put Blob أو Put Block List.

copyCompletionTime?: Date

قيمة الخاصية

Date

copyId

معرف السلسلة لعملية النسخ هذه. استخدم مع Get Blob Properties للتحقق من حالة عملية النسخ هذه، أو قم بالتمرير إلى Abort Copy Blob لإجهاض نسخة معلقة.

copyId?: string

قيمة الخاصية

string

copyProgress

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

copyProgress?: string

قيمة الخاصية

string

copySource

URL يصل إلى 2 كيلوبايت في الطول الذي يحدد الكائن الثنائي كبير الحجم المصدر أو الملف المستخدم في آخر محاولة عملية نسخ Blob حيث كان هذا الكائن الثنائي كبير الحجم الوجهة. لا يظهر هذا العنوان إذا لم يكن هذا الكائن الثنائي كبير الحجم هو الوجهة في عملية Copy Blob، أو إذا تم تعديل هذا الكائن الثنائي كبير الحجم بعد عملية نسخ Blob منتهي باستخدام تعيين خصائص Blob أو Put Blob أو Put Block List.

copySource?: string

قيمة الخاصية

string

copyStatus

حالة عملية النسخ المحددة بواسطة x-ms-copy-id.

copyStatus?: CopyStatusType

قيمة الخاصية

CopyStatusType

copyStatusDescription

يظهر فقط عند فشل حالة x-ms-copy-status أو تعليقها. يصف سبب آخر فشل عملية نسخ فادح أو غير فادح. لا يظهر هذا العنوان إذا لم يكن هذا الكائن الثنائي كبير الحجم هو الوجهة في عملية Copy Blob، أو إذا تم تعديل هذا الكائن الثنائي كبير الحجم بعد عملية نسخ Blob مختتمة باستخدام تعيين خصائص Blob أو Put Blob أو Put Block List

copyStatusDescription?: string

قيمة الخاصية

string

date

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

date?: Date

قيمة الخاصية

Date

encryptionKeySha256

تجزئة SHA-256 لمفتاح التشفير المستخدم لتشفير الكائن الثنائي كبير الحجم. يتم إرجاع هذا العنوان فقط عند تشفير الكائن الثنائي كبير الحجم باستخدام مفتاح يوفره العميل.

encryptionKeySha256?: string

قيمة الخاصية

string

encryptionScope

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

encryptionScope?: string

قيمة الخاصية

string

errorCode

رمز الخطأ

errorCode?: string

قيمة الخاصية

string

etag

يحتوي ETag على قيمة يمكنك استخدامها لتنفيذ العمليات بشكل مشروط. إذا كان إصدار الطلب هو 2011-08-18 أو أحدث، ستكون قيمة ETag في علامات الاقتباس.

etag?: string

قيمة الخاصية

string

isServerEncrypted

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

isServerEncrypted?: boolean

قيمة الخاصية

boolean

lastModified

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

lastModified?: Date

قيمة الخاصية

Date

leaseDuration

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

leaseDuration?: LeaseDurationType

قيمة الخاصية

LeaseDurationType

leaseState

حالة التأجير للكائن الثنائي كبير الحجم.

leaseState?: LeaseStateType

قيمة الخاصية

LeaseStateType

leaseStatus

حالة التأجير الحالية للكائن الثنائي كبير الحجم.

leaseStatus?: LeaseStatusType

قيمة الخاصية

LeaseStatusType

metadata

metadata?: [key: string]: string

قيمة الخاصية

[key: string]: string

requestId

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

requestId?: string

قيمة الخاصية

string

version

يشير إلى إصدار خدمة Blob المستخدمة لتنفيذ الطلب. يتم إرجاع هذا العنوان للطلبات المقدمة مقابل الإصدار 2009-09-19 والإصدارات الأحدث.

version?: string

قيمة الخاصية

string