azcopy copy

Copia os dados de origem para um local de destino.

Sinopse

Copia os dados de origem para um local de destino. As instruções suportadas são:

  • local <-> Blob do Azure (Autenticação SAS ou OAuth)
  • local <-> Arquivos do Azure (Compartilhar/diretório de autenticação SAS)
  • local <–> Azure Data Lake Storage Gen2 (autenticação SAS, OAuth, ou chave compartilhada)
  • Blob do Azure (SAS ou público) -> Blob do Azure (autenticação SAS ou OAuth)
  • Azure Data Lake Storage Gen2 (SAS ou público) –> Azure Data Lake Storage Gen2 (autenticação SAS ou OAuth)
  • Blob do Azure (autenticação SAS ou OAuth) <–> Blob do Azure (autenticação SAS ou OAuth) – confira Diretrizes.
  • Azure Data Lake Storage Gen2 (autenticação SAS ou OAuth) <–> Azure Data Lake Storage Gen2 (autenticação SAS ou OAuth)
  • Azure Data Lake Storage Gen2 (autenticação SAS ou OAuth) <–> Blob do Azure (autenticação SAS ou OAuth)
  • Blob do Azure (SAS ou público) -> Arquivos do Azure (SAS)
  • Arquivos do Azure (SAS) -> Arquivos do Azure (SAS)
  • Arquivos do Azure (SAS) -> Blob do Azure (Autenticação SAS ou OAuth)
  • AWS S3 (tecla de acesso) –> blob de blocos do Azure (autenticação SAS ou OAuth)
  • Google Cloud Storage (Chave de conta de serviço) –> blob de blocos do Azure (autenticação SAS ou OAuth)

Confira os exemplos para saber mais.

Avançado

O AzCopy detecta automaticamente o tipo de conteúdo dos arquivos ao carregar do disco local com base na extensão de arquivo ou no conteúdo (se nenhuma extensão for especificada).

A tabela de pesquisa interna é pequena, mas no UNIX, ela é aumentada pelos arquivos mime.types do sistema local, caso estejam disponíveis em um ou mais desses nomes:

  • /etc/mime.types
  • /etc/apache2/mime.types
  • /etc/apache/mime.types

No Windows, os tipos MIME são extraídos do registro. Esse recurso pode ser desativado com a ajuda de um sinalizador. Consulte a seção sinalizador.

Se você definir uma variável de ambiente usando a linha de comando, essa variável será legível no histórico da linha de comando. Considere limpar as variáveis que contêm credenciais do seu histórico de linha de comando. Para impedir que as variáveis apareçam no seu histórico, você pode usar um script para solicitar ao usuário que ele forneça as credenciais dele e defina a variável de ambiente.

azcopy copy [source] [destination] [flags]

Exemplos

Carregar um único arquivo usando a autenticação OAuth. Se você ainda não fez login no AzCopy, execute o comando azcopy login antes de executar o seguinte comando.

azcopy cp "/path/to/file.txt" "https://[account].blob.core.windows.net/[container]/[path/to/blob]"

Faz o mesmo que mencionado acima e também calcula o hash MD5 do conteúdo do arquivo e o salva como a propriedade Content-MD5 do blob:

azcopy cp "/path/to/file.txt" "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --put-md5

Carregar um único arquivo usando um token SAS:

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

Carregar um único arquivo usando um token e um redirecionamento SAS (somente blobs de blocos):

cat "/path/to/file.txt" | azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/blob]?[SAS]" --from-to PipeBlob

Carregar um só arquivo usando OAuth e um redirecionamento SAS (somente blobs de blocos):

cat "/path/to/file.txt" | azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --from-to PipeBlob

Carregar um diretório inteiro usando um token SAS:

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

ou

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

Carregar um conjunto de arquivos usando um token SAS e caracteres curinga (*):

azcopy cp "/path/*foo/*bar/*.pdf" "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]"

Carregar arquivos e diretórios usando um token SAS e caracteres curinga (*):

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

Carregar arquivos e diretórios na conta de Armazenamento do Microsoft Azure e definir as marcas codificadas da cadeia de caracteres de consulta no blob.

  • Para definir as marcas {key = "bla bla", val = "foo"} e {key = "bla bla 2", val = "bar"}, use a sintaxe a seguir:
  • azcopy cp "/path/*foo/*bar*" "https://[account].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --blob-tags="bla%20bla=foo&bla%20bla%202=bar"
  • As chaves e valores são codificados em URLs e os pares de chave-valor são separados por um e comercial ('&')
  • Ao definir marcas nos blobs, há mais permissões (não para marcas) em SAS sem as quais o serviço retorna o erro de autorização.

