Bagikan melalui

BlobDownloadResponseParsed interface

  • Referensi
Paket:
@azure/storage-blob

Berisi data respons untuk operasi.<xref:BlobClient.download>

Extends

BlobDownloadHeaders & Object

Properti

acceptRanges

Menunjukkan bahwa layanan mendukung permintaan untuk konten blob parsial.
blobBody

BROWSER HANYA Isi respons sebagai Blob browser. Selalu undefined dalam node.js.
blobCommittedBlockCount

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

Jika blob memiliki hash MD5, dan jika permintaan berisi header rentang (Rentang atau x-ms-range), 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'
copyCompletedOn

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 Blokir.
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 Set Blob Properties, Put Blob, atau Put Block List
copySource

PANJANG URL hingga 2 KB 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 fatal atau non-fatal terakhir. 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
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.
immutabilityPolicyExpiresOn

Nilai tanggal/waktu UTC yang dihasilkan oleh layanan yang menunjukkan waktu di mana kebijakan kekekalan blob akan kedaluwarsa.
immutabilityPolicyMode

Menunjukkan mode kebijakan imutabilitas.
isCurrentVersion

Nilai header ini menunjukkan apakah versi blob ini adalah versi saat ini, lihat juga header x-ms-version-id.
isSealed

Jika blob ini telah disegel
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).
lastAccessed

Nilai tanggal/waktu UTC yang dihasilkan oleh layanan yang menunjukkan waktu saat blob terakhir dibaca atau ditulis
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 memiliki durasi tak terbatas atau tetap.
leaseState

Status sewa blob.
leaseStatus

Status sewa blob saat ini.
legalHold

Menunjukkan apakah penahanan legal ada pada blob.
metadata
objectReplicationDestinationPolicyId

Id Kebijakan Replikasi Objek dari blob tujuan.
objectReplicationPolicyId

Pilihan. Hanya valid ketika Replikasi Objek diaktifkan untuk kontainer penyimpanan dan pada blob tujuan replikasi.
objectReplicationRules

Pilihan. Hanya valid ketika Replikasi Objek diaktifkan untuk kontainer penyimpanan dan pada blob sumber replikasi. Saat mengambil header ini, header akan mengembalikan header dengan id kebijakan dan id aturan (misalnya x-ms-or-policyid_ruleid), dan nilainya akan menjadi status replikasi (misalnya selesai, gagal).
objectReplicationSourceProperties

Id Kebijakan Replikasi Objek Terurai, Id Aturan, dan status blob sumber.
readableStreamBody

NODEJS HANYA Isi respons sebagai aliran node.js Dapat Dibaca. Selalu undefined di browser.
requestId

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

Jumlah tag yang terkait dengan blob
version

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

Nilai DateTime yang dikembalikan oleh layanan yang secara unik mengidentifikasi blob. Nilai header ini menunjukkan versi blob, dan dapat digunakan dalam permintaan berikutnya untuk mengakses versi blob ini.

Detail Properti

acceptRanges

Menunjukkan bahwa layanan mendukung permintaan untuk konten blob parsial.

acceptRanges?: string

Nilai Properti

string

blobBody

BROWSER HANYA Isi respons sebagai Blob browser. Selalu undefined dalam node.js.

blobBody?: Promise<Blob>

Nilai Properti

Promise<Blob>

blobCommittedBlockCount

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

blobCommittedBlockCount?: number

Nilai Properti

number

blobContentMD5

Jika blob memiliki hash MD5, dan jika permintaan berisi header rentang (Rentang atau x-ms-range), 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

BlobType

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

copyCompletedOn

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 Blokir.

copyCompletedOn?: 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 Set Blob Properties, Put Blob, atau Put Block List

copyProgress?: string

Nilai Properti

string

copySource

PANJANG URL hingga 2 KB 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

CopyStatusType

copyStatusDescription

Hanya muncul ketika x-ms-copy-status gagal atau tertunda. Menjelaskan penyebab kegagalan operasi penyalinan fatal atau non-fatal terakhir. 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

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

immutabilityPolicyExpiresOn

Nilai tanggal/waktu UTC yang dihasilkan oleh layanan yang menunjukkan waktu di mana kebijakan kekekalan blob akan kedaluwarsa.

immutabilityPolicyExpiresOn?: Date

Nilai Properti

Date

immutabilityPolicyMode

Menunjukkan mode kebijakan imutabilitas.

immutabilityPolicyMode?: BlobImmutabilityPolicyMode

Nilai Properti

BlobImmutabilityPolicyMode

isCurrentVersion

Nilai header ini menunjukkan apakah versi blob ini adalah versi saat ini, lihat juga header x-ms-version-id.

isCurrentVersion?: boolean

Nilai Properti

boolean

isSealed

Jika blob ini telah disegel

isSealed?: boolean

Nilai Properti

boolean

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

lastAccessed

Nilai tanggal/waktu UTC yang dihasilkan oleh layanan yang menunjukkan waktu saat blob terakhir dibaca atau ditulis

lastAccessed?: Date

Nilai Properti

Date

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 memiliki durasi tak terbatas atau tetap.

leaseDuration?: LeaseDurationType

Nilai Properti

LeaseDurationType

leaseState

Status sewa blob.

leaseState?: LeaseStateType

Nilai Properti

LeaseStateType

leaseStatus

Status sewa blob saat ini.

leaseStatus?: LeaseStatusType

Nilai Properti

LeaseStatusType

legalHold

Menunjukkan apakah penahanan legal ada pada blob.

legalHold?: boolean

Nilai Properti

boolean

metadata 

metadata?: [key: string]: string

Nilai Properti

[key: string]: string

objectReplicationDestinationPolicyId

Id Kebijakan Replikasi Objek dari blob tujuan.

objectReplicationDestinationPolicyId?: string

Nilai Properti

string

objectReplicationPolicyId

Pilihan. Hanya valid ketika Replikasi Objek diaktifkan untuk kontainer penyimpanan dan pada blob tujuan replikasi.

objectReplicationPolicyId?: string

Nilai Properti

string

objectReplicationRules

Pilihan. Hanya valid ketika Replikasi Objek diaktifkan untuk kontainer penyimpanan dan pada blob sumber replikasi. Saat mengambil header ini, header akan mengembalikan header dengan id kebijakan dan id aturan (misalnya x-ms-or-policyid_ruleid), dan nilainya akan menjadi status replikasi (misalnya selesai, gagal).

objectReplicationRules?: [key: string]: string

Nilai Properti

[key: string]: string

objectReplicationSourceProperties

Id Kebijakan Replikasi Objek Terurai, Id Aturan, dan status blob sumber.

objectReplicationSourceProperties?: ObjectReplicationPolicy[]

Nilai Properti

ObjectReplicationPolicy[]

readableStreamBody

NODEJS HANYA Isi respons sebagai aliran node.js Dapat Dibaca. Selalu undefined di browser.

readableStreamBody?: ReadableStream

Nilai Properti

ReadableStream

requestId

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

requestId?: string

Nilai Properti

string

tagCount

Jumlah tag yang terkait dengan blob

tagCount?: number

Nilai Properti

number

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

versionId

Nilai DateTime yang dikembalikan oleh layanan yang secara unik mengidentifikasi blob. Nilai header ini menunjukkan versi blob, dan dapat digunakan dalam permintaan berikutnya untuk mengakses versi blob ini.

versionId?: string

Nilai Properti

string