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


Fájl létrehozása

A Create File művelet létrehoz egy új fájlt, vagy lecserél egy fájlt. 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. Amikor meghívja Create File, csak inicializálja a fájlt. Ha tartalmat szeretne hozzáadni egy fájlhoz, hívja meg a Put Range műveletet.

Protokoll rendelkezésre állása

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

Kérés

A Create File 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/mydirectorypath/myfile 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ábbi táblázatban leírtak szerint:

Elérésiút-összetevő Leírás
myaccount A tárfiók neve.
myshare A fájlmegosztás neve.
mydirectorypath Szabadon választható. Annak a könyvtárnak az elérési útja, ahol a fájlt létre kell hozni. Ha a könyvtár elérési útja nincs megadva, a fájl a megadott megosztáson belül jön létre.

Ha a címtár meg van adva, a fájl létrehozásához már léteznie kell a megosztáson belül.
myfile A létrehozandó fájl 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é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 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.
Content-Length Szabadon választható. Ha jelen van, akkor nullának kell lennie.
x-ms-content-length: byte value Szükséges. Ez a fejléc a fájl maximális méretét adja meg, legfeljebb 4 terabájtig (TiB).
Content-Type vagy x-ms-content-type Szabadon választható. A fájl MIME-tartalomtípusa. Az alapértelmezett típus a application/octet-stream.
Content-Encoding vagy x-ms-content-encoding Szabadon választható. Megadja, hogy mely tartalomkódolások lettek alkalmazva a fájlra. Ezt az értéket a rendszer akkor adja vissza az ügyfélnek, ha a Fájl lekérése műveletet hajtja végre a fájlerőforráson, és a fájltartalom dekódolásához használhatja.
Content-Language vagy x-ms-content-language Szabadon választható. Megadja az erőforrás által használt természetes nyelveket.
Cache-Control vagy x-ms-cache-control Szabadon választható. Az Azure Files tárolja ezt az értéket, de nem használja és nem módosítja.
x-ms-content-md5 Szabadon választható. Beállítja a fájl MD5 kivonatát.
x-ms-content-disposition Szabadon választható. Beállítja a fájl Content-Disposition fejlécét.
x-ms-type: file Szükséges. Állítsa be ezt a fejlécet file.
x-ms-meta-name:value Szabadon választható. A fájlhoz metaadatként társított név-érték párok. A metaadatok nevének meg kell felelnie C#-azonosítókelnevezési szabályainak.

Megjegyzés: Az Azure Fileson keresztül megadott fájl metaadatai nem érhetők el egy SMB-ügyfélről.
x-ms-file-creation-time: { now ¦ <DateTime> } Kötelező: 2019-02-02-2021-04-10-es verzió. Nem kötelező: 2021-06-08-es és újabb verzió. A fájl koordinált univerzális idő (UTC) létrehozási ideje tulajdonsága. A kérés időpontjának jelzésére now érték használható. 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-es és újabb verzió. A fájl utolsó írási tulajdonsága a koordinált univerzális idő (UTC). A kérés időpontját a now értékével jelezheti. Az alapértelmezett érték a now.
x-ms-lease-id:<ID> Akkor szükséges, ha a fájl aktív bérletet kapott. A 2019-02-02-es és újabb verzióhoz érhető el.

Ezt a fejlécet a rendszer figyelmen kívül hagyja, ha a fájl engedélyezve van egy NFS protokollal rendelkező fájlmegosztáson, amely nem támogatja a fájlbérleteket.
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érelem fejléce Leírás
x-ms-file-change-time: { now ¦ <DateTime> } Szabadon választható. 2021-06-08-es és újabb verzió. A fájl koordinált univerzális idő (UTC) időtulajdonságának módosítása ISO 8601 formátumban. 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ó. Megadhatja, hogy melyik formátumot használja a x-ms-file-permission-format fejléc. Ezt a fejlécet akkor használhatja, ha az engedélyek mérete 8 kibájt (KiB) vagy annál kisebb. Ellenkező esetben használhatja a x-ms-file-permission-key. Ha megadja a fejlécet, annak 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.
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 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ő. Ha egyik fejléc sincs megadva, a inherit fejléchez a x-ms-file-permission alapértelmezett értékét használja a rendszer.

A kulcsot a Create Permission API meghívásával hozhatja létre.
x-ms-file-attributes Kötelező: 2019-02-02-2021-04-10-es verzió. Nem kötelező: 2021-06-08-es és újabb verzió. Ez a fejléc tartalmazza a fájlon beállítani kívánt fájlrendszerattribútumokat. További információ: elérhető attribútumok listája. Az alapértelmezett érték a None.

