Fájltulajdonságok beállítása
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 | Elérhető |
---|---|
SMB | |
NFS |
Kérés
A Set File Properties
kérelem az alábbiak szerint hozható létre. Javasoljuk, hogy HTTPS-t használjon.
Metódus | Kérés URI-ja | HTTP-verzió |
---|---|---|
PUT | 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ő | Description |
---|---|
myaccount |
A tárfiók neve. |
myshare |
A fájlmegosztás neve. |
mydirectorypath |
Választható. A szülőkönyvtár elérési útja. |
myfile |
A fájl neve. |
Az elérési utak elnevezésére vonatkozó korlátozásokkal kapcsolatos információkért lásd: Név- és hivatkozásmegosztások, könyvtárak, fájlok és metaadatok.
URI-paraméterek
A kérelem URI-jában a következő további paramétereket adhatja meg:
Paraméter | Leírás |
---|---|
timeout |
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érésfejlécek
A szükséges és nem kötelező kérésfejléceket az alábbi táblázat ismerteti:
Kérelem fejléce | Leírás |
---|---|
Authorization |
Kötelező. 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-ba. |
Date vagy x-ms-date |
Kötelező. Megadja a kérés egyezményes világidő (UTC) formátumban kifejezett időpontját. További információ: Kérelmek engedélyezése az Azure Storage-ba. |
x-ms-version |
Minden engedélyezett kéréshez szükséges. A kérelemhez használandó 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 |
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 explicit módon újra be van állítva a fájlon. |
x-ms-content-type |
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 explicit módon újra be van állítva a fájlon. |
x-ms-content-md5 |
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 explicit módon újra be van állítva a fájlon. |
x-ms-content-encoding |
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 explicit módon újra be van állítva a fájlon. |
x-ms-content-language |
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 explicit módon újra be van állítva a fájlon. |
x-ms-content-disposition |
Választható. Beállítja a fájl fejlécét Content-Disposition .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 explicit módon újra be van állítva a fájlon. |
x-ms-content-length: bytes |
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> } |
A 2019-02-02-2021-04-10 verzióban ez a fejléc szükséges, ha x-ms-file-permission-key nincs megadva. A 2021-06-08-as verziótól mindkét fejléc választható. Ez az engedély a Security Descriptor Definition Language (SDDL) nyelvben megadott fájl biztonsági leírója. Ezt a fejlécet akkor használhatja, ha az engedélyek mérete 8 kibájt (KiB) vagy kisebb. Ellenkező esetben használhatja a következőt x-ms-file-permission-key : . Ha meg van adva, tulajdonosi, csoport- és diszkréciós hozzáférés-vezérlési listával (DACL) kell rendelkeznie. Egy meglévő érték változatlanul hagyása érdekében átadható egy értéknek preserve .Megjegyzés: Megadhatja a x-ms-file-permission vagy x-ms-file-permission-key a értéket. Ha egyik fejléc sincs megadva, a rendszer az alapértelmezett értéket preserve 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 x-ms-file-permission nincs megadva. A 2021-06-08-as verziótól mindkét fejléc választható. A fájlhoz beállítandó engedély kulcsa. Ez az Create-Permission API-val hozható létre.Megjegyzés: Megadhatja a x-ms-file-permission vagy x-ms-file-permission-key a értéket. Ha egyik fejléc sincs megadva, a rendszer az alapértelmezett értéket preserve használja a x-ms-file-permission fejléchez. |
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ítandó fájlrendszerattribútumok. Tekintse meg az elérhető attribútumok listáját. Egy meglévő érték változatlanul hagyása érdekében átadható egy értéknek preserve . Az alapértelmezett érték 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 egyezményes világidő (UTC) létrehozási ideje tulajdonsága. Egy meglévő érték változatlanul hagyása érdekében átadható egy értéknek preserve . Az alapértelmezett érték 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ó. Az egyezményes világidő (UTC) utolsó írási tulajdonsága egy fájlhoz. Egy meglévő érték változatlanul hagyása érdekében átadható egy értéknek preserve . Ha preserve meg van adva, é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 megváltozik, de explicit időbélyeget ad meg, a rendszer az explicit időbélyeget használja. Az alapértelmezett érték preserve . |
x-ms-lease-id: <ID> |
Kötelező, ha a fájl aktív bérletet kapott. A 2019-02-02-es és újabb verziókhoz érhető el. |
x-ms-client-request-id |
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ó: Azure Files figyelése. |
x-ms-file-change-time: { now ¦ <DateTime> } |
Választható. 2021-06-08-es és újabb verzió. A fájl Egyezményes világidő (UTC) változási idő tulajdonsága ISO 8601 formátumban. Az érték now használatával jelezheti a kérés időpontját. Az alapértelmezett érték now . |
x-ms-file-request-intent |
Kötelező, ha Authorization a fejléc OAuth-jogkivonatot ad meg. Elfogadható érték: backup . Ez a fejléc azt adja meg, hogy a Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action vagy Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action értéket kell megadni, ha szerepelnek a fejléc használatával Authorization 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> } |
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 legyen-e levágva vagy sem. További információ: Megosztások, könyvtárak, fájlok és metaadatok elnevezése és hivatkozása. |
A kérés törzse
Nincsenek.
Reagálás
A válasz egy HTTP-állapotkódot és válaszfejléceket tartalmaz.
Állapotkód
A sikeres művelet a 200 -os állapotkódot adja vissza (OK).
Az állapotkódokkal kapcsolatos információkért lásd: Állapot- és hibakódok.
Válaszfejlécek
A műveletre adott válasz 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 | Description |
---|---|
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 ábrázolása 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 nincsenek hatással a könyvtár utolsó módosításának időpontjára. |
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érelem 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 akkor van beállítva, true ha a kérés tartalma sikeresen titkosítva van a megadott algoritmussal. Ellenkező esetben az érték értékre false 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ájlrendszerattribútumai. További információkért tekintse meg az elérhető attribútumok listáját. |
x-ms-file-creation-time |
2019-02-02-es és újabb verzió. Az UTC dátum/idő értéke, amely a fájl létrehozási ideje tulajdonságát jelöli. |
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 idejének tulajdonságát jelöli. |
x-ms-file-change-time |
2019-02-02-es és újabb verzió. Az UTC dátum/idő értéke, 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ó. A fejléc értéke megegyezik a x-ms-client-request-id kérelemben szereplő fejléc értékével, é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 jelenik meg a válaszban. |
Választörzs
Nincsenek.
Engedélyezé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 fájl. Az alkalmazások beolvashatják a fájlt, de nem írhatnak rá vagy nem törölhetnek. |
Rejtett | FILE_ATTRIBUTE_HIDDEN | A fájl rejtett. Ez nem szerepel egy szokásos könyvtárlistán. |
Rendszer | FILE_ATTRIBUTE_SYSTEM | Olyan fájl, amelyet az operációs rendszer kizárólag részben vagy kizárólagosan használ. |
None | 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 | Egy archív fájl. Az alkalmazások általában ezt az attribútumot használják a fájlok biztonsági mentésre vagy eltávolításra való megjelölésére. |
Ideiglenes | FILE_ATTRIBUTE_TEMPORARY | Ideiglenes tároláshoz használt fájl. |
Offline | FILE_ATTRIBUTE_OFFLINE | A fájlok adatai nem érhetők el azonnal. Ez a fájlrendszerattribútum elsősorban a Windowssal való kompatibilitás érdekében jelenik meg. 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 háttéradat-integritás-ellenőrző nem olvassa be a felhasználói adatfolyamot. Ez a fájlrendszerattribú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érelem megadja a
x-ms-content-length
fejléc értékét.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 az alábbi tulajdonságok közül bármelyik vagy több be van állítva, a rendszer az összes tulajdonságot együtt állítja be. Ha egy megadott tulajdonsághoz nem ad meg értéket, 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
Megjegyzés
A fenti fájltulajdonságok elkülönülnek 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.
Set File properties
A megosztás pillanatképe nem támogatott, amely egy megosztás írásvédett példánya. A művelet megosztási pillanatképen való végrehajtására tett kísérlet 400-as (InvalidQueryParameterValue) hibával meghiúsul.
Ha a fájlnak aktív bérlete van, az ügyfélnek érvényes bérletazonosítót kell megadnia a fájl tulajdonságainak írására irányuló kérelemben. 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-ös állapotkódot adja vissza (az előfeltétel sikertelen). Ha az ügyfél bérletazonosítót ad meg, de a fájlnak nincs aktív bérlete, a Fájlszolgáltatás a 412-ös állapotkódot is visszaadja (az előfeltétel sikertelen).