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
Antes de começar
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 Instalando ou atualizando para a versão mais recente do AWS CLI e Credenciais de autenticação e acesso para o AWS CLI.
-
O perfil que você usa deve ter permissões que permitam as AWS operações executadas pelos exemplos.
-
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
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 arquivobucket-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.sh
conté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:
-
Trabalhando com buckets do Amazon S3 no Guia do usuário do Amazon S3
-
Trabalhando com objetos do Amazon S3 no Guia do usuário do Amazon S3
-
Para ver, contribuir AWS SDK e AWS CLI codificar exemplos, consulte o Repositório AWS de exemplos de código
em GitHub.