Use comandos de alto nível (s3) com o AWS CLI

O exemplo a seguir cria o bucket s3://bucket-name.

$ aws s3 mb s3://bucket-name

O exemplo a seguir lista todos os seus buckets do Amazon S3.

$ aws s3 ls
2018-12-11 17:08:50 my-bucket
2018-12-14 14:55:44 my-bucket2

O comando a seguir lista todos os objetos e prefixos em um bucket. Neste exemplo de saída, o prefixo example/ tem um arquivo chamado MyFile1.txt.

$ aws s3 ls s3://bucket-name
                           PRE example/
2018-12-04 19:05:48          3 MyFile1.txt

Você pode filtrar a saída para um prefixo específico, incluindo-o no comando. O comando a seguir relaciona os objetos em bucket-name/example (ou seja, objetos em bucket-name filtrados pelo prefixo example/).

$ aws s3 ls s3://bucket-name/example/
2018-12-06 18:59:32          3 MyFile1.txt

O exemplo a seguir remove o bucket s3://bucket-name.

$ aws s3 rb s3://bucket-name

Por padrão, o bucket deve estar vazio para a operação ser bem-sucedida. Para remover um bucket que não está vazio, é necessário incluir a opção --force. Se você estiver usando um bucket com versionamento que contém objetos anteriormente excluídos, mas ainda retidos, esse comando não permitirá que você remova o bucket. Você deve primeiro remover todo o conteúdo.

O exemplo de comando a seguir exclui todos os objetos no bucket e, em seguida, exclui o bucket.

$ aws s3 rb s3://bucket-name --force

O exemplo a seguir exclui filename.txt de s3://bucket-name/example.

$ aws s3 rm s3://bucket-name/example/filename.txt

O exemplo a seguir exclui todos os objetos de s3://bucket-name/example usando a opção --recursive.

$ aws s3 rm s3://bucket-name/example --recursive

O exemplo a seguir move todos os objetos de s3://bucket-name/example para s3://my-bucket/.

$ aws s3 mv s3://bucket-name/example s3://my-bucket/

O exemplo a seguir move um arquivo local do diretório de trabalho atual para o bucket do Amazon S3 com o comando s3 mv.

$ aws s3 mv filename.txt s3://bucket-name

O exemplo a seguir move um arquivo do bucket do Amazon S3 para o diretório de trabalho atual, onde ./ especifica o diretório de trabalho atual.

$ aws s3 mv s3://bucket-name/filename.txt ./

O exemplo a seguir copia todos os objetos de s3://bucket-name/example para s3://my-bucket/.

$ aws s3 cp s3://bucket-name/example s3://my-bucket/

O exemplo a seguir copia um arquivo local do diretório de trabalho atual para o bucket do Amazon S3 com o comando s3 cp.

$ aws s3 cp filename.txt s3://bucket-name

O exemplo a seguir copia um arquivo do bucket do Amazon S3 para o diretório de trabalho atual, onde ./ especifica o diretório de trabalho atual.

$ aws s3 cp s3://bucket-name/filename.txt ./

O exemplo a seguir usa echo para transmitir o texto “hello world” para o arquivo s3://bucket-name/filename.txt.

$ echo "hello world" | aws s3 cp - s3://bucket-name/filename.txt

O exemplo a seguir transmite o arquivo s3://bucket-name/filename.txt para stdout e imprime o conteúdo no console.

$ aws s3 cp s3://bucket-name/filename.txt -
hello world

O exemplo a seguir transmite o conteúdo de s3://bucket-name/pre parastdout, usa o comando bzip2 para comprimir os arquivos e faz upload do novo arquivo compactado chamado key.bz2 para s3://bucket-name.

$ aws s3 cp s3://bucket-name/pre - | bzip2 --best | aws s3 cp - s3://bucket-name/key.bz2

O exemplo a seguir sincroniza o conteúdo de um prefixo do Amazon S3 chamado path no bucket chamado my-bucket com o diretório de trabalho atual.

s3 sync atualiza todos os arquivos que têm tamanho ou hora de modificação diferentes dos arquivos com o mesmo nome no destino. A saída exibe operações específicas executadas durante a sincronização. Observe que a operação sincroniza recursivamente o subdiretório MySubdirectory e seu conteúdo com s3://my-bucket/path/MySubdirectory.

$ aws s3 sync . s3://my-bucket/path
upload: MySubdirectory\MyFile3.txt to s3://my-bucket/path/MySubdirectory/MyFile3.txt
upload: MyFile2.txt to s3://my-bucket/path/MyFile2.txt
upload: MyFile1.txt to s3://my-bucket/path/MyFile1.txt

O exemplo a seguir, uma extensão do exemplo anterior, mostra como usar a opção --delete.

// Delete local file
$ rm ./MyFile1.txt

// Attempt sync without --delete option - nothing happens
$ aws s3 sync . s3://my-bucket/path

// Sync with deletion - object is deleted from bucket
$ aws s3 sync . s3://my-bucket/path --delete
delete: s3://my-bucket/path/MyFile1.txt

// Delete object from bucket
$ aws s3 rm s3://my-bucket/path/MySubdirectory/MyFile3.txt
delete: s3://my-bucket/path/MySubdirectory/MyFile3.txt

// Sync with deletion - local file is deleted
$ aws s3 sync s3://my-bucket/path . --delete
delete: MySubdirectory\MyFile3.txt

// Sync with Infrequent Access storage class
$ aws s3 sync . s3://my-bucket/path --storage-class STANDARD_IA

Quando a opção --delete é usada, as opções --exclude e --include podem filtrar arquivos ou objetos a serem excluídos durante uma operação s3 sync. Nesse caso, a sequência de parâmetro deve especificar os arquivos a serem excluídos ou incluídos, a exclusão no contexto do diretório de destino ou bucket. Por exemplo:

Assume local directory and s3://my-bucket/path currently in sync and each contains 3 files:
MyFile1.txt
MyFile2.rtf
MyFile88.txt
'''

// Sync with delete, excluding files that match a pattern. MyFile88.txt is deleted, while remote MyFile1.txt is not.
$ aws s3 sync . s3://my-bucket/path --delete --exclude "path/MyFile?.txt"
delete: s3://my-bucket/path/MyFile88.txt
'''

// Sync with delete, excluding MyFile2.rtf - local file is NOT deleted
$ aws s3 sync s3://my-bucket/path . --delete --exclude "./MyFile2.rtf"
download: s3://my-bucket/path/MyFile1.txt to MyFile1.txt
'''

// Sync with delete, local copy of MyFile2.rtf is deleted
$ aws s3 sync s3://my-bucket/path . --delete
delete: MyFile2.rtf