BlobGetPropertiesHeaders interface

套件:

@azure/storage-blob

定義Blob_getProperties作業的標頭。

屬性

acceptRanges	表示服務支援部分 Blob 內容的要求。
accessTier	進階儲存體帳戶上的分頁 Blob 層，或 Blob 儲存體 LRS 帳戶上的區塊 Blob 層。 如需允許的進階分頁 Blob 層清單，請參閱 https://docs.microsoft.com/en-us/azure/virtual-machines/windows/premium-storage#features 。 對於 Blob 儲存體 LRS 帳戶，有效值為經常性/非經常性存取/封存。
accessTierChangedOn	物件上變更階層的時間。 只有在已設定區塊 Blob 上的層時，才會傳回這個值。
accessTierInferred	僅適用于進階儲存體帳戶上的分頁 Blob。 如果未在 Blob 上明確設定存取層，則會根據其內容長度推斷層，而且此標頭會以 true 值傳回。
archiveStatus	對於 Blob 儲存體 LRS 帳戶，有效值為 rehydrate-pending-to-hot/rehydrate-pending-to-cool。 如果 Blob 正在解除凍結且未完成，則會傳回此標頭，指出解除凍結為擱置中，也會告知目的地層。
blobCommittedBlockCount	Blob 中存在已認可的區塊數目。 此標頭只會針對附加 Blob 傳回。
blobSequenceNumber	分頁 Blob 目前的序號。 區塊 Blob 或附加 Blob 不會傳回此標頭
blobType	Blob 的類型。
cacheControl	如果之前已指定 Blob，則會傳回此標頭。
clientRequestId	如果在要求中傳送用戶端要求識別碼標頭，此標頭將會出現在具有相同值的回應中。
contentDisposition	此標頭會傳回為 'x-ms-blob-content-disposition' 標頭指定的值。 Content-Disposition 回應標頭欄位會傳達如何處理回應承載的其他資訊，也可用來附加其他中繼資料。 例如，如果設定為附件，則表示使用者代理程式不應該顯示回應，而是顯示具有指定之 Blob 名稱以外的檔案名的 [另存新檔] 對話方塊。
contentEncoding	此標頭會傳回為 Content-Encoding 要求標頭指定的值
contentLanguage	此標頭會傳回為 Content-Language 要求標頭指定的值。
contentLength	Blob 大小 (以位元組為單位)。 對於分頁 Blob，此標頭會傳回以 Blob 儲存的 x-ms-blob-content-length 標頭值。
contentMD5	如果 Blob 具有 MD5 雜湊，而此作業是讀取完整 Blob，則會傳回此回應標頭，讓用戶端可以檢查訊息內容完整性。
contentType	為 blob 指定內容類型。 預設內容類型為 'application/octet-stream'
copyCompletedOn	上次嘗試複製 Blob 作業的結束時間，其中此 Blob 是目的地 Blob。 此值可指定完成、中止或複製嘗試失敗的時間。 如果複製擱置中，如果此 Blob 從未成為複製 Blob 作業中的目的地，或是此 Blob 在結束的複製 Blob 作業之後使用 [設定 Blob 屬性]、[放置 Blob] 或 [放置區塊清單] 進行修改，則不會顯示此標頭。
copyId	此複製作業的字串識別碼。 使用 取得 Blob 屬性來檢查此複製作業的狀態，或傳遞至中止複製 Blob 以中止暫止的複本。
copyProgress	包含上次嘗試的複製 Blob 作業中，複製的位元組數目和來源中的位元組總數，其中此 Blob 是目的地 Blob。 可以顯示覆制的介於 0 和 Content-Length 位元組之間。 如果此 Blob 從未成為複製 Blob 作業中的目的地，或是此 Blob 在結束的複製 Blob 作業之後使用 [設定 Blob 屬性]、[放置 Blob] 或 [放置區塊清單] 修改此 Blob 作業之後，就不會顯示此標頭
copySource	長度上限為 2 KB 的 URL，指定上次嘗試複製 Blob 作業所使用的來源 Blob 或檔案，其中此 Blob 是目的地 Blob。 如果此 Blob 從未成為複製 Blob 作業中的目的地，或是此 Blob 在結束的複製 Blob 作業之後使用 [設定 Blob 屬性]、[放置 Blob] 或 [放置區塊清單] 修改此 Blob 作業之後，就不會顯示此標頭。
copyStatus	x-ms-copy-id 所識別的複製作業狀態。
copyStatusDescription	只有在 x-ms-copy-status 失敗或擱置時才會出現。 針對上次嚴重或不嚴重複製的作業，描述其失敗的原因。 如果此 Blob 從未成為複製 Blob 作業中的目的地，或是此 Blob 在結束複製 Blob 作業之後使用 [設定 Blob 屬性]、[放置 Blob] 或 [放置區塊清單] 修改此 Blob 作業之後，就不會顯示此標頭
createdOn	傳回 Blob 建立的日期和時間。
date	服務所產生的 UTC 日期/時間值，指出起始回應的時間
destinationSnapshot	如果 Blob 為累加複製 Blob 或累加複製快照集，則為包含，如果 x-ms-copy-status 為成功。 此 Blob 上次成功增量複製快照集的快照集時間。
encryptionKeySha256	用來加密中繼資料之加密金鑰的 SHA-256 雜湊。 只有當中繼資料使用客戶提供的金鑰加密時，才會傳回此標頭。
encryptionScope	傳回用來加密 Blob 內容和應用程式中繼資料的加密範圍名稱。 請注意，缺少此標頭表示使用預設帳戶加密範圍。
errorCode	錯誤碼
etag	ETag 包含的值可讓您依條件執行作業。 如果要求版本為 2011-08-18 或更新版本，ETag 值會加上引號。
expiresOn	此 Blob 到期的時間。
immutabilityPolicyExpiresOn	服務所產生的 UTC 日期/時間值，指出 Blob 不變性原則到期的時間。
immutabilityPolicyMode	表示不變性原則模式。
isCurrentVersion	此標頭的值表示此 Blob 的版本是否為目前版本，另請參閱 x-ms-version-id 標頭。
isIncrementalCopy	如果 Blob 是累加複製 Blob，則包含此 Blob。
isSealed	如果此 Blob 已密封
isServerEncrypted	如果 Blob 資料和應用程式中繼資料使用指定的演算法完全加密，此標頭的值會設定為 true。 否則，當 Blob 未加密時，此值會設定為 false (，或者，如果只有 blob/應用程式中繼資料的部分會加密) 。
lastAccessed	服務所產生的 UTC 日期/時間值，指出 Blob 上次讀取或寫入的時間
lastModified	傳回 Blob 上次修改的日期和時間。 修改 Blob 的任何作業 (包括 Blob 更新的中繼資料或屬性)，都會變更 Blob 上次修改的時間。
leaseDuration	租用 Blob 時，指定租用期為無限或固定時間。
leaseState	Blob 的租用狀態。
leaseStatus	Blob 的目前租用狀態。
legalHold	指出 Blob 上是否有合法保留。
metadata
objectReplicationPolicyId	選擇性。 只有在針對儲存體容器和複寫的目的地 Blob 啟用物件複寫時，才有效。
objectReplicationRules	選擇性。 只有在針對儲存體容器和複寫的來源 Blob 啟用物件複寫時，才有效。 擷取此標頭時，它會傳回具有原則識別碼和規則識別碼的標頭 (，例如 x-ms-or-policyid_ruleid) ，而值會是複寫 (的狀態，例如完成、失敗) 。
rehydratePriority	如果物件處於解除凍結擱置狀態，則會以解除凍結的優先順序傳回此標頭。
requestId	此標頭可唯一識別提出的要求，而且可用來進行要求的疑難排解。
tagCount	與 Blob 相關聯的標記數目
version	指出用於執行要求的 Blob 服務版本。 對 2009-09-19 (含) 以上版本提出要求會傳回此標頭。
versionId	服務所傳回的 DateTime 值，可唯一識別 Blob。 此標頭的值表示 Blob 版本，而且可用於後續要求來存取此版本的 Blob。