Baixar um único arquivo usando uma autenticação OAuth. Se você ainda não fez login no AzCopy, execute o comando azcopy login antes de executar o seguinte comando.

azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/blob]" "/path/to/file.txt"

Baixar um único arquivo usando um token SAS:

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

Baixar um único arquivo usando um token SAS e redirecionar a sua saída para um arquivo (somente blobs de blocos):

azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/blob]?[SAS]" --from-to BlobPipe > "/path/to/file.txt"

Baixar um só arquivo usando OAuth e redirecionar a sua saída para um arquivo (somente blobs de blocos):

azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --from-to BlobPipe > "/path/to/file.txt"

Baixar um diretório inteiro usando um token SAS:

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

Observação sobre como usar um caractere curinga (*) em URLs:

Há apenas duas formas possíveis de usar um caractere curinga em uma URL.

  • Você pode usar um caractere logo após a barra final (/) de uma URL. Isso copia todos os arquivos em um diretório diretamente para o destino, sem colocá-los em um subdiretório.

  • Você também pode usar um no nome de um contêiner, desde que a URL se refira a apenas a um contêiner e não a um blob. Você pode usar essa abordagem para obter arquivos de um subconjunto de contêineres.

Baixar os conteúdos de um diretório sem copiar o próprio diretório.

azcopy cp "https://[srcaccount].blob.core.windows.net/[container]/[path/to/folder]/*?[SAS]" "/path/to/dir"

Baixar uma conta de armazenamento inteira.

azcopy cp "https://[srcaccount].blob.core.windows.net/" "/path/to/dir" --recursive

Baixar um subconjunto de contêineres em uma conta de armazenamento usando um caractere curinga (*) no nome do contêiner.

azcopy cp "https://[srcaccount].blob.core.windows.net/[container*name]" "/path/to/dir" --recursive

Baixe todas as versões de um blob do Armazenamento do Azure para o diretório local. Verifique se a origem é um blob válido, o destino é uma pasta local e versionidsFile que usa um caminho para o arquivo em que cada versão é gravada em uma linha separada. Todas as versões especificadas são baixadas na pasta de destino especificada.

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

Copiar um único blob para outro blob usando um token SAS.

azcopy cp "https://[srcaccount].blob.core.windows.net/[container]/[path/to/blob]?[SAS]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/blob]?[SAS]"

Copiar um blob único para outro blob usando um token SAS e um token OAuth.

azcopy cp "https://[srcaccount].blob.core.windows.net/[container]/[path/to/blob]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/blob]"

Copiar um diretório virtual de blob para outro usando um token SAS:

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

Copiar todos os contêineres de blob, diretórios e blobs da conta de armazenamento para outra usando um token SAS:

azcopy cp "https://[srcaccount].blob.core.windows.net?[SAS]" "https://[destaccount].blob.core.windows.net?[SAS]" --recursive=true

Copiar apenas um objeto para o Armazenamento de blobs do Amazon Web Services (AWS) S3 usando uma chave de acesso e um token SAS. Primeiro, defina as variáveis de ambiente AWS_ACCESS_KEY_ID e AWS_SECRET_ACCESS_KEY para a origem do AWS S3.

azcopy cp "https://s3.amazonaws.com/[bucket]/[object]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/blob]?[SAS]"

Copiar um diretório inteiro para o Armazenamento de blobs do AWS S3 usando uma chave de acesso e um token SAS. Primeiro, defina as variáveis de ambiente AWS_ACCESS_KEY_ID e AWS_SECRET_ACCESS_KEY para a origem do AWS S3.

azcopy cp "https://s3.amazonaws.com/[bucket]/[folder]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true

Consultar https://docs.aws.amazon.com/AmazonS3/latest/user-guide/using-folders.html para entender melhor o espaço reservado [pasta].

Copiar todos os buckets para o armazenamento de blobs do AWS (Amazon Web Services) usando uma chave de acesso e um token SAS. Primeiro, defina as variáveis de ambiente AWS_ACCESS_KEY_ID e AWS_SECRET_ACCESS_KEY para a origem do AWS S3.

azcopy cp "https://s3.amazonaws.com/" "https://[destaccount].blob.core.windows.net?[SAS]" --recursive=true

