Fájl átnevezése
A Rename File művelet átnevez egy fájlt, és opcionálisan beállíthatja a fájl rendszertulajdonságait. Ez az API a 2021-04-10-es és újabb verziókban érhető el.
Protokoll rendelkezésre állása
| Engedélyezett fájlmegosztási protokoll | Beszerezhető |
|---|---|
| SMB |
|
| NFS |
|
Kérés
A Rename File kérést az alábbiak szerint hozhatja létre. A HTTPS használata ajánlott.
| Módszer | URI kérése | HTTP-verzió |
|---|---|---|
| HELYEZ | https://myaccount.file.core.windows.net/myshare/mydirectorypath/myfile?comp=rename |
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ő célkönyvtár elérési útja. |
myfile |
A célfájl neve. |
Az útvonalelnevezési korlátozásokról további információt Megosztások, könyvtárak, fájlok és metaadatok elnevezése és hivatkozása.
URI-paraméterek
A kérelem URI-ján a következő további paramétert adhatja meg.
| Paraméter | Leírás |
|---|---|
timeout |
Szabadon választható. A timeout paraméter másodpercben van kifejezve. További információ: Azure Files-műveletek időtúllépéseinek beállítása. |
Kérelemfejlécek
Az alábbi táblázat a szükséges és választható kérelemfejléceket 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-file-rename-source:name |
Szükséges. Az átnevezni kívánt fájl teljes URI-ja. |
x-ms-file-rename-replace-if-exists |
Szabadon választható. Ha a célfájl már létezik, írja felül a fájlt. |
x-ms-file-rename-ignore-readonly |
Szabadon választható. Ha a célfájl a readonly attribútummal létezik, írja felül a fájlt.Ha igaz, x-ms-file-rename-replace-if-exists is igaznak kell lennie. |
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, akkor a tulajdonság megmarad a fájlhoz. |
x-ms-file-permission: { preserve ¦ <SDDL> ¦ <binary> } |
Nem kötelező, ha nincs megadva x-ms-file-permission-key. 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, ennek az engedélynek tulajdonosi, csoport- és hozzáférés-vezérlési listával kell rendelkeznie. Ha egy meglévő értéket változatlanul szeretne tartani, preserve értéket adhat át.Vegye figyelembe, hogy megadhat x-ms-file-permission vagy x-ms-file-permission-key, nem mindkettő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-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 |
Nem kötelező, ha nincs megadva x-ms-file-permission. A fájlhoz beállítandó engedély kulcsa. Ezt a Create-Permission API használatával hozhatja létre.Vegye figyelembe, hogy megadhat x-ms-file-permission vagy x-ms-file-permission-key, nem mindkettőt. |
x-ms-file-attributes |
Szabadon választható. A fájlon beállítani kívánt fájlrendszerattribútumok. Tekintse meg az elérhető attribútumok listáját. Ha egy meglévő értéket változatlanul szeretne tartani, preserve értéket adhat át. Ha nem adja meg ezt a tulajdonságot a kérelemben, akkor a tulajdonság megmarad a fájlhoz. |
x-ms-file-creation-time |
Szabadon választható. A fájl UTC létrehozási idő tulajdonsága. Ha egy meglévő értéket változatlanul szeretne tartani, preserve értéket adhat át. Ha nem adja meg ezt a tulajdonságot a kérelemben, akkor a tulajdonság megmarad a fájlhoz. |
x-ms-file-last-write-time |
Szabadon választható. Egy fájl UTC utolsó írási tulajdonsága. Ha egy meglévő értéket változatlanul szeretne tartani, preserve értéket adhat át. Ha nem adja meg ezt a tulajdonságot a kérelemben, akkor a tulajdonság megmarad a fájlhoz. |
x-ms-source-lease-id:<ID> |
Akkor szükséges, ha a forrásfájl aktív bérletet használ. |
x-ms-destination-lease-id:<ID> |
Akkor szükséges, ha a célfájl aktív bérletet kapott. |
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 Blob Storage. |
x-ms-meta-name:value |
Szabadon választható. Beállít egy név-érték párot a fájlhoz. A művelet minden hívása lecseréli a fájlhoz csatolt összes meglévő metaadatot. A metaadatok nevének meg kell felelnie C#-azonosítókelnevezési szabályainak. |
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. |
x-ms-source-allow-trailing-dot: { <Boolean> } |
Szabadon választható. 2022-11-02-es és újabb verzió. A logikai érték azt határozza meg, hogy a forrás URL-címében található záró pont levágható-e vagy sem. Ezt a fejlécet csak akkor kell megadni, ha a másolási forrás egy Azure-fájl. Ez az élőfej más másolási forrástípus esetén nem támogatott. 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 idézőjelekben ábrázoló értéket tartalmaz. |
Last-Modified |
A fájl utolsó módosításának dátumát és időpontját adja vissza. 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 futtatásához használt Azure Files-verziót jelzi. |
Date vagy x-ms-date |
UTC dátum/idő érték, amely a válasz indításának időpontját jelzi. A szolgáltatás létrehozza ezt az értéket. |
x-ms-request-server-encrypted: true/false |
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 |
A fájl engedélyének kulcsa. |
x-ms-file-attributes |
A fájl fájlrendszer-attribútumai. Tekintse meg az elérhető attribútumok listáját. |
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 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. Az érték legfeljebb 1024 látható ASCII-karakter lehet. 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 | Írásvédett fájl. Az alkalmazások beolvashatják a fájlt, de nem tudnak írni vagy törölni. |
Hidden |
FILE_ATTRIBUTE_HIDDEN | A fájl rejtett. Ez nem szerepel a szokásos címtárlistában. |
System |
FILE_ATTRIBUTE_SYSTEM | Olyan fájl, amelyet az operációs rendszer használ, vagy kizárólag egy részét használja. |
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. |
Archive |
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. |
Temporary |
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 cél nem lehet meglévő könyvtár.
Ha nem ad meg tulajdonságokat, a preserve vagy now alapértelmezett viselkedése lesz beállítva.
Jegyzet
Az előző fájltulajdonságok különállóak 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.
Rename File nem támogatott a megosztás pillanatképe, amely egy megosztás írásvédett másolata. Ha megkísérli végrehajtani ezt a műveletet egy megosztási pillanatképen, a szolgáltatás a 400-as hibaállapotot adja vissza (érvénytelen lekérdezési paraméterérték).
Ha a fájl aktív bérletet kapott, az ügyfélnek érvényes bérletazonosítót kell megadnia a kérelemben a fájl átnevezéséhez. Ha az ügyfél 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őfeltétel nem sikerült). Ha az ügyfél bérletazonosítót ad meg, de a fájl nem rendelkezik aktív bérletekkel, az Azure Files a 412-s állapotkódot is visszaadja (az előkondicionálás sikertelen).