屬性詳細資料

acceptRanges

表示服務支援部分 Blob 內容的要求。

acceptRanges?: string

屬性值

string

accessTier

進階儲存體帳戶上的分頁 Blob 層，或 Blob 儲存體 LRS 帳戶上的區塊 Blob 層。 如需允許的進階分頁 Blob 層清單，請參閱 https://docs.microsoft.com/en-us/azure/virtual-machines/windows/premium-storage#features 。 對於 Blob 儲存體 LRS 帳戶，有效值為經常性/非經常性存取/封存。

accessTier?: string

屬性值

string

accessTierChangedOn

物件上變更階層的時間。 只有在已設定區塊 Blob 上的層時，才會傳回這個值。

accessTierChangedOn?: Date

屬性值

Date

accessTierInferred

僅適用于進階儲存體帳戶上的分頁 Blob。 如果未在 Blob 上明確設定存取層，則會根據其內容長度推斷層，而且此標頭會以 true 值傳回。

accessTierInferred?: boolean

屬性值

boolean

archiveStatus

對於 Blob 儲存體 LRS 帳戶，有效值為 rehydrate-pending-to-hot/rehydrate-pending-to-cool。 如果 Blob 正在解除凍結且未完成，則會傳回此標頭，指出解除凍結為擱置中，也會告知目的地層。