Copiar todos os buckets para o armazenamento de blobs de uma região AWS (Amazon Web Services) usando uma chave de acesso e um token SAS. Primeiro, defina as variáveis de ambiente AWS_ACCESS_KEY_ID e AWS_SECRET_ACCESS_KEY para a origem do AWS S3.

azcopy cp "https://s3-[region].amazonaws.com/" "https://[destaccount].blob.core.windows.net?[SAS]" --recursive=true

Copiar um subconjunto de buckets usando um caractere curinga (*) no nome do bucket. Como os exemplos anteriores, você precisa de uma chave de acesso e um token SAS. Defina as variáveis de ambiente AWS_ACCESS_KEY_ID e AWS_SECRET_ACCESS_KEY para a origem do AWS S3.

azcopy cp "https://s3.amazonaws.com/[bucket*name]/" "https://[destaccount].blob.core.windows.net?[SAS]" --recursive=true

Copie blobs de um armazenamento de blobs para outro e preserve as marcas da origem. Para preservar marcas, use a seguinte sintaxe:

azcopy cp "https://[account].blob.core.windows.net/[source_container]/[path/to/directory]?[SAS]" "https://[account].blob.core.windows.net/[destination_container]/[path/to/directory]?[SAS]" --s2s-preserve-blob-tags=true

Transferir arquivos e diretórios para a conta de Armazenamento do Microsoft Azure e definir as marcas codificadas da cadeia de caracteres de consulta fornecidas no blob.

  • Para definir as marcas {key = "bla bla", val = "foo"} e {key = "bla bla 2", val = "bar"}, use a sintaxe a seguir:

    azcopy cp "https://[account].blob.core.windows.net/[source_container]/[path/to/directory]?[SAS]" "https://[account].blob.core.windows.net/[destination_container]/[path/to/directory]?[SAS]" --blob-tags="bla%20bla=foo&bla%20bla%202=bar"

  • As chaves e valores são codificados em URLs e os pares de chave-valor são separados por um e comercial ('&')

  • Ao definir marcas nos blobs, existem permissões adicionais ('t' para marcas) no SAS sem as quais o serviço apresentará erro de autorização.

Copiar apenas um objeto para o armazenamento de blobs do GCS (Google Cloud Storage) usando uma chave de conta de serviço e um token SAS. Primeiro, defina a variável de ambiente GOOGLE_APPLICATION_CREDENTIALS para a fonte do GCS.

azcopy cp "https://storage.cloud.google.com/[bucket]/[object]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/blob]?[SAS]"

Copiar um diretório inteiro para o armazenamento de blobs do GCS (Google Cloud Storage) usando uma chave de conta de serviço e um token SAS. Primeiro, defina a variável de ambiente GOOGLE_APPLICATION_CREDENTIALS para a fonte do GCS.

azcopy cp "https://storage.cloud.google.com/[bucket]/[folder]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true

Copiar um bucket inteiro para o armazenamento de blobs do GCS (Google Cloud Storage) usando uma chave de conta de serviço e um token SAS. Primeiro, defina a variável de ambiente GOOGLE_APPLICATION_CREDENTIALS para a fonte do GCS.

azcopy cp "https://storage.cloud.google.com/[bucket]" "https://[destaccount].blob.core.windows.net/?[SAS]" --recursive=true

Copiar todos os buckets para o armazenamento de blobs do GCS (Google Cloud Storage) usando uma chave de conta de serviço e um token SAS. Primeiro, defina as variáveis de ambiente GOOGLE_APPLICATION_CREDENTIALS e GOOGLE_CLOUD_PROJECT=<project-id> para a fonte do GCS

azcopy cp "https://storage.cloud.google.com/" "https://[destaccount].blob.core.windows.net/?[SAS]" --recursive=true

Copie um subconjunto de buckets usando um caractere curinga (*) no nome do bucket do GCS (Google Cloud Storage) usando uma chave de conta de serviço e um token SAS para o destino. Primeiro, defina as variáveis de ambiente GOOGLE_APPLICATION_CREDENTIALS and GOOGLE_CLOUD_PROJECT=<project-id> para a origem GCS

azcopy cp "https://storage.cloud.google.com/[bucket*name]/" "https://[destaccount].blob.core.windows.net/?[SAS]" --recursive=true

Opções

--as-subdir True por padrão. Coloca fontes de pasta como subdiretórios no destino. (padrão true)

