本頁是否能提供幫助?
您對此內容的意見反應十分重要。 請告訴我們您的想法。
其他意見反應?
剩餘 1500 個字元
匯出 (0) 列印
全部展開

取得分頁範圍

更新日期: 2015年4月

Get Page Ranges 作業會針對分頁 Blob 或分頁 Blob 的快照集,傳回有效的分頁範圍清單。

Get Page Ranges 要求的建構如下。建議使用 HTTPS。請以您的儲存體帳戶名稱取代 myaccount

 

  GET 方法要求 URI HTTP 版本

https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=pagelist

https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=pagelist&snapshot=<DateTime>

HTTP/1.1

對模擬儲存體服務提出要求時,請將模擬器主機名稱和 Blob 服務通訊埠指定為 127.0.0.1:10000,後面接著模擬儲存體帳戶名稱:

 

  GET 方法要求 URI HTTP 版本

http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob?comp=pagelist

HTTP/1.1

如需詳細資訊,請參閱Using the Azure Storage Emulator for Development and Testing

您可以在要求的 URI 中指定下列其他參數。

 

參數 說明

snapshot

選擇性。快照集參數是不透明的 DateTime 值,當其存在時,會指定要從中擷取資訊的 Blob 快照集。如需使用 Blob 快照集的詳細資訊,請參閱建立 Blob 的快照集

timeout

選擇性。timeout 參數以秒為單位。如需詳細資訊,請參閱設定 Blob 服務作業的逾時值

下表描述必要的和選用的要求標頭。

 

要求標頭 說明

Authorization

必要項。指定驗證配置、帳戶名稱及簽章。如需詳細資訊,請參閱Azure 儲存體服務的驗證

Datex-ms-date

必要項。指定要求的國際標準時間 (UTC)。如需詳細資訊,請參閱Azure 儲存體服務的驗證

x-ms-version

所有已驗證要求為必要項,匿名要求則為選擇性。指定用於這個要求的作業版本。如需詳細資訊,請參閱為 Windows Azure 中的 Blob、佇列和表格服務進行版本設定

Range

選擇性。指定需列出範圍的位元組範圍 (內含)。如果省略,則會傳回 Blob 的所有範圍。

x-ms-range

選擇性。指定需列出範圍的位元組範圍 (內含)。

如果同時指定 Rangex-ms-range,服務會使用 x-ms-range 的值。如需詳細資訊,請參閱指定 Blob 服務作業的範圍標頭

x-ms-lease-id:<ID>

選擇性。如果指定此標頭,只有同時符合下列兩個條件時,才會執行作業:

  • Blob 的租用目前為作用中。

  • 要求中所指定的租用識別碼與 Blob 中的租用識別碼相符。

如果指定此標頭但不符合任何一項條件,則要求和作業會失敗,並顯示狀態碼 412 (先決條件失敗)。

x-ms-client-request-id

選擇性。提供由用戶端產生的不透明值 (具有 1 KB 的字元限制),當儲存體分析記錄為啟用狀態時,此值會記錄在分析記錄檔中。如果是和伺服器所接收的要求相關的用戶端活動,則強烈建議您使用此標頭。如需詳細資訊,請參閱關於儲存體分析記錄Azure 記錄:使用記錄檔追蹤儲存體需求

唯有在符合指定條件的情況下,此作業也可支援使用條件式標頭以取得分頁範圍。如需詳細資訊,請參閱指定 Blob 服務作業的條件式標頭

無。

回應包括 HTTP 狀態碼、一組回應標頭和回應主體。

成功的作業會傳回狀態碼 200 (確定)。

如需狀態碼的資訊,請參閱<狀態和錯誤碼>。

這項作業的回應包括下列標頭。回應也可能包括其他標準 HTTP 標頭。所有標準標頭都符合 HTTP/1.1 通訊協定規格

 

語法 說明

Last-Modified

上次修改 Blob 的日期/時間。日期格式會依照 RFC 1123。

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

ETag

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

x-ms-blob-content-length

Blob 的大小 (以位元組為單位)。

x-ms-request-id

此標頭可唯一識別提出的要求,而且可用來進行要求的疑難排解。如需詳細資訊,請參閱對應用程式開發介面作業進行疑難排解

x-ms-version

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

如果容器使用 2009-09-19 版的 Blob 服務標示公開存取,也會針對未指定版本的匿名要求傳回此標頭。

Date

服務產生的 UTC 日期/時間值,可指出啟動回應的時間。

回應主體包含非重疊的有效分頁範圍清單,依遞增的位址分頁範圍排序。回應主體的格式如下。

<?xml version="1.0" encoding="utf-8"?>
<PageList>
   <PageRange>
      <Start>Start Byte</Start>
      <End>End Byte</End>
   </PageRange>
   <PageRange>
      <Start>Start Byte</Start>
      <End>End Byte</End>
   </PageRange>
</PageList>

如果已清除 Blob 的整組分頁,回應主體不會包含任何分頁範圍。

帳戶擁有者或使用共用存取簽章並有權讀取此 Blob 的任何人,都可以執行這項作業。如果將容器的 ACL 設為允許匿名存取,任何用戶端都可以呼叫這項作業。

每個分頁範圍的開始和結束位元組位移都包含在內。

在具有大量寫入的高度片段化分頁 Blob 中,Get Page Ranges 要求會因為內部伺服器逾時而失敗。當應用程式擷取具有大量寫入作業的分頁 Blob 範圍時,應一次擷取一個分頁範圍子集。如需詳細資訊,請參閱分區段取得大型分頁 Blob 的分頁範圍

顯示:
© 2015 Microsoft