# Exemplo de script para o ciclo de vida de bucket do Amazon S3 na AWS CLI
<a name="cli-services-s3-lifecycle-example"></a>

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 [https://docs.aws.amazon.com/cli/latest/reference/s3api/index.html](https://docs.aws.amazon.com/cli/latest/reference/s3api/index.html). Scripts shell são programas desenvolvidos para ser executados em uma interface de linha de comando.

**Topics**
+ [Antes de começar](#cli-services-s3-lifecycle-example-before)
+ [Sobre este exemplo](#cli-services-s3-lifecycle-example-about)
+ [Arquivos](#cli-services-s3-lifecycle-example-files)
+ [Referências](#cli-services-s3-lifecycle-example-references)

## Antes de começar
<a name="cli-services-s3-lifecycle-example-before"></a>

Antes que você possa executar qualquer um dos exemplos abaixo, as seguintes tarefas deverão ser concluídas.
+ Instale e configure a . AWS CLI. Para ter mais informações, consulte [Instalar ou atualizar a versão mais recente da AWS CLI](getting-started-install.md) e [Autenticação e credenciais de acesso para a AWS CLI](cli-chap-authentication.md).
+ O perfil utilizado deve ter permissões que garantem as operações da AWS realizadas pelos exemplos.
+ 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](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html#grant-least-privilege) 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](https://docs.aws.amazon.com/general/latest/gr/aws-service-information.html) 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
<a name="cli-services-s3-lifecycle-example-about"></a>

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](https://github.com/awsdocs/aws-doc-sdk-examples/tree/main/aws-cli/bash-linux/s3/bucket-lifecycle-operations) no *Repositório de exemplos de código da AWS* no *GitHub*.

## Arquivos
<a name="cli-services-s3-lifecycle-example-files"></a>

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](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/aws-cli/bash-linux/s3/bucket-lifecycle-operations/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](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/aws-cli/bash-linux/s3/bucket-lifecycle-operations/test_bucket_operations.sh)` no *GitHub*.

**awsdocs-general.sh**  
O arquivo de script `awsdocs-general.sh`conté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](https://github.com/awsdocs/aws-doc-sdk-examples/blob/main/aws-cli/bash-linux/s3/bucket-lifecycle-operations/awsdocs_general.sh)` no *GitHub*.

## Referências
<a name="cli-services-s3-lifecycle-example-references"></a>

**AWS CLI Referência da:**
+ [https://docs.aws.amazon.com/cli/latest/reference/s3api/index.html](https://docs.aws.amazon.com/cli/latest/reference/s3api/index.html)
+ [https://docs.aws.amazon.com/cli/latest/reference/s3api/create-bucket.html](https://docs.aws.amazon.com/cli/latest/reference/s3api/create-bucket.html)
+ [https://docs.aws.amazon.com/cli/latest/reference/s3api/copy-object.html](https://docs.aws.amazon.com/cli/latest/reference/s3api/copy-object.html)
+ [https://docs.aws.amazon.com/cli/latest/reference/s3api/delete-bucket.html](https://docs.aws.amazon.com/cli/latest/reference/s3api/delete-bucket.html)
+ [https://docs.aws.amazon.com/cli/latest/reference/s3api/delete-object.html](https://docs.aws.amazon.com/cli/latest/reference/s3api/delete-object.html)
+ [https://docs.aws.amazon.com/cli/latest/reference/s3api/head-bucket.html](https://docs.aws.amazon.com/cli/latest/reference/s3api/head-bucket.html)
+ [https://docs.aws.amazon.com/cli/latest/reference/s3api/list-objects.html](https://docs.aws.amazon.com/cli/latest/reference/s3api/list-objects.html)
+ [https://docs.aws.amazon.com/cli/latest/reference/s3api/put-object.html](https://docs.aws.amazon.com/cli/latest/reference/s3api/put-object.html)

**Outra referência:**
+ [Como trabalhar com buckets do Amazon S3](https://docs.aws.amazon.com//AmazonS3/latest/userguide/UsingBucket.html) no *Guia do desenvolvedor do Amazon S3*
+ [Como trabalhar com objetos do Amazon S3](https://docs.aws.amazon.com//AmazonS3/latest/userguide/UsingObjects.html) no *Guia do usuário do Amazon S3*
+ Para visualizar e contribuir para o SDK da AWS e exemplos de código da AWS CLI, consulte o [Repositório de exemplos de código da AWS](https://github.com/awsdocs/aws-doc-sdk-examples/) no *GitHub*.