archiveStatus?: string

屬性值

string

blobCommittedBlockCount

Blob 中存在已認可的區塊數目。 此標頭只會針對附加 Blob 傳回。

blobCommittedBlockCount?: number

屬性值

number

blobSequenceNumber

分頁 Blob 目前的序號。 區塊 Blob 或附加 Blob 不會傳回此標頭

blobSequenceNumber?: number

屬性值

number

blobType

Blob 的類型。

blobType?: BlobType

屬性值

BlobType

cacheControl

如果之前已指定 Blob，則會傳回此標頭。

cacheControl?: string

屬性值

string

clientRequestId

如果在要求中傳送用戶端要求識別碼標頭，此標頭將會出現在具有相同值的回應中。

clientRequestId?: string

屬性值

string

contentDisposition

此標頭會傳回為 'x-ms-blob-content-disposition' 標頭指定的值。 Content-Disposition 回應標頭欄位會傳達如何處理回應承載的其他資訊，也可用來附加其他中繼資料。 例如，如果設定為附件，則表示使用者代理程式不應該顯示回應，而是顯示具有指定之 Blob 名稱以外的檔案名的 [另存新檔] 對話方塊。

contentDisposition?: string

屬性值

string

contentEncoding

此標頭會傳回為 Content-Encoding 要求標頭指定的值

contentEncoding?: string

屬性值

string

contentLanguage

此標頭會傳回為 Content-Language 要求標頭指定的值。

contentLanguage?: string

屬性值

string

contentLength

Blob 大小 (以位元組為單位)。 對於分頁 Blob，此標頭會傳回以 Blob 儲存的 x-ms-blob-content-length 標頭值。

contentLength?: number

屬性值

number

contentMD5

如果 Blob 具有 MD5 雜湊，而此作業是讀取完整 Blob，則會傳回此回應標頭，讓用戶端可以檢查訊息內容完整性。

contentMD5?: Uint8Array

屬性值

Uint8Array

contentType

為 blob 指定內容類型。 預設內容類型為 'application/octet-stream'

contentType?: string

屬性值

string

copyCompletedOn

上次嘗試複製 Blob 作業的結束時間，其中此 Blob 是目的地 Blob。 此值可指定完成、中止或複製嘗試失敗的時間。 如果複製擱置中，如果此 Blob 從未成為複製 Blob 作業中的目的地，或是此 Blob 在結束的複製 Blob 作業之後使用 [設定 Blob 屬性]、[放置 Blob] 或 [放置區塊清單] 進行修改，則不會顯示此標頭。

copyCompletedOn?: Date

屬性值

Date

copyId

此複製作業的字串識別碼。 使用 取得 Blob 屬性來檢查此複製作業的狀態，或傳遞至中止複製 Blob 以中止暫止的複本。

copyId?: string

屬性值

string

copyProgress

包含上次嘗試的複製 Blob 作業中，複製的位元組數目和來源中的位元組總數，其中此 Blob 是目的地 Blob。 可以顯示覆制的介於 0 和 Content-Length 位元組之間。 如果此 Blob 從未成為複製 Blob 作業中的目的地，或是此 Blob 在結束的複製 Blob 作業之後使用 [設定 Blob 屬性]、[放置 Blob] 或 [放置區塊清單] 修改此 Blob 作業之後，就不會顯示此標頭

copyProgress?: string

屬性值

string

copySource

長度上限為 2 KB 的 URL，指定上次嘗試複製 Blob 作業所使用的來源 Blob 或檔案，其中此 Blob 是目的地 Blob。 如果此 Blob 從未成為複製 Blob 作業中的目的地，或是此 Blob 在結束的複製 Blob 作業之後使用 [設定 Blob 屬性]、[放置 Blob] 或 [放置區塊清單] 修改此 Blob 作業之後，就不會顯示此標頭。

copySource?: string

屬性值

string

copyStatus

x-ms-copy-id 所識別的複製作業狀態。

copyStatus?: CopyStatusType

屬性值

CopyStatusType

copyStatusDescription

只有在 x-ms-copy-status 失敗或擱置時才會出現。 針對上次嚴重或不嚴重複製的作業，描述其失敗的原因。 如果此 Blob 從未成為複製 Blob 作業中的目的地，或是此 Blob 在結束複製 Blob 作業之後使用 [設定 Blob 屬性]、[放置 Blob] 或 [放置區塊清單] 修改此 Blob 作業之後，就不會顯示此標頭

copyStatusDescription?: string

屬性值

string

createdOn

傳回 Blob 建立的日期和時間。

createdOn?: Date

屬性值

Date

date

