Pobieranie statystyk usługi Blob Service

  • Artykuł

Operacja Get Blob Service Stats pobiera statystyki związane z replikacją dla Azure Blob Storage. Operacja jest dostępna tylko w punkcie końcowym lokalizacji dodatkowej, gdy jest włączona replikacja geograficznie nadmiarowa dostępu do odczytu dla konta magazynu.

Żądanie

Żądanie można skonstruować Get Blob Service Stats w następujący sposób. Zalecamy używanie protokołu HTTPS. Zastąp myaccount ciąg nazwą konta magazynu i zwróć uwagę, że -secondary sufiks jest wymagany:

Metoda Identyfikator URI żądania Wersja PROTOKOŁU HTTP
GET https://myaccount-secondary.blob.core.windows.net/?restype=service&comp=stats HTTP/1.1

Uwaga

Identyfikator URI musi zawsze zawierać ukośnik (/), aby oddzielić nazwę hosta od części ścieżki i zapytania. W przypadku 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 Azure Blob 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). Gdy operacja jest wywoływana w punkcie końcowym lokalizacji pomocniczej, który nie jest włączony dla pomocniczego odczytu, zwraca kod stanu HTTP 403 z błędem InsufficientAccountPermissions .

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 Unikatowo identyfikuje wykonane żądanie i można go 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 używanej 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 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 przekracza 1024 widocznych znaków ASCII. x-ms-client-request-id Jeśli nagłówek nie znajduje się w żądaniu, ten nagłówek nie jest 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 początkowa synchronizacja z lokalizacji podstawowej do lokalizacji pomocniczej jest w toku. Zwykle występuje to, gdy replikacja jest najpierw włączona.
- niedostępne: wskazuje, że lokalizacja pomocnicza jest tymczasowo niedostępna.
LastSyncTime Wartość daty/godziny GMT na drugą. Wszystkie podstawowe zapisy, które poprzedzają tę wartość, mają gwarancję, że będą dostępne dla operacji odczytu w pomocniczej lokalizacji. 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 unavailable.

Mimo że replikacja geograficzna jest stale włączona, LastSyncTime wynik może odzwierciedlać wartość buforowaną z usługi, która jest odświeżona co kilka minut.

Autoryzacja

Autoryzacja jest wymagana podczas wywoływania dowolnej operacji dostępu do danych w usłudze Azure Storage. Możesz autoryzować operację zgodnie z Get Blob Service Stats poniższym opisem.

Usługa Azure Storage obsługuje używanie Tożsamość Microsoft Entra do autoryzacji żądań do danych obiektów blob. Za pomocą Tożsamość Microsoft Entra możesz użyć kontroli dostępu opartej na rolach (RBAC) platformy Azure, aby udzielić uprawnień podmiotowi zabezpieczeń. Podmiot zabezpieczeń może być użytkownikiem, grupą, jednostką usługi aplikacji lub tożsamością zarządzaną platformy Azure. Podmiot zabezpieczeń jest uwierzytelniany przez Tożsamość Microsoft Entra w celu zwrócenia tokenu OAuth 2.0. Token może następnie służyć do autoryzowania żądania względem usługi Blob Service.

Aby dowiedzieć się więcej na temat autoryzacji przy użyciu Tożsamość Microsoft Entra, zobacz Autoryzowanie dostępu do obiektów blob przy użyciu Tożsamość Microsoft Entra.

Uprawnienia

Poniżej wymieniono akcję RBAC niezbędną do wywołania Get Blob Service Stats operacji przez użytkownika, grupę lub jednostkę usługi Microsoft Entra oraz najmniej uprzywilejowaną wbudowaną rolę RBAC platformy Azure, która obejmuje tę akcję:

Aby dowiedzieć się więcej na temat przypisywania ról przy użyciu kontroli dostępu opartej na rolach platformy Azure, zobacz Przypisywanie roli platformy Azure w celu uzyskania dostępu do danych obiektów blob.

Uwagi

Dzięki replikacji geograficznie nadmiarowej usługa Azure Storage zapewnia trwałość danych w dwóch lokalizacjach, które są od siebie setki kilometrów. W obu lokalizacjach usługa Azure Storage stale utrzymuje wiele replik w dobrej kondycji danych.

Para geograficznie nadmiarowa obejmuje następujące elementy:

  • Lokalizacja podstawowa: lokalizacja, w której odczytujesz, utworzysz, zaktualizujesz lub usuniesz dane. Lokalizacja podstawowa istnieje w regionie wybranym podczas tworzenia konta za pośrednictwem klasycznego portalu Azure (na przykład północno-środkowe stany USA).

  • Lokalizacja pomocnicza : lokalizacja, do której są replikowane dane. 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.

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, 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 do nazwy konta w identyfikatorze URI używanym do odczytu z usługi Blob Storage. Na przykład pomocniczy identyfikator URI operacji Get Blob będzie podobny do https://myaccount-secondary.blob.core.windows.net/mycontainer/myblob.

Rozliczenia

Żądania cenowe mogą pochodzić od klientów korzystających z interfejsów API usługi Blob Storage bezpośrednio za pośrednictwem interfejsu API REST usługi Blob Storage lub biblioteki klienta usługi Azure Storage. Te żądania naliczają opłaty za transakcję. Typ transakcji wpływa na sposób naliczania opłat za konto. Na przykład transakcje odczytu są naliczane do innej kategorii rozliczeniowej niż transakcje zapisu. W poniższej tabeli przedstawiono kategorię rozliczeń dla Get Blob Service Stats żądań na podstawie typu konta magazynu:

Operacja Typ konta magazynu Kategoria rozliczeń
Pobieranie statystyk usługi Blob Service Blokowy obiekt blob w warstwie Premium
Standardowa ogólnego przeznaczenia, wersja 2		 Inne operacje
Pobieranie statystyk usługi Blob Service Standardowa ogólnego przeznaczenia, wersja 1 Operacje odczytu

Aby dowiedzieć się więcej o cenach dla określonej kategorii rozliczeń, zobacz Azure Blob Storage Cennik.

Przykładowe żądanie i odpowiedź

Oto przykładowe żądanie operacji Get Blob Service Stats :

GET http://myaccount-secondary.blob.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-Blob/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 (Blob Storage)