BlobQueryHeaders interface

定義Blob_query作業的標頭。

屬性

acceptRanges

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

blobCommittedBlockCount

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

blobContentMD5

如果 Blob 具有 MD5 哈希,而且如果要求包含範圍標頭(Range 或 x-ms-range),則會傳回此回應標頭,且其值為整個 Blob 的 MD5 值。 此值不一定等於 Content-MD5 標頭中傳回的值,後者是從要求的範圍計算而來

blobSequenceNumber

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

blobType

Blob 的類型。

cacheControl

如果先前已為 Blob 指定此標頭,則會傳回此標頭。

clientRequestId

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

contentCrc64

如果要求是讀取指定的範圍,且 x-ms-range-get-content-crc64 設定為 true,則只要範圍大小小於或等於 4 MB,要求就會傳回 crc64。 如果在相同的要求中指定了 x-ms-range-get-content-crc64 & x-ms-range-get-content-md5,則會失敗併產生 400(不正確的要求)。

contentDisposition

此標頭會傳回為 'x-ms-blob-content-disposition' 標頭指定的值。 Content-Disposition 回應標頭字段會傳達有關如何處理響應承載的其他資訊,也可用來附加其他元數據。 例如,如果設定為附件,則表示使用者代理程式不應該顯示回應,而是顯示 [另存新檔] 對話方塊,其檔名不是指定的 Blob 名稱。

contentEncoding

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

contentLanguage

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

contentLength

響應主體中存在的位元組數目。

contentMD5

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

contentRange

指出客戶端藉由設定 『Range』 要求標頭來要求 Blob 子集時所傳回的位元組範圍。

contentType

回應主體的媒體類型。 針對下載 Blob,這是 'application/octet-stream'

copyCompletionTime

上次嘗試複製 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 或放置區塊清單進行修改,則不會出現此標頭

copySource

長度最多 2 KB 的 URL,指定上次嘗試複製 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 或放置區塊清單進行修改,則不會出現此標頭

date

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

encryptionKeySha256

用來加密 Blob 之加密金鑰的 SHA-256 哈希。 只有當 Blob 使用客戶提供的金鑰加密時,才會傳回此標頭。

encryptionScope

傳回用來加密 Blob 內容和應用程式元數據的加密範圍名稱。 請注意,缺少此標頭表示使用預設帳戶加密範圍。

errorCode

錯誤碼

etag

ETag 包含一個值,可用來有條件地執行作業。 如果要求版本是 2011-08-18 或更新版本,ETag 值將會以引號括住。

isServerEncrypted

如果 Blob 資料和應用程式元數據使用指定的演算法完全加密,則此標頭的值會設定為 true。 否則,此值會設定為 false (當 Blob 未加密時,或只加密 Blob/應用程式元數據的一部分時)。

lastModified

傳回上次修改容器的日期和時間。 任何修改 Blob 的作業,包括 Blob 元數據或屬性的更新,會變更 Blob 上次修改的時間。

leaseDuration

當 Blob 租用時,指定租用是無限期還是固定持續時間。

leaseState

Blob 的租用狀態。

leaseStatus

Blob 目前的租用狀態。

metadata
requestId

此標頭可唯一識別已提出並可用於對要求進行疑難解答的要求。

version

指出用來執行要求的 Blob 服務版本。 針對針對 2009-09-19 版和更新版本提出的要求,會傳回此標頭。

屬性詳細資料

acceptRanges

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

TypeScript
acceptRanges?: string

屬性值

string

blobCommittedBlockCount

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

TypeScript
blobCommittedBlockCount?: number

屬性值

number

blobContentMD5

如果 Blob 具有 MD5 哈希,而且如果要求包含範圍標頭(Range 或 x-ms-range),則會傳回此回應標頭,且其值為整個 Blob 的 MD5 值。 此值不一定等於 Content-MD5 標頭中傳回的值,後者是從要求的範圍計算而來

TypeScript
blobContentMD5?: Uint8Array

屬性值

Uint8Array

blobSequenceNumber

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

TypeScript
blobSequenceNumber?: number

屬性值

number

blobType

Blob 的類型。

TypeScript
blobType?: BlobType

屬性值

cacheControl

如果先前已為 Blob 指定此標頭,則會傳回此標頭。

TypeScript
cacheControl?: string

屬性值

string

clientRequestId

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

TypeScript
clientRequestId?: string

屬性值

string

contentCrc64

如果要求是讀取指定的範圍,且 x-ms-range-get-content-crc64 設定為 true,則只要範圍大小小於或等於 4 MB,要求就會傳回 crc64。 如果在相同的要求中指定了 x-ms-range-get-content-crc64 & x-ms-range-get-content-md5,則會失敗併產生 400(不正確的要求)。

