Bagikan melalui


BlobQueryHeaders interface

Menentukan header untuk operasi Blob_query.

Properti

acceptRanges

Menunjukkan bahwa layanan mendukung permintaan untuk konten blob parsial.

blobCommittedBlockCount

Jumlah blok yang diterapkan yang ada dalam blob. Header ini dikembalikan hanya untuk blob tambahan.

blobContentMD5

Jika blob memiliki hash MD5, dan jika permintaan berisi header rentang (Rentang atau rentang x-ms), header respons ini dikembalikan dengan nilai seluruh nilai MD5 blob. Nilai ini mungkin atau mungkin tidak sama dengan nilai yang dikembalikan di header Content-MD5, dengan yang terakhir dihitung dari rentang yang diminta

blobSequenceNumber

Nomor urut saat ini untuk blob halaman. Header ini tidak dikembalikan untuk blob blok atau blob penambahan

blobType

Jenis blob.

cacheControl

Header ini dikembalikan jika sebelumnya ditentukan untuk blob.

clientRequestId

Jika header id permintaan klien dikirim dalam permintaan, header ini akan ada dalam respons dengan nilai yang sama.

contentCrc64

Jika permintaannya adalah membaca rentang tertentu dan x-ms-range-get-content-crc64 diatur ke true, maka permintaan mengembalikan crc64 untuk rentang, selama ukuran rentang kurang dari atau sama dengan 4 MB. Jika x-ms-range-get-content-crc64 & x-ms-range-get-content-md5 ditentukan dalam permintaan yang sama, itu akan gagal dengan 400(Permintaan Buruk).

contentDisposition

Header ini mengembalikan nilai yang ditentukan untuk header 'x-ms-blob-content-disposition'. Bidang header respons Content-Disposition menyampaikan informasi tambahan tentang cara memproses payload respons, dan juga dapat digunakan untuk melampirkan metadata tambahan. Misalnya, jika diatur ke lampiran, itu menunjukkan bahwa agen pengguna tidak boleh menampilkan respons, tetapi sebaliknya menampilkan dialog Simpan Sebagai dengan nama file selain nama blob yang ditentukan.

contentEncoding

Header ini mengembalikan nilai yang ditentukan untuk header permintaan Pengodean Konten

contentLanguage

Header ini mengembalikan nilai yang ditentukan untuk header permintaan Content-Language.

contentLength

Jumlah byte yang ada dalam isi respons.

contentMD5

Jika blob memiliki hash MD5 dan operasi ini adalah membaca blob lengkap, header respons ini dikembalikan sehingga klien dapat memeriksa integritas konten pesan.

contentRange

Menunjukkan rentang byte yang dikembalikan jika klien meminta subset blob dengan mengatur header permintaan 'Rentang'.

contentType

Jenis media isi respons. Untuk Unduh Blob, ini adalah 'application/octet-stream'

copyCompletionTime

Waktu kesimpulan dari operasi Salin Blob terakhir yang dicoba di mana blob ini adalah blob tujuan. Nilai ini dapat menentukan waktu upaya penyalinan yang selesai, dibatalkan, atau gagal. Header ini tidak muncul jika salinan tertunda, jika blob ini belum pernah menjadi tujuan dalam operasi Salin Blob, atau jika blob ini telah dimodifikasi setelah operasi Salin Blob yang disimpulkan menggunakan Atur Properti Blob, Letakkan Blob, atau Letakkan Daftar Blok.

copyId

Pengidentifikasi string untuk operasi penyalinan ini. Gunakan dengan Dapatkan Properti Blob untuk memeriksa status operasi salin ini, atau teruskan ke Batalkan Salin Blob untuk membatalkan salinan yang tertunda.

copyProgress

Berisi jumlah byte yang disalin dan total byte dalam sumber dalam operasi Salin Blob terakhir yang dicoba di mana blob ini adalah blob tujuan. Dapat memperlihatkan antara 0 dan byte Panjang Konten yang disalin. Header ini tidak muncul jika blob ini belum pernah menjadi tujuan dalam operasi Salin Blob, atau jika blob ini telah dimodifikasi setelah operasi Salin Blob yang disimpulkan menggunakan Atur Properti Blob, Letakkan Blob, atau Letakkan Daftar Blok

