Címtár létrehozása

Cikk
02/20/2025

A Create Directory művelet létrehoz egy új könyvtárat a megadott megosztási vagy szülőkönyvtár alatt. A címtárerőforrás tartalmazza a könyvtár tulajdonságait. Nem tartalmazza a címtárban található fájlok vagy alkönyvtárak listáját. 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
NFS

Kérés

A Create Directory 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ó
Helyezze	`https://myaccount.file.core.windows.net/myshare/myparentdirectorypath/mydirectory?restype=directory`	HTTP/1.1

Cserélje le a kérelem URI-jának elérésiút-összetevőit a sajátjára, ahogyan az az alábbi táblázatban látható:

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, ahol saját könyvtár létre kell hozni. Ha a szülőkönyvtár elérési útja nincs megadva, a címtár a megadott megosztáson belül jön létre. Ha a szülőkönyvtár meg van adva, annak már léteznie kell a megosztáson belül, mielőtt saját könyvtárat hozhat létre.
`mydirectory`	A létrehozandó könyvtár neve.

Az elérésiút-elnevezési korlátozásokról további információt 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étereket adhatja meg.

Paraméter	Leírás
`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 fájlszolgáltatás-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érelemfejléc	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 idő (UTC) idejét 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-meta-name:value`	Szabadon választható. 2015-02-21-es vagy újabb verzió. Egy név-érték pár, amely metaadatként társítja a könyvtárat. A metaadatok nevének meg kell felelnie C#-azonosítókelnevezési szabályainak.
`x-ms-file-creation-time: { now ¦ <DateTime> }`	Kötelező: 2019-02-02-2021-04-10-es verzió. Nem kötelező: 2021-06-08-s és újabb verzió. A címtár koordinált univerzális idő (UTC) létrehozási ideje tulajdonsága. A kérés időpontját a `now` értékével jelezheti. Az alapértelmezett érték a `now`.
`x-ms-file-last-write-time: { now ¦ <DateTime> }`	Kötelező: 2019-02-02-2021-04-10-es verzió. Nem kötelező: 2021-06-08-s vagy újabb verzió. Az egyezményes világidő (UTC) utolsó írási tulajdonsága a könyvtárhoz. A kérés időpontját a `now` értékével jelezheti. Az alapértelmezett érték a `now`.
`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

Kérelemfejléc	Leírás
`x-ms-file-change-time: { now ¦ <DateTime> }`	Szabadon választható. A címtár időtulajdonságának (UTC) módosítása ISO 8601 formátumban. 2021-06-08-s és újabb verzió. A kérés időpontját a `now` értékével jelezheti. Az alapértelmezett érték a `now`.
`x-ms-file-permission: { inherit ¦ <SDDL> ¦ <binary> }`	A 2019-02-02-2021-04-10-es verzióban ez a fejléc szükséges, ha nincs megadva `x-ms-file-permission-key`. A 2021-06-08-as verziótól mindkét fejléc nem kötelező. Ez az engedély a Security Descriptor Definition Language (SDDL) vagy (2024-11-04-es vagy újabb verzió) bináris biztonsági leírómegadott könyvtár biztonsági leírója. Megadhatja, hogy melyik formátumot használja a `x-ms-file-permission-format` fejléc. Ez a fejléc akkor használható, ha az engedélyek mérete meghaladja a 8 kibájtot (KiB). Ellenkező esetben használhatja a `x-ms-file-permission-key`. Ha meg van adva, tulajdonossal, csoportokkal és diszkrecionális hozzáférés-vezérlési listával (DACL)kell rendelkeznie. A szülőkönyvtárból öröklő `inherit` értéket adhat át. Megjegyzés: Megadhatja `x-ms-file-permission` vagy `x-ms-file-permission-key`. Ha egyik fejléc sincs megadva, a rendszer a `inherit` alapértelmezett értékét használja.
`x-ms-file-permission-format: { sddl ¦ binary }`	Szabadon választható. 2024-11-04-es vagy újabb verzió. Megadja, hogy az `x-ms-file-permission` átadott érték SDDL-ben vagy bináris formátumban van-e. Ha `x-ms-file-permissioninherit`értékre van állítva, akkor ezt a fejlécet nem szabad beállítani. Ha `x-ms-file-permission` a `inherit`értékétől eltérő értékre van állítva, és ha ez a fejléc nincs beállítva, a `sddl` alapértelmezett értéke lesz használva.
`x-ms-file-permission-key: <PermissionKey>`	A címtárhoz beállítandó engedély kulcsa. A 2019-02-02-2021-04-10-es verzióban ez a fejléc szükséges, ha nincs megadva `x-ms-file-permission`. A 2021-06-08-as verziótól mindkét fejléc nem kötelező. Ezt a kulcsot a `Create-Permission` API használatával hozhatja létre. Megjegyzés: Megadhatja `x-ms-file-permission` vagy `x-ms-file-permission-key`. Ha egyik fejléc sincs megadva, a `inherit` fejléchez a `x-ms-file-permission` alapértelmezett értékét használja a rendszer.
`x-ms-file-attributes`	Kötelező: 2019-02-02-2021-04-10-es verzió. Nem kötelező: 2021-06-08-es és újabb verzió. A címtárban beállítandó fájlrendszer-attribútumok. Tekintse meg az elérhető attribútumok listáját. Az alapértelmezett érték a Címtár.

Csak NFS-kérelemfejlécek

Kérelemfejléc	Leírás
`x-ms-mode`	2025-05-05-ös és újabb verzió. A fájlon beállítani kívánt módbitek. A mód 12 bites numerikus oktális vagy szimbolikus "rwx" formátumban jelenik meg. Az alapértelmezett érték 0755. Lásd: POSIX-fájlengedélyek (mód). Lásd: POSIX-fájlengedélyek (mód).
`x-ms-owner`	2025-05-05-ös és újabb verzió. A fájl tulajdonosának felhasználói azonosítója (UID) a fájlon. Az alapértelmezett érték a 0 (gyökér).
`x-ms-group`	2025-05-05-ös és újabb verzió. A fájl tulajdonosának csoportazonosítója (GID) a fájlon. Az alapértelmezett érték a 0 (gyökér).

Kérelem törzse

Egyik sem.

Mintakérés

PUT https://myaccount.file.core.windows.net/myshare/myparentdirectorypath/mydirectory? restype=directory HTTP/1.1  
  
Request headers:  
x-ms-version: 2014-02-14  
x-ms-date: Mon, 27 Jan 2014 22:50:32 GMT  
x-ms-meta-Category: Images  
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 201-ben (létrehozva) állapotkódot adja vissza. További információ az állapotkódokról: Állapot- és hibakódok.

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`	Idézőjelek közé zárt könyvtárverziót tartalmazó értéket tartalmaz.
`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. Minden olyan művelet, amely módosítja a könyvtárat vagy annak tulajdonságait, a legutóbbi módosítás időpontját frissíti. A 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-request-id`	Egyedileg azonosítja a kérést, amely a kérés hibaelhárításához használható. További információ: API Operationshibaelhárítása.
`x-ms-version`	A kérés végrehajtásához használt Azure Files-verzió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-request-server-encrypted: true/false`	2017-04-17-es vagy újabb verzió. Ennek az élőfejnek az értéke `true`, ha a kérés tartalma sikeresen titkosítva van a megadott algoritmussal, és egyébként `false`.
`x-ms-file-creation-time`	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`	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`	A címtár változási idő tulajdonságát képviselő UTC dátum/idő.
`x-ms-file-file-id`	A könyvtár fájlazonosítója.
`x-ms-file-parent-id`	A könyvtár szülőfájl-azonosítója.
`x-ms-client-request-id`	A kérések és a megfelelő 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 ez a fejléc 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ék a következő: `Directory`.

Válasz törzse

Egyik sem.

Mintaválasz

Response status:  
HTTP/1.1 201 Created  
  
Response headers:  
Transfer-Encoding: chunked  
Date: Mon, 27 Jan 2014 23:00:12 GMT  
ETag: "0x8CB14C3E29B7E82"  
Last-Modified: Mon, 27 Jan 2014 23:00:06 GMT  
x-ms-version: 2014-02-14  
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	Egy írásvédett könyvtár.
Rejtett	FILE_ATTRIBUTE_HIDDEN	A könyvtár rejtett. Ez nem szerepel a szokásos címtárlistában.
Rendszer	FILE_ATTRIBUTE_SYSTEM	Olyan könyvtár, amelyet az operációs rendszer használ, vagy kizárólag egy részét használja.
Egyik sem	FILE_ATTRIBUTE_NORMAL	Olyan könyvtár, amely nem rendelkezik más attribútumokkal. Ez az attribútum csak akkor érvényes, ha egyedül használja.
Címtár	FILE_ATTRIBUTE_DIRECTORY	A könyvtárat azonosító leíró.
Archívum	FILE_ATTRIBUTE_ARCHIVE	Egy archív könyvtár. Az alkalmazások általában ezzel az attribútummal jelölik meg a fájlokat biztonsági mentésre vagy eltávolításra.
Offline	FILE_ATTRIBUTE_OFFLINE	A címtárak 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 offline tárolási lehetőségekkel.
NotContentIndexed	FILE_ATTRIBUTE_NOT_CONTENT_INDEXED	A címtárat nem kell indexelnie a tartalomindexelő szolgáltatásnak.
NoScrubData	FILE_ATTRIBUTE_NO_SCRUB_DATA	A felhasználói adatfolyamot nem beolvasni a háttéradat-integritás-ellenőrző. 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 Create Directory meghívásakor egy azonos nevű könyvtárat töröl, a kiszolgáló a 409-et (Ütközés) állapotkódot adja vissza, és további hibainformációkat biztosít, amelyek azt jelzik, hogy a címtárat törölték.

Ha már létezik egy azonos nevű könyvtár vagy fájl, a művelet a 409-ben (Ütközés) állapotkóddal meghiúsul. Ha a szülőkönyvtár nem létezik, a művelet a 412-s állapotkóddal hiúsul meg (az előkondicionálás sikertelen).

Egyetlen Create Directory művelettel nem hozható létre címtárhierarchia. A könyvtárat csak akkor hozhatja létre, ha annak közvetlen szülője már létezik, az elérési úton megadott módon. Ha a szülőkönyvtár nem létezik, a művelet a 412-s állapotkóddal hiúsul meg (az előkondicionálás sikertelen).

Create Directory nem támogatott a megosztás pillanatképe, amely egy megosztás írásvédett másolata. A művelet megosztási pillanatképen való végrehajtásának kísérlete a 400-as hibával meghiúsul (InvalidQueryParameterValue)

Lásd még:

könyvtárakon

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