服務所產生的 UTC 日期/時間值，指出起始回應的時間

date?: Date

屬性值

Date

destinationSnapshot

如果 Blob 為累加複製 Blob 或累加複製快照集，則為包含，如果 x-ms-copy-status 為成功。 此 Blob 上次成功增量複製快照集的快照集時間。

destinationSnapshot?: string

屬性值

string

encryptionKeySha256

用來加密中繼資料之加密金鑰的 SHA-256 雜湊。 只有當中繼資料使用客戶提供的金鑰加密時，才會傳回此標頭。

encryptionKeySha256?: string

屬性值

string

encryptionScope

傳回用來加密 Blob 內容和應用程式中繼資料的加密範圍名稱。 請注意，缺少此標頭表示使用預設帳戶加密範圍。

encryptionScope?: string

屬性值

string

errorCode

錯誤碼

errorCode?: string

屬性值

string

etag

ETag 包含的值可讓您依條件執行作業。 如果要求版本為 2011-08-18 或更新版本，ETag 值會加上引號。

etag?: string

屬性值

string

expiresOn

此 Blob 到期的時間。

expiresOn?: Date

屬性值

Date

immutabilityPolicyExpiresOn

服務所產生的 UTC 日期/時間值，指出 Blob 不變性原則到期的時間。

immutabilityPolicyExpiresOn?: Date

屬性值

Date

immutabilityPolicyMode

表示不變性原則模式。

immutabilityPolicyMode?: BlobImmutabilityPolicyMode

屬性值

BlobImmutabilityPolicyMode

isCurrentVersion

此標頭的值表示此 Blob 的版本是否為目前版本，另請參閱 x-ms-version-id 標頭。

isCurrentVersion?: boolean

屬性值

boolean

isIncrementalCopy

如果 Blob 是累加複製 Blob，則包含此 Blob。

isIncrementalCopy?: boolean

屬性值

boolean

isSealed

如果此 Blob 已密封

isSealed?: boolean

屬性值

boolean

isServerEncrypted

如果 Blob 資料和應用程式中繼資料使用指定的演算法完全加密，此標頭的值會設定為 true。 否則，當 Blob 未加密時，此值會設定為 false (，或者，如果只有 blob/應用程式中繼資料的部分會加密) 。

isServerEncrypted?: boolean

屬性值

boolean

lastAccessed

服務所產生的 UTC 日期/時間值，指出 Blob 上次讀取或寫入的時間

lastAccessed?: Date

屬性值

Date

lastModified

傳回 Blob 上次修改的日期和時間。 修改 Blob 的任何作業 (包括 Blob 更新的中繼資料或屬性)，都會變更 Blob 上次修改的時間。

lastModified?: Date

屬性值

Date

leaseDuration

租用 Blob 時，指定租用期為無限或固定時間。

leaseDuration?: LeaseDurationType

屬性值

LeaseDurationType

leaseState

Blob 的租用狀態。

leaseState?: LeaseStateType

屬性值

LeaseStateType

leaseStatus

Blob 的目前租用狀態。

leaseStatus?: LeaseStatusType

屬性值

LeaseStatusType

legalHold

指出 Blob 上是否有合法保留。

legalHold?: boolean

屬性值

boolean

metadata

metadata?: [key: string]: string

屬性值

[key: string]: string

objectReplicationPolicyId

選擇性。 只有在針對儲存體容器和複寫的目的地 Blob 啟用物件複寫時，才有效。

objectReplicationPolicyId?: string

屬性值

string

objectReplicationRules

選擇性。 只有在針對儲存體容器和複寫的來源 Blob 啟用物件複寫時，才有效。 擷取此標頭時，它會傳回具有原則識別碼和規則識別碼的標頭 (，例如 x-ms-or-policyid_ruleid) ，而值會是複寫 (的狀態，例如完成、失敗) 。

objectReplicationRules?: [key: string]: string

屬性值

[key: string]: string

rehydratePriority

如果物件處於解除凍結擱置狀態，則會以解除凍結的優先順序傳回此標頭。

rehydratePriority?: RehydratePriority

屬性值

RehydratePriority

requestId

此標頭可唯一識別提出的要求，而且可用來進行要求的疑難排解。

requestId?: string

屬性值

string

tagCount

與 Blob 相關聯的標記數目

tagCount?: number

屬性值

number

version

指出用於執行要求的 Blob 服務版本。 對 2009-09-19 (含) 以上版本提出要求會傳回此標頭。

version?: string

屬性值

string

versionId

服務所傳回的 DateTime 值，可唯一識別 Blob。 此標頭的值表示 Blob 版本，而且可用於後續要求來存取此版本的 Blob。

versionId?: string

屬性值

string