copySource

URL hingga 2 KB panjangnya yang menentukan blob sumber atau file yang digunakan dalam operasi Salin Blob terakhir yang dicoba di mana blob ini adalah blob tujuan. Header ini tidak muncul jika blob ini belum pernah menjadi tujuan dalam operasi Salin Blob, atau jika blob ini telah dimodifikasi setelah operasi Salin Blob yang disimpulkan menggunakan Set Blob Properties, Put Blob, atau Put Block List.

copyStatus

Status operasi salin yang diidentifikasi oleh x-ms-copy-id.

copyStatusDescription

Hanya muncul ketika x-ms-copy-status gagal atau tertunda. Menjelaskan penyebab kegagalan operasi penyalinan terakhir yang fatal atau tidak fatal. Header ini tidak muncul jika blob ini belum pernah menjadi tujuan dalam operasi Salin Blob, atau jika blob ini telah dimodifikasi setelah operasi Salin Blob yang disimpulkan menggunakan Atur Properti Blob, Letakkan Blob, atau Letakkan Daftar Blok

date

Nilai tanggal/waktu UTC yang dihasilkan oleh layanan yang menunjukkan waktu di mana respons dimulai

encryptionKeySha256

Hash SHA-256 dari kunci enkripsi yang digunakan untuk mengenkripsi blob. Header ini hanya dikembalikan ketika blob dienkripsi dengan kunci yang disediakan pelanggan.

encryptionScope

Mengembalikan nama cakupan enkripsi yang digunakan untuk mengenkripsi konten blob dan metadata aplikasi. Perhatikan bahwa tidak adanya header ini menyiratkan penggunaan cakupan enkripsi akun default.

errorCode

Kode Kesalahan

etag

ETag berisi nilai yang dapat Anda gunakan untuk melakukan operasi secara kondisional. Jika versi permintaan adalah 2011-08-18 atau yang lebih baru, nilai ETag akan berada dalam tanda kutip.

isServerEncrypted

Nilai header ini diatur ke true jika data blob dan metadata aplikasi sepenuhnya dienkripsi menggunakan algoritma yang ditentukan. Jika tidak, nilai diatur ke false (ketika blob tidak terenkripsi, atau jika hanya bagian dari metadata blob/aplikasi yang dienkripsi).

lastModified

Mengembalikan tanggal dan waktu kontainer terakhir diubah. Setiap operasi yang memodifikasi blob, termasuk pembaruan metadata atau properti blob, mengubah waktu blob yang terakhir dimodifikasi.

leaseDuration

Ketika blob disewakan, menentukan apakah sewa tidak terbatas atau durasi tetap.

leaseState

Status sewa blob.

leaseStatus

Status sewa blob saat ini.

metadata
requestId

Header ini secara unik mengidentifikasi permintaan yang dibuat dan dapat digunakan untuk memecahkan masalah permintaan.

version

Menunjukkan versi layanan Blob yang digunakan untuk menjalankan permintaan. Header ini dikembalikan untuk permintaan yang dibuat terhadap versi 2009-09-19 ke atas.

Detail Properti

acceptRanges

Menunjukkan bahwa layanan mendukung permintaan untuk konten blob parsial.

acceptRanges?: string

Nilai Properti

string

blobCommittedBlockCount

Jumlah blok yang diterapkan yang ada dalam blob. Header ini dikembalikan hanya untuk blob tambahan.

blobCommittedBlockCount?: number

Nilai Properti

number

blobContentMD5

Jika blob memiliki hash MD5, dan jika permintaan berisi header rentang (Rentang atau rentang x-ms), header respons ini dikembalikan dengan nilai seluruh nilai MD5 blob. Nilai ini mungkin atau mungkin tidak sama dengan nilai yang dikembalikan di header Content-MD5, dengan yang terakhir dihitung dari rentang yang diminta

blobContentMD5?: Uint8Array

Nilai Properti

Uint8Array

blobSequenceNumber

