指定 Blob 服務作業的範圍標頭

  • 發行項

有數項 Blob 服務 GET 作業支援使用標準 HTTP Range 標頭。 許多 HTTP 用戶端，包括 .NET 用戶端程式庫，會將標頭的大小 Range 限制為 32 位整數，因此其值上限為 4 GiB。 由於區塊 Blob 和分頁 Blob 的大小可以大於 4 GiB，因此 Blob 服務會針對接受 HTTP Range 標頭的任何作業接受自訂範圍標頭 x-ms-range 。

有些 HTTP 用戶端 (包括 Microsoft Silverlight 程式庫) 會限制存取整個 Range 標頭。 x-ms-range 標頭也可以用來規避這些限制。

如果在要求上指定 x-ms-range 標頭，服務會使用 x-ms-range 指定的範圍，否則就會使用 Range 標頭指定的範圍。

注意

當您設定 Range 物件的 PutPageProperties 屬性時，Azure 儲存體用戶端程式庫會自動處理在要求上設定適當範圍標頭的作業。

範圍標頭格式

對於 Range 和 x-ms-range 標頭而言，Blob 服務可接受兩個位元組範圍。 位元組範圍必須遵守下列任一標頭格式：

  • bytes=startByte- 適用於使用 2011-08-18 版或更新版本的要求

  • 要求的bytes=startByte-endByte 適用於使用所有版本 (2009-04-14 版到最新版本) 的要求

格式 1：bytes=startByte-

第一種格式 bytes=startByte- 僅適用於使用 2011-08-18 版或更新版本的要求，或是 SDK 1.6 版或更新版本中的儲存體模擬器服務。 此範圍將會傳回從位移 startByte 到 Blob 結尾的位元組。 例如，指定的範圍若要包含 Blob 前 256 個位元組之後的所有位元組，您可以在下列任一標頭中傳遞：

  • Range: bytes=255-

  • x-ms-range: bytes=255-

回應中的 Content-Length 標頭等於從位移到 Blob 結尾的位元組數。 如果針對長度為 1,024 個位元組的 Blob，使用上述範例範圍，則 Content-Length 是 756。

如果位移有效，而且未超過 Blob 的總長度，要求將會傳回狀態碼 206 (部份內容)。 如果位移無效，而且超過 Blob 的總長度，要求將會傳回狀態碼 416 (無法滿足的要求範圍)。

格式 2：bytes=startByte-endByte

第二種格式 bytes=startByte-endByte 適用於使用所有版本 (2009-04-14 版到最新版本) 的要求，以及所有版本的儲存體模擬器服務。 此範圍將會傳回從位移 startByte 到 endByte 的位元組。 例如，指定的範圍若要包含 Blob 的前 512 個位元組，您可以在下列任一標頭中傳遞：

  • Range: bytes=0-511

  • x-ms-range: bytes=0-511

回應中的 Content-Length 標頭等於各位移之間的位元組數。 針對長度 Content-Length 為 1，024 個位元組的 Blob，使用上述範例範圍會是 512。

如果位移有效，而且未超過 Blob 的總長度，要求將會傳回狀態碼 206 (部份內容)。 如果位移無效，而且超過 Blob 的總長度，要求將會傳回狀態碼 416 (無法滿足的要求範圍)。

另請參閱

Blob 服務概念
Azure 儲存體服務的版本設定 \(英文\)