Usar o AWS SDK for Ruby - versão 3

O AWS SDK for Ruby fornece uma API para as operações de buckets e objetos do Amazon S3. Para operações de objeto, você pode usar a API para fazer upload de objetos em uma única operação ou fazer upload de objetos grandes em partes (consulte Fazer upload de um objeto usando multipart upload). Contudo, a API para um único upload de operação também pode aceitar objetos grandes e, em segundo plano, gerenciar o upload em partes para você, reduzindo a quantidade de script que precisa escrever.

A organização da API Ruby

Ao criar aplicações do Amazon S3 usando o AWS SDK for Ruby SDK for Ruby, instale o gem SDK for Ruby. Para obter mais informações, consulte AWS SDK for Ruby Version 3. Depois de instalado, você pode acessar a API, incluindo as seguintes classes de chaves:

• Aws::S3::Resource: representa a interface para o Amazon S3 para o SDK do Ruby e fornece métodos para criar e enumerar buckets.

  A classe S3 fornece o método da instância #buckets para acessar buckets existentes ou criar novos.

• Aws::S3::Bucket representa um bucket do Amazon S3. 

  A classe Bucket fornece os métodos #object(key) e #objects para acessar os objetos em um bucket, bem como métodos para excluir um bucket e retornar informações sobre um bucket, como a política do bucket.

• Aws::S3::Object: representa um objeto do Amazon S3 identificado por sua chave.

  A classe Object fornece métodos para obter e definir as propriedades de um objeto, especificando a classe storage para armazenar objetos, e definindo permissões de objetos usando listas de controle de acesso. A classe Object também tem métodos para exclusão, upload e cópia de objetos. Ao carregar objetos em partes, essa classe fornece opções para especificar a ordem das partes carregadas e o tamanho das partes.

Para obter mais informações sobre a API do AWS SDK for Ruby, acesse AWS SDK for Ruby Version 2.

Testar os exemplos de script do Ruby

A maneira mais fácil de começar a usar os exemplos de script do Ruby é instalar o AWS SDK for Ruby gem. Para obter informações sobre como instalar ou atualizar a gem mais recente, acesse AWS SDK for Ruby Version 3. As tarefas a seguir orientam você na criação e nos testes dos exemplos de script do Ruby pressupondo que você instalou o AWS SDK for Ruby.

1	Para acessar a AWS, você deve fornecer um conjunto de credenciais para sua aplicação do SDK for Ruby. Para obter mais informações, consulte Configuração do AWS SDK for Ruby.
2	Crie um script do SDK para Ruby e adicione as seguintes linhas à parte superior do script. #!/usr/bin/env ruby require 'rubygems' require 'aws-sdk-s3' A primeira linha é a diretiva do intérprete e as duas instruções require importam duas gems necessárias no script.
3	Copie o código da seção que você está lendo no script.
4	Atualize o código fornecendo todos os dados necessários. Por exemplo, se estiver fazendo o upload de um arquivo, forneça o caminho do arquivo e o nome do bucket.
5	Execute o script. Verifique as alterações nos buckets e nos objetos usando o AWS Management Console. Para obter mais informações sobre o AWS Management Console, acesse https://aws.amazon.com/console/.

Exemplos do Ruby

Os links a seguir contêm exemplos para ajudar você a começar a usar o SDK para Ruby versão 3:

• Criação de um bucket

• Fazer upload de objetos