Přejmenovat adresář

  • Článek

Operace Rename Directory přejmenuje adresář a volitelně může pro tento adresář nastavit systémové vlastnosti. Toto rozhraní API je k dispozici ve verzi 2021-04-10 a novější.

Dostupnost protokolu

Povolený protokol sdílených složek K dispozici.
SMB Ano
NFS Ne

Žádost

Požadavek můžete vytvořit Rename Directory následujícím způsobem. Doporučuje se https.

Metoda Identifikátor URI žádosti Verze PROTOKOLU HTTP
PUT https://myaccount.file.core.windows.net/myshare/mydirectorypath/mydirectory?restype=directory&comp=rename HTTP/1.1

Následujícím způsobem nahraďte komponenty cesty uvedené v identifikátoru URI požadavku vlastními:

Komponenta Cesta Popis
myaccount Název vašeho účtu úložiště.
myshare Název sdílené složky.
mydirectorypath Nepovinný parametr. Cesta k nadřazené adresáři.
mydirectory Název cílového adresáře.

Podrobnosti o omezeních pojmenování cest najdete v tématu Pojmenování sdílených složek, adresářů, souborů a metadat a odkazování na nich.

Parametry identifikátoru URI

V identifikátoru URI požadavku můžete zadat následující další parametr.

Parametr Popis
timeout Nepovinný parametr. Parametr timeout je vyjádřen v sekundách. Další informace najdete v tématu Nastavení časových limitů pro operace Azure Files.

Hlavičky požadavku

Následující tabulka popisuje požadované a volitelné hlavičky požadavků.

Hlavička požadavku Popis
Authorization Povinná hodnota. Určuje schéma autorizace, název účtu a podpis. Další informace najdete v tématu Autorizace požadavků do služby Azure Storage.
Date nebo x-ms-date Povinná hodnota. Určuje formát UTC (Coordinated Universal Time). Další informace najdete v tématu Autorizace požadavků do služby Azure Storage.
x-ms-version Povinné pro všechny autorizované žádosti. Určuje verzi operace, která se má použít pro tento požadavek. Další informace najdete v tématu Správa verzí pro služby Azure Storage.
x-ms-file-rename-source:name Povinná hodnota. Název adresáře, který se má přejmenovat.
x-ms-file-rename-replace-if-exists Nepovinný parametr. Pokud cílový soubor již existuje, přepište ho.
x-ms-file-rename-ignore-readonly Nepovinný parametr. Pokud cílový soubor s atributem readonly existuje, přepište ho.

Pokud je pravda, x-ms-file-rename-replace-if-exists musí být také pravda.
x-ms-file-permission Volitelné, pokud x-ms-file-permission-key není zadané. Toto oprávnění je popisovač zabezpečení pro adresář určený v jazyce SDDL (Security Descriptor Definition Language). Tuto hlavičku můžete použít, pokud je velikost oprávnění 8 kibibajtů (KiB) nebo menší. V opačném případě můžete použít x-ms-file-permission-key. Pokud je toto oprávnění zadané, musí mít vlastníka, skupinu a volitelný seznam řízení přístupu. Pokud chcete zachovat existující hodnotu beze změny, můžete předat hodnotu preserve .

Všimněte si, že můžete zadat buď nebo x-ms-file-permissionx-ms-file-permission-key, ne obojí.
x-ms-file-permission-key Volitelné, pokud x-ms-file-permission není zadané. Klíč oprávnění, které se má pro soubor nastavit. Můžete ho Create-Permission vytvořit pomocí rozhraní API.

