azcopy copy
Copia os dados de origem para um local de destino.
Nota
O AzCopy não suporta cenários em que a origem ou o destino estão sendo ativamente alterados durante a transferência.
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 (autenticação SAS de compartilhamento/diretório ou autenticação OAuth)
- local <-> Azure Data Lake Storage (autenticação SAS, OAuth ou SharedKey)
- Blob do Azure (SAS ou público) -> Blob do Azure (autenticação SAS ou OAuth)
- Azure Data Lake Storage (SAS ou público) -> Azure Data Lake Storage (autenticação SAS ou OAuth)
- Blob do Azure (autenticação SAS ou OAuth) <-> Blob do Azure (autenticação SAS ou OAuth) - Consulte Diretrizes.
- Azure Data Lake Storage (autenticação SAS ou OAuth) <-> Azure Data Lake Storage (autenticação SAS ou OAuth)
- Azure Data Lake Storage (autenticação SAS ou OAuth) <-> Azure Blob (autenticação SAS ou OAuth)
- Blob do Azure (SAS ou público) -> Arquivos do Azure (SAS)
- Arquivo do Azure (autenticação SAS ou OAuth) <-> Arquivo do Azure (autenticação SAS ou OAuth)
- Arquivos do Azure (SAS) -> Blob do Azure (autenticação SAS ou OAuth)
- AWS S3 (chave de acesso) -> Azure Block Blob (autenticação SAS ou OAuth)
- Google Cloud Storage (Chave de Conta de Serviço) -> Azure Block Blob (autenticação SAS ou OAuth)
Consulte os exemplos para obter mais informações.
Avançado
AzCopy deteta automaticamente o tipo de conteúdo dos arquivos ao carregar a partir do disco local, com base na extensão do arquivo ou conteúdo (se nenhuma extensão for especificada).
A tabela de pesquisa integrada é pequena, mas no Unix, ela é aumentada pelo(s) arquivo(s) mime.types do sistema local, se disponível sob um ou mais destes nomes:
- /etc/mime.types
- /etc/apache2/mime.types
- /etc/apache/mime.types
No Windows, os tipos MIME são extraídos do registo. Este recurso pode ser desativado com a ajuda de um sinalizador. Consulte a seção de bandeira.
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 variáveis que contenham credenciais do histórico da linha de comando. Para impedir que as variáveis apareçam em seu histórico, você pode usar um script para solicitar ao usuário suas credenciais e definir a variável de ambiente.
azcopy copy [source] [destination] [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
Carregue um único arquivo usando a autenticação OAuth. Se ainda não iniciou sessão 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]"
O mesmo que acima, mas desta vez também calcule o hash MD5 do conteúdo do arquivo e salve-o 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
Carregue um único arquivo usando um token SAS:
azcopy cp "/path/to/file.txt" "https://[account].blob.core.windows.net/[container]/[path/to/blob]?[SAS]"
Carregue um único arquivo usando um token SAS e tubulação (somente blobs de bloco):
cat "/path/to/file.txt" | azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/blob]?[SAS]" --from-to PipeBlob
Carregue um único arquivo usando OAuth e tubulação (somente blobs de bloco):
cat "/path/to/file.txt" | azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --from-to PipeBlob
Carregue 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
Carregue 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]"
Carregue 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
Carregue arquivos e diretórios para a conta de Armazenamento do Azure e defina as tags codificadas de cadeia de caracteres de consulta no blob.
- Para definir tags {key = "bla bla", val = "foo"} e {key = "bla bla 2", val = "bar"}, use a seguinte sintaxe:
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 os valores são codificados por URL e os pares chave-valor são separados por um e comercial('&')
- Ao definir tags nos blobs, há mais permissões('t' para tags) no SAS sem as quais o serviço devolve o erro de autorização.
Baixe um único arquivo usando a autenticação OAuth. Se ainda não iniciou sessão 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"
Baixe um único arquivo usando um token SAS:
azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/blob]?[SAS]" "/path/to/file.txt"
Transfira um único ficheiro utilizando um token SAS e, em seguida, canalize a saída para um ficheiro (apenas blobs de bloco):
azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/blob]?[SAS]" --from-to BlobPipe > "/path/to/file.txt"
Baixe um único arquivo usando OAuth e, em seguida, canalizando a saída para um arquivo (somente blobs de bloco):
azcopy cp "https://[account].blob.core.windows.net/[container]/[path/to/blob]" --from-to BlobPipe > "/path/to/file.txt"
Baixe 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
Uma observação sobre o uso de um caractere curinga (*) em URLs:
Há apenas duas maneiras suportadas de usar um caractere curinga em uma URL.
Você pode usar uma 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 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.
Baixe o conteúdo de um diretório sem copiar o diretório que o contém.
azcopy cp "https://[srcaccount].blob.core.windows.net/[container]/[path/to/folder]/*?[SAS]" "/path/to/dir"
Faça o download de uma conta de armazenamento inteira.
azcopy cp "https://[srcaccount].blob.core.windows.net/" "/path/to/dir" --recursive
Baixe um subconjunto de contêineres em uma conta de armazenamento usando um símbolo 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 listadas em um arquivo de texto (por exemplo: versionidsFile) para o diretório local. Certifique-se de que a origem é um blob válido, o destino é uma pasta local e versionidsFile é um arquivo de texto onde cada versão é escrita 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]"
Copie 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]"
Copie um único blob 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]"
Copie 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
Copie 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
Copie um único objeto para o Blob Storage do Amazon Web Services (AWS) S3 usando uma chave de acesso e um token SAS. Primeiro, defina a variável 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]"
Copie um diretório inteiro para o Blob Storage do AWS S3 usando uma chave de acesso e um token SAS. Primeiro, defina a variável 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
Consulte para https://docs.aws.amazon.com/AmazonS3/latest/user-guide/using-folders.html entender melhor o espaço reservado [pasta].
Copie todos os buckets para o Blob Storage da Amazon Web Services (AWS) usando uma chave de acesso e um token SAS. Primeiro, defina a variável 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
Copie todos os buckets para o Blob Storage de uma região da Amazon Web Services (AWS) usando uma chave de acesso e um token SAS. Primeiro, defina a variável 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
Copie um subconjunto de buckets usando um símbolo curinga (*) no nome do bucket. Como os exemplos anteriores, você precisa de uma chave de acesso e um token SAS. Certifique-se de definir a variável 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 blob para outro e preserve as tags da origem. Para preservar tags, 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
Transfira arquivos e diretórios para a conta de Armazenamento do Azure e defina as tags codificadas de cadeia de caracteres de consulta no blob.
Para definir tags {key = "bla bla", val = "foo"} e {key = "bla bla 2", val = "bar"}, 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]" --blob-tags="bla%20bla=foo&bla%20bla%202=bar"As chaves e os valores são codificados por URL e os pares chave-valor são separados por um e comercial('&')
Ao definir tags nos blobs, há permissões adicionais ('t' para tags) no SAS sem as quais o serviço devolverá o erro de autorização.
Copie um único objeto para o Armazenamento de Blobs do Google Cloud Storage (GCS) usando uma chave de conta de serviço e um token SAS. Primeiro, defina a variável de ambiente GOOGLE_APPLICATION_CREDENTIALS para a origem GCS.
azcopy cp "https://storage.cloud.google.com/[bucket]/[object]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/blob]?[SAS]"
Copie um diretório inteiro para o Armazenamento de Blobs do Google Cloud Storage (GCS) usando uma chave de conta de serviço e um token SAS. Primeiro, defina a variável de ambiente GOOGLE_APPLICATION_CREDENTIALS para a origem GCS.
azcopy cp "https://storage.cloud.google.com/[bucket]/[folder]" "https://[destaccount].blob.core.windows.net/[container]/[path/to/directory]?[SAS]" --recursive=true
Copie um bucket inteiro para o Blob Storage do Google Cloud Storage (GCS) usando uma chave de conta de serviço e um token SAS. Primeiro, defina a variável de ambiente GOOGLE_APPLICATION_CREDENTIALS para a origem GCS.
azcopy cp "https://storage.cloud.google.com/[bucket]" "https://[destaccount].blob.core.windows.net/?[SAS]" --recursive=true
Copie todos os buckets do Google Cloud Storage (GCS) para o Blob 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 origem 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 símbolo curinga (*) no nome do bucket do Google Cloud Storage (GCS) usando uma chave de conta de serviço e um token SAS para destino. Primeiro, defina as variáveis GOOGLE_APPLICATION_CREDENTIALS and GOOGLE_CLOUD_PROJECT=<project-id> de ambiente para a origem do GCS
azcopy cp "https://storage.cloud.google.com/[bucket*name]/" "https://[destaccount].blob.core.windows.net/?[SAS]" --recursive=true
Para copiar arquivos alterados antes ou depois do início do trabalho AzCopy, o AzCopy fornece data e hora no log de trabalho no formato ISO8601 (procure por 'ISO 8601 START TIME' no log de trabalhos) que pode ser usado com os --include-after sinalizadores e --include-before , veja os exemplos abaixo. Isso é útil para cópias incrementais.
Copie um subconjunto de arquivos modificados em ou após a data e hora especificadas (em formato ISO8601) em um contêiner usando o include-after sinalizador.
azcopy cp "https://[srcaccount].blob.core.windows.net/[containername]?[SAS]" "https://[dstaccount].blob.core.windows.net/[containername]?[SAS]" --include-after="2020-08-19T15:04:00Z"
Copie um subconjunto de arquivos modificados em ou antes da data e hora especificadas (em formato ISO8601) em um contêiner usando o include-before sinalizador.
azcopy cp "https://[srcaccount].blob.core.windows.net/[containername]?[SAS]" "https://[dstaccount].blob.core.windows.net/[containername]?[SAS]" --include-before="2020-08-19T15:04:00Z"
Opções
--as-subdir True por padrão. Coloca as fontes de pasta como subdiretórios sob o destino. (padrão true)
--backup Ativa o SeBackupPrivilege do Windows para uploads, ou SeRestorePrivilege para downloads, para permitir que o AzCopy veja todos os arquivos lidos, 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 membro do grupo 'Operadores de Backup'). Este sinalizador ativa privilégios que a conta já tem
--blob-tags (string) Definir tags em blobs para categorizar dados em sua conta de armazenamento
--blob-type (string) 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 de blob de destino. Ao carregar um ficheiro, 'Detectar' determina se o ficheiro é um ficheiro VHD ou VHDX com base na extensão do ficheiro. Se o arquivo for um arquivo VHD ou VHDX, o AzCopy tratará o arquivo como um blob de página. (padrão "Detetar")
--block-blob-tier (string) carregar blob de bloco para o Armazenamento do Azure usando essa camada de blob. (padrão "Nenhum")
--block-size-mb (flutuar) Use esse tamanho de bloco (especificado em MiB) ao carregar no Armazenamento do Azure e fazer o download 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 permitido do bloco é 0,75 * AZCOPY_BUFFER_GB. Para saber mais, consulte Otimizar o uso da memória.
--cache-control (string) Defina o cabeçalho cache-control. Retornado no download.
--check-length Verifique o comprimento de um arquivo no destino após a transferência. Se houver uma incompatibilidade entre origem e destino, a transferência será marcada como falha. (padrão true)
--check-md5 (string) Especifica como estritamente os hashes MD5 devem ser validados durante o download. Disponível apenas durante o download. Opções disponíveis: NoCheck, LogOnly, FailIfDifferent, FailIfDifferentOrMissing. (padrão 'FailIfDifferent') (padrão "FailIfDifferent")
--content-disposition (string) Defina o cabeçalho de disposição de conteúdo. Retornado no download.
--content-encoding (string) Defina o cabeçalho de codificação de conteúdo. Retornado no download.
--content-language (string) Defina o cabeçalho do idioma do conteúdo. Retornado no download.
--content-type (string) Especifica o tipo de conteúdo do arquivo. Implica no-guess-mime-type. Retornado no download.
--cpk-by-name (string) O cliente forneceu chave por nome que dá aos clientes que fazem solicitações no armazenamento de Blob do Azure uma opção para fornecer uma chave de criptografia por solicitação. O nome da chave fornecida é buscado no Cofre da Chave do Azure e é usado para criptografar os dados
--cpk-by-value Falso por padrão. O cliente forneceu chave por nome que permite aos clientes que fazem solicitações no armazenamento de Blob do Azure uma opção para fornecer uma chave de criptografia por solicitação. A chave fornecida e seu hash são obtidos de variáveis de ambiente
--decompress Descompacte automaticamente os arquivos ao fazer o download, se a codificação de conteúdo indicar que eles estão compactados. Os valores de codificação de conteúdo suportados são 'gzip' e 'deflate'. As extensões de arquivo de '.gz'/'.gzip' ou '.zz' não são necessárias, mas são removidas se estiverem 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 desativar a decodificação automática.
--dry-run Falso por padrão. Imprime os caminhos de arquivo que seriam copiados por este comando. Esse sinalizador não copia os arquivos reais. O sinalizador --overwrite não tem efeito. Se você definir o sinalizador --overwrite como false, os arquivos no diretório de origem serão listados mesmo que esses arquivos existam no diretório de destino.
--exclude-attributes (string) (Apenas Windows) Exclua arquivos cujos atributos correspondam à lista de atributos. Por exemplo: A; S; R
--exclude-blob-type (string) 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 azures para serviços. Mais de um blob deve ser separado por ';'.
--exclude-container (string) Exclua esses contêineres ao transferir apenas de conta para conta. Vários recipientes podem ser separados com ';'.
--exclude-path (string) Exclua esses caminhos ao copiar. Esta opção não suporta caracteres curinga (*). Verifica o prefixo do caminho relativo(Por exemplo: myFolder; myFolder/subDirName/file.pdf). Quando usados em combinação com a passagem de conta, os caminhos não incluem o nome do contêiner.
--exclude-pattern (string) Exclua esses arquivos ao copiar. Esta opção suporta caracteres curinga (*)
--exclude-regex (string) Exclua todo o caminho relativo dos arquivos que se alinham com expressões regulares. Separe expressões regulares com ';'.
--follow-symlinks Siga links simbólicos ao carregar do sistema de arquivos local.
--force-if-read-only Ao substituir um arquivo existente em Arquivos do Windows ou do Azure, force a substituição a funcionar mesmo que o arquivo existente tenha seu atributo somente leitura definido
--from-to (string) Opcionalmente, especifica a combinação de destino de origem. Por exemplo: LocalBlob, BlobLocal, LocalBlobFS. Tubulação: BlobPipe, PipeBlob
-h, --help ajuda para cópia
--include-after (string) Inclua apenas os ficheiros modificados na ou após a data/hora indicada. 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 uma hora 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-permissions.
--include-attributes (string) (Apenas Windows) Inclua arquivos cujos atributos correspondam à lista de atributos. Por exemplo: A; S; R
--include-before (string) Inclua apenas os ficheiros modificados antes ou na data/hora indicada. 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 uma hora 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-directory-stub False por padrão para ignorar stubs de diretório. Os 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 este sinalizador sem valor assume como padrão true (por exemplo, azcopy copy --include-directory-stub é o mesmo que azcopy copy --include-directory-stub=true).
--include-path (string) Inclua apenas esses caminhos ao copiar. 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 esses arquivos ao copiar. Esta opção suporta caracteres curinga (*). Separe os arquivos usando um ';'.
--include-regex (string) Inclua apenas o caminho relativo dos arquivos que se alinham com expressões regulares. Separe expressões regulares com ';'.
--list-of-versions (string) Especifica um arquivo 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. AzCopy fará o download das versões especificadas na pasta de destino fornecida.
--metadata (string) Carregue no Armazenamento do Azure com esses pares chave-valor como metadados.
--no-guess-mime-type Impede que o AzCopy detete o tipo de conteúdo com base na extensão ou no conteúdo do arquivo.
--overwrite (string) Substitua os arquivos e blobs conflitantes no destino se esse sinalizador estiver definido como true. (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 são substituídas se esse sinalizador for 'true' ou se uma resposta positiva for fornecida ao prompt. (padrão "true")
--page-blob-tier (string) Carregue o blob de página no Armazenamento do Azure usando essa camada de blob. (por defeito, «Nenhum»). (padrão "Nenhum")
--preserve-last-modified-time Disponível apenas quando o destino é o sistema de arquivos.
--preserve-owner Só tem efeito em downloads, e somente quando --preserve-smb-permissions é usado. Se true (o padrão), o arquivo Proprietário e Grupo são preservados em downloads. Se definido como false,
--preserve-smb-permissions ainda preservará ACLs, mas Owner and Group é baseado no usuário que executa o AzCopy (padrão true)
--preserve-permissions Falso por padrão. Preserva ACLs entre recursos sensíveis (Arquivos do Windows e do Azure ou Armazenamento do Azure Data Lake para Armazenamento do Azure Data Lake). 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 ser atribuída a função de Proprietário de Dados de Blob de Armazenamento, com escopo para o contêiner de destino, conta de armazenamento, grupo de recursos pai ou assinatura. Para downloads, você também precisará do --backup sinalizador para restaurar permissões onde o novo proprietário não será o usuário executando o AzCopy. Esse sinalizador se aplica a arquivos e pastas, a menos que um filtro somente arquivo seja especificado (por exemplo, include-pattern).
--preserve-posix-properties Falso por padrão. Preserva as informações de propriedade obtidas de ou statx para metadados de stat objeto.
--preserve-smb-info Para locais com reconhecimento de SMB, o sinalizador é definido como true por padrão. Preserva as informações da propriedade SMB (última hora de gravação, hora de criação, bits de atributo) entre recursos com reconhecimento de SMB (Arquivos do Windows e do Azure). Apenas os bits de atributo suportados pelos Arquivos do Azure são transferidos; quaisquer outros são ignorados. Esse sinalizador se aplica a arquivos e pastas, a menos que um filtro somente arquivo seja especificado (por exemplo, include-pattern). As informações transferidas para pastas são as mesmas que para arquivos, exceto Last Write Time para as quais nunca são preservadas para pastas. (padrão true)
--preserve-symlinks Se ativado, os destinos do link simbólico são preservados como o conteúdo do blob, em vez de carregar o arquivo ou 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 Crie um hash MD5 de cada arquivo e salve o hash como a propriedade Content-MD5 do blob ou arquivo de destino. (Por predefinição, o hash NÃO é criado). Apenas está disponível ao carregar.
--recursive Analise os subdiretórios recursivamente ao carregar a partir do sistema de arquivos local.
--s2s-detect-source-changed Detete se o arquivo/blob de origem muda enquanto está sendo lido. (Este parâmetro só se aplica a cópias de serviço para serviço, porque a verificação correspondente está permanentemente habilitada para uploads e downloads.)
--s2s-handle-invalid-metadata (string) Especifica como as chaves de metadados inválidas são tratadas. Opções disponíveis: ExcludeIfInvalid, FailIfInvalid, RenameIfInvalid. (padrão 'ExcludeIfInvalid'). (padrão "ExcludeIfInvalid")
--s2s-preserve-access-tier Preservar a camada de acesso durante o serviço para cópia de serviço. Consulte Armazenamento de Blob do Azure: camadas de acesso quente, legal e de arquivamento para garantir que a conta de armazenamento de destino ofereça suporte à configuração da camada de acesso. Nos casos em que a configuração da camada de acesso não é suportada, certifique-se de usar s2sPreserveAccessTier=false para ignorar a camada de acesso de cópia. (padrão true). (padrão true)
--s2s-preserve-blob-tags Falso por padrão. Preservar tags de índice durante a transferência de serviço para serviço de um armazenamento de blob para outro
--s2s-preserve-properties Preserve propriedades completas durante o serviço para cópia de serviço. Para a origem de arquivo não única do AWS S3 e do Azure File, a operação de lista não retorna propriedades completas de objetos e arquivos. Para preservar as propriedades completas, o AzCopy precisa enviar mais uma solicitação por objeto ou arquivo. (padrão true)
--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.
Opções herdadas dos comandos pai
--cap-mbps (flutuar) 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.
--log-level (string) Defina a verbosidade do log para o arquivo de log, níveis disponíveis: INFO(todas as solicitações/respostas), WARNING(respostas lentas), ERROR(somente solicitações com falha) e NONE(sem logs de saída). (padrão 'INFO'). (padrão "INFO")
--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.