本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 使用适用于 Ruby 的 Amazon SDK REPL 实用程序
<a name="repl"></a>

`aws-sdk` Gem 包含一个读取-求值-输出-循环 (REPL) 交互式命令行界面，您可以在其中测试适用于 Ruby 的 SDK 并立即查看结果。适用于 Ruby 的 SDK Gem 在 [RubyGems.org](https://rubygems.org/gems/aws-sdk/) 中提供。

## 先决条件
<a name="repl-prerequisites"></a>
+ [安装适用于 Ruby 的 S Amazon DK](setup-install.md).
+ [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) 位于 [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) Gem 中。`aws-sdk-resources` 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) Gem 中。
+ 您需要一个 xml 库，比如 `rexml` Gem。
+ 虽然该程序确实能够使用交互式 Ruby Shell (`irb`)，但我们建议您安装 `pry` Gem，后者提供了更强大的 REPL 环境。

## Bundler 设置
<a name="bundler-repl"></a>

 如果您使用 [Bundler](http://bundler.io/)，则 `Gemfile` 的以下更新将解决先决条件 Gem 问题：

1. 打开您在安装适用于 Ruby 的 Amazon SDK 时创建的 `Gemfile`。将以下行添加到该文件中：

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

1. 保存此 Gemfile。

1. 安装 `Gemfile` 中指定的依赖项：

   ```
   $ bundle install
   ```

## 运行 REPL
<a name="using-repl"></a>

您可以通过从命令行运行 `aws-v3.rb` 来访问 REPL。

```
aws-v3.rb
```

或者，您可以通过设置 verbose 标记来启用 HTTP 线路日志记录。HTTP 线路日志记录提供了有关适用于 Ruby 的 Amazon SDK 与 Amazon 之间通信的信息。请注意，verbose 标记还会增加开销，从而使代码运行速度变慢。

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

适用于 Ruby 的 SDK 包括提供 Amazon Web Services 服务接口的客户端类。每个客户端类都支持特定的 Amazon Web Services 服务。在 REPL 中，每个服务类都有一个助手，该助手会返回一个用于与该服务交互的新客户端对象。该助手的名称是转换为小写的服务名称。例如，Amazon S3 和 Amazon EC2 助手对象的名称分别为 `s3` 和 `ec2`。要列出您账户中的 Amazon S3 存储桶，您可以在提示中输入 `s3.list_buckets`。

您可以在 REPL 提示中键入 `quit` 以退出。