BlobQueryHeaders interface
定義Blob_query作業的標頭。
accept |
表示服務支援部分 Blob 內容的要求。 |
blob |
Blob 中存在的已認可區塊數目。 此標頭只會針對附加 Blob 傳回。 |
blob |
如果 Blob 具有 MD5 哈希,而且如果要求包含範圍標頭(Range 或 x-ms-range),則會傳回此回應標頭,且其值為整個 Blob 的 MD5 值。 此值不一定等於 Content-MD5 標頭中傳回的值,後者是從要求的範圍計算而來 |
blob |
分頁 Blob 的目前序號。 區塊 Blob 或附加 Blob 不會傳回此標頭 |
blob |
Blob 的類型。 |
cache |
如果先前已為 Blob 指定此標頭,則會傳回此標頭。 |
client |
如果在要求中傳送用戶端要求標識符標頭,此標頭將會出現在具有相同值的回應中。 |
content |
如果要求是讀取指定的範圍,且 x-ms-range-get-content-crc64 設定為 true,則只要範圍大小小於或等於 4 MB,要求就會傳回 crc64。 如果在相同的要求中指定了 x-ms-range-get-content-crc64 & x-ms-range-get-content-md5,則會失敗併產生 400(不正確的要求)。 |
content |
此標頭會傳回為 'x-ms-blob-content-disposition' 標頭指定的值。 Content-Disposition 回應標頭字段會傳達有關如何處理響應承載的其他資訊,也可用來附加其他元數據。 例如,如果設定為附件,則表示使用者代理程式不應該顯示回應,而是顯示 [另存新檔] 對話方塊,其檔名不是指定的 Blob 名稱。 |
content |
此標頭會傳回針對 Content-Encoding 要求標頭指定的值 |
content |
此標頭會傳回為 Content-Language 要求標頭指定的值。 |
content |
響應主體中存在的位元組數目。 |
contentMD5 | 如果 Blob 具有 MD5 哈希,而且此作業是讀取完整的 Blob,則會傳回此回應標頭,讓用戶端可以檢查訊息內容完整性。 |
content |
指出客戶端藉由設定 『Range』 要求標頭來要求 Blob 子集時所傳回的位元組範圍。 |
content |
回應主體的媒體類型。 針對下載 Blob,這是 'application/octet-stream' |
copy |
上次嘗試複製 Blob 作業的結束時間,其中此 Blob 是目的地 Blob。 這個值可以指定完成、中止或失敗複製嘗試的時間。 如果複製擱置中、如果此 Blob 從未成為複製 Blob 作業中的目的地,或是此 Blob 在結束的複製 Blob 作業之後使用 [設定 Blob 屬性]、[放置 Blob] 或 [放置區塊清單] 進行修改,則不會出現此標頭。 |
copy |
此複製作業的字串識別碼。 使用 取得 Blob 屬性來檢查此複製作業的狀態,或傳遞至中止複製 Blob 以中止暫止的複本。 |
copy |
包含複製的位元組數目,以及上次嘗試複製 Blob 作業中來源中的位元組總數,其中此 Blob 是目的地 Blob。 可以顯示複製的介於 0 和 Content-Length 位元組之間。 如果此 Blob 從未是複製 Blob 作業中的目的地,或是此 Blob 在結束的複製 Blob 作業之後使用設定 Blob 屬性、放置 Blob 或放置區塊清單進行修改,則不會出現此標頭 |
copy |
長度最多 2 KB 的 URL,指定上次嘗試複製 Blob 作業中使用的來源 Blob 或檔案,其中此 Blob 是目的地 Blob。 如果此 Blob 從未是複製 Blob 作業中的目的地,或是此 Blob 在結束的複製 Blob 作業之後使用設定 Blob 屬性、放置 Blob 或放置區塊清單進行修改,則不會出現此標頭。 |
copy |
x-ms-copy-id 所識別之複製作業的狀態。 |
copy |
只有在 x-ms-copy-status 失敗或擱置時才會出現。 描述最後一個致命或非嚴重複製作業失敗的原因。 如果此 Blob 從未是複製 Blob 作業中的目的地,或是此 Blob 在結束的複製 Blob 作業之後使用設定 Blob 屬性、放置 Blob 或放置區塊清單進行修改,則不會出現此標頭 |
date | 服務所產生的 UTC 日期/時間值,指出回應起始的時間 |
encryption |
用來加密 Blob 之加密金鑰的 SHA-256 哈希。 只有當 Blob 使用客戶提供的金鑰加密時,才會傳回此標頭。 |
encryption |
傳回用來加密 Blob 內容和應用程式元數據的加密範圍名稱。 請注意,缺少此標頭表示使用預設帳戶加密範圍。 |
error |
錯誤碼 |
etag | ETag 包含一個值,可用來有條件地執行作業。 如果要求版本是 2011-08-18 或更新版本,ETag 值將會以引號括住。 |
is |
如果 Blob 資料和應用程式元數據使用指定的演算法完全加密,則此標頭的值會設定為 true。 否則,此值會設定為 false (當 Blob 未加密時,或只加密 Blob/應用程式元數據的一部分時)。 |
last |
傳回上次修改容器的日期和時間。 任何修改 Blob 的作業,包括 Blob 元數據或屬性的更新,會變更 Blob 上次修改的時間。 |
lease |
當 Blob 租用時,指定租用是無限期還是固定持續時間。 |
lease |
Blob 的租用狀態。 |
lease |
Blob 目前的租用狀態。 |
metadata | |
request |
此標頭可唯一識別已提出並可用於對要求進行疑難解答的要求。 |
version | 指出用來執行要求的 Blob 服務版本。 針對針對 2009-09-19 版和更新版本提出的要求,會傳回此標頭。 |
表示服務支援部分 Blob 內容的要求。
acceptRanges?: string
屬性值
string
Blob 中存在的已認可區塊數目。 此標頭只會針對附加 Blob 傳回。
blobCommittedBlockCount?: number
屬性值
number
如果 Blob 具有 MD5 哈希,而且如果要求包含範圍標頭(Range 或 x-ms-range),則會傳回此回應標頭,且其值為整個 Blob 的 MD5 值。 此值不一定等於 Content-MD5 標頭中傳回的值,後者是從要求的範圍計算而來
blobContentMD5?: Uint8Array
屬性值
Uint8Array
分頁 Blob 的目前序號。 區塊 Blob 或附加 Blob 不會傳回此標頭
blobSequenceNumber?: number
屬性值
number
如果先前已為 Blob 指定此標頭,則會傳回此標頭。
cacheControl?: string
屬性值
string
如果在要求中傳送用戶端要求標識符標頭,此標頭將會出現在具有相同值的回應中。
clientRequestId?: string
屬性值
string
如果要求是讀取指定的範圍,且 x-ms-range-get-content-crc64 設定為 true,則只要範圍大小小於或等於 4 MB,要求就會傳回 crc64。 如果在相同的要求中指定了 x-ms-range-get-content-crc64 & x-ms-range-get-content-md5,則會失敗併產生 400(不正確的要求)。
contentCrc64?: Uint8Array
屬性值
Uint8Array
此標頭會傳回為 'x-ms-blob-content-disposition' 標頭指定的值。 Content-Disposition 回應標頭字段會傳達有關如何處理響應承載的其他資訊,也可用來附加其他元數據。 例如,如果設定為附件,則表示使用者代理程式不應該顯示回應,而是顯示 [另存新檔] 對話方塊,其檔名不是指定的 Blob 名稱。
contentDisposition?: string
屬性值
string
此標頭會傳回針對 Content-Encoding 要求標頭指定的值
contentEncoding?: string
屬性值
string
此標頭會傳回為 Content-Language 要求標頭指定的值。
contentLanguage?: string
屬性值
string
響應主體中存在的位元組數目。
contentLength?: number
屬性值
number
如果 Blob 具有 MD5 哈希,而且此作業是讀取完整的 Blob,則會傳回此回應標頭,讓用戶端可以檢查訊息內容完整性。
contentMD5?: Uint8Array
屬性值
Uint8Array
指出客戶端藉由設定 『Range』 要求標頭來要求 Blob 子集時所傳回的位元組範圍。
contentRange?: string
屬性值
string
回應主體的媒體類型。 針對下載 Blob,這是 'application/octet-stream'
contentType?: string
屬性值
string
上次嘗試複製 Blob 作業的結束時間,其中此 Blob 是目的地 Blob。 這個值可以指定完成、中止或失敗複製嘗試的時間。 如果複製擱置中、如果此 Blob 從未成為複製 Blob 作業中的目的地,或是此 Blob 在結束的複製 Blob 作業之後使用 [設定 Blob 屬性]、[放置 Blob] 或 [放置區塊清單] 進行修改,則不會出現此標頭。
copyCompletionTime?: Date
屬性值
Date
此複製作業的字串識別碼。 使用 取得 Blob 屬性來檢查此複製作業的狀態,或傳遞至中止複製 Blob 以中止暫止的複本。
copyId?: string
屬性值
string
包含複製的位元組數目,以及上次嘗試複製 Blob 作業中來源中的位元組總數,其中此 Blob 是目的地 Blob。 可以顯示複製的介於 0 和 Content-Length 位元組之間。 如果此 Blob 從未是複製 Blob 作業中的目的地,或是此 Blob 在結束的複製 Blob 作業之後使用設定 Blob 屬性、放置 Blob 或放置區塊清單進行修改,則不會出現此標頭
copyProgress?: string
屬性值
string
長度最多 2 KB 的 URL,指定上次嘗試複製 Blob 作業中使用的來源 Blob 或檔案,其中此 Blob 是目的地 Blob。 如果此 Blob 從未是複製 Blob 作業中的目的地,或是此 Blob 在結束的複製 Blob 作業之後使用設定 Blob 屬性、放置 Blob 或放置區塊清單進行修改,則不會出現此標頭。
copySource?: string
屬性值
string
只有在 x-ms-copy-status 失敗或擱置時才會出現。 描述最後一個致命或非嚴重複製作業失敗的原因。 如果此 Blob 從未是複製 Blob 作業中的目的地,或是此 Blob 在結束的複製 Blob 作業之後使用設定 Blob 屬性、放置 Blob 或放置區塊清單進行修改,則不會出現此標頭
copyStatusDescription?: string
屬性值
string
服務所產生的 UTC 日期/時間值,指出回應起始的時間
date?: Date
屬性值
Date
用來加密 Blob 之加密金鑰的 SHA-256 哈希。 只有當 Blob 使用客戶提供的金鑰加密時,才會傳回此標頭。
encryptionKeySha256?: string
屬性值
string
傳回用來加密 Blob 內容和應用程式元數據的加密範圍名稱。 請注意,缺少此標頭表示使用預設帳戶加密範圍。
encryptionScope?: string
屬性值
string
錯誤碼
errorCode?: string
屬性值
string
ETag 包含一個值,可用來有條件地執行作業。 如果要求版本是 2011-08-18 或更新版本,ETag 值將會以引號括住。
etag?: string
屬性值
string
如果 Blob 資料和應用程式元數據使用指定的演算法完全加密,則此標頭的值會設定為 true。 否則,此值會設定為 false (當 Blob 未加密時,或只加密 Blob/應用程式元數據的一部分時)。
isServerEncrypted?: boolean
屬性值
boolean
傳回上次修改容器的日期和時間。 任何修改 Blob 的作業,包括 Blob 元數據或屬性的更新,會變更 Blob 上次修改的時間。
lastModified?: Date
屬性值
Date
metadata?: {[propertyName: string]: string}
屬性值
{[propertyName: string]: string}
此標頭可唯一識別已提出並可用於對要求進行疑難解答的要求。
requestId?: string
屬性值
string
指出用來執行要求的 Blob 服務版本。 針對針對 2009-09-19 版和更新版本提出的要求,會傳回此標頭。
version?: string
屬性值
string