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 |
|
| NFS |
|
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.