取得佇列服務統計資料

發行項
08/05/2023

此 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-id` 。 `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 UTC 日期/時間值，以秒為單位。在此值之前的所有主要寫入，保證都可用於次要寫入的讀取作業。此時間點之後的主要寫入可能無法用於讀取。

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

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

回應標頭	描述
`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>

另請參閱

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