Címtártulajdonságok lekérése
A Get Directory Properties
művelet a megadott könyvtár összes rendszertulajdonságát visszaadja, és a címtár meglétének ellenőrzésére is használható. A visszaadott adatok nem tartalmazzák a könyvtárban vagy alkönyvtárakban lévő fájlokat.
Protokoll rendelkezésre állása
Engedélyezett fájlmegosztási protokoll | Elérhető |
---|---|
SMB | ![]() |
NFS | ![]() |
Kérés
A Get Directory Properties
kérelem az alábbiak szerint hozható létre. Javasoljuk, hogy HTTPS-t használjon.
Metódus | Kérés URI-ja | HTTP-verzió |
---|---|---|
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 |
Cserélje le a kérelem URI-jában látható elérésiút-összetevőket a sajátjára, az alábbiak szerint:
Elérésiút-összetevő | Description |
---|---|
myaccount |
A tárfiók neve. |
myshare |
A fájlmegosztás neve. |
myparentdirectorypath |
Választható. A szülőkönyvtár elérési útja. |
mydirectory |
A könyvtár neve. |
Az elérési utak elnevezésére vonatkozó korlátozásokkal kapcsolatos információkért lásd: Név- és hivatkozásmegosztások, könyvtárak, fájlok és metaadatok.
URI-paraméterek
A kérelem URI-ja a következő további paramétereket határozhatja meg:
Paraméter | Leírás |
---|---|
sharesnapshot |
Választható. 2017-04-17-es és újabb verzió. A sharesnapshot paraméter egy átlátszatlan DateTime érték, amely jelen esetben megadja a címtártulajdonságok lekérdezéséhez szükséges megosztási pillanatképet |
timeout |
Választható. A timeout paraméter másodpercben van kifejezve. További információ: Időtúllépések beállítása Azure Files műveletekhez. |
Kérésfejlécek
A szükséges és nem kötelező kérésfejléceket az alábbi táblázat ismerteti:
Kérelem fejléce | Leírás |
---|---|
Authorization |
Kötelező. Megadja az engedélyezési sémát, a fióknevet és az aláírást. További információ: Kérelmek engedélyezése az Azure Storage-ba. |
Date vagy x-ms-date |
Kötelező. Megadja a kérés egyezményes világidő (UTC) formátumban kifejezett időpontját. További információ: Kérelmek engedélyezése az Azure Storage-ba. |
x-ms-version |
Az összes engedélyezett kéréshez kötelező, a névtelen kérésekhez nem kötelező. A kérelemhez használandó művelet verzióját adja meg. További információ: Az Azure Storage-szolgáltatások verziószámozása. |
x-ms-client-request-id |
Választható. Ügyfél által generált, átlátszatlan értéket biztosít egy 1 kibibyte (KiB) karakterkorláttal, amelyet a naplózás konfigurálásakor rögzít a naplókban. Javasoljuk, hogy ezt a fejlécet használva korrelálja az ügyféloldali tevékenységeket a kiszolgáló által kapott kérésekkel. További információ: Azure Files figyelése. |
x-ms-file-request-intent |
Kötelező, ha Authorization a fejléc OAuth-jogkivonatot ad meg. Elfogadható érték: backup . Ez a fejléc azt adja meg, hogy a Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action vagy Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action értéket kell megadni, ha szerepelnek a fejléc használatával Authorization engedélyezett identitáshoz rendelt RBAC-szabályzatban. A 2022-11-02-es és újabb verziókhoz érhető el. |
x-ms-allow-trailing-dot: { <Boolean> } |
Választható. 2022-11-02-es és újabb verzió. A logikai érték azt határozza meg, hogy a kérelem URL-címében található záró pont legyen-e levágva vagy sem. További információ: Megosztások, könyvtárak, fájlok és metaadatok elnevezése és hivatkozása. |
A kérés törzse
Nincsenek.
Mintakérés
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=
Reagálás
A válasz egy HTTP-állapotkódot és válaszfejléceket tartalmaz.
Állapotkód
A sikeres művelet a 200 -os állapotkódot adja vissza (OK).
További információ az állapotkódokról: Állapot- és hibakódok.
Válaszfejlécek
A műveletre adott válasz a következő fejléceket tartalmazza. A válasz további szabványos HTTP-fejléceket is tartalmazhat. Minden szabványos fejléc megfelel a HTTP/1.1 protokoll specifikációjának.
Válaszfejléc | Description |
---|---|
ETag |
Az ETag olyan értéket tartalmaz, amellyel feltételesen hajthat végre műveleteket. Az érték idézőjelek közé van zárva. |
Last-Modified |
A könyvtár utolsó módosításának dátumát és időpontját adja vissza. A dátumformátum az RFC 1123-at követi. További információ: Dátum-/időértékek ábrázolása fejlécekben. A könyvtáron belüli fájlokon végzett műveletek nincsenek hatással a könyvtár utolsó módosításának időpontjára. |
x-ms-meta-name:value |
Név-érték párok készlete, amelyek a könyvtár metaadatait tartalmazzák. |
x-ms-request-id |
A kérés egyedi azonosítóját adja vissza, amely segíthet a kérés hibaelhárításában. További információ: API-műveletek hibaelhárítása. |
x-ms-version |
A kérés végrehajtásához használt szolgáltatásverziót jelzi. |
Date |
A szolgáltatás által létrehozott UTC dátum/idő érték, amely a válasz indításának időpontját jelzi. |
x-ms-server-encrypted: true/false |
2017-04-17-es és újabb verzió. Ennek a fejlécnek az értéke akkor van beállítva, true ha a címtár metaadatai teljes mértékben titkosítva van a megadott algoritmussal. Ha a metaadatok nincsenek titkosítva, az érték értékre false van állítva. |
x-ms-file-permission-key |
2019-02-02-es és újabb verzió. A könyvtár engedélyének kulcsa. |
x-ms-file-attributes |
2019-02-02-es és újabb verzió. A könyvtár fájlrendszerattribútumai. További információkért tekintse meg az elérhető attribútumok listáját. |
x-ms-file-creation-time |
2019-02-02-es és újabb verzió. A címtár létrehozási idő tulajdonságát képviselő UTC dátum/idő érték. |
x-ms-file-last-write-time |
2019-02-02-es és újabb verzió. Az UTC dátum/idő értéke, amely a könyvtár utolsó írási idő tulajdonságát jelöli. |
x-ms-file-change-time |
2019-02-02-es és újabb verzió. Az UTC dátum/idő értéke, amely a könyvtár változási idő tulajdonságát jelöli. |
x-ms-file-file-id |
2019-02-02-es és újabb verzió. A könyvtár fájlazonosítója. |
x-ms-file-parent-id |
2019-02-02-es és újabb verzió. A könyvtár szülőfájl-azonosítója. |
x-ms-client-request-id |
A kérések és a hozzájuk tartozó válaszok hibaelhárítására használható. A fejléc értéke megegyezik a x-ms-client-request-id fejléc értékével, ha az szerepel a kérelemben, és az érték legfeljebb 1024 látható ASCII-karaktert tartalmaz. Ha a x-ms-client-request-id fejléc nem szerepel a kérelemben, akkor nem jelenik meg a válaszban. |
Választörzs
Nincsenek.
Mintaválasz
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
Engedélyezés
Ezt a műveletet csak a fióktulajdonos hívhatja meg.
Megjegyzések
Ha a megadott könyvtár elérési útja nem létezik, a kérés a 404-ben (nem található) állapotkóddal meghiúsul.