Uzyskiwanie statystyk usługi Table Service

Operacja Get Table Service Stats pobiera statystyki związane z replikacją dla usługi Table Service. Jest ona dostępna tylko w punkcie końcowym lokalizacji pomocniczej, gdy dla konta magazynu jest włączona replikacja geograficznie nadmiarowa z dostępem do odczytu.

Żądanie

Żądanie Get Table Service Stats może zostać skonstruowane w następujący sposób. Protokół HTTPS jest zalecany. Zastąp nazwą konta magazynu i zwróć myaccount 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

Należy pamiętać, że w celu oddzielenia nazwy hosta od ścieżki i części adresu URI zapytania należy zawsze uwzględnić ukośnik (/). W przypadku tej operacji część ścieżki w uri jest pusta.

Parametry identyfikatora URI

W żądaniu URI można określić następujące dodatkowe parametry.

Parametr Opis
Timeout Opcjonalny. Parametr timeout jest wyrażony 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 Versioning for the Azure Storage services(Wersje usług Azure Storage Services).
x-ms-client-request-id Opcjonalny. Wygenerowana przez klienta nieprzezroczysta wartość z limitem znaków 1 KB, która jest rejestrowana w dziennikach analizy, gdy Storage rejestrowanie analityczne jest włączone. Użycie tego nagłówka jest zdecydowanie zalecane w przypadku korelowania działań po stronie klienta z żądaniami odebranych przez serwer. Aby uzyskać więcej informacji, zobacz Azure Logging: Using Logs to Track Storage Requests (Rejestrowanie na platformie Azure: używaniedzienników do śledzenia Storage żądań).

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). W przypadku wywoływania w punkcie końcowym lokalizacji pomocniczej, który nie jest włączony dla odczytu pomocniczego, zwracany jest kod stanu Http 403 z InsufficientAccountPermissions błędem.

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 Ten nagłówek unikatowo identyfikuje żądanie, które zostało wykonane, i może służyć do rozwiązywania problemów z żądaniem. Aby uzyskać więcej informacji, zobacz Troubleshooting API Operations (Rozwiązywanie problemów z operacjami interfejsu API).
x-ms-version Określa wersję operacji używanej dla odpowiedzi. Aby uzyskać więcej informacji, zobacz Versioning for the Azure Storage services(Wersje usług Azure Storage Services).
Date Wartość daty/czasu UTC wygenerowana przez usługę, która wskazuje czas, o której została zainicjowana odpowiedź.
x-ms-client-request-id Ten nagłówek może służyć do rozwiązywania problemów z żądaniami i odpowiadającymi odpowiedziami. Wartość tego nagłówka jest równa wartości nagłówka, jeśli jest obecny w żądaniu, a wartość jest co najwyżej 1024 widocznych znaków x-ms-client-request-id ASCII. Jeśli nagłówek x-ms-client-request-id nie jest obecny w żądaniu, ten nagłówek nie będzie obecny w odpowiedzi.

Treść odpowiedzi

Treść odpowiedzi ma następujący format:

<?xml version="1.0" encoding="utf-8"?>  
<StorageServiceStats>  
  <GeoReplication>        
      <Status>live|bootstrap|unavailable</Status>  
      <LastSyncTime>sync-time|<empty></LastSyncTime>  
  </GeoReplication>  
</StorageServiceStats>  

W poniższej tabeli opisano elementy treści odpowiedzi:

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 synchronizacja początkowa z lokalizacji podstawowej do lokalizacji pomocniczej. Zwykle dzieje się tak, gdy replikacja jest włączona po raz pierwszy.
- niedostępne: wskazuje, że lokalizacja pomocnicza jest tymczasowo niedostępna.
LastSyncTime Wartość daty/godziny GMT na sekundę. Gwarantuje się, że wszystkie podstawowe operacje zapisu poprzedzające tę wartość będą dostępne dla operacji odczytu w pomocniczym miejscu. Podstawowe zapisu po tym punkcie w czasie mogą być lub nie być dostępne dla odczytów.

Wartość może być pusta, jeśli LastSyncTime nie jest dostępna. Taka możliwość może wystąpić, jeśli stan replikacji to bootstrap lub unavailable .

Mimo że replikacja geograficzna jest stale włączona, wynik może odzwierciedlać buforowane wartości z usługi, które LastSyncTime są odświeżane 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 trwałe dane w dwóch lokalizacjach. W obu lokalizacjach usługa Azure Storage stale utrzymuje wiele replik danych w dobrej kondycji.

Lokalizacja, w której odczytujesz, tworzysz, aktualizujesz lub usuwasz dane, jest lokalizacją podstawowego konta magazynu. Lokalizacja podstawowa istnieje w regionie, który wybierzesz podczas tworzenia konta za pośrednictwem klasycznego portalu Azure Zarządzania Azure, na przykład Północno-środkowe usa. Lokalizacja, do której są replikowane dane, jest lokalizacją pomocniczą. Lokalizacja pomocnicza znajduje się w regionie, który jest automatycznie geograficznie sparowany 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 do odczytu. Aby uzyskać więcej informacji na temat replikacji geograficznie nadmiarowej dostępnej do odczytu, zobacz blog zespołu usługi Azure Storage Team.

Aby skonstruować żądanie operacji odczytu względem pomocniczego punktu końcowego, dołącz jako sufiks do nazwy konta w adresie URI, który będzie odczytywany z -secondary usługi Table Storage. Na przykład pomocniczy 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 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>  

Zobacz też

Operacje na koncie (usługa Tabel)