--backup Ativa o SeBackupPrivilege do Windows para carregamentos ou o SeRestorePrivilege para downloads, para permitir que o AzCopy consulte e leia todos os arquivos, independentemente de suas permissões do sistema de arquivos e restaure todas as permissões. Requer que a conta que executa o AzCopy já tenha essas permissões (por exemplo, tenha direitos de administrador ou seja um membro do grupo 'Operadores de Backup'). Esse sinalizador ativa os privilégios que a conta já tem

--blob-tags (cadeia de caracteres) Define as marcas em blobs para categorizar os dados em sua conta de armazenamento

--blob-type (cadeia de caracteres) Define o tipo de blob no destino. Isso é usado para carregar blobs e ao copiar entre contas (padrão 'Detect'). Os valores válidos incluem 'Detect', 'BlockBlob', 'PageBlob' e 'AppendBlob'. Ao copiar entre contas, um valor de 'Detect' faz com que o AzCopy use o tipo de blob de origem para determinar o tipo do blob de destino. Ao carregar um arquivo, 'Detect' determina se o arquivo é um VHD ou um arquivo VHDX com base na extensão de arquivo. Mesmo que o arquivo seja um VHD ou arquivo VHDX o AzCopy tratará o arquivo como um blob de páginas. (padrão "Detectar")

--block-blob-tier (cadeia de caracteres) carrega um blob de blocos para o Armazenamento do Microsoft Azure usando esta camada de blob. (padrão “Nenhum”)

--block-size-mb (float) Usa esse tamanho de bloco (especificado na MiB) ao carregar no Armazenamento do Microsoft Azure e ao baixar do armazenamento do Azure. O valor padrão é calculado automaticamente com base no tamanho do arquivo. Frações decimais são permitidas (por exemplo: 0,25). Ao carregar ou baixar, o tamanho máximo de bloco permitido é de 0.75 * AZCOPY_BUFFER_GB. Para saber mais, consulte Otimizar o uso da memória.

--cache-control (cadeia de caracteres) Defina o cabeçalho de controle de cache. Devolução no download.

--check-length Verifica o comprimento de um arquivo no destino após a transferência. Se houver incompatibilidade entre a origem e o destino, a transferência será marcada como falha. (padrão true)

--check-md5 (cadeia de caracteres) Especifica o nível de restrição com o qual os hashes MD5 devem ser validados durante o download. Disponível somente durante o download. Opções disponíveis: NoCheck, LogOnly, FailIfDifferent, FailIfDifferentOrMissing. (padrão 'FailIfDifferent') (padrão "FailIfDifferent")

--content-disposition (cadeia de caracteres) Defina o cabeçalho de disposição de conteúdo. Devolução no download.

--content-encoding (cadeia de caracteres) Defina o cabeçalho de codificação de conteúdo. Devolução no download.

--content-language (cadeia de caracteres) Defina o cabeçalho de linguagem de conteúdo. Devolução no download.

--content-type (cadeia de caracteres) Especifique o tipo de conteúdo do arquivo. Sugere o tipo MIME sem estimativa. Devolução no download.

--cpk-by-name (cadeia de caracteres) Chave fornecida pelo cliente por nome que fornece aos clientes que fazem solicitações no Armazenamento de Blobs do Azure a opção de fornecer uma chave de criptografia para cada solicitação. O nome da chave fornecida é obtido do Azure Key Vault e é usado para criptografar os dados

--cpk-by-value Cliente forneceu chave por nome que permite aos clientes que fazem 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 são buscados de variáveis de ambiente

--decompress Descompacta automaticamente os arquivos durante o download, se a codificação de conteúdo indicar que eles estão compactados. Os valores de codificação de conteúdo com suporte são 'gzip' e 'deflate'. Extensões de arquivo de '.gz'/'.gzip' ou '.zz' não são necessárias, mas são removidas se presentes.

--disable-auto-decoding False por padrão para habilitar a decodificação automática de caracteres ilegais no Windows. Pode ser definido como true para desabilitar a decodificação automática.

--dry-run Imprime os caminhos de arquivo que seriam copiados por este comando. Esse sinalizador não copia os arquivos reais. O sinalizador --substituir não tem efeito. Se você definir o sinalizador --substituir como falso, os arquivos no diretório de origem serão listados mesmo se esses arquivos existirem no diretório de destino.

--exclude-attributes (cadeira de caracteres) (somente Windows) Exclui os arquivos cujos atributos correspondem à lista de atributos. Por exemplo: A;S;R

