Pobieranie statystyk udziału
Żądanie Get Share Stats pobiera statystyki powiązane z udziałem. Mimo że ten interfejs API jest w pełni obsługiwany, jest to starszy interfejs API zarządzania. Z tego powodu zalecamy użycie udziałów plików — Pobierz, który jest dostarczany przez dostawcę zasobów magazynu (Microsoft.Storage), zamiast tego.
Aby dowiedzieć się więcej o programowej interakcji z FileShare zasobami przy użyciu dostawcy zasobów magazynu, zobacz Operacje na udziałach Azure Files.
Dostępność protokołu
| Włączony protokół udziału plików | Dostępne |
|---|---|
| SMB |
|
| NFS |
|
Żądanie
Żądanie Get Share 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 zastąp ciąg myshare nazwą udziału.
| Metoda | Identyfikator URI żądania | Wersja PROTOKOŁU HTTP |
|---|---|---|
| GET | https://myaccount.file.core.windows.net/myshare?restype=share&comp=stats |
HTTP/1.1 |
Parametry identyfikatora URI
W identyfikatorze URI żądania można określić następujące dodatkowe parametry:
| Parametr | Opis |
|---|---|
timeout |
Opcjonalny. Parametr limitu czasu jest wyrażony w sekundach. Aby uzyskać więcej informacji, zobacz Ustawianie limitów czasu dla operacji Azure Files. |
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 lub 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ń. Wersja 2015-02-21 lub nowsza. 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 Azure Files. |
x-ms-lease-id:<ID> |
Opcjonalny. Wersja 2020-02-10 lub nowsza. Jeśli nagłówek jest określony, operacja jest wykonywana tylko wtedy, gdy dzierżawa udziału plików jest obecnie aktywna, a identyfikator dzierżawy określony w żądaniu jest zgodny z identyfikatorem dzierżawy udziału plików. Jeśli nie ma dopasowania, operacja zakończy się niepowodzeniem z kodem stanu 412 (Niepowodzenie warunku wstępnego). |
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).
Aby uzyskać informacje o kodach stanu, zobacz Kody stanu i błędów.
Nagłówki odpowiedzi
Odpowiedź na tę operację zawiera następujące nagłówki. Odpowiedź może również zawierać dodatkowe standardowe nagłówki HTTP. Wszystkie standardowe nagłówki są zgodne ze specyfikacją protokołu HTTP/1.1.
| Nagłówek odpowiedzi | Opis |
|---|---|
Last-Modified |
Zwraca datę i godzinę ostatniej modyfikacji udziału. Format daty jest zgodny z dokumentem RFC 1123. Aby uzyskać więcej informacji, zobacz Reprezentacja wartości daty/godziny w nagłówkach. Każda operacja modyfikując udział lub jego właściwości aktualizuje czas ostatniej modyfikacji. Operacje na plikach nie mają wpływu na czas ostatniej modyfikacji udziału. |
ETag |
Zawiera wartość, której można użyć do warunkowego wykonywania operacji. Wartość jest ujęta w znaki cudzysłowu. |
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 |
Wskazuje Azure Files wersję, która została użyta do wykonania żądania. |
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"?>
<ShareStats>
<ShareUsageBytes>8189134192</ShareUsageBytes>
</ShareStats>
| Element | Opis |
|---|---|
ShareUsageBytes |
Przybliżony rozmiar danych przechowywanych w udziale. Pamiętaj, że ta wartość może nie zawierać wszystkich ostatnio utworzonych lub ostatnio zmienionych plików. |
Autoryzacja
Tylko właściciel konta może wywołać tę operację.
Uwagi
Nie można pobrać statystyk migawki udziału. Jeśli zostanie podjęta próba pobrania statystyk migawki udziału, usługa zwróci kod stanu 400 (nieprawidłowa wartość parametru zapytania).
Od wersji 2018-11-09 ShareUsage element odpowiedzi został zastąpiony ciągiem ShareUsageBytes.
ShareUsage jest przybliżonym rozmiarem danych przechowywanych w udziale, zaokrąglonym w górę do najbliższego gibibajta (GiB).