Získání statistik služby Table Service
Operace Get Table Service Stats
načte statistiky související s replikací pro Azure Table 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 s přístupem pro čtení.
Žádost
Požadavek Get Table Service Stats
může být vytvořen následujícím způsobem. Doporučujeme použít https. Nahraďte myaccount názvem vašeho účtu úložiště a všimněte si, že je vyžadována přípona -secondary :
Metoda | Identifikátor URI žádosti | Verze PROTOKOLU HTTP |
---|---|---|
GET | https://myaccount-secondary.table.core.windows.net/?restype=service&comp=stats |
HTTP/1.1 |
Poznámka
Identifikátor URI musí vždy obsahovat znak lomítka (/), aby se název hostitele oddělil od části cesty a dotazu identifikátoru URI. 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 timeout je vyjádřen v sekundách. |
Hlavičky požadavku
Požadované a volitelné hlavičky požadavků jsou popsané v následující tabulce:
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 |
Povinné pro všechny autorizované žádosti. Určuje verzi operace, která se má použít pro tento požadavek. 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 Table 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 |
Jedineč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 |
Dá se použít k řešení potíží s požadavky a jejich odpovídajícími odpověďmi. Hodnota této hlavičky se rovná hodnotě x-ms-client-request-id hlavičky, pokud je v požadavku, a hodnota neobsahuje více než 1 024 viditelných znaků ASCII. Pokud hlavička x-ms-client-request-id v požadavku není, nebude v odpovědi. |
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 popsané 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: Označuje, ž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 na sekundu. 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 nebo nemusí být pro čtení k dispozici. Pokud je hodnota nedostupná, může být prázdná LastSyncTime . K tomu může dojít v případě, že je stav replikace bootstrap nebo není k dispozici.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 Management Azure Classic (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 s přístupem 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í pro sekundární koncový bod, připojte k názvu účtu v identifikátoru URI, který používáte ke čtení ze služby Table Storage, parametr -secondary . Například sekundární identifikátor URI pro operaci Entity dotazu bude podobný https://myaccount-secondary.table.core.windows.net/mytable(PartitionKey='<partition-key>',RowKey='<row-key>')
jako .
Ukázkový požadavek a odpověď
Následuje ukázkový požadavek pro Get Table Service Stats
operaci:
GET http://myaccount-secondary.table.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=
Stavový kód a hlavičky 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-Table/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>