Pobieranie statystyk usługi kolejki
Operacja Get Queue Service Stats pobiera statystyki związane z replikacją dla usługi Azure Queue Storage. Jest ona dostępna tylko w punkcie końcowym lokalizacji dodatkowej, gdy dla konta magazynu jest włączona replikacja geograficznie nadmiarowa dostępu do odczytu.
Żądanie
Żądanie Get Queue Service Stats można skonstruować w następujący sposób. Zalecamy używanie protokołu HTTPS. Zastąp ciąg myaccount nazwą konta magazynu i zwróć uwagę, że sufiks -secondary jest wymagany:
| Metoda | Identyfikator URI żądania | Wersja PROTOKOŁU HTTP |
|---|---|---|
| GET | https://myaccount-secondary.queue.core.windows.net/?restype=service&comp=stats |
HTTP/1.1 |
Uwaga
Identyfikator URI musi zawsze zawierać znak ukośnika (/), aby oddzielić nazwę hosta od ścieżki i fragmentów zapytania identyfikatora URI. W tej operacji część ścieżki identyfikatora URI jest pusta.
Parametry identyfikatora URI
W identyfikatorze URI żądania można określić następujące dodatkowe parametry:
| Parametr | Opis |
|---|---|
Timeout |
Opcjonalny. Parametr jest wyrażony timeout w sekundach. |
Nagłówki żądań
W poniższej tabeli opisano wymagane i opcjonalne nagłówki żądań.
| Nagłówek żądania | Opis |
|---|---|
Authorization |
Wymagane. Określa schemat autoryzacji, nazwę konta i podpis. Aby uzyskać więcej informacji, zobacz Autoryzowanie żądań do usługi Azure Storage. |
Date or x-ms-date |
Wymagane. Określa dla żądania godzinę w formacie uniwersalnego czasu koordynowanego (UTC). Aby uzyskać więcej informacji, zobacz Autoryzowanie żądań do usługi Azure Storage. |
x-ms-version |
Wymagane dla wszystkich autoryzowanych żądań. Określa wersję operacji do użycia dla tego żądania. Aby uzyskać więcej informacji, zobacz Przechowywanie wersji usług Azure Storage. |
x-ms-client-request-id |
Opcjonalny. Udostępnia nieprzezroczystą wartość wygenerowaną przez klienta z limitem znaków 1-kibibyte (KiB), który jest rejestrowany w dziennikach podczas konfigurowania rejestrowania. Zdecydowanie zalecamy używanie tego nagłówka do korelowania działań po stronie klienta z żądaniami odbieranymi przez serwer. Aby uzyskać więcej informacji, zobacz Monitorowanie usługi Azure Queue Storage. |
Treść żądania
Brak.
Reakcja
Odpowiedź zawiera kod stanu HTTP, zestaw nagłówków odpowiedzi i treść odpowiedzi.
Kod stanu
Operacja zakończona powodzeniem zwraca kod stanu 200 (OK). Po wywołaniu punktu końcowego lokalizacji pomocniczej, który nie jest włączony dla pomocniczego odczytu, zwraca kod stanu HTTP 403 (Niewystarczające uprawnienia konta).
Nagłówki odpowiedzi
Odpowiedź na tę operację zawiera następujące nagłówki. Odpowiedź zawiera również dodatkowe standardowe nagłówki HTTP. Wszystkie nagłówki standardowe są zgodne ze specyfikacją protokołu HTTP/1.1.
| Nagłówek odpowiedzi | Opis |
|---|---|
x-ms-request-id |
Jednoznacznie identyfikuje wykonane żądanie i może służyć do rozwiązywania problemów z żądaniem. Aby uzyskać więcej informacji, zobacz Rozwiązywanie problemów z operacjami interfejsu API. |
x-ms-version |
Określa wersję operacji, która została użyta dla odpowiedzi. Aby uzyskać więcej informacji, zobacz Przechowywanie wersji usług Azure Storage. |
Date |
Wartość daty/godziny UTC wygenerowana przez usługę, która wskazuje godzinę zainicjowania odpowiedzi. |
x-ms-client-request-id |
Ten nagłówek może służyć do rozwiązywania problemów z żądaniami i odpowiadającymi im odpowiedziami. Wartość tego nagłówka jest równa wartości x-ms-client-request-id nagłówka, jeśli znajduje się w żądaniu, a wartość nie zawiera więcej niż 1024 widocznych znaków ASCII.
x-ms-client-request-id Jeśli nagłówek nie jest obecny w żądaniu, nie będzie on obecny w odpowiedzi. |
Treść odpowiedzi
Format treści odpowiedzi jest następujący:
<?xml version="1.0" encoding="utf-8"?>
<StorageServiceStats>
<GeoReplication>
<Status>live|bootstrap|unavailable</Status>
<LastSyncTime>sync-time|<empty></LastSyncTime>
</GeoReplication>
</StorageServiceStats>
Elementy treści odpowiedzi opisano w poniższej tabeli:
| Nagłówek odpowiedzi | Opis |
|---|---|
Status |
Stan lokalizacji pomocniczej. Możliwe wartości: - live: wskazuje, że lokalizacja pomocnicza jest aktywna i operacyjna. - bootstrap: wskazuje, że trwa początkowa synchronizacja z lokalizacji podstawowej do lokalizacji pomocniczej. Zwykle występuje to, gdy replikacja jest najpierw włączona. - niedostępne: wskazuje, że lokalizacja pomocnicza jest tymczasowo niedostępna. |
LastSyncTime |
Wartość daty/godziny UTC w sekundach. Wszystkie podstawowe zapisy, które poprzedzają tę wartość, mają gwarancję, że będą dostępne dla operacji odczytu w pomocniczym zapisie. Operacje zapisu podstawowego po tym punkcie w czasie mogą być dostępne dla operacji odczytu lub mogą nie być dostępne. Wartość może być pusta, jeśli LastSyncTime jest niedostępna. Może się to zdarzyć, jeśli stan replikacji to bootstrap lub niedostępny.Mimo że replikacja geograficzna jest stale włączona, LastSyncTime wynik może odzwierciedlać wartość buforowaną z usługi odświeżonej co kilka minut. |
Autoryzacja
Tylko właściciel konta może wywołać tę operację.
Uwagi
Dzięki replikacji geograficznie nadmiarowej usługa Azure Storage zapewnia trwałość danych w dwóch lokalizacjach. W obu lokalizacjach usługa Azure Storage stale utrzymuje wiele replik w dobrej kondycji danych.
Lokalizacja, w której odczytujesz, utworzysz, zaktualizujesz lub usuniesz dane, jest podstawową lokalizacją konta magazynu. Lokalizacja podstawowa istnieje w regionie wybranym podczas tworzenia konta za pośrednictwem klasycznego portalu Azure Management (na przykład Północno-środkowe stany USA).
Lokalizacja, do której są replikowane dane, to lokalizacja pomocnicza . Lokalizacja pomocnicza znajduje się w regionie, który jest automatycznie sparowany geograficznie z regionem podstawowym. Dostęp tylko do odczytu jest dostępny z lokalizacji pomocniczej, jeśli dla konta magazynu jest włączona replikacja geograficznie nadmiarowa dostępu do odczytu .
Aby uzyskać więcej informacji na temat replikacji geograficznie nadmiarowej dostępu do odczytu, zobacz Nadmiarowość danych.
Aby utworzyć żądanie operacji odczytu względem pomocniczego punktu końcowego, dołącz -secondary jako sufiks do nazwy konta w identyfikatorze URI używanym do odczytu z usługi Queue Storage. Na przykład pomocniczy identyfikator URI operacji Peek Messages jest podobny do https://myaccount-secondary.queue.core.windows.net/myqueue/messages?peekonly=true.
Przykładowe żądanie i odpowiedź
Poniżej przedstawiono przykładowe żądanie operacji Get Queue Service Stats :
GET http://myaccount-secondary.queue.core.windows.net/?restype=service&comp=stats HTTP/1.1
Żądanie jest wysyłane z następującymi nagłówkami:
x-ms-version: 2013-08-15
x-ms-date: Wed, 23 Oct 2013 22:08:44 GMT
Authorization: SharedKey myaccount:CY1OP3O3jGFpYFbTCBimLn0Xov0vt0khH/E5Gy0fXvg=
Kod stanu i nagłówki odpowiedzi są zwracane w następujący sposób:
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
Odpowiedź zawiera następującą treść 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>