azcopy remove
Exclua blobs ou arquivos de uma conta de armazenamento do Azure.
Sinopse
azcopy remove [resourceURL] [flags]
Artigos conceptuais relacionados
- Introdução ao AzCopy
- Transfira dados com o armazenamento AzCopy e Blob
- Transferir dados com o AzCopy e armazenamento de ficheiros
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 apenas os blobs dentro de um diretório virtual, mas não remova nenhum subdiretório 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 apenas 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"
Remova um diretório virtual inteiro, mas exclua determinados blobs do escopo (por exemplo: cada blob que começa com foo 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. Certifique-se de que a fonte é um blob válido e versionidsfile
que leva em um caminho para o arquivo onde 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 específicos e diretórios virtuais 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 é escrito em uma linha separada. O --list-of-files
sinalizador pode incorrer em custos de desempenho devido a transações adicionais para recuperar propriedades do objeto. Para obter mais informações sobre as APIs que o AzCopy usa e 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
Remova um único arquivo de uma conta de Armazenamento de Blob que tenha um namespace hierárquico (inclusão/exclusão não suportada):
azcopy rm "https://[account].dfs.core.windows.net/[container]/[path/to/file]?[SAS]"
Remova um único diretório de uma conta de Armazenamento de Blob que tenha um namespace hierárquico (inclusão/exclusão não suportada):
azcopy rm "https://[account].dfs.core.windows.net/[container]/[path/to/directory]?[SAS]"
Opções
--cpk-by-name
(string) A chave fornecida pelo cliente pelo nome permite que os clientes que fazem solicitações no Armazenamento de Blobs do Azure sejam uma opção para fornecer uma chave de criptografia por solicitação. O nome da chave fornecida será buscado no Cofre de Chaves do Azure e será usado para criptografar os dados.
--cpk-by-value
Falso por padrão. A chave fornecida pelo cliente pelo nome permite que os clientes que fazem solicitações no Armazenamento de Blobs do Azure sejam uma opção para fornecer uma chave de criptografia por solicitação. A chave fornecida e seu hash serão buscados a partir de variáveis CPK_ENCRYPTION_KEY
de ambiente e CPK_ENCRYPTION_KEY_SHA256
.
--delete-snapshots
(string) Por padrão, a operação de exclusão falhará se um blob tiver instantâneos. Especifique 'include' para remover o blob raiz e todos os seus snapshots; Como alternativa, especifique 'apenas' para remover apenas os instantâneos, mas mantenha o blob raiz.
--dry-run
Falso por padrão. Imprime os arquivos de caminho que seriam removidos pelo comando. Este sinalizador não aciona a remoção dos ficheiros.
--exclude-path
(string) Exclua esses caminhos ao remover. Esta opção não suporta caracteres curinga (*). Verifica o prefixo do caminho relativo. Por exemplo: myFolder; myFolder/subDirName/file.pdf
--exclude-pattern
(string) Exclua arquivos em que o nome corresponde à lista de padrões. Por exemplo: .jpg;. pdf; exactName
--force-if-read-only
Falso por padrão. Ao excluir um arquivo ou pasta de Arquivos do Azure, force a exclusão para funcionar mesmo que o objeto existente tenha seu atributo somente leitura definido
--from-to
(string) Opcionalmente, especifica a combinação de destino de origem. Por exemplo: BlobTrash, FileTrash, BlobFSTrash
-h
, --help
ajuda para remover
--include-after
(string) Inclua apenas os ficheiros modificados na data e hora indicadas ou após essa data. O valor deve estar no formato ISO8601. Se nenhum fuso horário for especificado, presume-se que o valor esteja 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 apenas 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
(string) Inclua apenas os ficheiros modificados antes ou na data e hora indicadas. O valor deve estar no formato ISO8601. Se nenhum fuso horário for especificado, presume-se que o valor esteja 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.7, esse sinalizador se aplica apenas 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-permissions
.
--include-path
(string) Inclua apenas esses caminhos ao remover. Esta opção não suporta caracteres curinga (*). Verifica o prefixo do caminho relativo. Por exemplo: myFolder; myFolder/subDirName/file.pdf
--include-pattern
(string) Inclua apenas arquivos em que o nome corresponda à lista de padrões. Por exemplo: .jpg;. pdf; exactName
--list-of-files
(string) 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 por URL.
--list-of-versions
(string) Especifica um arquivo de texto onde cada ID de versão é listado em uma linha separada. Certifique-se de que a origem deve apontar para um único blob e todos os IDs de versão especificados no arquivo usando esse sinalizador devem pertencer apenas ao blob de origem. As IDs de versão especificadas do blob fornecido serão excluídas do Armazenamento do Azure.
--permanent-delete
(string) Este é um recurso de visualização que exclui PERMANENTEMENTE instantâneos/versões excluídos por software. Os valores possíveis incluem 'snapshots', 'versions', 'snapshotsandversions', 'none'. (padrão "nenhum")
--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 pontos à direita, onde o serviço de arquivos cortará todos os pontos à direita nos caminhos. Isso pode resultar em potencial 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 pontos à direita, ele avisará os clientes no log de varredura, mas não tentará abortar a operação. Se o destino não suportar arquivos de pontos à direita (Windows ou Armazenamento de Blob), o AzCopy falhará se o arquivo de pontos à direita for a raiz da transferência e ignorará quaisquer caminhos de pontos à direita encontrados durante a enumeração.
--recursive
Falso por padrão. Analise os subdiretórios recursivamente ao sincronizar entre diretórios.
Opções herdadas dos comandos pai
--cap-mbps float
Limita a taxa de transferência, em megabits por segundo. A taxa de transferência momento a momento pode variar ligeiramente do limite. Se essa opção estiver definida como zero ou for omitida, a taxa de transferência não será limitada.
--output-type
(string) Formato da saída do comando. As opções incluem: texto, json. O valor padrão é 'text'. (padrão "texto")
--trusted-microsoft-suffixes
(string) Especifica sufixos de domínio adicionais para onde os tokens de login do Microsoft Entra podem ser enviados. O padrão é '.core.windows.net;. core.chinacloudapi.cn;. core.cloudapi.de;. core.usgovcloudapi.net;*.storage.azure.net'. Qualquer listado aqui é adicionado ao padrão. Por segurança, você só deve colocar domínios do Microsoft Azure aqui. Separe várias entradas com ponto-e-vírgula.
--log-level
(string) Defina a verbosidade do log para o arquivo de log. Os níveis disponíveis incluem: INFO(todas as solicitações/respostas), WARNING(respostas lentas), ERROR(apenas solicitações com falha) e NONE(sem logs de saída). (padrão 'INFO') (padrão "INFO")