Získání statistik služby front

Článek
06/27/2023

Operace Get Queue Service Stats načte statistiky související s replikací pro Azure Queue Storage. Je k dispozici pouze v sekundárním koncovém bodu umístění, pokud je pro účet úložiště povolená geograficky redundantní replikace jen pro čtení.

Žádost

Požadavek Get Queue Service Stats může být vytvořen následujícím způsobem. Doporučujeme používat protokol HTTPS. Nahraďte myaccount názvem vašeho účtu úložiště a všimněte si, že se vyžaduje přípona -secondary :

Metoda	Identifikátor URI žádosti	Verze PROTOKOLU HTTP
GET	`https://myaccount-secondary.queue.core.windows.net/?restype=service&comp=stats`	HTTP/1.1

Poznámka

Identifikátor URI musí vždy obsahovat lomítko (/), aby se název hostitele oddělil od části URI cesty a dotazu. V této operaci je část cesty identifikátoru URI prázdná.

Parametry identifikátoru URI

V identifikátoru URI požadavku je možné zadat následující další parametry:

Parametr	Popis
`Timeout`	Nepovinný parametr. Parametr se `timeout` vyjadřuje v sekundách.

Hlavičky požadavku

Následující tabulka popisuje požadované a volitelné hlavičky požadavků.

Hlavička požadavku	Popis
`Authorization`	Povinná hodnota. Určuje schéma autorizace, název účtu a podpis. Další informace najdete v tématu Autorizace požadavků do služby Azure Storage.
`Date or x-ms-date`	Povinná hodnota. Určuje formát UTC (Coordinated Universal Time). Další informace najdete v tématu Autorizace požadavků do služby Azure Storage.
`x-ms-version`	Vyžaduje se pro všechny autorizované žádosti. Určuje verzi operace, která se má pro tento požadavek použít. Další informace najdete v tématu Správa verzí pro služby Azure Storage.
`x-ms-client-request-id`	Nepovinný parametr. Poskytuje klientem vygenerovanou neprůselnou hodnotu s limitem počtu znaků 1 kibibajt (KiB), který je zaznamenán v protokolech při konfiguraci protokolování. Důrazně doporučujeme použít tuto hlavičku ke korelaci aktivit na straně klienta s požadavky, které server přijímá. Další informace najdete v tématu Monitorování služby Azure Queue Storage.

Text požadavku

Žádné

Odpověď

Odpověď obsahuje stavový kód HTTP, sadu hlaviček odpovědi a tělo odpovědi.

Stavový kód

Úspěšná operace vrátí stavový kód 200 (OK). Když se volá na sekundárním koncovém bodu umístění, který nemá povolené sekundární čtení, vrátí stavový kód HTTP 403 (Nedostatečná oprávnění účtu).

Hlavičky odpovědi

Odpověď na tuto operaci obsahuje následující hlavičky. Odpověď obsahuje také další standardní hlavičky HTTP. Všechny standardní hlavičky odpovídají specifikaci protokolu HTTP/1.1.

Hlavička odpovědi	Description
`x-ms-request-id`	Jednoznačně identifikuje požadavek, který byl proveden, a lze ho použít k řešení potíží s požadavkem. Další informace najdete v tématu Řešení potíží s operacemi rozhraní API.
`x-ms-version`	Určuje verzi operace, která byla použita pro odpověď. Další informace najdete v tématu Správa verzí pro služby Azure Storage.
`Date`	Hodnota data a času UTC vygenerovaná službou, která označuje čas, kdy byla odpověď inicializována.
`x-ms-client-request-id`	Tato hlavička se dá použít k řešení potíží s požadavky a odpovídajícími odpověďmi. Hodnota této hlavičky se rovná hodnotě `x-ms-client-request-id` hlavičky, pokud se nachází v požadavku, a hodnota obsahuje maximálně 1 024 viditelných znaků ASCII. Pokud se hlavička `x-ms-client-request-id` v požadavku nenachází, v odpovědi se nezobrazí.

Text odpovědi

