Megosztás a következőn keresztül:

Címtártulajdonságok lekérése

  • Cikk

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. Ezt a műveletet a 2025-05-05-ös és újabb verzió támogatja az engedélyezett NFS protokollal rendelkező fájlmegosztások esetében.

Protokoll rendelkezésre állása

Engedélyezett fájlmegosztási protokoll Beszerezhető
SMB Igen
NFS Igen

Kérés

A Get Directory Properties kérés a következőképpen jön létre. Javasoljuk, hogy HTTPS-t használjon.

Módszer URI kérése HTTP-verzió
LEKÉRÉS/FEJ https://myaccount.file.core.windows.net/myshare/myparentdirectorypath/mydirectory?restype=directory HTTP/1.1
LEKÉRÉS/FEJ 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ő Leírás
myaccount A tárfiók neve.
myshare A fájlmegosztás neve.
myparentdirectorypath Szabadon választható. A szülőkönyvtár elérési útja.
mydirectory A könyvtár neve.

Az útvonalelnevezési korlátozásokról további információt a Név- és hivatkozásmegosztások, könyvtárak, fájlok és metaadatokcímű témakörben talál.

URI-paraméterek

A kérelem URI-ján a következő további paraméterek adhatók meg:

Paraméter Leírás
sharesnapshot Szabadon 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 Szabadon választható. A timeout paraméter másodpercben van kifejezve. További információ: Időtúllépések beállítása az Azure Files-műveletekhez.

Kérelemfejlécek

A szükséges és nem kötelező kérelemfejléceket az alábbi táblázatok ismertetik:

Gyakori kérésfejlécek

Kérelem fejléce Leírás
Authorization Szükséges. 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-.
Date vagy x-ms-date Szükséges. A kérelem koordinált egyetemes idejét (UTC) adja meg. További információ: Kérelmek engedélyezése az Azure Storage-.
x-ms-version Minden engedélyezett kéréshez szükséges. A kérelemhez használni kívánt művelet verzióját adja meg. Ezt a műveletet a 2025-05-05-ös és újabb verzió támogatja az engedélyezett NFS protokollal rendelkező fájlmegosztások esetében.

További információ: Az Azure Storage-szolgáltatások verziószámozása.
x-ms-client-request-id Szabadon 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ó: Monitor Azure Files.
x-ms-file-request-intent Kötelező, ha Authorization fejléc OAuth-jogkivonatot ad meg. Az elfogadható érték backup. Ez a fejléc azt határozza meg, hogy a Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action vagy Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action meg kell adni, ha azok szerepelnek a Authorization fejléc használatával 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> } Szabadon 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 levágható-e vagy sem.

Ez a fejléc figyelmen kívül lesz hagyva, ha a cél olyan fájlmegosztáson található, amelyen engedélyezve van az NFS protokoll, amely alapértelmezés szerint támogatja a záró pont használatát.

További információ: Megosztások, könyvtárak, fájlok és metaadatok elnevezése és hivatkozása.

Csak SMB-kérésfejlécek

Egyik sem.

Csak NFS-kérelemfejlécek

Egyik sem.

Kérelem törzse

Egyik sem.

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=

Válasz

A válasz tartalmaz egy HTTP-állapotkódot és válaszfejléceket.

Állapotkód

A sikeres művelet a 200-ra (OK) vonatkozó állapotkódot adja vissza. Az állapotkódokkal kapcsolatos információkért lásd állapot- és hibakódokat.

Válaszfejlécek

A műveletre adott válasz az alábbi táblázatok fejléceit 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 .

Gyakori válaszfejlécek

Válaszfejléc Leírás
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 címtá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 megjelenítése fejlécekben. A címtáron belüli fájlokon végzett műveletek nem befolyásolják a címtár utolsó módosításának időpontját.
x-ms-meta-name:value Név-érték párok készlete, amelyek a címtá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 true, ha a címtár metaadatait a megadott algoritmussal titkosítja. Ha a metaadatok nincsenek titkosítva, az érték false.
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ó. A címtár utolsó írási idejének tulajdonságát képviselő UTC dátum/idő érték.
x-ms-file-change-time 2019-02-02-es és újabb verzió. Az UTC dátum/idő értéke, amely a címtá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ó. Ennek az élőfejnek az é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 az nem szerepel a válaszban.

Csak SMB-válaszfejlécek

Válaszfejléc Leírás
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ájlrendszer-attribútumai. További információ: elérhető attribútumok listája.

Csak NFS-válaszfejlécek

Válaszfejléc Leírás
x-ms-mode 2025-05-05-ös és újabb verzió. A könyvtár módja. Lásd: POSIX-fájlengedélyek (mód).
x-ms-owner 2025-05-05-ös és újabb verzió. A címtártulajdonos felhasználói azonosítója (UID).
x-ms-group 2025-05-05-ös és újabb verzió. A címtártulajdonos csoportazonosítója (GID).
x-ms-file-file-type 2025-05-05-ös és újabb verzió. A fájl típusa, a lehetséges értékek a következők: Directory.

Válasz törzse

Egyik sem.

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

Felhatalmazás

Ezt a műveletet csak a fióktulajdonos hívhatja meg.

Fájlrendszerattribútumok