Všimněte si, že můžete zadat buď nebo x-ms-file-permissionx-ms-file-permission-key, ne obojí.
x-ms-file-attributes Nepovinný parametr. Atributy systému souborů, které se mají nastavit v adresáři. Podívejte se na seznam dostupných atributů. Pokud chcete zachovat existující hodnotu beze změny, můžete předat hodnotu preserve . Pokud tato vlastnost není v požadavku zadána, bude vlastnost pro soubor zachována.
x-ms-file-creation-time Nepovinný parametr. Vlastnost čas vytvoření (UTC) pro adresář Pokud chcete zachovat existující hodnotu beze změny, můžete předat hodnotu preserve . Pokud tato vlastnost není v požadavku zadána, bude vlastnost pro soubor zachována.
x-ms-file-last-write-time Nepovinný parametr. Vlastnost posledního zápisu (UTC) pro adresář Pokud chcete zachovat existující hodnotu beze změny, můžete předat hodnotu preserve . Pokud tato vlastnost není v požadavku zadána, bude vlastnost pro soubor zachována.
x-ms-destination-lease-id:<ID> Vyžaduje se, pokud má cílový soubor aktivní zapůjčení.
x-ms-client-request-id Nepovinný parametr. Poskytuje klientem vygenerovanou neprůselnou hodnotu s limitem počtu znaků 1 KiB, která je zaznamenána v protokolech při konfiguraci protokolování. Důrazně doporučujeme použít tuto hlavičku ke korelaci aktivit na straně klienta s požadavky, které server přijímá. Další informace najdete v tématu Monitorování Azure Blob Storage.
x-ms-meta-name:value Nepovinný parametr. Nastaví dvojici název-hodnota pro soubor.

Každé volání této operace nahradí všechna existující metadata připojená k souboru.

Názvy metadat musí splňovat pravidla pojmenování identifikátorů jazyka C#. Pokud tato vlastnost není v požadavku zadána, bude vlastnost pro soubor zachována.
x-ms-file-request-intent Vyžaduje se, pokud Authorization hlavička určuje token OAuth. Přijatelná hodnota je backup. Tato hlavička určuje, že Microsoft.Storage/storageAccounts/fileServices/readFileBackupSemantics/action by se měly udělit nebo Microsoft.Storage/storageAccounts/fileServices/writeFileBackupSemantics/action , pokud jsou zahrnuté v zásadách RBAC přiřazených k identitě, která je autorizována pomocí hlavičky Authorization . K dispozici pro verzi 2022-11-02 a novější.
x-ms-allow-trailing-dot: { <Boolean> } Nepovinný parametr. Verze 2022-11-02 a novější. Logická hodnota určuje, jestli se má v adrese URL požadavku oříznout koncová tečka, nebo ne. Další informace najdete v tématu Pojmenování sdílených složek, adresářů, souborů a metadat a odkazování na nich.
x-ms-source-allow-trailing-dot: { <Boolean> } Nepovinný parametr. Verze 2022-11-02 a novější. Logická hodnota určuje, jestli se má oříznout koncová tečka obsažená ve zdrojové adrese URL. Tato hlavička by měla být zadána pouze v případě, že zdrojem kopírování je soubor Azure. Tato hlavička není podporována pro žádný jiný typ zdroje kopírování. Další informace najdete v tématu Pojmenování sdílených složek, adresářů, souborů a metadat a odkazování na nich.

Text požadavku

Žádné

Odpověď

Odpověď obsahuje stavový kód HTTP a sadu hlaviček odpovědi.

Stavový kód

Úspěšná operace vrátí stavový kód 200 (OK). Informace o stavových kódech najdete v tématu Stavové kódy a kódy chyb.

Hlavičky odpovědi

Odpověď na tuto operaci obsahuje následující hlavičky. Odpověď může také obsahovat další standardní hlavičky HTTP. Všechny standardní hlavičky odpovídají specifikaci protokolu HTTP/1.1.