Nomor urut saat ini untuk blob halaman. Header ini tidak dikembalikan untuk blob blok atau blob penambahan

blobSequenceNumber?: number

Nilai Properti

number

blobType

Jenis blob.

blobType?: BlobType

Nilai Properti

cacheControl

Header ini dikembalikan jika sebelumnya ditentukan untuk blob.

cacheControl?: string

Nilai Properti

string

clientRequestId

Jika header id permintaan klien dikirim dalam permintaan, header ini akan ada dalam respons dengan nilai yang sama.

clientRequestId?: string

Nilai Properti

string

contentCrc64

Jika permintaannya adalah membaca rentang tertentu dan x-ms-range-get-content-crc64 diatur ke true, maka permintaan mengembalikan crc64 untuk rentang, selama ukuran rentang kurang dari atau sama dengan 4 MB. Jika x-ms-range-get-content-crc64 & x-ms-range-get-content-md5 ditentukan dalam permintaan yang sama, itu akan gagal dengan 400(Permintaan Buruk).

contentCrc64?: Uint8Array

Nilai Properti

Uint8Array

contentDisposition

Header ini mengembalikan nilai yang ditentukan untuk header 'x-ms-blob-content-disposition'. Bidang header respons Content-Disposition menyampaikan informasi tambahan tentang cara memproses payload respons, dan juga dapat digunakan untuk melampirkan metadata tambahan. Misalnya, jika diatur ke lampiran, itu menunjukkan bahwa agen pengguna tidak boleh menampilkan respons, tetapi sebaliknya menampilkan dialog Simpan Sebagai dengan nama file selain nama blob yang ditentukan.

contentDisposition?: string

Nilai Properti

string

contentEncoding

Header ini mengembalikan nilai yang ditentukan untuk header permintaan Pengodean Konten

contentEncoding?: string

Nilai Properti

string

contentLanguage

Header ini mengembalikan nilai yang ditentukan untuk header permintaan Content-Language.

contentLanguage?: string

Nilai Properti

string

contentLength

Jumlah byte yang ada dalam isi respons.

contentLength?: number

Nilai Properti

number

contentMD5

Jika blob memiliki hash MD5 dan operasi ini adalah membaca blob lengkap, header respons ini dikembalikan sehingga klien dapat memeriksa integritas konten pesan.

contentMD5?: Uint8Array

Nilai Properti

Uint8Array

contentRange

Menunjukkan rentang byte yang dikembalikan jika klien meminta subset blob dengan mengatur header permintaan 'Rentang'.

contentRange?: string

Nilai Properti

string

contentType

Jenis media isi respons. Untuk Unduh Blob, ini adalah 'application/octet-stream'

contentType?: string

Nilai Properti

string

copyCompletionTime

Waktu kesimpulan dari operasi Salin Blob terakhir yang dicoba di mana blob ini adalah blob tujuan. Nilai ini dapat menentukan waktu upaya penyalinan yang selesai, dibatalkan, atau gagal. Header ini tidak muncul jika salinan tertunda, jika blob ini belum pernah menjadi tujuan dalam operasi Salin Blob, atau jika blob ini telah dimodifikasi setelah operasi Salin Blob yang disimpulkan menggunakan Atur Properti Blob, Letakkan Blob, atau Letakkan Daftar Blok.

copyCompletionTime?: Date

Nilai Properti

Date

copyId

Pengidentifikasi string untuk operasi penyalinan ini. Gunakan dengan Dapatkan Properti Blob untuk memeriksa status operasi salin ini, atau teruskan ke Batalkan Salin Blob untuk membatalkan salinan yang tertunda.

copyId?: string

Nilai Properti

string

copyProgress

Berisi jumlah byte yang disalin dan total byte dalam sumber dalam operasi Salin Blob terakhir yang dicoba di mana blob ini adalah blob tujuan. Dapat memperlihatkan antara 0 dan byte Panjang Konten yang disalin. Header ini tidak muncul jika blob ini belum pernah menjadi tujuan dalam operasi Salin Blob, atau jika blob ini telah dimodifikasi setelah operasi Salin Blob yang disimpulkan menggunakan Atur Properti Blob, Letakkan Blob, atau Letakkan Daftar Blok

