Sdílet prostřednictvím

azcopy remove

  • Článek

Odstraňte objekty blob nebo soubory z účtu úložiště Azure.

Synopse

azcopy remove [resourceURL] [flags]

Příklady

Odebrání jednoho objektu blob pomocí tokenu SAS:

azcopy rm "https://[account].blob.core.windows.net/[container]/[path/to/blob]?[SAS]"

Odeberte celý virtuální adresář pomocí tokenu SAS:

azcopy rm "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true

Odeberte pouze objekty blob uvnitř virtuálního adresáře, ale neodebívejte žádné podadresáře ani objekty blob v těchto podadresářích:

azcopy rm "https://[account].blob.core.windows.net/[container]/[path/to/virtual/dir]" --recursive=false

Odeberte podmnožinu objektů blob ve virtuálním adresáři (například: odeberte pouze soubory jpg a pdf nebo pokud je název objektu blob "exactName"):

azcopy rm "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true --include-pattern="*.jpg;*.pdf;exactName"

Odeberte celý virtuální adresář, ale vyloučíte určité objekty blob z oboru (například každý objekt blob, který začíná foo nebo končí pruhem):

azcopy rm "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true --exclude-pattern="foo*;*bar"

Odeberte ze služby Azure Storage zadané ID verzí objektu blob. Ujistěte se, že zdrojem je platný objekt blob, který versionidsfile přebírá cestu k souboru, kde je každá verze zapsána na samostatný řádek. Ze služby Azure Storage se odeberou všechny zadané verze.

azcopy rm "https://[srcaccount].blob.core.windows.net/[containername]/[blobname]" "/path/to/dir" --list-of-versions="/path/to/dir/[versionidsfile]"

Odeberte konkrétní objekty blob a virtuální adresáře tak, že pomocí příznaku umístíte jejich relativní cesty (NENÍ kódované adresou URL) do textového --list-of-files souboru (například: list.txt). V textovém souboru se každý objekt blob a virtuální adresář zapisují na samostatný řádek. Příznak --list-of-files může mít za následek náklady na výkon kvůli dalším transakcím pro načtení vlastností objektu. Další informace o rozhraních API, která AzCopy používá, a odhad nákladů najdete v tématu Odhad nákladů na přenos objektů blob pomocí nástroje AzCopy.

azcopy rm "https://[account].blob.core.windows.net/[container]/[path/to/parent/dir]" --recursive=true --list-of-files=/usr/bar/list.txt

Odeberte jeden soubor z účtu služby Blob Storage, který má hierarchický obor názvů (zahrnutí nebo vyloučení se nepodporuje):

azcopy rm "https://[account].dfs.core.windows.net/[container]/[path/to/file]?[SAS]"

Odeberte jeden adresář z účtu služby Blob Storage, který má hierarchický obor názvů (zahrnutí nebo vyloučení se nepodporuje):

azcopy rm "https://[account].dfs.core.windows.net/[container]/[path/to/directory]?[SAS]"

Možnosti

--cpk-by-name (řetězec) Klient poskytnutý názvem umožňuje klientům, kteří zadávat požadavky na Službu Blob Storage, možnost poskytnout šifrovací klíč pro jednotlivé požadavky. Zadaný název klíče se načte ze služby Azure Key Vault a použije se k šifrování dat.

--cpk-by-value Ve výchozím nastavení je false. Klient poskytnutý názvem umožňuje klientům, kteří zadávat požadavky na Službu Blob Storage, možnost poskytnout šifrovací klíč pro jednotlivé požadavky. Zadaný klíč a jeho hodnota hash se načte z proměnných CPK_ENCRYPTION_KEY prostředí a CPK_ENCRYPTION_KEY_SHA256.

--delete-snapshots (řetězec) Operace odstranění ve výchozím nastavení selže, pokud má objekt blob snímky. Zadejte include pro odebrání kořenového objektu blob a všech jeho snímků; případně zadejte pouze snímky, ale ponechte kořenový objekt blob.

--dry-run Ve výchozím nastavení je false. Vytiskne soubory cest, které by příkaz odebral. Tento příznak neaktivuje odebrání souborů.

--exclude-path (řetězec) Tyto cesty při odebírání vylučte. Tato možnost nepodporuje zástupné znaky (*). Kontroluje předponu relativní cesty. Například: myFolder; myFolder/subDirName/file.pdf

--exclude-pattern (řetězec) Vylučte soubory, ve kterých název odpovídá seznamu vzorů. Příklad: .jpg;. Pdf; exactName

--force-if-read-only Ve výchozím nastavení je false. Při odstraňování souboru nebo složky Azure Files vynuťte, aby odstranění fungovalo i v případě, že má existující objekt nastavený atribut jen pro čtení.

--from-to (řetězec) Volitelně určuje zdrojovou cílovou kombinaci. Příklad: BlobTrash, FileTrash, BlobFSTrash

-h, --help nápověda k odebrání