--exclude-blob-type (cadeia de caracteres) Opcionalmente, especifica o tipo de blob (BlockBlob/PageBlob/AppendBlob) a ser excluído ao copiar blobs do contêiner ou da conta. O uso desse sinalizador não é aplicável para copiar dados de serviços não Azure para o serviço. Mais de um blob deve ser separado por ";".

--exclude-path (cadeia de caracteres) Exclua esses caminhos ao copiar. Essa opção não dá suporte a caracteres curinga (*). Verifica o prefixo de caminho relativo (por exemplo: myFolder;myFolder/subDirName/file.pdf). Os caminhos não incluem o nome do contêiner quando usados junto a passagem de conta.

--exclude-pattern (cadeia de caracteres) Exclua esses arquivos ao copiar. Essa opção dá suporte a caracteres curinga (*)

--exclude-regex (cadeia de caracteres) Exclua todo caminho relativo dos arquivos alinhados às expressões regulares. Separe as expressões regulares com ';'.

--follow-symlinks Segue links simbólicos ao carregar do sistema de arquivos local.

--force-if-read-only Ao substituir um arquivo existente no Windows ou em Arquivos do Azure, force a substituição para funcionar mesmo que o arquivo existente tenha seu próprio atributo somente leitura definido

--from-to (cadeia de caracteres) Especifica opcionalmente a combinação de origem e destino. Por exemplo: LocalBlob, BlobLocal, LocalBlobFS. Piping: BlobPipe, PipeBlob

-h, --help ajuda para cópia

--include-after (cadeia de caracteres) Inclua apenas os arquivos modificados após ou na data/hora determinada. O valor deve estar no formato ISO8601. Se não for especificado um fuso horário, o valor será considerado de acordo com o fuso horário local do computador que está executando o AzCopy. Por exemplo, 2020-08-19T15:04:00Z para um horário UTC ou 2020-08-19 para às 0h (meia-noite) no fuso horário local. Como o AzCopy 10.5, 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-attributes (cadeia de caracteres) (somente Windows) Inclui os arquivos cujos atributos correspondem à lista de atributos. Por exemplo: A;S;R

--include-before (cadeia de caracteres) Inclua apenas os arquivos modificados antes ou na data/hora determinada. O valor deve estar no formato ISO8601. Se não for especificado um fuso horário, o valor será considerado de acordo com o fuso horário local do computador que está executando o AzCopy. por exemplo, 2020-08-19T15:04:00Z para um horário UTC ou 2020-08-19 para às 0h (meia-noite) 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-directory-stub Falso por padrão para ignorar stubs de diretório. Stubs de diretório são blobs com metadados hdi_isfolder:true. Definir o valor como true preservará os stubs de diretório durante as transferências. Incluir esse sinalizador sem valor tem como padrão true (por exemplo,azcopy copy --include-directory-stub é o mesmo que azcopy copy --include-directory-stub=true).

--include-path (cadeia de caracteres) Inclua apenas esses caminhos ao copiar. Essa opção não dá suporte a caracteres curinga (*). Verifica o prefixo de caminho relativo (por exemplo: myFolder;myFolder/subDirName/file.pdf).

--include-pattern (cadeia de caracteres) Inclua apenas esses arquivos ao copiar. Essa opção dá suporte a caracteres curinga (*). Separe arquivos usando um ";".

--include-regex (cadeia de caracteres) Inclua apenas o caminho relativo dos arquivos alinhados às expressões regulares. Separe as expressões regulares com ';'.

--list-of-versions (cadeia de caracteres) Especifica um arquivo 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. O AzCopy baixará as versões especificadas na pasta de destino fornecida.

--log-level (cadeia de caracteres) define o detalhamento do arquivo de log, com os níveis disponíveis: INFORMAÇÕES (todas as solicitações/respostas), AVISO (respostas lentas), ERRO (somente solicitações com falha) e NENHUM (sem logs de saída). (padrão 'INFO'). (padrão "INFO")

--metadata (cadeia de caracteres) Carregue no Armazenamento do Microsoft Azure esses pares de chave-valor como metadados.

--no-guess-mime-type Impede que o AzCopy detecte o tipo de conteúdo com base na extensão ou no conteúdo do arquivo.

--overwrite (cadeia de caracteres) Substitua os arquivos conflitantes e os blobs no destino se esse sinalizador for definido como verdadeiro. (padrão 'true') Os valores possíveis incluem 'true', 'false', 'prompt' e 'ifSourceNewer'. Para destinos que oferecem suporte a pastas, as propriedades conflitantes no nível da pasta serão substituídas se esse sinalizador for 'true' ou se uma resposta positiva for fornecida ao prompt. (padrão “true”)

