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

Cikk
08/07/2024

A Set File Properties művelet beállítja a fájl rendszertulajdonságokat.

Protokoll rendelkezésre állása

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

Kérés

A Set File Properties kérelem a következőképpen hozható 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ázat ismerteti:

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. 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-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. A meglévő érték változatlan maradása érdekében `preserve` érték 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-permission-keypreserve`értékre van állítva, akkor ezt a fejlécet nem szabad beállítani. Ha `x-ms-file-permission-key` a `preserve`értékétől eltérő értékre van állítva, és ha ez a fejléc nincs beállítva, a rendszer a `sddl` alapértelmezett értékét használja.
`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 `x-ms-file-permission` fejléchez a `preserve` 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. A meglévő érték változatlan maradása érdekében `preserve` érték adható át. Az alapértelmezett érték a `preserve`.
`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. A meglévő érték változatlan maradása érdekében `preserve` érték 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. A meglévő érték változatlan maradása érdekében `preserve` érték 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.
`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-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-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. További információ: Megosztások, könyvtárak, fájlok és metaadatok elnevezése és hivatkozása.

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.

Válaszfejlécek

A művelet válasza a következő fejléceket 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.

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

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.

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, a fájl más tulajdonságai nem módosulnak.
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 az Azure Files

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