--include-after (řetězec) Zahrnout pouze tyto soubory změněné k danému datu a času nebo po tomto datu. Hodnota by měla být ve formátu ISO8601. Pokud není zadané žádné časové pásmo, předpokládá se, že hodnota je v místním časovém pásmu počítače, na kterém běží AzCopy (například 2020-08-19T15:04:00Z, pro čas UTC nebo 2020-08-19 pro půlnoc (00:00) v místním časovém pásmu). Od verze AzCopy 10.5 platí tento příznak pouze pro soubory, ne složky, takže vlastnosti složky se při použití tohoto příznaku s tímto příznakem --preserve-smb-info nebo --preserve-smb-permissions nekopírovaly.

--include-before (řetězec) Zahrnout pouze tyto soubory změněné před nebo k danému datu a času. Hodnota by měla být ve formátu ISO8601. Pokud není zadané žádné časové pásmo, předpokládá se, že hodnota je v místním časovém pásmu počítače, na kterém běží AzCopy (například 2020-08-19T15:04:00Z, pro čas UTC nebo 2020-08-19 pro půlnoc (00:00) v místním časovém pásmu). Od verze AzCopy 10.7 se tento příznak vztahuje pouze na soubory, ne složky, takže vlastnosti složky se při použití tohoto příznaku --preserve-smb-info--preserve-smb-permissionsnebo .

--include-path (řetězec) Při odebírání zahrňte pouze tyto cesty. Tato možnost nepodporuje zástupné znaky (*). Kontroluje předponu relativní cesty. Například: myFolder; myFolder/subDirName/file.pdf

--include-pattern (řetězec) Zahrnout pouze soubory, ve kterých název odpovídá seznamu vzorů. Příklad: .jpg;. Pdf; exactName

--list-of-files (řetězec) Definuje umístění textového souboru, který obsahuje seznam souborů a adresářů, které se mají odstranit. Relativní cesty by měly být oddělené koncům řádků a cesty by neměly být kódovány adresou URL.

--list-of-versions (řetězec) Určuje textový soubor, kde je každé ID verze uvedené na samostatném řádku. Ujistěte se, že zdroj musí odkazovat na jeden objekt blob a všechna ID verzí zadaná v souboru pomocí tohoto příznaku musí patřit pouze do zdrojového objektu blob. Zadaná ID verzí daného objektu blob se odstraní ze služby Azure Storage.

--permanent-delete (řetězec) Jedná se o funkci preview, která trvale odstraní obnovitelné odstraněné snímky nebo verze. Mezi možné hodnoty patří snapshots, versions, snapshotsandversions, none. (výchozí "none")

--trailing-dot Ve výchozím nastavení je povolené, aby se operace související se sdílenou složkou byly bezpečně zacházeno. Dostupné možnosti: Enable, Disable. Zvolte Disable , že se vrátíte ke starší verzi (potenciálně nebezpečné) léčbě koncových souborů s tečkami, ve kterých služba file service ořízne všechny koncové tečky v cestách. To může vést k potenciálnímu poškození dat, pokud přenos obsahuje dvě cesty, které se liší pouze koncovou tečkou (například mypath a mypath.). Pokud je tento příznak nastavený na a AzCopy narazí na Disable koncový tečkový soubor, upozorní zákazníky v protokolu prohledávání, ale nepokusí se operaci přerušit. Pokud cíl nepodporuje koncové soubory s tečkou (Windows nebo Blob Storage), AzCopy selže, pokud je koncový bod souboru kořenem přenosu a přeskočí všechny koncové cesty tečky, ke kterým došlo během výčtu.

--recursive Ve výchozím nastavení je false. Při synchronizaci mezi adresáři se podívejte na podadresáře rekurzivně.

Možnosti zděděné z nadřazených příkazů

--cap-mbps float Limituje přenosovou rychlost v megabitech za sekundu. Propustnost za okamžik se může mírně lišit od limitu. Pokud je tato možnost nastavená na nulu nebo je vynechána, propustnost není omezena.

--output-type (řetězec) Formát výstupu příkazu Mezi tyto volby patří: text, json. Výchozí hodnota je text. (výchozí text)

--trusted-microsoft-suffixes (řetězec) Určuje další přípony domény, ve kterých se můžou odesílat přihlašovací tokeny Microsoft Entra. Výchozí hodnota je .core.windows.net;. core.chinacloudapi.cn;. core.cloudapi.de;. core.usgovcloudapi.net;*.storage.azure.net'. Všechny zde uvedené jsou přidány do výchozího nastavení. Kvůli zabezpečení byste sem měli umístit jenom domény Microsoft Azure. Oddělte více položek středníky.

--log-level (řetězec) Definujte úroveň podrobností protokolu pro soubor protokolu. Mezi dostupné úrovně patří: INFO(všechny požadavky/odpovědi), WARNING(pomalé odpovědi), ERROR(pouze neúspěšné požadavky) a NONE(žádné výstupní protokoly). (výchozí 'INFO') (výchozí "INFORMACE")

Viz také