共用方式為


取得佇列服務統計資料

Get Queue Service Stats 作業會擷取與 Azure 佇列儲存體複寫相關的統計資料。 只有在儲存體帳戶啟用讀取權限異地備援複寫時,才能在次要位置端點上使用。

要求

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 選擇性。 提供用戶端產生的不透明值,其中包含設定記錄時記錄的 1 kibibyte (KiB) 字元限制。 強烈建議您使用此標頭,將用戶端活動與伺服器接收的要求相互關聯。 如需詳細資訊,請參閱 監視 Azure 佇列儲存體

要求本文

無。

回應

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

狀態碼

成功的作業會傳回狀態碼 200 (OK)。 在未啟用次要讀取的次要位置端點上呼叫時,它會傳回 HTTP 狀態碼 403 (帳戶許可權不足) 。

回應標頭

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

回應標頭 描述
x-ms-request-id 可唯一識別發出的要求,並可用來對要求進行疑難排解。 如需詳細資訊,請參閱 針對 API 作業進行疑難排解
x-ms-version 指定用於回應的作業版本。 如需詳細資訊,請參閱 Azure 儲存體服務的版本
Date 服務所產生的 UTC 日期/時間值,表示起始回應的時間。
x-ms-client-request-id 此標頭可用來針對要求和對應的回應進行疑難排解。 如果此標頭存在於要求中,且值包含不超過 1,024 個可見的 ASCII 字元,則此標頭的值等於 標頭的值 x-ms-client-request-idx-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 UTC 日期/時間值,以秒為單位。 在此值之前的所有主要寫入,保證都可用於次要寫入的讀取作業。 此時間點之後的主要寫入可能無法用於讀取。

如果 LastSyncTime 無法使用,此值可能是空的。 如果複寫狀態為 啟動程式無法使用,就會發生這種情況。

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

授權

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

備註

使用異地備援複寫,Azure 儲存體會在兩個位置永久維護您的資料。 在這兩個位置中,Azure 儲存體會持續維護狀況良好的多個資料複本。

您讀取、建立、更新或刪除資料的位置是「主要」儲存體帳戶的位置。 當您透過 Azure 管理 Azure 傳統入口網站建立帳戶時,主要位置存在於您所選擇的區域中,例如 美國中 北部) (。

資料複寫的目標位置是「次要」位置。 次要位置位於自動與主要區域配對的區域。 當儲存體帳戶啟用「讀取權限的地理備援複寫」時,可從次要位置使用唯讀權限。

如需讀取權限異地備援複寫的詳細資訊,請參閱 資料備援

若要針對次要端點建構讀取作業的要求,請將 作為尾碼附加 -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>  

另請參閱

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