Könyvtár átnevezése

Cikk
05/01/2024

A Rename Directory művelet átnevez egy könyvtárat, és opcionálisan beállíthat rendszertulajdonságokat a címtárhoz. 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	Elérhető
SMB
NFS

Kérés

A kérést az Rename Directory alábbiak szerint hozhatja létre. A HTTPS használata ajánlott.

Metódus	Kérés URI-ja	HTTP-verzió
PUT	`https://myaccount.file.core.windows.net/myshare/mydirectorypath/mydirectory?restype=directory&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ő	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.
`mydirectory`	A célkönyvtár neve.

Az elérési utak elnevezési korlátozásával kapcsolatos részletekért lásd: 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`	Választható. A `timeout` paraméter másodpercben van kifejezve. További információ: Időtúllépések beállítása Azure Files műveletekhez.

Kérésfejlécek

Az alábbi táblázat a szükséges és nem kötelező kérelemfejléceket 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-file-rename-source:name`	Kötelező. Az átnevezni kívánt könyvtár teljes URI-ja.
`x-ms-file-rename-ignore-readonly`	Választható. Ha a célkönyvtár létezik az `readonly` attribútummal, írja felül a könyvtárat. Ha igaz, `x-ms-file-rename-replace-if-exists` akkor is igaznak kell lennie.
`x-ms-file-permission`	Nem kötelező, ha `x-ms-file-permission-key` nincs megadva. Ez az engedély a Security Descriptor Definition Language (SDDL) nyelvben megadott könyvtár 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, ennek az engedélynek tulajdonosi, csoport- és diszkréciós hozzáférés-vezérlési listával kell rendelkeznie. A értékét `preserve` átadhatja, ha egy meglévő értéket változatlanul szeretne hagyni. Vegye figyelembe, hogy a vagy `x-ms-file-permission-key`a értéket is megadhatja`x-ms-file-permission`, nem mindkettőt.
`x-ms-file-permission-key`	Nem kötelező, ha `x-ms-file-permission` nincs megadva. A könyvtárhoz beállítandó engedély kulcsa. Ezt az `Create-Permission` API-val hozhatja létre. Vegye figyelembe, hogy a vagy `x-ms-file-permission-key`a értéket is megadhatja`x-ms-file-permission`, nem mindkettőt.
`x-ms-file-attributes`	Választható. A könyvtárban beállítandó fájlrendszerattribútumok. Tekintse meg az elérhető attribútumok listáját. A értékét `preserve` átadhatja, ha egy meglévő értéket változatlanul szeretne hagyni. Ha ez a tulajdonság nincs megadva a kérelemben, akkor a tulajdonság megmarad.
`x-ms-file-creation-time`	Választható. A címtár UTC létrehozási ideje tulajdonsága. A értékét `preserve` átadhatja, ha egy meglévő értéket változatlanul szeretne hagyni. Ha ez a tulajdonság nincs megadva a kérelemben, akkor a tulajdonság megmarad.
`x-ms-file-last-write-time`	Választható. Egy címtár UTC utolsó írási tulajdonsága. A értékét `preserve` átadhatja, ha egy meglévő értéket változatlanul szeretne hagyni. Ha ez a tulajdonság nincs megadva a kérelemben, akkor a tulajdonság megmarad.
`x-ms-destination-lease-id:<ID>`	Kötelező, ha a célfájl aktív bérletet kapott.
`x-ms-client-request-id`	Választható. Ügyfél által generált, átlátszatlan értéket biztosít 1 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 Blob Storage figyelése.
`x-ms-meta-name:value`	Választható. Beállítja a könyvtár név-érték párját. A művelet minden hívása lecseréli a címtárhoz csatolt összes meglévő metaadatot. A metaadatok nevének meg kell felelnie a C#-azonosítók elnevezési szabályainak. Ha ez a tulajdonság nincs megadva a kérelemben, akkor a tulajdonság megmarad.
`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.
`x-ms-source-allow-trailing-dot: { <Boolean> }`	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 legyen-e levágva vagy sem. Ezt a fejlécet csak akkor kell megadni, ha a másolási forrás egy Azure-fájlmegosztás. Ez a fejléc más másolási forrástípus esetében nem támogatott. 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 idézőjelek között á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 á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érés futtatásához használt Azure Files verziójá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. Ezt az értéket a szolgáltatás hozza létre.
`x-ms-request-server-encrypted: true/false`	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`	A fájl engedélyének kulcsa.
`x-ms-file-attributes`	A fájl fájlrendszerattribútumai. Tekintse meg az elérhető attribútumok listáját.
`x-ms-file-creation-time`	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`	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`	A fájl változási idő tulajdonságát jelölő 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 a fejlécnek 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, 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	Írásvédett könyvtár.
`Hidden`	FILE_ATTRIBUTE_HIDDEN	A könyvtár rejtett. Ez nem szerepel egy szokásos könyvtárlistán.
`System`	FILE_ATTRIBUTE_SYSTEM	Olyan könyvtár, amelyet az operációs rendszer kizárólag részben vagy kizárólagosan használ.
`None`	FILE_ATTRIBUTE_NORMAL	Olyan könyvtár, amely nem rendelkezik más attribútumokkal. Ez az attribútum csak akkor érvényes, ha egyedül használja.
`Directory`	FILE_ATTRIBUTE_DIRECTORY	A könyvtárat azonosító leíró.
`Archive`	FILE_ATTRIBUTE_ARCHIVE	Egy archív könyvtár. 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.
`Offline`	FILE_ATTRIBUTE_OFFLINE	A címtárak 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 címtárat 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

Ha a cél egy könyvtár, akkor a könyvtár nem létezhet.

Rename Directory A megosztás pillanatképe nem támogatott, amely egy megosztás írásvédett példánya. Ha megosztási pillanatképen kísérli meg végrehajtani ezt a műveletet, a szolgáltatás a 400-ás hibaállapotot adja vissza (érvénytelen lekérdezési paraméterérték).

Ha nem ad meg tulajdonságokat, a vagy now az alapértelmezett viselkedése preserve lesz beállítva.

Ha a címtár rendelkezik aktív bérletmel, az ügyfélnek érvényes bérletazonosítót kell megadnia a kérelemben a címtár átnevezéséhez. Ha az ügyfél nem ad meg bérletazonosítót, vagy érvénytelen bérletazonosítót ad meg, Azure Files a 412-ös állapotkódot adja vissza (az előfeltétel sikertelen). Ha az ügyfél bérletazonosítót ad meg, de a címtár nem rendelkezik aktív bérletekkel, Azure Files a 412-ös állapotkódot is visszaadja (az előfeltétel sikertelen).

Lásd még

Könyvtárakon végzett műveletek