Získání vlastností adresáře
Operace Get Directory Properties vrátí všechny systémové vlastnosti zadaného adresáře a dá se také použít ke kontrole existence adresáře. Vrácená data neobsahují soubory v adresáři ani žádné podadresáře.
Dostupnost protokolu
| Povolený protokol sdílených složek | K dispozici. |
|---|---|
| SMB |
|
| NFS |
|
Žádost
Požadavek Get Directory 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/myparentdirectorypath/mydirectory?restype=directory |
HTTP/1.1 |
GET/HEAD |
https://myaccount.file.core.windows.net/myshare/ myparentdirectorypath/mydirectory?restype=directory&sharesnapshot=<DateTime> |
HTTP/1.1 |
Následujícím způsobem nahraďte komponenty cesty, které jsou 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. |
myparentdirectorypath |
Nepovinný parametr. Cesta k nadřazené adresáři. |
mydirectory |
Název adresáře. |
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 DateTime, která pokud je k dispozici, určuje snímek sdílené složky, který se má dotazovat na vlastnosti adresáře. |
timeout |
Nepovinný parametr. Parametr timeout 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, volitelné pro anonymní žá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-file-request-intent |
Vyžaduje se, pokud Authorization hlavička určuje token OAuth. Přijatelná hodnota je backup. Tato hlavička určuje, že Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action by se měly udělit nebo Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action , pokud jsou zahrnuté v zásadách RBAC přiřazených k identitě, která je autorizována pomocí hlavičky Authorization . K dispozici pro verzi 2022-11-02 a novější. |
x-ms-allow-trailing-dot: { <Boolean> } |
Nepovinný parametr. Verze 2022-11-02 a novější. Logická hodnota určuje, jestli se má v adrese URL požadavku oříznout koncová tečka, nebo ne. Další informace najdete v tématu Pojmenování sdílených složek, adresářů, souborů a metadat a odkazování na nich. |
Text požadavku
Žádné
Ukázkový požadavek
HEAD https://myaccount.file.core.windows.net/myshare/myparentdirectorypath/mydirectory?restype=directory HTTP/1.1
Request Headers:
x-ms-version: 2015-02-21
x-ms-date: <date>
Authorization: SharedKey myaccount:Z5043vY9MesKNh0PNtksNc9nbXSSqGHueE00JdjidOQ=
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 |
|---|---|
ETag |
Značka ETag obsahuje hodnotu, kterou můžete použít k podmíněnému provádění operací. Hodnota je uzavřena v uvozovkách. |
Last-Modified |
Vrátí datum a čas poslední změny adresáře. Formát data se řídí dokumentem RFC 1123. Další informace najdete v tématu Reprezentace hodnot data a času v záhlavích. Operace se soubory v adresáři nemají vliv na čas poslední změny adresáře. |
x-ms-meta-name:value |
Sada párů název-hodnota, které obsahují metadata pro adresář. |
x-ms-request-id |
Vrátí jedinečný identifikátor požadavku, který vám může pomoct s řešením problému. Další informace najdete v tématu Řešení potíží s operacemi rozhraní API. |
x-ms-version |
Označuje verzi služby, 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-server-encrypted: true/false |
Verze 2017-04-17 a novější. Hodnota této hlavičky je nastavena na true , pokud jsou metadata adresáře zcela šifrovaná pomocí zadaného algoritmu. Pokud metadata nejsou zašifrovaná, hodnota je nastavená na false. |
x-ms-file-permission-key |
Verze 2019-02-02 a novější. Klíč oprávnění k adresáři. |
x-ms-file-attributes |
Verze 2019-02-02 a novější. Atributy systému souborů v adresáři. Další informace najdete v seznamu dostupných atributů. |
x-ms-file-creation-time |
Verze 2019-02-02 a novější. Hodnota data a času UTC, která představuje vlastnost času vytvoření adresáře. |
x-ms-file-last-write-time |
Verze 2019-02-02 a novější. Hodnota data a času UTC, která představuje vlastnost posledního času zápisu pro adresář. |
x-ms-file-change-time |
Verze 2019-02-02 a novější. Hodnota data a času UTC, která představuje vlastnost změnit čas pro adresář. |
x-ms-file-file-id |
Verze 2019-02-02 a novější. ID souboru adresáře. |
x-ms-file-parent-id |
Verze 2019-02-02 a novější. ID nadřazeného souboru adresáře. |
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 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 nenachází. |
Text odpovědi
Žádné
Ukázková odpověď
Response Status:
HTTP/1.1 200 OK
Response Headers:
Transfer-Encoding: chunked
Date: <date>
ETag: "0x8CAFB82EFF70C46"
Last-Modified: <date>
x-ms-version: 2015-02-21
Server: Windows-Azure-File/1.0 Microsoft-HTTPAPI/2.0
Autorizace
Tuto operaci může volat pouze vlastník účtu.
Poznámky
Pokud zadaná cesta k adresáři neexistuje, požadavek selže se stavovým kódem 404 (Nenalezena).