Usar o AWS SDK para Ruby - versão 3 - Amazon Simple Storage Service

Usar o AWS SDK para Ruby - versão 3

O AWS SDK para Ruby fornece uma API para operações de bucket e objeto 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 Usar o AWS SDK para Ruby para 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 aplicativos do Amazon S3 usando o AWS SDK para Ruby, você deve instalar o SDK para Ruby gem. Para obter mais informações, consulte AWS SDK para Ruby - versão 3. Depois de instalado, você pode acessar a API, incluindo as seguintes classes de chaves:

  • Aws::S3::Resource — representa a interface para 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 o AWS SDK para a API do Ruby, visite AWS SDK para Ruby - versão 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 para Ruby gem. Para obter informações sobre como instalar ou atualizar a gem mais recente, visite AWS SDK para Ruby - versão 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 para Ruby.

1

Para acessar a AWS, você deve fornecer um conjunto de credenciais para seu aplicativo SDK para Ruby. Para obter mais informações, consulte Configurar o AWS SDK para Ruby.

2

Crie um script SDK para Ruby novo 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 Console de gerenciamento da AWS. Para obter mais informações sobre o Console de gerenciamento da AWS, visite 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: