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á.

# Uso do utilitário REPL do AWS SDK para Ruby
<a name="repl"></a>

O gem `aws-sdk` inclui uma interface de linha de comando interativa Read-Eval-Print-Loop (REPL) na qual você pode testar o SDK para Ruby e ver os resultados imediatamente. Os gems do SDK para Ruby estão disponíveis em [RubyGems.org](https://rubygems.org/gems/aws-sdk/). 

## Pré-requisitos
<a name="repl-prerequisites"></a>
+ [Instalando o AWS SDK para Ruby](setup-install.md).
+ O [https://github.com/aws/aws-sdk-ruby/blob/version-3/gems/aws-sdk-resources/bin/aws-v3.rb](https://github.com/aws/aws-sdk-ruby/blob/version-3/gems/aws-sdk-resources/bin/aws-v3.rb) está localizado no gem [https://github.com/aws/aws-sdk-ruby/tree/version-3/gems/aws-sdk-resources](https://github.com/aws/aws-sdk-ruby/tree/version-3/gems/aws-sdk-resources). O gem `aws-sdk-resources` também foi incluído pelo gem [https://github.com/aws/aws-sdk-ruby/blob/version-3/gems/aws-sdk/aws-sdk.gemspec](https://github.com/aws/aws-sdk-ruby/blob/version-3/gems/aws-sdk/aws-sdk.gemspec) principal.
+ Você precisará de uma biblioteca xml, como a do gem `rexml`.
+ Embora o programa funcione com o Interactive Ruby Shell (IRB) (`irb`), recomendamos que você instale o gem`pry`, que fornece um ambiente REPL mais poderoso.

## Configuração do Bundler
<a name="bundler-repl"></a>

 Se você usa o [Bundler](http://bundler.io/), as seguintes atualizações em seu `Gemfile` abordarão os gems de pré-requisito:

1. Abra o `Gemfile` que você criou quando instalou o AWS SDK para Ruby. Adicione as seguintes linhas ao arquivo:

   ```
   gem "aws-sdk"
   gem "rexml"
   gem "pry"
   ```

1. Salve o Gemfile.

1. Instale as dependências especificadas em seu `Gemfile`:

   ```
   $ bundle install
   ```

## Executar o REPL
<a name="using-repl"></a>

É possível acessar o REPL executando o `aws-v3.rb` a partir da linha de comando.

```
aws-v3.rb
```

Como alternativa, você pode habilitar o log de comunicação HTTP definindo a flag de verbose. O log de comunicação HTTP fornece informações sobre a comunicação entre o AWS SDK para Ruby e a AWS. Observe que a flag de verbose também adiciona overhead que pode tornar a execução do seu código mais lenta.

```
aws-v3.rb -v
```

O SDK para Ruby inclui classes de cliente que fornecem interfaces para os Serviços da AWS. Cada classe de cliente oferece suporte a um determinado AWS service (Serviço da AWS). No REPL, cada classe de serviço tem um auxiliar que retorna um novo objeto cliente para interagir com esse serviço. O nome do auxiliar será o nome do serviço convertido em minúsculas. Por exemplo, os nomes dos objetos auxiliares do Amazon S3 e do Amazon EC2 são `s3` e `ec2`, respectivamente. Para listar os buckets do Amazon S3 em sua conta, você pode inserir `s3.list_buckets` no prompt.

Você pode digitar `quit` no prompt do REPL para sair.