Csak NFS-kérelemfejlécek

Kérelem fejléce Leírás
x-ms-mode Szabadon választható. 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 a 0644. Lásd: POSIX-fájlengedélyek (mód).
x-ms-owner Szabadon választható. 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 Szabadon választható. 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ércsoport).
x-ms-file-file-type Szabadon választható. 2025-05-05-ös és újabb verzió. A fájl típusa. Ha van ilyen, "Normál" értéket kell megadnia.

Kérelem törzse

Egyik sem.

Mintakérés

Request Syntax:  
PUT https://myaccount.file.core.windows.net/myshare/myfile HTTP/1.1  
  
Request Headers:  
x-ms-version: 2020-02-10
x-ms-date: Mon, 27 Jan 2014 22:41:55 GMT  
Content-Type: text/plain; charset=UTF-8  
x-ms-content-length: 1024  
Authorization: SharedKey myaccount:YhuFJjN4fAR8/AmBrqBz7MG2uFinQ4rkh4dscbj598g=  

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. 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 egy olyan értéket tartalmaz, amely a fájl verzióját jelöli. Az érték idézőjelek közé van zárva.
Last-Modified A fájl 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-műveletek hibaelhá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 és újabb verzió. A fejléc értéke true, ha a megadott algoritmussal sikeresen titkosította a kérés tartalmát. Ha a titkosítás sikertelen, az érték false.
x-ms-file-creation-time A fájl létrehozási idő tulajdonságát képviselő UTC dátum/idő érték.
x-ms-file-last-write-time Az UTC dátum/idő értéke, amely a fájl utolsó írási idő tulajdonságát jelöli.
x-ms-file-change-time A fájl változási idő tulajdonságát képviselő UTC dátum/idő.
x-ms-file-file-id A fájl fájlazonosítója.
x-ms-file-parent-id A fájl 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 szolgál. 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 fájl engedélyének kulcsa.
x-ms-file-attributes 2019-02-02-es és újabb verzió. A fájl 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 fájl mód. Lásd: POSIX-fájlengedélyek (mód).
x-ms-owner 2025-05-05-ös és újabb verzió. A fájltulajdonos felhasználói azonosítója (UID).
x-ms-group 2025-05-05-ös és újabb verzió. A fájltulajdonos 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ő: "Regular".

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 Csak olvasható fájl. Az alkalmazások elolvashatjá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 offline tárolási lehetőségekkel.
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 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

Új fájl létrehozásához először inicializálja Create File meghívásával és maximális méretének megadásával, legfeljebb 4 TiB-ig. A művelet végrehajtásakor ne tartalmazzon tartalmat a kérelem törzsében. Miután létrehozta a fájlt, hívja meg a Put Range, hogy adjon hozzá tartalmat a fájlhoz, vagy módosítsa.

A fájl méretét a Set File Propertiesmeghívásával módosíthatja.

Ha a megosztási vagy szülőkönyvtár nem létezik, a művelet a 412-s állapotkóddal meghiúsul (az előkondicionálás sikertelen).

Jegyzet

A fájltulajdonságok cache-control, content-type, content-md5, content-encodingés content-language különböznek az SMB-ügyfelek számára elérhető fájlrendszer-tulajdonságoktól. Az SMB-ügyfelek nem tudják olvasni, írni vagy módosítani ezeket a tulajdonságértékeket.

A fájl létrehozásához, ha a meglévő fájl aktív bérletet kapott, az ügyfélnek érvényes bérletazonosítót kell megadnia a kérelemben. Ha az ügyfél vagy nem ad meg bérletazonosítót, vagy érvénytelen bérletazonosítót ad meg, az Azure Files visszaadja a 412-s állapotkódot (az előkondicionálás sikertelen). Ha az ügyfél bérletazonosítót ad meg, de a fájl nem rendelkezik aktív bérleteladással, az Azure Files ebben a példányban is visszaadja a 412-s állapotkódot (az előkondicionálás sikertelen). Ha az ügyfél egy még nem létező fájl bérletazonosítóját adja meg, az Azure Files a 2019-02-02-es és újabb verziójú kérelmek esetében a 412-es állapotkódot adja vissza (az előkondicionálás sikertelen).

Ha egy meglévő, aktív bérlettel rendelkező fájlt felülír egy Create File művelet, a bérlet a frissített fájlon marad a kiadásáig.

Create File nem támogatott a megosztás pillanatképe, amely egy megosztás írásvédett másolata. A megosztási pillanatképen végrehajtott művelet végrehajtása a 400-as állapotkóddal (InvalidQueryParameterValue) meghiúsul.

Lásd még:

Műveletek fájlokon