azcopy remove
Exclua blobs ou arquivos de uma conta de armazenamento do Azure.
Sinopse
azcopy remove [resourceURL] [flags]
Artigos conceituais relacionados
- Introdução ao AzCopy
- Transferir dados com o AzCopy e o Armazenamento de blobs
- Transferir dados com o AzCopy e o Armazenamento de Arquivos
Exemplos
Remova um único blob usando um token SAS:
azcopy rm "https://[account].blob.core.windows.net/[container]/[path/to/blob]?[SAS]"
Remova um diretório virtual inteiro usando um token SAS:
azcopy rm "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true
Remova somente os blobs dentro de um diretório virtual, mas não remova subdiretórios ou blobs dentro desses subdiretórios:
azcopy rm "https://[account].blob.core.windows.net/[container]/[path/to/virtual/dir]" --recursive=false
Remova um subconjunto de blobs em um diretório virtual (por exemplo, remova somente arquivos JPG e PDF, ou se o nome do blob for "exactName"):
azcopy rm "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true --include-pattern="*.jpg;*.pdf;exactName"
Sincronize um diretório virtual inteiro, mas exclua determinados blobs do escopo (por exemplo, cada blob que inicia com foto ou termina com bar):
azcopy rm "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true --exclude-pattern="foo*;*bar"
Remova as IDs de versão especificadas de um blob do Armazenamento do Azure. Verifique se a origem é um blob válido e versionidsfile
, que usa um caminho para o arquivo em que cada versão é gravada em uma linha separada. Todas as versões especificadas serão removidas do Armazenamento do Azure.
azcopy rm "https://[srcaccount].blob.core.windows.net/[containername]/[blobname]" "/path/to/dir" --list-of-versions="/path/to/dir/[versionidsfile]"
Remova blobs e diretórios virtuais específicos colocando seus caminhos relativos (NÃO codificados por URL) em um arquivo de texto (Por exemplo: list.txt
) usando o --list-of-files
sinalizador. No arquivo de texto, cada blob e diretório virtual é gravado em uma linha separada. O --list-of-files
sinalizador pode incorrer em custos de desempenho devido a transações adicionais para recuperar propriedades de objeto. Para obter mais informações sobre as APIs que o AzCopy usa e para estimar custos, consulte Estimar o custo do uso do AzCopy para transferir blobs.
azcopy rm "https://[account].blob.core.windows.net/[container]/[path/to/parent/dir]" --recursive=true --list-of-files=/usr/bar/list.txt
Remover um único arquivo de uma conta de Armazenamento de Blobs que tem um namespace hierárquico (não permite incluir/excluir):
azcopy rm "https://[account].dfs.core.windows.net/[container]/[path/to/file]?[SAS]"
Remover um único diretório de uma conta de Armazenamento de Blobs que tem um namespace hierárquico (não permite incluir/excluir):
azcopy rm "https://[account].dfs.core.windows.net/[container]/[path/to/directory]?[SAS]"
Opções
--cpk-by-name
(cadeia de caracteres) A chave fornecida pelo nome do cliente permite que os clientes façam solicitações no Armazenamento de Blobs do Azure uma opção para fornecer uma chave de criptografia por solicitação. O nome da chave fornecido será buscado no Azure Key Vault e será usada para criptografar os dados.
--cpk-by-value
False por padrão. A chave fornecida pelo nome do cliente permite que os clientes façam solicitações no Armazenamento de Blobs do Azure uma opção para fornecer uma chave de criptografia por solicitação. A chave fornecida e seu hash serão buscados das variáveis CPK_ENCRYPTION_KEY
de ambiente e CPK_ENCRYPTION_KEY_SHA256
.
--delete-snapshots
(cadeia de caracteres) Por padrão, a operação excluir falha se o blob tem instantâneos. Especifique 'include' para remover o blob raiz e todos os seus instantâneos. Também é possível especificar 'only' para remover apenas os instantâneos, mas manter o blob raiz.
--dry-run
False por padrão. Imprime os arquivos de caminho que seriam removidos pelo comando. Esse sinalizador não dispara a remoção dos arquivos.
--exclude-path
(cadeia de caracteres) Exclui esses caminhos ao remover. Essa opção não dá suporte a caracteres curinga (*). Verifica o prefixo do caminho relativo. Por exemplo: myFolder;myFolder/subDirName/file.pdf
--exclude-pattern
(cadeira de caracteres) Exclui os arquivos com nomes que correspondem à lista padrão. Por exemplo: .jpg;.pdf;exactName
--force-if-read-only
False por padrão. Ao excluir um arquivo ou pasta de Arquivos do Azure, force a exclusão a funcionar mesmo se o objeto existente tiver seu atributo somente leitura definido
--from-to
(cadeira de caracteres) Especifica opcionalmente a combinação de origem e destino. Por exemplo: BlobTrash, FileTrash, BlobFSTrash
-h
, --help
ajuda para remover
--include-after
(cadeia de caracteres) Inclua apenas os arquivos modificados na data e hora especificadas ou após ela. O valor deve estar no formato ISO8601. Se nenhum fuso horário for especificado, o valor será assumido como estando no fuso horário local da máquina que executa o AzCopy (Por exemplo: '2020-08-19T15:04:00Z' para um horário UTC ou '2020-08-19' para meia-noite (00:00) no fuso horário local). A partir do AzCopy 10.5, esse sinalizador se aplica somente a arquivos, não a pastas, portanto, as propriedades da pasta não serão copiadas ao usar esse sinalizador com --preserve-smb-info
ou --preserve-smb-permission
s.
--include-before
(cadeia de caracteres) Inclua apenas os arquivos modificados antes ou na data e hora determinadas. O valor deve estar no formato ISO8601. Se nenhum fuso horário for especificado, o valor será assumido como estando no fuso horário local da máquina que executa o AzCopy (Por exemplo: '2020-08-19T15:04:00Z' para um horário UTC ou '2020-08-19' para meia-noite (00:00) no fuso horário local). Como o AzCopy 10.7, esse sinalizador é aplicável apenas em arquivos, não em pastas, as propriedades da pasta não serão copiadas ao usar esse sinalizador com --preserve-smb-info
ou --preserve-smb-permissions
.
--include-path
(cadeia de caracteres) Inclui apenas esses caminhos ao remover. Essa opção não dá suporte a caracteres curinga (*). Verifica o prefixo do caminho relativo. Por exemplo: myFolder;myFolder/subDirName/file.pdf
--include-pattern
(cadeira de caracteres) Inclui somente os arquivos com nome correspondente à lista padrão. Por exemplo: .jpg;.pdf;exactName
--list-of-files
(cadeia de caracteres) Define o local de um arquivo de texto que contém a lista de arquivos e diretórios a serem excluídos. Os caminhos relativos devem ser delimitados por quebras de linha e os caminhos NÃO devem ser codificados em URL.
--list-of-versions
(cadeia de caracteres) Especifica um arquivo de texto em que cada ID de versão é listada em uma linha separada. Verifique se a origem deve apontar para um único blob e se todas as IDs de versão especificadas no arquivo usando esse sinalizador devem pertencer somente ao blob de origem. As IDs de versão especificadas do blob especificado serão excluídas do Armazenamento do Microsoft Azure.
--permanent-delete
(cadeia de caracteres) Essa é uma versão prévia do recurso que exclui permanentemente instantâneos/versões excluídas temporariamente. Os valores possíveis incluem 'snapshots', 'versions', 'snapshotsandversions', 'none'. (padrão “none”)
--trailing-dot
Habilitado por padrão para tratar operações relacionadas ao compartilhamento de arquivos de maneira segura. Opções disponíveis: Enable
, Disable
. Opte por Disable
voltar ao tratamento herdado (potencialmente inseguro) de arquivos de ponto à direita, onde o serviço de arquivos cortará quaisquer pontos à direita nos caminhos. Isso pode resultar em possível corrupção de dados se a transferência contiver dois caminhos que diferem apenas por um ponto à direita (Por exemplo mypath
, e mypath.
). Se esse sinalizador estiver definido como Disable
e o AzCopy encontrar um arquivo de ponto à direita, ele avisará os clientes no log de varredura, mas não tentará abortar a operação. Se o destino não oferecer suporte a arquivos de ponto à direita (Windows ou Armazenamento de Blobs), o AzCopy falhará se o arquivo de ponto à direita for a raiz da transferência e ignorará quaisquer caminhos de pontos à direita encontrados durante a enumeração.
--recursive
False por padrão. Examine subdiretórios recursivamente ao sincronizar entre diretórios.
Opções herdadas de comandos pai
--cap-mbps float
Limita a taxa de transferência em megabits por segundo. A taxa de transferência por minuto pode variar um pouco do limite. Caso essa opção esteja definida como zero ou omitida, a taxa de transferência não tem limite.
--output-type
(cadeia de caracteres) Formato da saída do comando. As opções incluem: text, JSON. O valor padrão é "texto". (padrão “text”)
--trusted-microsoft-suffixes
(cadeia de caracteres) Especifica sufixos de domínio adicionais para onde os tokens de logon do Microsoft Entra podem ser enviados. O padrão é “.core.windows.net;.core.chinacloudapi.cn;.core.cloudapi.de;.core.usgovcloudapi.net;*.storage.azure.net”. Todos listados aqui são adicionados ao padrão. Por segurança, você deve colocar apenas domínios do Microsoft Azure aqui. Separar várias entradas com ponto e vírgula.
--log-level
(cadeia de caracteres) Define o detalhamento do log no arquivo de log. Os níveis disponíveis incluem: INFO (todas as solicitações/respostas), AVISO (respostas lentas), ERRO (somente solicitações com falha) e NENHUM (nenhum log de saída). (padrão 'INFO') (padrão "INFO")