Hämta kötjänststatistik

  • Artikel

Åtgärden Get Queue Service Stats hämtar statistik som rör replikering för Azure Queue 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 Queue 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.queue.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

I följande tabell beskrivs obligatoriska och valfria begärandehuvuden.

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 Queue 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 Det här huvudet kan användas för att felsöka begäranden och 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, i sekunder. 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 dina 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-hantering (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 som suffix i kontonamnet i den URI som du använder för att läsa från Queue Storage. En sekundär URI för åtgärden Granska meddelanden liknar till https://myaccount-secondary.queue.core.windows.net/myqueue/messages?peekonly=trueexempel .

Exempel på begäran och svar

Följande är en exempelbegäran för åtgärden Get Queue Service Stats :

GET http://myaccount-secondary.queue.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-Queue/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>

Se även

Åtgärder för kontot (kötjänst)