Pobieranie statystyk usługi Table Service
Operacja Get Table Service Stats pobiera statystyki powiązane z replikacją dla usługi Azure Table Storage. Jest ona dostępna tylko w punkcie końcowym lokalizacji pomocniczej, gdy dla konta magazynu jest włączona replikacja geograficznie nadmiarowa dostępu do odczytu.
Żądanie
Żądanie Get Table Service Stats może być skonstruowane w następujący sposób. Zalecamy korzystanie z 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.table.core.windows.net/?restype=service&comp=stats |
HTTP/1.1 |
Uwaga
Identyfikator URI musi zawsze zawierać znak ukośnika (/), aby oddzielić nazwę hosta od części ścieżki i zapytania identyfikatora URI. W tej operacji część ścieżki identyfikatora URI jest pusta.
Parametry identyfikatora URI
Dla identyfikatora 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ń
Wymagane i opcjonalne nagłówki żądań zostały opisane w poniższej tabeli:
| 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 dla usług Azure Storage. |
x-ms-client-request-id |
Opcjonalny. Zapewnia nieprzezroczystą wartość wygenerowaną przez klienta z limitem znaków 1-kibibyte (KiB) rejestrowanym 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 Table Storage. |
Treść żądania
Brak.
Reakcja
Odpowiedź zawiera kod stanu HTTP, zestaw nagłówków odpowiedzi i treść odpowiedzi
Kod stanu
Pomyślna operacja zwraca kod stanu 200 (OK). Po wywołaniu punktu końcowego lokalizacji pomocniczej, który nie jest włączony dla odczytu pomocniczego, 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 standardowe nagłówki są zgodne ze specyfikacją protokołu HTTP/1.1.
| Nagłówek odpowiedzi | Opis |
|---|---|
x-ms-request-id |
Unikatowo 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 dla usług Azure Storage. |
Date |
Wartość daty/godziny UTC wygenerowana przez usługę, która wskazuje godzinę zainicjowania odpowiedzi. |
x-ms-client-request-id |
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 jest obecna w żądaniu, a wartość zawiera nie więcej niż 1024 widoczne znaki ASCII.
x-ms-client-request-id Jeśli nagłówek nie znajduje się 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 działa. - bootstrap: wskazuje, że początkowa synchronizacja z lokalizacji podstawowej do lokalizacji pomocniczej jest w toku. Zwykle występuje to, gdy replikacja jest włączona po raz pierwszy. - niedostępne: wskazuje, że lokalizacja pomocnicza jest tymczasowo niedostępna. |
LastSyncTime |
Wartość daty/godziny UTC do sekundy. Wszystkie podstawowe zapisy, które poprzedzają tę wartość, muszą być dostępne dla operacji odczytu w pomocniczym zapisie. Zapisy podstawowe 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ę tak zdarzyć, jeśli stan replikacji to bootstrap lub niedostępny.Mimo że replikacja geograficzna jest stale włączona, LastSyncTime wynik może odzwierciedlać buforowaną wartość z usługi, która jest odświeżona 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 utrzymuje dane trwale 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 wybranym regionie 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 automatycznie sparowanym geograficznie z regionem podstawowym. Dostęp tylko do odczytu jest dostępny z lokalizacji pomocniczej, jeśli dla konta magazynu włączono replikację geograficznie nadmiarową z dostępem do odczytu .
Aby uzyskać więcej informacji na temat replikacji geograficznie nadmiarowej z dostępem do odczytu, zobacz Nadmiarowość danych.
Aby skonstruować żądanie operacji odczytu względem pomocniczego punktu końcowego, dołącz parametr -secondary do nazwy konta w identyfikatorze URI używanym do odczytu z usługi Table Storage. Na przykład pomocniczy identyfikator URI dla operacji Jednostki zapytania będzie podobny do https://myaccount-secondary.table.core.windows.net/mytable(PartitionKey='<partition-key>',RowKey='<row-key>').
Przykładowe żądanie i odpowiedź
Poniżej przedstawiono przykładowe żądanie dla Get Table Service Stats operacji:
GET http://myaccount-secondary.table.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-Table/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>