Text odpovědi má následující formát:

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

Prvky textu odpovědi jsou popsány v následující tabulce:

Hlavička odpovědi Description

Status Stav sekundárního umístění. Možné hodnoty:

- live: Označuje, že sekundární umístění je aktivní a funkční.
- bootstrap: Indikuje, že probíhá počáteční synchronizace z primárního umístění do sekundárního umístění. K tomu obvykle dochází při prvním povolení replikace.
- nedostupné: Označuje, že sekundární umístění je dočasně nedostupné.

LastSyncTime Hodnota data a času UTC (v sekundách). U všech primárních zápisů, které předcházejí této hodnotě, je zaručeno, že budou k dispozici pro operace čtení v sekundárním zápisu. Primární zápisy po tomto bodu v čase můžou, ale nemusí být pro čtení dostupné.

Hodnota může být prázdná, pokud LastSyncTime není k dispozici. K tomu může dojít v případě, že je stav replikace bootstrap nebo nedostupný.

Přestože je geografická replikace nepřetržitě povolená, LastSyncTime výsledek může odrážet hodnotu uloženou v mezipaměti ze služby, která se aktualizuje každých několik minut.

Hlavička odpovědi	Description
`Status`	Stav sekundárního umístění. Možné hodnoty: - live: Označuje, že sekundární umístění je aktivní a funkční. - bootstrap: Indikuje, že probíhá počáteční synchronizace z primárního umístění do sekundárního umístění. K tomu obvykle dochází při prvním povolení replikace. - nedostupné: Označuje, že sekundární umístění je dočasně nedostupné.
`LastSyncTime`	Hodnota data a času UTC (v sekundách). U všech primárních zápisů, které předcházejí této hodnotě, je zaručeno, že budou k dispozici pro operace čtení v sekundárním zápisu. Primární zápisy po tomto bodu v čase můžou, ale nemusí být pro čtení dostupné. Hodnota může být prázdná, pokud `LastSyncTime` není k dispozici. K tomu může dojít v případě, že je stav replikace bootstrap nebo nedostupný. Přestože je geografická replikace nepřetržitě povolená, `LastSyncTime` výsledek může odrážet hodnotu uloženou v mezipaměti ze služby, která se aktualizuje každých několik minut.

Autorizace

Tuto operaci může volat pouze vlastník účtu.

Poznámky

Díky geograficky redundantní replikaci Azure Storage trvale udržuje vaše data ve dvou umístěních. V obou umístěních Azure Storage neustále udržuje několik replik dat, které jsou v pořádku.

Umístění, kde čtete, vytváříte, aktualizujete nebo odstraňujete data, je primární umístění účtu úložiště. Primární umístění existuje v oblasti, kterou zvolíte při vytváření účtu prostřednictvím portálu Azure Classic pro správu Azure (například USA – středosever).

Umístění, do kterého se data replikují, je sekundární umístění. Sekundární umístění se nachází v oblasti, která je automaticky geograficky spárovaná s primární oblastí. Přístup jen pro čtení je k dispozici ze sekundárního umístění, pokud je pro váš účet úložiště povolená geograficky redundantní replikace jen pro čtení .

Další informace o geograficky redundantní replikaci s přístupem pro čtení najdete v tématu Redundance dat.

Pokud chcete vytvořit požadavek na operaci čtení vůči sekundárnímu koncovému bodu, připojte -secondary jako příponu k názvu účtu v identifikátoru URI, který používáte ke čtení ze služby Queue Storage. Například sekundární identifikátor URI pro operaci Náhled zpráv je podobný jako https://myaccount-secondary.queue.core.windows.net/myqueue/messages?peekonly=true.

Ukázkový požadavek a odpověď

Následuje ukázkový požadavek na Get Queue Service Stats operaci:

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

Požadavek se odešle s následujícími hlavičkami:

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

Hlavičky stavového kódu a odpovědi se vrátí takto:

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

Odpověď obsahuje následující text 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>

Viz také

Operace s účtem (služba front)