Fájltulajdonságok beállítása

Cikk
02/21/2025

A Set File Properties művelet beállítja a fájl rendszertulajdonságokat. 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 Set File 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ó
HELYEZ	`https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile?comp=properties`	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.
`mydirectorypath`	Szabadon választható. A szülőkönyvtár elérési útja.
`myfile`	A fájl 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ában 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 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-cache-control`	Szabadon választható. Módosítja a fájl gyorsítótár-vezérlési sztringét. Ha ez a tulajdonság nincs megadva a kérelemben, a tulajdonság törlődik a fájlhoz. A Fájltulajdonságok lekérése későbbi hívásai nem fogják visszaadni ezt a tulajdonságot, kivéve, ha az újra explicit módon be van állítva a fájlban.
`x-ms-content-type`	Szabadon választható. Beállítja a fájl tartalomtípusát. Ha ez a tulajdonság nincs megadva a kérelemben, a tulajdonság törlődik a fájlhoz. A Fájltulajdonságok lekérése későbbi hívásai nem fogják visszaadni ezt a tulajdonságot, kivéve, ha az újra explicit módon be van állítva a fájlban.
`x-ms-content-md5`	Szabadon választható. Beállítja a fájl MD5 kivonatát. Ha ez a tulajdonság nincs megadva a kérelemben, a tulajdonság törlődik a fájlhoz. A Fájltulajdonságok lekérése későbbi hívásai nem fogják visszaadni ezt a tulajdonságot, kivéve, ha az újra explicit módon be van állítva a fájlban.
`x-ms-content-encoding`	Szabadon választható. Beállítja a fájl tartalomkódolását. Ha ez a tulajdonság nincs megadva a kérelemben, a tulajdonság törlődik a fájlhoz. A Fájltulajdonságok lekérése későbbi hívásai nem fogják visszaadni ezt a tulajdonságot, kivéve, ha az újra explicit módon be van állítva a fájlban.
`x-ms-content-language`	Szabadon választható. Beállítja a fájl tartalomnyelvét. Ha ez a tulajdonság nincs megadva a kérelemben, a tulajdonság törlődik a fájlhoz. A Fájltulajdonságok lekérése későbbi hívásai nem fogják visszaadni ezt a tulajdonságot, kivéve, ha az újra explicit módon be van állítva a fájlban.
`x-ms-content-disposition`	Szabadon választható. Beállítja a fájl `Content-Disposition` fejlécét. Ha ez a tulajdonság nincs megadva a kérelemben, a tulajdonság törlődik a fájlhoz. A Fájltulajdonságok lekérése későbbi hívásai nem fogják visszaadni ezt a tulajdonságot, kivéve, ha az újra explicit módon be van állítva a fájlban.
`x-ms-content-length: bytes`	Szabadon választható. Átméretez egy fájlt a megadott méretre. Ha a megadott bájtérték kisebb, mint a fájl aktuális mérete, a megadott bájtérték feletti összes tartomány törlődik.
`x-ms-file-creation-time: { preserve ¦ <DateTime> }`	Kötelező, 2019-02-02-2021-04-10-es verzió. Nem kötelező, 2021-06-08-es és újabb verzió. Egy fájl összehangolt univerzális idő (UTC) létrehozási ideje tulajdonsága. Egy meglévő érték változatlanul hagyásához `preserve` adható át. Az alapértelmezett érték a `preserve`.
`x-ms-file-last-write-time: { preserve ¦ <DateTime> }`	Kötelező, 2019-02-02-2021-04-10-es verzió. Nem kötelező, 2021-06-08-es és újabb verzió. A koordinált univerzális idő (UTC) utolsó írási tulajdonsága egy fájlhoz. Egy meglévő érték változatlanul hagyásához `preserve` adható át. Ha `preserve` van megadva, és a fájl mérete módosul, az utolsó írási idő az aktuális időpontra frissül. Ha a fájl mérete módosul, de explicit időbélyeget ad meg, a rendszer a kifejezett időbélyeget használja. Az alapértelmezett érték a `preserve`.
`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 időtulajdonságának (UTC) 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: { preserve ¦ <SDDL> ¦ <binary> }`	A 2019-02-02-2021-04-10 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 biztonsági leíró a Biztonsági leíró definíciós nyelv (SDDL) vagy (2024-11-04-es vagy újabb verzió) base64 kódolású bináris biztonsági leíró formátumban. 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 meg van adva, tulajdonossal, csoportokkal és diszkrecionális hozzáférés-vezérlési listával (DACL)kell rendelkeznie. Egy meglévő érték változatlanul hagyásához `preserve` adható át. Megjegyzés: Megadhatja `x-ms-file-permission` vagy `x-ms-file-permission-key`. Ha egyik fejléc sincs megadva, a rendszer a `preserve` 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-permissionpreserve`értékre van állítva, akkor ezt a fejlécet nem szabad beállítani. Ha `x-ms-file-permission` a `preserve`é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 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ő. A fájlhoz beállítandó engedély kulcsa. Ez a `Create-Permission` API használatával hozható létre. Megjegyzés: Megadhatja `x-ms-file-permission` vagy `x-ms-file-permission-key`. Ha egyik fejléc sincs megadva, a `preserve` fejléchez a `x-ms-file-permission` alapértelmezett értékét használja a rendszer.
`x-ms-file-attributes: { preserve ¦ <FileAttributeList> }`	Kötelező, 2019-02-02-2021-04-10-es verzió. Nem kötelező, 2021-06-08-es és újabb verzió. A fájlon beállítani kívánt fájlrendszerattribútumok. Tekintse meg az elérhető attribútumok listáját. Egy meglévő érték változatlanul hagyásához `preserve` adható át. Az alapértelmezett érték a `preserve`.

