Exemplo de script para o ciclo de vida do bucket do Amazon S3 no AWS CLI - AWS Command Line Interface
Antes de começarSobre este exemploArquivosReferências

Esta documentação é para a AWS CLI única versão 1. Para obter a documentação relacionada à versão 2 do AWS CLI, consulte o Guia do usuário da versão 2.

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

Exemplo de script para o ciclo de vida do bucket do Amazon S3 no AWS CLI

Este tópico usa um exemplo de script bash para operações de ciclo de vida do bucket do Amazon S3 usando a AWS Command Line Interface (AWS CLI). Este exemplo de desenvolvimento de scripts usa o conjunto de comandos aws s3api. Scripts shell são programas desenvolvidos para ser executados em uma interface de linha de comando.

Antes de começar

Antes que você possa executar qualquer um dos exemplos abaixo, as seguintes tarefas deverão ser concluídas.

  • Como prática AWS recomendada, conceda a esse código o menor privilégio ou somente as permissões necessárias para realizar uma tarefa. Para obter mais informações, consulte Conceder privilégios mínimos no Guia do IAM usuário.

  • Esse código não foi testado em todas as AWS regiões. Alguns AWS serviços estão disponíveis somente em regiões específicas. Para obter mais informações, consulte Endpoints de serviço e cotas no Guia de referência geral da AWS .

  • A execução desse código pode resultar em cobranças em sua AWS conta. É sua responsabilidade garantir que todos os recursos criados por este script sejam removidos após você terminar de usá-los.

O serviço Amazon S3 usa os seguintes termos:

  • Bucket: uma pasta de nível superior do Amazon S3.

  • Prefixo: uma pasta do Amazon S3 em um bucket.

  • Objeto: qualquer item hospedado em um bucket do Amazon S3.

Sobre este exemplo

Este exemplo mostra como interagir com algumas das operações básicas do Amazon S3 usando um conjunto de funções em arquivos de script de shell. As funções estão localizadas no arquivo de script shell chamado bucket-operations.sh. Você pode chamar essas funções em outro arquivo. Cada arquivo de script contém comentários descrevendo cada uma das funções.

Para ver os resultados intermediários de cada etapa, execute o script com um parâmetro -i. É possível exibir o status atual do bucket ou do conteúdo usando o console do Amazon S3. O script avançará para a próxima etapa somente após você pressionar ENTER no prompt.

Para ver o exemplo completo e os arquivos de script disponíveis para download, consulte Operações do ciclo de vida do bucket do Amazon S3 no repositório de exemplos de código em AWS . GitHub

Arquivos

O exemplo contém os seguintes arquivos:

bucket-operations.sh

Esse arquivo de script principal pode ser originado de outro arquivo. Ele inclui funções que executam as seguintes tarefas:

  • Criar um bucket e verificar se ele existe

  • Copiar um arquivo do computador local para um bucket

  • Copiar um arquivo de um local de bucket para um local de bucket diferente

  • Listar o conteúdo de um bucket

  • Excluir um arquivo de um bucket

  • Excluir um bucket

Veja o código para bucket-operations.sh on GitHub.

test-bucket-operations.sh

O arquivo de script de shell test-bucket-operations.sh demonstra como chamar as funções utilizando o arquivo bucket-operations.sh e chamando cada uma das funções. Após chamar funções, o script de teste remove todos os recursos que ele criou.

Veja o código para test-bucket-operations.sh on GitHub.

awsdocs-general.sh

O arquivo de script awsdocs-general.shcontém funções de uso geral usadas em exemplos avançados de código para a AWS CLI.

Veja o código para awsdocs-general.sh on GitHub.

Referências

AWS CLI referência:

Outra referência: