Sdílet prostřednictvím


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 Ano
NFS Ano

Žá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).

Viz také

Operace se sdílenými složkami Azure