copyProgress?: string

Nilai Properti

string

copySource

URL hingga 2 KB panjangnya yang menentukan blob sumber atau file yang digunakan dalam operasi Salin Blob terakhir yang dicoba di mana blob ini adalah blob tujuan. Header ini tidak muncul jika blob ini belum pernah menjadi tujuan dalam operasi Salin Blob, atau jika blob ini telah dimodifikasi setelah operasi Salin Blob yang disimpulkan menggunakan Set Blob Properties, Put Blob, atau Put Block List.

copySource?: string

Nilai Properti

string

copyStatus

Status operasi salin yang diidentifikasi oleh x-ms-copy-id.

copyStatus?: CopyStatusType

Nilai Properti

copyStatusDescription

Hanya muncul ketika x-ms-copy-status gagal atau tertunda. Menjelaskan penyebab kegagalan operasi penyalinan terakhir yang fatal atau tidak fatal. Header ini tidak muncul jika blob ini belum pernah menjadi tujuan dalam operasi Salin Blob, atau jika blob ini telah dimodifikasi setelah operasi Salin Blob yang disimpulkan menggunakan Atur Properti Blob, Letakkan Blob, atau Letakkan Daftar Blok

copyStatusDescription?: string

Nilai Properti

string

date

Nilai tanggal/waktu UTC yang dihasilkan oleh layanan yang menunjukkan waktu di mana respons dimulai

date?: Date

Nilai Properti

Date

encryptionKeySha256

Hash SHA-256 dari kunci enkripsi yang digunakan untuk mengenkripsi blob. Header ini hanya dikembalikan ketika blob dienkripsi dengan kunci yang disediakan pelanggan.

encryptionKeySha256?: string

Nilai Properti

string

encryptionScope

Mengembalikan nama cakupan enkripsi yang digunakan untuk mengenkripsi konten blob dan metadata aplikasi. Perhatikan bahwa tidak adanya header ini menyiratkan penggunaan cakupan enkripsi akun default.

encryptionScope?: string

Nilai Properti

string

errorCode

Kode Kesalahan

errorCode?: string

Nilai Properti

string

etag

ETag berisi nilai yang dapat Anda gunakan untuk melakukan operasi secara kondisional. Jika versi permintaan adalah 2011-08-18 atau yang lebih baru, nilai ETag akan berada dalam tanda kutip.

etag?: string

Nilai Properti

string

isServerEncrypted

Nilai header ini diatur ke true jika data blob dan metadata aplikasi sepenuhnya dienkripsi menggunakan algoritma yang ditentukan. Jika tidak, nilai diatur ke false (ketika blob tidak terenkripsi, atau jika hanya bagian dari metadata blob/aplikasi yang dienkripsi).

isServerEncrypted?: boolean

Nilai Properti

boolean

lastModified

Mengembalikan tanggal dan waktu kontainer terakhir diubah. Setiap operasi yang memodifikasi blob, termasuk pembaruan metadata atau properti blob, mengubah waktu blob yang terakhir dimodifikasi.

lastModified?: Date

Nilai Properti

Date

leaseDuration

Ketika blob disewakan, menentukan apakah sewa tidak terbatas atau durasi tetap.

leaseDuration?: LeaseDurationType

Nilai Properti

leaseState

Status sewa blob.

leaseState?: LeaseStateType

Nilai Properti

leaseStatus

Status sewa blob saat ini.

leaseStatus?: LeaseStatusType

Nilai Properti

metadata

metadata?: [key: string]: string

Nilai Properti

[key: string]: string

requestId

Header ini secara unik mengidentifikasi permintaan yang dibuat dan dapat digunakan untuk memecahkan masalah permintaan.

requestId?: string

Nilai Properti

string

version

Menunjukkan versi layanan Blob yang digunakan untuk menjalankan permintaan. Header ini dikembalikan untuk permintaan yang dibuat terhadap versi 2009-09-19 ke atas.

version?: string

Nilai Properti

string