Získání statistik sdílení
Požadavek Get Share Stats načte statistiky, které souvisejí se sdílenou složkou. I když je toto rozhraní API plně podporované, jedná se o starší verzi rozhraní API pro správu. Z tohoto důvodu doporučujeme místo toho použít sdílené složky – Získat, které poskytuje poskytovatel prostředků úložiště (Microsoft.Storage).
Další informace o programové interakci s prostředky pomocí poskytovatele prostředků úložiště najdete v tématu Operace se sdílenými složkamiFileShare Azure Files.
Dostupnost protokolu
| Povolený protokol sdílených složek | K dispozici. |
|---|---|
| SMB |
|
| NFS |
|
Žádost
Požadavek Get Share Stats může být vytvořen následujícím způsobem. Doporučujeme použít https. Nahraďte myaccount názvem vašeho účtu úložiště a myshare nahraďte názvem vaší sdílené složky.
| Metoda | Identifikátor URI žádosti | Verze PROTOKOLU HTTP |
|---|---|---|
| GET | https://myaccount.file.core.windows.net/myshare?restype=share&comp=stats |
HTTP/1.1 |
Parametry identifikátoru URI
V identifikátoru URI požadavku je možné zadat následující další parametry:
| Parametr | Popis |
|---|---|
timeout |
Nepovinný parametr. Parametr časového limitu je vyjádřen v sekundách. Další informace najdete v tématu Nastavení časových limitů pro operace Azure Files. |
Hlavičky požadavku
Požadované a volitelné hlavičky požadavků jsou popsané v následující tabulce:
| Hlavička požadavku | Popis |
|---|---|
Authorization |
Povinná hodnota. Určuje schéma autorizace, název účtu a podpis. Další informace najdete v tématu Autorizace požadavků do služby Azure Storage. |
Date nebo x-ms-date |
Povinná hodnota. Určuje formát UTC (Coordinated Universal Time). Další informace najdete v tématu Autorizace požadavků do služby Azure Storage. |
x-ms-version |
Povinné pro všechny autorizované žádosti. Verze 2015-02-21 a novější. Určuje verzi operace, která se má použít pro tento požadavek. Další informace najdete v tématu Správa verzí pro služby Azure Storage. |
x-ms-client-request-id |
Nepovinný parametr. Poskytuje klientem vygenerovanou neprůselnou hodnotu s limitem počtu znaků 1 kibibajt (KiB), který je zaznamenán v protokolech při konfiguraci protokolování. Důrazně doporučujeme použít tuto hlavičku ke korelaci aktivit na straně klienta s požadavky, které server přijímá. Další informace najdete v tématu Monitorování Azure Files. |
x-ms-lease-id:<ID> |
Nepovinný parametr. Verze 2020-02-10 a novější. Pokud je zadána hlavička, operace se provede pouze v případě, že je zapůjčení sdílené složky aktuálně aktivní a ID zapůjčení zadané v požadavku odpovídá ID zapůjčení sdílené složky. Pokud neexistuje žádná shoda, operace selže se stavovým kódem 412 (předběžná podmínka selhala). |
Text požadavku
Žádné
Odpověď
Odpověď obsahuje stavový kód HTTP a, sadu hlaviček odpovědi a tělo odpovědi.
Stavový kód
Úspěšná operace vrátí stavový kód 200 (OK).
Informace o stavových kódech najdete v tématu Stavové kódy a kódy chyb.
Hlavičky odpovědi
Odpověď na tuto operaci obsahuje následující hlavičky. Odpověď může také obsahovat další standardní hlavičky HTTP. Všechny standardní hlavičky odpovídají specifikaci protokolu HTTP/1.1.
| Hlavička odpovědi | Description |
|---|---|
Last-Modified |
Vrátí datum a čas poslední změny sdílené složky. Formát data se řídí dokumentem RFC 1123. Další informace najdete v tématu Reprezentace hodnot data a času v záhlavích. Každá operace, která upraví sdílenou složku nebo její vlastnosti, aktualizuje čas poslední změny. Operace se soubory nemají vliv na čas poslední změny sdílené složky. |
ETag |
Obsahuje hodnotu, kterou můžete použít k podmíněnému provádění operací. Hodnota je uzavřena v uvozovkách. |
x-ms-request-id |
Jedinečně identifikuje požadavek, který byl proveden, a lze ho použít k řešení potíží s požadavkem. Další informace najdete v tématu Řešení potíží s operacemi rozhraní API. |
x-ms-version |
Označuje Azure Files verzi, která byla použita ke spuštění požadavku. |
Date |
Hodnota data a času UTC vygenerovaná službou, která označuje čas, kdy byla odpověď inicializována. |
x-ms-client-request-id |
Dá se použít k řešení potíží s požadavky a jejich odpovídajícími odpověďmi. Hodnota této hlavičky se rovná hodnotě x-ms-client-request-id hlavičky, pokud je v požadavku, a hodnota neobsahuje více než 1 024 viditelných znaků ASCII. Pokud hlavička x-ms-client-request-id v požadavku není, nebude v odpovědi. |
Text odpovědi
Text odpovědi má následující formát:
<?xml version="1.0" encoding="utf-8"?>
<ShareStats>
<ShareUsageBytes>8189134192</ShareUsageBytes>
</ShareStats>
| Element | Popis |
|---|---|
ShareUsageBytes |
Přibližná velikost dat uložených ve sdílené složce Všimněte si, že tato hodnota nemusí zahrnovat všechny nedávno vytvořené soubory nebo soubory s nedávno změněnou velikostí. |
Autorizace
Tuto operaci může volat pouze vlastník účtu.
Poznámky
Statistiky pro snímek sdílené složky nejde načíst. Pokud dojde k pokusu o načtení statistiky snímků sdílené složky, vrátí služba stavový kód 400 (neplatná hodnota parametru dotazu).
Od verze 2018-11-09 ShareUsage byl element response nahrazen ShareUsageBytesza .
ShareUsage je přibližná velikost dat uložených ve sdílené složce zaokrouhlená nahoru na nejbližší gibibajt (GiB).