As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Transferir arquivos usando a interface de linha de comandos (CLI)
As seções a seguir detalham como fazer upload, baixar e configurar hot folders File Transfer com a interface de linha de comando (CLI).
**Topics**
+ [Upload de arquivos](#upload-cli)
+ [Configurar pastas ativas](#hot-folders-file-transfer-cli)
+ [Baixe arquivos](#download-cli)
## Upload de arquivos
Os comandos a seguir são para a interface de linha de comandos (CLI). Com esses comandos, você pode baixar arquivos do bucket S3 correspondente que você configurou em seu arquivo de configuração. Você pode executar esses comandos de qualquer lugar no seu computador. No entanto, recomendamos executar esses comandos a partir da raiz.
O File Transfer preserva a estrutura de pastas que você fornece. Isso significa que a estrutura de pastas permanece a mesma depois de chegar ao Amazon S3. No entanto, você não pode dar um caminho absoluto ao File Transfer. Isso significa que o caminho do arquivo não pode começar com uma `/` (barra).
O File Transfer faz upload para todas as classes de armazenamento do S3. Para obter mais informações sobre as classes de armazenamento, consulte [Classes de armazenamento do Amazon S3](https://aws.amazon.com/s3/storage-classes/).
**nota**
Recomendamos que você desabilite o modo de suspensão no computador local. Se o computador ativar o modo de suspensão, as transferências em andamento poderão ser interrompidas. Em **Configurações**, ative a opção **Desabilitar o modo de suspensão (somente macOS)**.
**Para iniciar os carregamentos usando a CLI**
1. Abra um terminal.
1. (Recomendado) Navegue até a pasta que contém os arquivos e pastas que você quer enviar por upload.
1. Execute o comando a seguir de qualquer lugar do seu computador para fazer upload de arquivos da sua máquina local para o Amazon S3.
```
filetransfer upload [transfer profile] [relative path]
```
1. Substitua *[perfil de transferência]* pelo perfil de transferência que você deseja usar.
1. Substitua *[caminho relativo]* pelo caminho do arquivo ou diretório que você deseja fazer upload.
1. Um caminho relativo não começa com uma `/` (barra). Exemplo: `Users/username/Desktop/folder1`
1. Não use um caminho absoluto. Um caminho de arquivo absoluto começa com uma `/` (barra). Exemplo: `/Users/username/Desktop/folder1`
1. Exemplo de comando: `filetransfer upload [transfer profile name] /Users/username/Desktop/folder1`
O File Transfer executa a [Somas de verificação de File Transfer](checksums.md) dos seus arquivos. A soma de verificação é usada para verificação adicional da integridade do arquivo, para que você detecte se um arquivo foi modificado inesperadamente. Depois que essas somas de verificação forem concluídas, as transferências serão iniciadas. Se você fornecer sua própria *Lista de hash de mídia* (*MHL*), o File Transfer poderá verificar se seus arquivos correspondem à soma de verificação definida na MHL. O MHL é um arquivo XML que geralmente vem com imagens brutas de câmera.
### Sinalizadores
Para realizar determinadas ações, você pode adicionar sinalizadores ao final de um comando. É opcional usar sinalizadores.
| Sinalizador | Descrição | Exemplo |
| --- | --- | --- |
| --help | Listar os sinalizadores e comandos disponíveis. | `filetransfer --help` |
| --checksum-algorithm | Defina qual cálculo da soma de verificação é executado pelo File Transfer. Valores suportados: `md5`, `XXHash`, `XXHash64` e `XXH3`. | `filetransfer upload [remote configuration] [relative path] –-checksum-algorithm xxhash64` |
| --enable-metadata-filter | Quando usado, o File Transfer filtra automaticamente os arquivos de metadados do sistema. Esses arquivos incluem `Thumbs.db`, `.DS_Store`, e arquivos que começam com `._.` | `filetransfer upload [remote configuration] [relative path] --enable-metadata-filter` |
| --filter | Filtra os arquivos que estão sendo transferidos com base em seu formato. O campo de filtro aceita expressões regulares válidas. Exemplo: `^.*\.(mov)$` apenas transfere arquivos que terminam em `.mov`. Filtros podem ser adicionados ao arquivo de configuração para realizar determinadas ações. Quando você adiciona filtros à configuração em vez de usá-los como sinalizadores em comandos específicos, o File Transfer aplica a ação a todas as transferências. | `filetransfer upload [remote configuration] [relative path] --filter "^.*\.(mov)$"` Esse comando só fará upload de arquivos que estejam no formato `.mov`. |
| --force | Forçar uma transferência independentemente dos filtros ou conflitos. Por padrão, o File Transfer não transfere arquivos transferidos anteriormente. O sinalizador de forçar faz com que o File Transfer ignore quaisquer filtros ou conflitos. Essa função é útil se você excluiu acidentalmente um arquivo que precisa baixar. | `filetransfer upload [remote configuration] [relative path] --force` |
| --max-age | Transferir somente arquivos que foram criados ou modificados dentro de uma janela de tempo que termina na hora atual. Se nenhuma unidade for fornecida, a idade máxima será em segundos. Por exemplo, `2d` fará o download de arquivos dos últimos dois dias e `3500` fará o upload de arquivos dos últimos 3500 segundos. | `filetransfer upload [remote configuration] [relative path] --max-age “2d”` O comando acima só fará upload de arquivos para o bucket do S3 nos últimos 2 dias. |
| --retry-count | Se ocorrer um erro, o File Transfer tentará transferir seus arquivos tantas vezes quanto a contagem de novas tentativas. | `filetransfer upload [remote configuration] [relative path] --retry-count 4` |
| --chunk-size | Tamanho do bloco em MB (padrão 25) | `filetransfer upload [remote configuration] [relative path] --chunk-size 50` |
| --auto-tuning | Permitir que a ferramenta decida os melhores valores de configuração para otimizar a transferência | `filetransfer upload [remote configuration] [relative path] --auto-tuning true` |
| --max-active-checksums | Número máximo de somas de verificação ativas (padrão 1). Essa sinalização é válida somente para uploads. | `filetransfer upload [remote configuration] [relative path] --max-active-checksums 5` |
| --max-active-transfers | Número máximo de transferências | `filetransfer upload [remote configuration] [relative path] --max-active-transfers 10` |
| --prefix | Caminho do prefixo do S3 para uploads e downloads | `filetransfer upload [remote configuration] [relative path] --prefix my/s3/path` |
| --profile | AWS perfil nomeado | `filetransfer upload [remote configuration] [relative path] --profile my_named_profile` |
| --threads | Número de threads por upload (padrão 10) | `filetransfer upload [remote configuration] [relative path] --threads 10` |
| FILETRANSFER\$1CONFIG\$1DIR | Substitui a pasta padrão `.filetransfer`. Essa variável pode definir qualquer diretório para armazenar o arquivo de configuração e o arquivo do banco de dados. Se `FILETRANSFER_CONFIG_DIR` não estiver definido, o valor padrão `~/.filetransfer` será usado. Os arquivos ainda devem ser nomeados `configuration.yaml` ou `configuration.yaml` e `checksum-cache.db`. Se eles não existirem, eles são criados. | `FILETRANSFER_CONFIG_DIR=Desktop/config1 filetransfer upload [remote configuration] [relative path]` |
## Configurar pastas ativas
**Para configurar a pasta ativa de upload usando a CLI.**
1. Abra o arquivo de configuração com qualquer software de edição de texto em seu computador.
1. Windows: navegue até a pasta `User/` do seu computador. Abra a pasta `.filetransfer` e abra o arquivo `filetransfer.yaml` com um editor de texto.
1. macOS: insira **Cmd\$1Shift\$1G**. Em seguida, insira **\$1/.filetransfer**. Abra o arquivo `filetransfer.yaml` em um editor de texto.
1. Linux: abra o arquivo `filetransfer.yaml` usando qualquer editor de texto. O arquivo está localizado em `~/.filetransfer/configuration.yaml`.
1. Criar uma seção `hot_folder` com os seguintes campos
```
hot folders:
- enabled: true
local_source_folder: /Users/user/myhotfolder
name: my_hot_folder
remote_configurations:
- remote_configuration_name: example_configuration
s3_destination_folder: my/s3/prefix
```
1. A pasta ativa só estará ativa quando a opção `enabled` estiver definida como verdadeira.
1. Substitua *local\$1source\$1folder* pelo local da pasta que você deseja que o File Transfer monitore. O caminho do arquivo deve conter o caminho completo: `C:\path\to\upload-hot-folder` (Windows) ou `/path/to/upload-hot-folder` (Linux & macOS).
1. Em `remote_configurations`:
1. Substitua *remote\$1configuration\$1name* pelo nome da configuração remota que você deseja usar. Você pode encontrar as configurações remotas listadas em `protocols.s3.transfer_profiles`.
1. (Opcional) Substitua *s3\$1destination\$1folder* pela pasta de destino do S3 na qual você deseja carregar os arquivos. O File Transfer criará a pasta no Amazon S3 se ela não existir. Os arquivos serão colocados na raiz do bucket se o valor não for definido.
1. (Opcional) Você pode adicionar aqui quantas entradas de configuração remota quiser, e a pasta ativa iniciará um upload usando cada configuração remota. Isso permite que você defina uma única pasta ativa que será carregada em vários buckets.
1. Veja a seguir um exemplo de configuração de pasta ativa de upload com várias pastas ativas. Neste exemplo, há duas pastas ativas.
1. A primeira pasta ativa está configurada para observar a pasta `Media/drive`. Quando os arquivos são adicionados a essa pasta, dois uploads são iniciados, um usando a configuração remota `example1` e outro usando a configuração remota `example2`. Cada upload usará sua `s3_destination_folder` respectiva.
1. A segunda pasta ativa está configurada para observar a pasta `/Users/user1/myhotfolder`. Quando os arquivos são adicionados a essa pasta, ela iniciará um único upload, usando a configuração remota `another_configuration`. Todos os arquivos serão carregados na pasta `example_folder` no Amazon S3.
```
hot folders:
- enabled: true
local_source_folder: /Media/drive
name: my_hot_folder
remote_configurations:
- remote_configuration_name: example1
s3_destination_folder: my/s3/folder
- remote_configuration_name: example2
s3_destination_folder: second/folder
- enabled: true
local_source_folder: /Users/user1/my_hot_folder
name: another_hot_folder
remote_configurations:
- remote_configuration_name: another_configuration
s3_destination_folder: example/folder
```
1. Salve o arquivo de configuração.
**nota**
Quando você inicia o daemon ou quando pastas ativas são adicionadas/atualizadas, um upload automático forçado será iniciado para toda a pasta. Se você não preferir esse comportamento, poderá abrir a GUI e cancelar o trabalho.
## Baixe arquivos
Com os comandos a seguir, você pode baixar arquivos do bucket S3 correspondente que você configurou em seu arquivo de configuração. Você pode executar esses comandos de qualquer lugar no seu computador. No entanto, recomendamos executar esses comandos a partir da raiz.
File Transfer não pode baixar diretamente das classes de armazenamento Deep Archive ou Glacier. Isso ocorre porque eles são armazenados em um sistema diferente. Esses tipos de objetos exigem um método diferente de recuperação dos arquivos. Para obter mais informações sobre como recuperar objetos de sistemas diferentes, consulte [Restauração de um objeto arquivado](https://docs.aws.amazon.com/AmazonS3/latest/userguide/restoring-objects.html). Para obter mais informações sobre as classes de armazenamento, consulte [Classes de armazenamento do Amazon S3](https://aws.amazon.com/s3/storage-classes/).
**nota**
Recomendamos que você desabilite o modo de suspensão no computador local. Se o computador ativar o modo de suspensão, as transferências em andamento poderão ser interrompidas. Em **Configurações**, ative a opção **Desabilitar o modo de suspensão (somente macOS)**.
**Para iniciar downloads usando a CLI**
1. Abra um terminal.
1. (Recomendado) Navegue até a pasta para a qual você deseja baixar seus arquivos.
1. Execute o comando a seguir de qualquer lugar do seu computador para baixar arquivos do Amazon S3 para a seu computador.
```
filetransfer download [transfer profile]
[relative path]
```
1. Substitua *[perfil de transferência]* pelo perfil de transferência que você deseja usar.
1. Substitua *[caminho relativo]* pelo caminho para o qual você deseja baixar seus arquivos.
1. Um caminho relativo não começa com uma `/` (barra). Exemplo: `Users/username/Desktop/folder1`
1. Não use um caminho absoluto. Um caminho de arquivo absoluto começa com uma `/` (barra). Exemplo: `/Users/username/Desktop/folder1`
1. Exemplo de comando: `filetransfer download [transfer profile name] /Users/username/Desktop/folder1`
File Transfer verifica o banco de dados File Transfer local para verificar se o arquivo selecionado já foi baixado.
### Sinalizadores
Para realizar determinadas ações, você pode adicionar sinalizadores ao final de um comando. É opcional usar sinalizadores.
| Sinalizador | Descrição | Exemplo |
| --- | --- | --- |
| --help | Listar os sinalizadores e comandos disponíveis. | `filetransfer --help` |
| --checksum-algorithm | Defina qual cálculo da soma de verificação é executado pelo File Transfer. Valores suportados: `md5`, `XXHash`, `XXHash64` e `XXH3`. | `filetransfer download [remote configuration] [relative path] –-checksum-algorithm xxhash64` |
| --enable-metadata-filter | Quando usado, o File Transfer filtra automaticamente os arquivos de metadados do sistema. Esses arquivos incluem `Thumbs.db`, `.DS_Store`, e arquivos que começam com `._.` | `filetransfer download [remote configuration] [relative path] --enable-metadata-filter` |
| --filter | Filtra os arquivos que estão sendo transferidos com base em seu formato. O campo de filtro aceita expressões regulares válidas. Exemplo: `^.*\.(mov)$` apenas transfere arquivos que terminam em `.mov`. Filtros podem ser adicionados ao arquivo de configuração para realizar determinadas ações. Quando você adiciona filtros à configuração em vez de usá-los como sinalizadores em comandos específicos, o File Transfer aplica a ação a todas as transferências. | `filetransfer download [remote configuration] [relative path] --filter "^.*\.(mov)$"` Esse comando só baixará arquivos que estejam no formato `.mov`. |
| --force | Forçar uma transferência independentemente dos filtros ou conflitos. Por padrão, o File Transfer não transfere arquivos transferidos anteriormente. O sinalizador de forçar faz com que o File Transfer ignore quaisquer filtros ou conflitos. Essa função é útil se você excluiu acidentalmente um arquivo que precisa baixar. | `filetransfer download [remote configuration] [relative path] --force` |
| --max-age | Transferir somente arquivos que foram criados ou modificados dentro de uma janela de tempo que termina na hora atual. Se nenhuma unidade for fornecida, a idade máxima será em segundos. Por exemplo, `2d` fará o download de arquivos dos últimos dois dias e `3500` fará o upload de arquivos dos últimos 3500 segundos. | `filetransfer download [remote configuration] [relative path] --max-age “2d”` O comando acima só baixará arquivos para o bucket do S3 nos últimos 2 dias. |
| --retry-count | Se ocorrer um erro, o File Transfer tentará transferir seus arquivos tantas vezes quanto a contagem de novas tentativas. | `filetransfer download [remote configuration] [relative path] --retry-count 4` |
| --chunk-size | Tamanho do bloco em MB (padrão 25) | `filetransfer download [remote configuration] [relative path] --chunk-size 50` |
| --auto-tuning | Permitir que a ferramenta decida os melhores valores de configuração para otimizar a transferência | `filetransfer download [remote configuration] [relative path] --auto-tuning true` |
| --max-active-checksums | Número máximo de somas de verificação ativas (padrão 1) | `filetransfer download [remote configuration] [relative path] --max-active-checksums 5` |
| --max-active-transfers | Número máximo de transferências | `filetransfer download [remote configuration] [relative path] --max-active-transfers 10` |
| --prefix | Caminho do prefixo do S3 para uploads e downloads | `filetransfer download [remote configuration] [relative path] --prefix my/s3/path` |
| --profile | AWS perfil nomeado | `filetransfer download [remote configuration] [relative path] --profile my_named_profile` |
| --threads | Número de threads por download (padrão 10) | `filetransfer download [remote configuration] [relative path] --threads 10` |
| FILETRANSFER\$1CONFIG\$1DIR | Substitui a pasta padrão `.filetransfer`. Essa variável pode definir qualquer diretório para armazenar o arquivo de configuração e o arquivo do banco de dados. Se `FILETRANSFER_CONFIG_DIR` não estiver definido, o valor padrão `~/.filetransfer` será usado. Os arquivos ainda devem ser nomeados `configuration.yaml` ou `configuration.yaml` e `checksum-cache.db`. Se eles não existirem, eles são criados. | `FILETRANSFER_CONFIG_DIR=Desktop/config1 filetransfer download [remote configuration] [relative path]` |