Získání vlastností sdílené složky
Požadavek Get Share Properties
vrátí vlastnosti pro zadanou sdílenou složku nebo snímek sdílené složky.
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ýmiFileShare
složkami.
Dostupnost protokolu
Povolený protokol sdílených složek | K dispozici. |
---|---|
SMB | |
NFS |
Žádost
Požadavek Get Share Properties
může být vytvořen následujícím způsobem. Doporučujeme použít https.
Metoda | Identifikátor URI žádosti | Verze PROTOKOLU HTTP |
---|---|---|
GET/HEAD |
https://myaccount.file.core.windows.net/myshare?restype=share |
HTTP/1.1 |
GET/HEAD |
https://myaccount.file.core.windows.net/myshare?restype=share&sharesnapshot=<DateTime> |
HTTP/1.1 |
Následujícím způsobem nahraďte komponenty cesty uvedené v identifikátoru URI požadavku vlastními:
Komponenta Cesta | Description |
---|---|
myaccount |
Název vašeho účtu úložiště. |
myshare |
Název sdílené složky. |
Informace o omezeních pojmenování cest najdete v tématu Názvy a odkazy na sdílené složky, adresáře, soubory a metadata.
Parametry identifikátoru URI
V identifikátoru URI požadavku je možné zadat následující další parametry:
Parametr | Popis |
---|---|
sharesnapshot |
Nepovinný parametr. Verze 2017-04-17 a novější. Parametr sharesnapshot je neprůselná hodnota data a času, která pokud je k dispozici, určuje snímek sdílené složky, na který se má dotazovat za účelem načtení vlastností. |
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 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. 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.
Stavový kód
Úspěšná operace vrátí stavový kód 200 (OK).
Další 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 Date-Time 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. |
x-ms-meta-name:value |
Sada párů název-hodnota, které obsahují uživatelem definovaná metadata 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 |
Verze Azure Files, která se použila 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-share-quota |
Verze 2015-02-21 a novější. Vrátí aktuální kvótu sdílených složek v gibibajtech (GiB). |
x-ms-share-provisioned-iops |
Verze 2019-07-07 a novější. Vráceno pouze pro sdílené složky úrovně Premium (sdílené složky v rámci typu účtu úložiště FileStorage). Vrátí počet vstupně-výstupních operací za sekundu (IOPS), jak je zřízený pro podíl na úrovni premium. |
x-ms-share-provisioned-ingress-mbps |
Verze 2019-07-07 a novější. Vráceno pouze pro sdílené složky úrovně Premium (sdílené složky v rámci typu účtu úložiště FileStorage). Vrátí příchozí přenos dat v mebibajtech za sekundu (MiB/s), jak je zřízeno pro podíl na úrovni premium. |
x-ms-share-provisioned-egress-mbps |
Verze 2019-07-07 a novější. Vráceno pouze pro sdílené složky úrovně Premium (sdílené složky v rámci typu účtu úložiště FileStorage). Vrátí výchozí hodnotu v MiB/s, jak je zajištěna pro podíl na úrovni premium. |
x-ms-share-provisioned-bandwidth-mibps |
Verze 2021-02-12 a novější. Vráceno pouze pro sdílené složky úrovně Premium (sdílené složky v rámci typu účtu úložiště FileStorage). Vrátí kombinovanou šířku pásma (příchozí přenos a výchozí přenos dat) v MiB/s, jak je zřízena pro podíl na úrovni premium. |
x-ms-share-next-allowed-quota-downgrade-time |
Verze 2019-07-07 a novější. Vráceno pouze pro sdílené složky úrovně Premium (sdílené složky v rámci účtu FileStorage storage typu). Hodnota data a času, která určuje, kdy je povoleno snížit kvótu pro sdílenou složku úrovně Premium. Formát data odpovídá dokumentu RFC 1123. |
x-ms-access-tier |
Verze 2019-12-12 a novější. Vrátí aktuální úroveň přístupu sdílené složky. V účtech TransationOptimized úložiště pro obecné účely verze 2 (GPv2) je výchozí úroveň sdílené složky. V části FileStorage storage account types (Typ Premium účtu úložiště) je výchozí úroveň sdílené složky. |
x-ms-access-tier-change-time |
Verze 2019-12-12 a novější. Vrátí datum a čas poslední změny úrovně přístupu ve sdílené složce. |
x-ms-access-tier-transition-state |
Verze 2019-12-12 a novější. Pokud sdílená složka prochází přechodem vrstev, tato hlavička označuje vrstvu, ze které přechází. |
x-ms-lease-duration:<fixed,infinite> |
Verze 2020-02-10 a novější. Určuje, jestli má zapůjčení sdílené složky neomezenou nebo pevnou dobu trvání. |
x-ms-lease-state: <available;leased;expired;breaking;broken> |
Verze 2020-02-10 a novější. Při zapůjčení sdílené složky určuje tato hlavička stav zapůjčení sdílené složky. |
x-ms-lease-status: <locked;unlocked> |
Verze 2020-02-10 a novější. Při zapůjčení sdílené složky určuje tato hlavička stav zapůjčení sdílené složky. |
x-ms-enabled-protocols: <SMB;NFS> |
Vrátí aktuální protokoly s povolenými sdílenými složkami pro verzi 2019-07-07 a novější. - SMB : Sdílená složka je přístupná přes SMBv3.0, SMBv2.1 a REST.- NFS : Ke sdílené složce má přístup NFSv4.1. |
x-ms-root-squash: <NoRootSquash;RootSquash;AllSquash> |
Vrátí aktuální chování omezení kořenové složky pro verzi 2019-07-07 a novější. Pouze systém souborů NFS. - NoRootSquash : Root squashing je vypnutý.- RootSquash : Požadavky z UID/GID 0 se mapují na anonymní UID/GID.- AllSquash : Všechny identifikátory UID a GID se mapují na anonymního uživatele. |
x-ms-client-request-id |
Dá se použít k řešení potíží s požadavky a odpovídajícími odpověďmi. Hodnota této hlavičky se rovná hodnotě x-ms-client-request-id hlavičky, pokud se nachází v požadavku, a hodnota obsahuje maximálně 1 024 viditelných znaků ASCII. Pokud se hlavička x-ms-client-request-id v požadavku nenachází, v odpovědi se nezobrazí. |
Text odpovědi
Žádné
Ukázková odpověď
Response Status:
HTTP/1.1 200 OK
Response Headers:
Transfer-Encoding: chunked
x-ms-meta-name: some_metadata
Date: <date>
ETag: "0x8CB171DBEAD6A6B"
Last-Modified: <date>
x-ms-share-quota: 1024
x-ms-access-tier: Premium
x-ms-version: 2020-02-10
x-ms-enabled-protocols: NFS
x-ms-root-squash: RootSquash
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0
Autorizace
Tuto operaci může volat pouze vlastník účtu.
Poznámky
Žádné