Attribútum Win32 fájlattribútum Definíció
ReadOnly FILE_ATTRIBUTE_READONLY Csak olvasható fájl. Az alkalmazások beolvashatják a fájlt, de nem tudnak írni vagy törölni.
Rejtett FILE_ATTRIBUTE_HIDDEN A fájl rejtett. Ez nem szerepel a szokásos címtárlistában.
Rendszer FILE_ATTRIBUTE_SYSTEM Olyan fájl, amelyet az operációs rendszer használ, vagy kizárólag egy részét használja.
Egyik sem FILE_ATTRIBUTE_NORMAL Olyan fájl, amely nem rendelkezik más attribútumokkal. Ez az attribútum csak akkor érvényes, ha egyedül használja.
Archívum FILE_ATTRIBUTE_ARCHIVE Archív fájl. Az alkalmazások általában ezzel az attribútummal jelölik meg a fájlokat biztonsági mentésre vagy eltávolításra.
Ideiglenes FILE_ATTRIBUTE_TEMPORARY Ideiglenes tároláshoz használt fájl.
Offline FILE_ATTRIBUTE_OFFLINE A fájl adatai nem érhetők el azonnal. Ez a fájlrendszer-attribútum elsősorban a Windowssal való kompatibilitás érdekében jelenik meg. Az Azure Files nem támogatja az offline tárolási lehetőségeket.
NotContentIndexed FILE_ATTRIBUTE_NOT_CONTENT_INDEXED A fájlt nem kell indexelnie a tartalomindexelő szolgáltatásnak.
NoScrubData FILE_ATTRIBUTE_NO_SCRUB_DATA A felhasználói adatfolyamot nem kell beolvasnia a háttéradat-integritás-ellenőrzőnek. Ez a fájlrendszer-attribútum elsősorban a Windowssal való kompatibilitás érdekében jelenik meg.

POSIX-fájlengedélyek (mód)

A POSIX-fájlengedélyek numerikusan 12 bites numerikus oktális formátumban vagy szimbolikus "rwx" formátumban adhatók meg. Példák:

  • "0644" vagy "rw-r--r---": A felhasználó (fájltulajdonos) olvasási, írási engedéllyel rendelkezik. A csoport olvasási engedéllyel rendelkezik. Mások olvasási engedéllyel rendelkeznek.
  • "0755" vagy "rwxr-xr-x": A felhasználó (fájltulajdonos) olvasási, írási és végrehajtási engedéllyel rendelkezik. A csoport olvasási és végrehajtási engedéllyel rendelkezik. Mások olvasási és végrehajtási engedéllyel rendelkeznek.

Numerikus oktális formátum

A három legalacsonyabb sorrendű oktális szám a tulajdonos/felhasználó, a csoport és mások engedélyeit jelöli, és egy oktális számmal (0-7) van jelölve, amely a "4" (Olvasás), "2" (Írás), "1" (Végrehajtás) bitenkénti kombinációjával van formázva. A legmagasabb rendű oktális szám (0-7) a "4" (SetUID), "2" (SetGID), "1" (StickyBit) engedélyek kombinációjának jelzésére szolgál.

Formátum Engedély
0700 A felhasználó (fájltulajdonos) olvasási, írási és végrehajtási engedéllyel rendelkezik.
0400 A felhasználó olvasási engedéllyel rendelkezik.
0200 A felhasználó írási engedéllyel rendelkezik.
0100 A felhasználó rendelkezik végrehajtási engedéllyel.
0070 A csoport olvasási, írási és végrehajtási engedéllyel rendelkezik.
0040 A csoport olvasási engedéllyel rendelkezik.
0020 A csoport írási engedéllyel rendelkezik.
0010 A csoport rendelkezik végrehajtási engedéllyel.
0007 Mások olvasási, írási és végrehajtási engedéllyel rendelkeznek.
0004 Mások olvasási engedéllyel rendelkeznek.
0002 Mások írási engedéllyel rendelkeznek.
0001 Mások végrehajtási engedéllyel rendelkeznek.
4000 Állítsa be az érvényes felhasználói azonosítót a fájlban.
2000 Állítsa be az érvényes csoportazonosítót a fájlban.
1000 A beállítás azt jelzi, hogy a fájlt csak a fájltulajdonos, a címtártulajdonos vagy a gyökérfelhasználó törölheti vagy nevezheti át.

Szimbolikus "rwx" formátum

A tulajdonosra/felhasználóra, csoportra és másokra vonatkozó engedélyek az "r" (Olvasás), a "w" (Írás) és az "x" (Végrehajtás) karakterek kombinációjával vannak megjelölve.

Formátum Engedély
rwx------ A felhasználó (fájltulajdonos) olvasási, írási és végrehajtási engedéllyel rendelkezik.
r-------- A felhasználó olvasási engedéllyel rendelkezik.
-w------- A felhasználó írási engedéllyel rendelkezik.
--x------ A felhasználó rendelkezik végrehajtási engedéllyel.
---rwx--- A csoport olvasási, írási és végrehajtási engedéllyel rendelkezik.
---r----- A csoport olvasási engedéllyel rendelkezik.
----w---- A csoport írási engedéllyel rendelkezik.
-----x--- A csoport rendelkezik végrehajtási engedéllyel.
------rwx Mások olvasási, írási és végrehajtási engedéllyel rendelkeznek.
------r- Mások olvasási engedéllyel rendelkeznek.
-------w- Mások írási engedéllyel rendelkeznek.
--------x Mások végrehajtási engedéllyel rendelkeznek.

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.

Lásd még:

könyvtárakon