--page-blob-tier (cadeia de caracteres) Carregue um blob de páginas no Armazenamento do Azure usando esta camada de blob. (padrão 'None'). (padrão “Nenhum”)

--preserve-last-modified-time Disponível somente quando o destino é sistema de arquivos.

--preserve-owner Só tem efeito em downloads e somente quando --preserve-smb-permissions é usado. Se true (o padrão), o proprietário e o grupo do arquivo forem preservados nos downloads. Se definido como false,

--preserve-smb-permissions ainda preservará ACLs, mas Proprietário e Grupo é baseado no usuário que executa o AzCopy (true padrão)

--preserve-permissions False por padrão. Preserva as ACLs entre os recursos com reconhecimento (Windows e Arquivos do Azure ou Azure Data Lake Storage Gen2 para Azure Data Lake Storage Gen2). Para contas que têm um namespace hierárquico, sua entidade de segurança deve ser o usuário proprietário do contêiner de destino ou deve receber a função Proprietário de Dados do Blob de Armazenamento, com escopo para o contêiner de destino, conta de armazenamento, grupo de recursos pai ou assinatura. Para baixar, você também precisará do sinalizador --backup para restaurar as permissões nas quais o novo proprietário não será o usuário que vai executar o AzCopy. Esse sinalizador é aplicável a arquivos e pastas, a menos que um filtro de apenas arquivo seja especificado (por exemplo, incluir padrão).

--preserve-smb-info Para locais com reconhecimento de SMB, o sinalizador é definido como true por padrão. Preserva as informações de propriedade SMB (hora da última gravação, hora de criação, bits de atributo) entre recursos com reconhecimento de SMB (arquivos do Windows e do Azure). Somente os bits de atributo suportados pelos Arquivos do Azure são transferidos; quaisquer outros são ignorados. Esse sinalizador é aplicável a arquivos e pastas, a menos que um filtro de apenas arquivo seja especificado (por exemplo, incluir padrão). As informações transferidas para pastas são as mesmas para arquivos, exceto por Last Write Time, que nunca é preservada para pastas. (padrão true)

--preserve-symlinks Se habilitado, os destinos do link simbólico serão preservados como o conteúdo do blob, em vez de carregar o arquivo ou a pasta na outra extremidade do link simbólico.

--put-blob-size-mb Use esse tamanho (especificado em MiB) como um limite para determinar se um blob deve ser carregado como uma única solicitação PUT ao carregar no Armazenamento do Azure. O valor padrão é calculado automaticamente com base no tamanho do arquivo. Frações decimais são permitidas (por exemplo: 0,25).

--put-md5 Cria um hash MD5 de cada arquivo e salva o hash como a propriedade Content-MD5 do blob ou arquivo de destino. (Por padrão, o hash NÃO é criado.) Disponível somente ao carregar.

--recursive Examina os subdiretórios recursivamente ao carregar do sistema de arquivos local.

--s2s-detect-source-changed Detectar se o arquivo de origem/blob muda enquanto está sendo lido. (Esse parâmetro se aplica somente a cópias de serviço a serviço, pois a verificação correspondente é permanentemente habilitada para uploads e downloads.)

--s2s-handle-invalid-metadata (cadeia de caracteres) Especifique como são tratadas as chaves de metadados inválidas. Opções disponíveis: ExcludeIfInvalid, FailIfInvalid, RenameIfInvalid. ('ExcludeIfInvalid' padrão). (padrão "ExcludeIfInvalid")

--s2s-preserve-access-tier Preserva a camada de acesso durante a cópia de serviço para serviço. Consulte o Armazenamento de blobs do Azure: camadas de acesso frequentes, esporádicos e do arquivo para garantir que a conta de armazenamento de destino dê suporte à configuração da camada de acesso. Nos casos em que não há suporte para a configuração da camada de acesso, use s2sPreserveAccessTier=false para ignorar a cópia da camada de acesso. (padrão true). (padrão true)

--s2s-preserve-blob-tags Preserva as marcas de índice durante a transferência de serviço a serviço de um armazenamento de blobs para outro

--s2s-preserve-properties Preserva todas as propriedades durante a cópia de serviço a serviço. Para os AWS S3 e fonte de arquivo não único de arquivo do Azure, a operação de lista não retorna todas as propriedades de objetos e arquivos. Para preservar todas as propriedades, o AzCopy precisa enviar mais solicitações por objeto ou arquivo. (padrão true)

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.

Confira também