TypeScript
contentCrc64?: Uint8Array

屬性值

Uint8Array

contentDisposition

此標頭會傳回為 'x-ms-blob-content-disposition' 標頭指定的值。 Content-Disposition 回應標頭字段會傳達有關如何處理響應承載的其他資訊,也可用來附加其他元數據。 例如,如果設定為附件,則表示使用者代理程式不應該顯示回應,而是顯示 [另存新檔] 對話方塊,其檔名不是指定的 Blob 名稱。

TypeScript
contentDisposition?: string

屬性值

string

contentEncoding

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

TypeScript
contentEncoding?: string

屬性值

string

contentLanguage

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

TypeScript
contentLanguage?: string

屬性值

string

contentLength

響應主體中存在的位元組數目。

TypeScript
contentLength?: number

屬性值

number

contentMD5

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

TypeScript
contentMD5?: Uint8Array

屬性值

Uint8Array

contentRange

指出客戶端藉由設定 『Range』 要求標頭來要求 Blob 子集時所傳回的位元組範圍。

TypeScript
contentRange?: string

屬性值

string

contentType

回應主體的媒體類型。 針對下載 Blob,這是 'application/octet-stream'

TypeScript
contentType?: string

屬性值

string

copyCompletionTime

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

TypeScript
copyCompletionTime?: Date

屬性值

Date

copyId

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

TypeScript
copyId?: string

屬性值

string

copyProgress

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

TypeScript
copyProgress?: string

屬性值

string

copySource

長度最多 2 KB 的 URL,指定上次嘗試複製 Blob 作業中使用的來源 Blob 或檔案,其中此 Blob 是目的地 Blob。 如果此 Blob 從未是複製 Blob 作業中的目的地,或是此 Blob 在結束的複製 Blob 作業之後使用設定 Blob 屬性、放置 Blob 或放置區塊清單進行修改,則不會出現此標頭。

TypeScript
copySource?: string

屬性值

string

copyStatus

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

TypeScript
copyStatus?: CopyStatusType

屬性值

copyStatusDescription

只有在 x-ms-copy-status 失敗或擱置時才會出現。 描述最後一個致命或非嚴重複製作業失敗的原因。 如果此 Blob 從未是複製 Blob 作業中的目的地,或是此 Blob 在結束的複製 Blob 作業之後使用設定 Blob 屬性、放置 Blob 或放置區塊清單進行修改,則不會出現此標頭

TypeScript
copyStatusDescription?: string

屬性值

string

date

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

TypeScript
date?: Date

屬性值

Date

encryptionKeySha256

用來加密 Blob 之加密金鑰的 SHA-256 哈希。 只有當 Blob 使用客戶提供的金鑰加密時,才會傳回此標頭。

TypeScript
encryptionKeySha256?: string

屬性值

string

encryptionScope

傳回用來加密 Blob 內容和應用程式元數據的加密範圍名稱。 請注意,缺少此標頭表示使用預設帳戶加密範圍。

TypeScript
encryptionScope?: string

屬性值

string

errorCode

錯誤碼

TypeScript
errorCode?: string

屬性值

string

etag

ETag 包含一個值,可用來有條件地執行作業。 如果要求版本是 2011-08-18 或更新版本,ETag 值將會以引號括住。

TypeScript
etag?: string

屬性值

string

isServerEncrypted

如果 Blob 資料和應用程式元數據使用指定的演算法完全加密,則此標頭的值會設定為 true。 否則,此值會設定為 false (當 Blob 未加密時,或只加密 Blob/應用程式元數據的一部分時)。

TypeScript
isServerEncrypted?: boolean

屬性值

boolean

lastModified

傳回上次修改容器的日期和時間。 任何修改 Blob 的作業,包括 Blob 元數據或屬性的更新,會變更 Blob 上次修改的時間。

TypeScript
lastModified?: Date

屬性值

Date

leaseDuration

當 Blob 租用時,指定租用是無限期還是固定持續時間。

TypeScript
leaseDuration?: LeaseDurationType

屬性值

leaseState

Blob 的租用狀態。

TypeScript
leaseState?: LeaseStateType

屬性值

leaseStatus

Blob 目前的租用狀態。

TypeScript
leaseStatus?: LeaseStatusType

屬性值

metadata

TypeScript
metadata?: {[propertyName: string]: string}

屬性值

{[propertyName: string]: string}

requestId

此標頭可唯一識別已提出並可用於對要求進行疑難解答的要求。

TypeScript
requestId?: string

屬性值

string

version

指出用來執行要求的 Blob 服務版本。 針對針對 2009-09-19 版和更新版本提出的要求,會傳回此標頭。

TypeScript
version?: string

屬性值

string