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	نوع الوسائط لنص الاستجابة. لتنزيل كائن ثنائي كبير الحجم هذا هو "application/octet-stream"
copyCompletionTime	وقت الاستنتاج لآخر محاولة لعملية نسخ كائن ثنائي كبير الحجم حيث كان هذا الكائن الثنائي كبير الحجم الوجهة. يمكن لهذه القيمة تحديد وقت محاولة النسخ المكتملة أو التي تم إجهاضها أو فشلها. لا يظهر هذا العنوان إذا كانت النسخة معلقة، إذا لم تكن هذه النقطة أبدا الوجهة في عملية نسخ كائن ثنائي كبير الحجم، أو إذا تم تعديل هذا الكائن الثنائي كبير الحجم بعد عملية نسخ كائن ثنائي كبير الحجم منتهي باستخدام تعيين خصائص كائن ثنائي كبير الحجم أو وضع كائن ثنائي كبير الحجم أو وضع قائمة حظر.
copyId	معرف السلسلة لعملية النسخ هذه. استخدم مع Get Blob Properties للتحقق من حالة عملية النسخ هذه، أو قم بالتمرير إلى Abort Copy Blob لإجهاض نسخة معلقة.
copyProgress	يحتوي على عدد وحدات البايت المنسوخة وإجمالي وحدات البايت في المصدر في آخر محاولة لعملية نسخ كائن ثنائي كبير الحجم حيث كان هذا الكائن الثنائي كبير الحجم الوجهة. يمكن أن يظهر بين 0 وبايت طول المحتوى المنسخ. لا يظهر هذا العنوان إذا لم يكن هذا الكائن الثنائي كبير الحجم أبدا الوجهة في عملية نسخ كائن ثنائي كبير الحجم، أو إذا تم تعديل هذا الكائن الثنائي كبير الحجم بعد عملية نسخ كائن ثنائي كبير الحجم منتهي باستخدام تعيين خصائص كائن ثنائي كبير الحجم أو وضع كائن ثنائي كبير الحجم أو وضع قائمة حظر
copySource	عنوان URL يصل إلى 2 كيلوبايت في الطول الذي يحدد الكائن الثنائي كبير الحجم المصدر أو الملف المستخدم في آخر محاولة لعملية نسخ كائن ثنائي كبير الحجم حيث كان هذا الكائن الثنائي كبير الحجم الوجهة. لا يظهر هذا العنوان إذا لم يكن هذا الكائن الثنائي كبير الحجم أبدا الوجهة في عملية نسخ كائن ثنائي كبير الحجم، أو إذا تم تعديل هذا الكائن الثنائي كبير الحجم بعد عملية نسخ كائن ثنائي كبير الحجم منتهي باستخدام تعيين خصائص كائن ثنائي كبير الحجم أو وضع كائن ثنائي كبير الحجم أو وضع قائمة حظر.
copyStatus	حالة عملية النسخ المحددة بواسطة x-ms-copy-id.
copyStatusDescription	يظهر فقط عند فشل حالة x-ms-copy-status أو تعليقها. يصف سبب آخر فشل فادح أو غير فادح في عملية النسخ. لا يظهر هذا العنوان إذا لم يكن هذا الكائن الثنائي كبير الحجم أبدا الوجهة في عملية نسخ كائن ثنائي كبير الحجم، أو إذا تم تعديل هذا الكائن الثنائي كبير الحجم بعد عملية نسخ كائن ثنائي كبير الحجم منتهي باستخدام تعيين خصائص كائن ثنائي كبير الحجم أو وضع كائن ثنائي كبير الحجم أو وضع قائمة حظر
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

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

contentType?: string

قيمة الخاصية

string

copyCompletionTime

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

copyCompletionTime?: Date

قيمة الخاصية

Date

copyId

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

copyId?: string

قيمة الخاصية

string

copyProgress

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

copyProgress?: string

قيمة الخاصية

string

copySource

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

copySource?: string

قيمة الخاصية

string

copyStatus

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

copyStatus?: CopyStatusType

قيمة الخاصية

CopyStatusType

copyStatusDescription

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

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