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).

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.

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.

2. (Recomendado) Navegue até a pasta que contém os arquivos e pastas que você quer enviar por upload.

3. 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.

   2. 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

      2. Não use um caminho absoluto. Um caminho de arquivo absoluto começa com uma / (barra). Exemplo: /Users/username/Desktop/folder1

   3. Exemplo de comando: filetransfer upload [transfer profile name] /Users/username/Desktop/folder1

O File Transfer executa a Somas de verificação de File Transfer 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_CONFIG_DIR	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/<your username> do seu computador. Abra a pasta .filetransfer e abra o arquivo filetransfer.yaml com um editor de texto.

   2. macOS: insira Cmd+Shift+G. Em seguida, insira ~/.filetransfer. Abra o arquivo filetransfer.yaml em um editor de texto.

   3. Linux: abra o arquivo filetransfer.yaml usando qualquer editor de texto. O arquivo está localizado em ~/.filetransfer/configuration.yaml.

2. 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

3. A pasta ativa só estará ativa quando a opção enabled estiver definida como verdadeira.

4. Substitua local_source_folder 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).

5. Em remote_configurations:

   1. Substitua remote_configuration_name pelo nome da configuração remota que você deseja usar. Você pode encontrar as configurações remotas listadas em protocols.s3.transfer_profiles.

   2. (Opcional) Substitua s3_destination_folder 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.

   3. (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.

6. 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.

   2. 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
   

7. 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. Para obter mais informações sobre as classes de armazenamento, consulte Classes de armazenamento do Amazon S3.

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.

2. (Recomendado) Navegue até a pasta para a qual você deseja baixar seus arquivos.

3. 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.

   2. 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

      2. Não use um caminho absoluto. Um caminho de arquivo absoluto começa com uma / (barra). Exemplo: /Users/username/Desktop/folder1

   3. 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_CONFIG_DIR	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]