Hlavička odpovědi Popis
ETag Obsahuje hodnotu, která představuje verzi souboru v uvozovkách.
Last-Modified Vrátí datum a čas poslední změny souboru. Další informace najdete v tématu Reprezentace hodnot data a času v záhlavích. Každá operace, která upraví adresář nebo jeho vlastnosti, aktualizuje čas poslední změny. Operace se soubory nemají vliv na čas poslední změny adresáře.
x-ms-request-id Jednoznačně identifikuje požadavek, který byl proveden, a lze ho použít k řešení potíží s požadavkem. Další informace najdete v tématu Řešení potíží s operacemi rozhraní API.
x-ms-version Označuje verzi Azure Files použité ke spuštění požadavku.
Date nebo x-ms-date Hodnota data a času UTC, která označuje čas, kdy byla odpověď zahájena. Tato služba vygeneruje tuto hodnotu.
x-ms-request-server-encrypted: true/false Hodnota této hlavičky je nastavena na true , pokud je obsah požadavku úspěšně zašifrován pomocí zadaného algoritmu. V opačném případě je hodnota nastavena na falsehodnotu .
x-ms-file-permission-key Klíč oprávnění k souboru.
x-ms-file-attributes Atributy systému souborů v souboru. Podívejte se na seznam dostupných atributů.
x-ms-file-creation-time Hodnota data a času UTC, která představuje vlastnost času vytvoření souboru.
x-ms-file-last-write-time Hodnota data a času UTC, která představuje vlastnost čas posledního zápisu souboru.
x-ms-file-change-time Datum a čas UTC, která představuje vlastnost čas změny souboru.
x-ms-file-file-id ID souboru.
x-ms-file-parent-id ID nadřazeného souboru souboru.
x-ms-client-request-id Dá se použít k řešení potíží s požadavky a odpovídajícími odpověďmi. Hodnota této hlavičky se rovná hodnotě x-ms-client-request-id hlavičky, pokud je v požadavku. Hodnota je maximálně 1 024 viditelných znaků ASCII. Pokud hlavička x-ms-client-request-id v požadavku není, nebude v odpovědi.

Text odpovědi

Žádné

Autorizace

Tuto operaci může volat pouze vlastník účtu.

Atributy systému souborů

Atribut Atribut souboru Win32 Definice
ReadOnly FILE_ATTRIBUTE_READONLY Adresář, který je jen pro čtení.
Hidden FILE_ATTRIBUTE_HIDDEN Adresář je skrytý. Není součástí běžného výpisu adresáře.
System FILE_ATTRIBUTE_SYSTEM Adresář, který operační systém používá nebo používá výhradně.
None FILE_ATTRIBUTE_NORMAL Adresář, který nemá nastavené další atributy. Tento atribut je platný pouze při použití samostatně.
Directory FILE_ATTRIBUTE_DIRECTORY Popisovač, který identifikuje adresář.
Archive FILE_ATTRIBUTE_ARCHIVE Adresář, který je archivní adresář. Aplikace obvykle používají tento atribut k označení souborů pro zálohování nebo odebrání.
Offline FILE_ATTRIBUTE_OFFLINE Data adresáře nejsou k dispozici okamžitě. Tento atribut systému souborů je prezentován především kvůli zajištění kompatibility se systémem Windows. Azure Files nepodporuje možnosti offline úložiště.
NotContentIndexed FILE_ATTRIBUTE_NOT_CONTENT_INDEXED Adresář nemá indexovat služba indexování obsahu.
NoScrubData FILE_ATTRIBUTE_NO_SCRUB_DATA Datový proud uživatele nemá číst skener integrity dat na pozadí. Tento atribut systému souborů je prezentován především kvůli zajištění kompatibility se systémem Windows.

Poznámky

Pokud je cílem adresář, nesmí adresář existovat.

Rename Directory se nepodporuje u snímku sdílené složky, což je kopie sdílené složky jen pro čtení. Pokud se pokusíte provést tuto operaci na snímku sdílené složky, vrátí služba stav chyby 400 (neplatná hodnota parametru dotazu).

Pokud nezadáte vlastnosti, nastaví se výchozí chování nebo preservenow .

Pokud má adresář aktivní zapůjčení, musí klient v požadavku zadat platné ID zapůjčení, aby mohl adresář přejmenovat. Pokud klient nezadá ID zapůjčení nebo zadá neplatné ID zapůjčení, vrátí Azure Files stavový kód 412 (Předběžná podmínka se nezdařila). Pokud klient zadá ID zapůjčení, ale adresář nemá aktivní zapůjčení, vrátí Azure Files také stavový kód 412 (Předběžná podmínka selhala).

Viz také

Operace s adresáři