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

Exemplo de script para o ciclo de vida de bucket do Amazon S3 na 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 recomendada da AWS, conceda a esse código privilégio mínimo ou apenas as permissões necessárias para executar uma tarefa. Para obter mais informações, consulte Conceder privilégio mínimo no Guia do usuário do IAM.

  • Este código não foi testado em todas as regiões da AWS. Alguns serviços da AWS só estão disponíveis 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.

  • Executar este código pode resultar em cobranças em sua conta da AWS. É 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 obter o exemplo completo e os arquivos de script para download, consulte Operações de ciclo de vida de bucket do Amazon S3 no Repositório de exemplos de código da AWS no 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

Visualize o código para bucket-operations.sh no 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.

Visualize o código para test-bucket-operations.sh no 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.

Visualize o código para awsdocs-general.sh no GitHub.

Referências

Referência da AWS CLI:

Outra referência: