Hämta statistik för tabelltjänst
Åtgärden Get Table Service Stats hämtar statistik som är relaterad till replikering för Azure Table Storage. Den är endast tillgänglig på den sekundära platsslutpunkten när geo-redundant replikering med läsbehörighet är aktiverad för lagringskontot.
Förfrågan
Begäran Get Table Service Stats kan konstrueras på följande sätt. Vi rekommenderar att du använder HTTPS. Ersätt myaccount med namnet på ditt lagringskonto och observera att det sekundära suffixet krävs:
| Metod | URI för förfrågan | HTTP-version |
|---|---|---|
| GET | https://myaccount-secondary.table.core.windows.net/?restype=service&comp=stats |
HTTP/1.1 |
Anteckning
URI:n måste alltid innehålla ett snedstreck (/) för att skilja värdnamnet från sökvägen och frågedelarna i URI:n. I den här åtgärden är sökvägsdelen av URI:n tom.
URI-parametrar
Följande ytterligare parametrar kan anges på begärande-URI:n:
| Parameter | Beskrivning |
|---|---|
Timeout |
Valfritt. Parametern timeout uttrycks i sekunder. |
Begärandehuvuden
De obligatoriska och valfria begärandehuvudena beskrivs i följande tabell:
| Begärandehuvud | Beskrivning |
|---|---|
Authorization |
Krävs. Anger auktoriseringsschema, kontonamn och signatur. Mer information finns i Auktorisera begäranden till Azure Storage. |
Date or x-ms-date |
Krävs. Anger Coordinated Universal Time (UTC) för begäran. Mer information finns i Auktorisera begäranden till Azure Storage. |
x-ms-version |
Krävs för alla auktoriserade begäranden. Anger vilken version av åtgärden som ska användas för den här begäran. Mer information finns i Versionshantering för Azure Storage-tjänsterna. |
x-ms-client-request-id |
Valfritt. Tillhandahåller ett klientgenererat, täckande värde med en teckengräns på 1 kibibyte (KiB) som registreras i loggarna när loggning har konfigurerats. Vi rekommenderar starkt att du använder det här huvudet för att korrelera aktiviteter på klientsidan med begäranden som servern tar emot. Mer information finns i [Övervaka Azure Table Storage. |
Begärandetext
Inga.
Svarsåtgärder
Svaret innehåller en HTTP-statuskod, en uppsättning svarshuvuden och en svarstext
Statuskod
En lyckad åtgärd returnerar statuskod 200 (OK). När den anropas på en sekundär platsslutpunkt som inte är aktiverad för en sekundär läsning returneras HTTP-statuskod 403 (Otillräckliga kontobehörigheter).
Svarshuvuden
Svaret för den här åtgärden innehåller följande rubriker. Svaret innehåller även ytterligare HTTP-standardhuvuden. Alla standardhuvuden överensstämmer med http/1.1-protokollspecifikationen.
| Svarsrubrik | Description |
|---|---|
x-ms-request-id |
Identifierar den begäran som gjordes unikt och kan användas för att felsöka begäran. Mer information finns i Felsöka API-åtgärder. |
x-ms-version |
Anger versionen av åtgärden som användes för svaret. Mer information finns i Versionshantering för Azure Storage-tjänsterna. |
Date |
Ett DATUM-/tidsvärde för UTC som genereras av tjänsten, vilket anger den tid då svaret initierades. |
x-ms-client-request-id |
Kan användas för att felsöka begäranden och deras motsvarande svar. Värdet för det här huvudet är lika med värdet x-ms-client-request-id för rubriken om det finns i begäran och värdet inte innehåller fler än 1 024 synliga ASCII-tecken. Om rubriken x-ms-client-request-id inte finns i begäran finns den inte i svaret. |
Själva svaret
Formatet på svarstexten är följande:
<?xml version="1.0" encoding="utf-8"?>
<StorageServiceStats>
<GeoReplication>
<Status>live|bootstrap|unavailable</Status>
<LastSyncTime>sync-time|<empty></LastSyncTime>
</GeoReplication>
</StorageServiceStats>
Elementen i svarstexten beskrivs i följande tabell:
| Svarsrubrik | Description |
|---|---|
Status |
Status för den sekundära platsen. Möjliga värden: - live: Anger att den sekundära platsen är aktiv och i drift. - bootstrap: Anger att den inledande synkroniseringen från den primära platsen till den sekundära platsen pågår. Detta inträffar vanligtvis när replikeringen först aktiveras. - ej tillgänglig: Anger att den sekundära platsen inte är tillgänglig för tillfället. |
LastSyncTime |
Ett DATUM-/tidsvärde för UTC, till det andra. Alla primära skrivningar som föregår det här värdet är garanterat tillgängliga för läsåtgärder vid den sekundära skrivningen. Primära skrivningar efter den här tidpunkten kanske eller kanske inte är tillgängliga för läsningar. Värdet kan vara tomt om LastSyncTime det inte är tillgängligt. Detta kan inträffa om replikeringsstatusen är bootstrap eller otillgänglig.Även om geo-replikering är kontinuerligt aktiverat kan LastSyncTime resultatet återspegla ett cachelagrat värde från tjänsten som uppdateras med några minuters mellanrum. |
Auktorisering
Endast kontoinnehavaren kan anropa den här åtgärden.
Kommentarer
Med geo-redundant replikering underhåller Azure Storage dina data varaktigt på två platser. På båda platserna upprätthåller Azure Storage ständigt flera felfria repliker av data.
Den plats där du läser, skapar, uppdaterar eller tar bort data är den primära lagringskontoplatsen. Den primära platsen finns i den region som du väljer när du skapar ett konto via den klassiska Azure-portalen för Azure Management (till exempel USA, norra centrala).
Platsen som dina data replikeras till är den sekundära platsen. Den sekundära platsen finns i en region som automatiskt kopplas ihop med den primära regionen. Skrivskyddad åtkomst är tillgänglig från den sekundära platsen, om geo-redundant replikering med läsbehörighet är aktiverad för ditt lagringskonto.
Mer information om geo-redundant replikering med läsbehörighet finns i Dataredundans.
Om du vill skapa en begäran om en läsåtgärd mot den sekundära slutpunkten lägger du till -secondary till kontonamnet i den URI som du använder för att läsa från Table Storage. En sekundär URI för åtgärden Frågeentiteter liknar till https://myaccount-secondary.table.core.windows.net/mytable(PartitionKey='<partition-key>',RowKey='<row-key>')exempel .
Exempel på begäran och svar
Följande är en exempelbegäran för åtgärden Get Table Service Stats :
GET http://myaccount-secondary.table.core.windows.net/?restype=service&comp=stats HTTP/1.1
Begäran skickas med följande rubriker:
x-ms-version: 2013-08-15
x-ms-date: Wed, 23 Oct 2013 22:08:44 GMT
Authorization: SharedKey myaccount:CY1OP3O3jGFpYFbTCBimLn0Xov0vt0khH/E5Gy0fXvg=
Statuskoden och svarshuvudena returneras på följande sätt:
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
Svaret innehåller följande XML-brödtext:
<?xml version="1.0" encoding="utf-8"?>
<StorageServiceStats>
<GeoReplication>
<Status>live</Status>
<LastSyncTime> Wed, 23 Oct 2013 22:05:54 GMT</LastSyncTime>
</GeoReplication>
</StorageServiceStats>