Csak NFS-kérelemfejlécek

Kérelem fejléce	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. 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.
`x-ms-group`	2025-05-05-ös és újabb verzió. A fájl tulajdonosának csoportazonosítója (GID) a fájlon.

Kérelem törzse

Egyik sem.

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. 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`	A fájl verzióját képviselő értéket tartalmaz. 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, frissíti az utolsó módosítás időpontját. 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 Fájlszolgáltatás verzióját jelzi.
`Date` vagy `x-ms-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ó. Ennek a fejlécnek az értéke `true`, ha a kérés tartalma sikeresen titkosítva van a megadott algoritmussal. Ellenkező esetben az érték `false`értékre van állítva.
`x-ms-file-creation-time`	2019-02-02-es és újabb verzió. A fájl 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 fájl 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ék, amely a fájl változási idő tulajdonságát jelöli.
`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, az nem jelenik meg 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-link-count`	2025-05-05-ös és újabb verzió. A fájl hivatkozásszáma.

Válasz törzse

Egyik sem.

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), a "2" (Írás), az "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

A fájl tulajdonságainak frissítésére szolgáló szemantikák a következők:

A fájl mérete csak akkor módosul, ha a kérés a x-ms-content-length fejléc értékét adja meg.
Ha egy kérelem csak x-ms-content-length és más tulajdonságokat nem állít be:
- Ha a fájl olyan fájlmegosztáson található, amelyen engedélyezve van az SMB protokoll, akkor a fájl egyik más tulajdonsága sem módosul.
- Ha a fájl olyan fájlmegosztáson található, amelyen engedélyezve van az NFS protokoll, akkor a fájl változási ideje és az utolsó írási idő módosul.
Ha a kérelemben a következő tulajdonságok bármelyike be van állítva, a rendszer az összes tulajdonságot együtt állítja be. Ha egy megadott tulajdonsághoz nincs megadva érték, ha a következő tulajdonságok közül legalább egy be van állítva, akkor a tulajdonság törlődik a fájlhoz.
- x-ms-cache-control
- x-ms-content-type
- x-ms-content-md5
- x-ms-content-encoding
- x-ms-content-language

Jegyzet

Az előző fájltulajdonságok eltérnek az SMB-ügyfelek számára elérhető fájlrendszer-tulajdonságoktól. Az SMB-ügyfelek nem tudják olvasni, írni és módosítani ezeket a tulajdonságértékeket.

Set File properties 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 400-zal (InvalidQueryParameterValue) meghiúsul.

Ha a fájlnak aktív bérlete van, az ügyfélnek meg kell adnia egy érvényes bérletazonosítót a kérelemben, amely tulajdonságokat szeretne írni a fájlba. Ha az ügyfél nem ad meg bérletazonosítót, vagy érvénytelen bérletazonosítót ad meg, a Fájlszolgáltatás a 412-et adja vissza (az előfeltétel nem sikerült). Ha az ügyfél bérletazonosítót ad meg, de a fájl nem rendelkezik aktív bérlettal, a Fájlszolgáltatás a 412-et is visszaadja (az előfeltétel nem sikerült).

Lásd még:

Műveletek fájlokon

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