取得佇列服務統計資料

Get Queue Service Stats作業會擷取與佇列服務的複寫相關的統計資料。 當儲存體帳戶啟用讀取權限的地理備援複寫時,它只能用於次要位置端點。

要求

Get Queue Service Stats 要求的建構如下。 建議使用 HTTPS。 請以您的儲存體帳戶名稱取代 myaccount,並注意需要 -secondary 尾碼:

方法 要求 URI HTTP 版本
GET https://myaccount-secondary.queue.core.windows.net/?restype=service&comp=stats HTTP/1.1

請注意,URI 一律需包含正斜線 (/),將主機名稱與 URI 的路徑和查詢部分隔開。 若為這項作業,URI 的路徑部分為空白。

URI 參數

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

參數 描述
Timeout 選擇性。 timeout 參數以秒為單位。

要求標頭

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

要求標頭 描述
Authorization 必要。 指定授權配置、帳戶名稱和簽章。 如需詳細資訊,請參閱授權 Azure 儲存體的要求
Date or x-ms-date 必要。 指定要求的「國際標準時間」(UTC)。 如需詳細資訊,請參閱授權 Azure 儲存體的要求
x-ms-version 所有授權要求都需要。 指定用於這個要求的作業版本。 如需詳細資訊,請參閱Azure 儲存體服務的版本控制
x-ms-client-request-id 選擇性。 用戶端產生的不透明值,並在啟用儲存體分析記錄時,記錄在分析記錄中的1kb 字元限制。 要將用戶端活動與伺服器收到的要求產生關聯時,極力建議您使用這個標頭。 如需詳細資訊,請參閱Azure 記錄:使用記錄檔追蹤儲存體要求

要求本文

無。

回應

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

狀態碼

成功的作業會傳回狀態碼 200 (OK)。 在未啟用次要讀取的次要位置端點上呼叫時,它會傳回 Http 狀態碼 403 與 InsufficientAccountPermissions 錯誤。

回應標頭

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

回應標頭 描述
x-ms-request-id 此標頭可唯一識別提出的要求,而且可用來進行要求的疑難排解。 如需詳細資訊,請參閱 疑難排解 API 作業
x-ms-version 指定用於回應的作業版本。 如需詳細資訊,請參閱Azure 儲存體服務的版本控制
Date 服務產生的 UTC 日期/時間值,可指出啟動回應的時間。
x-ms-client-request-id 此標頭可用於疑難排解要求和對應的回應。 x-ms-client-request-id如果要求中有標頭的值,且值最多1024個可見的 ASCII 字元,則此標頭的值會等於標頭的值。 如果 x-ms-client-request-id 標頭不存在於要求中,則回應中不會出現此標頭。

回應本文

回應主體的格式如下:

<?xml version="1.0" encoding="utf-8"?>  
<StorageServiceStats>  
  <GeoReplication>        
      <Status>live|bootstrap|unavailable</Status>  
      <LastSyncTime>sync-time|<empty></LastSyncTime>  
  </GeoReplication>  
</StorageServiceStats>  

下表描述回應主體的元素:

回應標頭 描述
Status 次要位置的狀態。 可能的值包括:

- live:指出次要位置為作用中且可運作。
- bootstrap:表示從主要位置到次要位置的初始同步處理正在進行中。 這通常發生在最初啟用複寫時。
-無法使用:指出次要位置暫時無法使用。
LastSyncTime GMT 日期/時間值 (到秒值)。 這個值前面的所有主要寫入保證都可在次要位置供讀取作業使用。 這個點後面的主要寫入不一定可供讀取作業使用。

如果無法使用 LastSyncTime,這個值可能是空的。 如果複寫狀態為 bootstrapunavailable,就可能會發生這個情況。

雖然持續啟用地理複寫,但是 LastSyncTime 結果可能會反映服務中每隔幾分鐘重新整理一次的快取值。

授權

只有帳戶擁有者可呼叫這項作業。

備註

有了地理備援複寫,Azure 儲存體會以持久的方式在兩個位置維護您的資料。 在這兩個位置中,Azure 儲存體會持續維護狀況良好的多個資料複本。

您讀取、建立、更新或刪除資料的位置是 「主要」 儲存體帳戶的位置。 主要位置存在於您透過 Azure 管理 Azure 傳統入口網站(例如 美國中北部)建立帳戶時所選擇的區域中。 資料複寫的目標位置是 「次要」 位置。 次要位置位於自動與主要區域配對之地理位置的區域中。 當儲存體帳戶啟用 「讀取權限的地理備援複寫」 時,可從次要位置使用唯讀權限。 如需有關「讀取權限異地複寫」複寫的詳細資訊,請參閱Azure 儲存體 Team Blog

若要針對次要端點建構讀取作業的要求,請將 -secondary 當做尾碼附加到帳戶名稱,此名稱位於您用來從佇列儲存體讀取的 URI 內。 例如,「 查看訊息 」作業的次要 URI 將類似于 https://myaccount-secondary.queue.core.windows.net/myqueue/messages?peekonly=true

範例要求和回應

以下顯示Get Queue Service Stats作業的範例要求:

GET http://myaccount-secondary.queue.core.windows.net/?restype=service&comp=stats HTTP/1.1  

所傳送的要求包含下列標頭:

x-ms-version: 2013-08-15  
x-ms-date: Wed, 23 Oct 2013 22:08:44 GMT  
Authorization: SharedKey myaccount:CY1OP3O3jGFpYFbTCBimLn0Xov0vt0khH/E5Gy0fXvg=  

傳回的狀態碼和回應標頭如下:

HTTP/1.1 200 OK  
Content-Type: application/xml  
Date: Wed, 23 Oct 2013 22:08:54 GMT  
x-ms-version: 2013-08-15  
x-ms-request-id: cb939a31-0cc6-49bb-9fe5-3327691f2a30  
Server: Windows-Azure-Queue/1.0 Microsoft-HTTPAPI/2.0  

回應包含下列 XML 主體:

<?xml version="1.0" encoding="utf-8"?>  
<StorageServiceStats>  
  <GeoReplication>  
      <Status>live</Status>  
      <LastSyncTime> Wed, 23 Oct 2013 22:05:54 GMT</LastSyncTime>        
  </GeoReplication>  
</StorageServiceStats>  

另請參閱

帳戶上的作業 (佇列服務)