Bagikan melalui

BlobGetPropertiesHeaders interface

  • Referensi
Paket:
@azure/storage-blob

Menentukan header untuk operasi Blob_getProperties.

Properti

acceptRanges

Menunjukkan bahwa layanan mendukung permintaan untuk konten blob parsial.
accessTier

Tingkat blob halaman pada akun penyimpanan premium atau tingkat blob blok pada akun LRS penyimpanan blob. Untuk daftar tingkat blob halaman premium yang diizinkan, lihat https://docs.microsoft.com/en-us/azure/virtual-machines/windows/premium-storage#features. Untuk akun LRS penyimpanan blob, nilai yang valid adalah Hot/Cool/Archive.
accessTierChangedOn

Waktu tingkat diubah pada objek. Ini hanya dikembalikan jika tingkat pada blob blok pernah ditetapkan.
accessTierInferred

Untuk blob halaman pada akun penyimpanan premium saja. Jika tingkat akses tidak diatur secara eksplisit pada blob, tingkatan disimpulkan berdasarkan panjang kontennya dan header ini akan dikembalikan dengan nilai true.
archiveStatus

Untuk akun LRS penyimpanan blob, nilai yang valid adalah rehydrate-pending-to-hot/rehydrate-pending-to-cool. Jika blob sedang direhidrasi dan tidak selesai maka header ini dikembalikan yang menunjukkan bahwa rehidrasi tertunda dan juga memberi tahu tingkat tujuan.
blobCommittedBlockCount

Jumlah blok yang diterapkan yang ada dalam blob. Header ini hanya dikembalikan untuk blob tambahan.
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.
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

Ukuran blob dalam byte. Untuk blob halaman, header ini mengembalikan nilai header x-ms-blob-content-length yang disimpan dengan blob.
contentMD5

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

Tipe konten yang ditentukan untuk blob. Jenis konten default 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
createdOn

Mengembalikan tanggal dan waktu blob dibuat.
date

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

Disertakan jika blob adalah blob salinan inkremental atau salinan bayangan bertahap, jika x-ms-copy-status berhasil. Waktu rekam jepret salinan inkremental terakhir yang berhasil untuk blob ini.
encryptionKeySha256

Hash SHA-256 dari kunci enkripsi yang digunakan untuk mengenkripsi metadata. Header ini hanya dikembalikan ketika metadata 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.
expiresOn

Waktu blob ini akan kedaluwarsa.
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.
isIncrementalCopy

Disertakan jika blob adalah blob salinan inkremental.
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 blob 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
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).
rehydratePriority

Jika objek dalam status tertunda rehidrasi, header ini dikembalikan dengan prioritas rehidrasi.
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 blob service 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

accessTier

Tingkat blob halaman pada akun penyimpanan premium atau tingkat blob blok pada akun LRS penyimpanan blob. Untuk daftar tingkat blob halaman premium yang diizinkan, lihat https://docs.microsoft.com/en-us/azure/virtual-machines/windows/premium-storage#features. Untuk akun LRS penyimpanan blob, nilai yang valid adalah Hot/Cool/Archive.

accessTier?: string

Nilai Properti

string

accessTierChangedOn

Waktu tingkat diubah pada objek. Ini hanya dikembalikan jika tingkat pada blob blok pernah ditetapkan.

accessTierChangedOn?: Date

Nilai Properti

Date

accessTierInferred

Untuk blob halaman pada akun penyimpanan premium saja. Jika tingkat akses tidak diatur secara eksplisit pada blob, tingkatan disimpulkan berdasarkan panjang kontennya dan header ini akan dikembalikan dengan nilai true.

accessTierInferred?: boolean

Nilai Properti

boolean

archiveStatus

Untuk akun LRS penyimpanan blob, nilai yang valid adalah rehydrate-pending-to-hot/rehydrate-pending-to-cool. Jika blob sedang direhidrasi dan tidak selesai maka header ini dikembalikan yang menunjukkan bahwa rehidrasi tertunda dan juga memberi tahu tingkat tujuan.

archiveStatus?: string

Nilai Properti

string

blobCommittedBlockCount

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

blobCommittedBlockCount?: number

Nilai Properti

number

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

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

Ukuran blob dalam byte. Untuk blob halaman, header ini mengembalikan nilai header x-ms-blob-content-length yang disimpan dengan blob.

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

contentType

Tipe konten yang ditentukan untuk blob. Jenis konten default 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

createdOn

Mengembalikan tanggal dan waktu blob dibuat.

createdOn?: Date

Nilai Properti

Date

date

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

date?: Date

Nilai Properti

Date

destinationSnapshot

Disertakan jika blob adalah blob salinan inkremental atau salinan bayangan bertahap, jika x-ms-copy-status berhasil. Waktu rekam jepret salinan inkremental terakhir yang berhasil untuk blob ini.

destinationSnapshot?: string

Nilai Properti

string

encryptionKeySha256

Hash SHA-256 dari kunci enkripsi yang digunakan untuk mengenkripsi metadata. Header ini hanya dikembalikan ketika metadata 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

expiresOn

Waktu blob ini akan kedaluwarsa.

expiresOn?: Date

Nilai Properti

Date

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

isIncrementalCopy

Disertakan jika blob adalah blob salinan inkremental.

isIncrementalCopy?: 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 blob 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?: {[propertyName: string]: string}

Nilai Properti

{[propertyName: string]: 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?: {[propertyName: string]: string}

Nilai Properti

{[propertyName: string]: string}

rehydratePriority

Jika objek dalam status tertunda rehidrasi, header ini dikembalikan dengan prioritas rehidrasi.

rehydratePriority?: RehydratePriority

Nilai Properti

RehydratePriority

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 blob service 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