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

# 参考
<a name="elasticache-api-reference"></a>

本节中的主题涵盖如何使用亚马逊 ElastiCache API 和 ElastiCache 部分 Amazon CLI。本部分还包含常见错误消息和服务通知。
+ [使用 ElastiCache API](ProgrammingGuide.md)
+ [ElastiCache API 引用](https://docs.amazonaws.cn/AmazonElastiCache/latest/APIReference/Welcome.html)
+ [ElastiCache Amazon CLI 参考文献部分](https://docs.amazonaws.cn/cli/latest/reference/elasticache/index.html)
+ [Amazon ElastiCache 错误消息](ErrorMessages.md)
+ [通知](elasticache-notifications.md)

## 设置 ElastiCache 命令行界面
<a name="StartCLI"></a>

本部分描述了运行命令行工具的先决条件、在何处获取命令行工具以及如何设置工具及其环境，同时包含了一系列常见的工具用途示例。

仅当你要去for时，才按照本主题中的说明 Amazon CLI 进行操作 ElastiCache。

**重要**  
在 API 版本 2014-09-30 之后，亚马逊 ElastiCache 命令行界面 (CLI) 不支持任何 ElastiCache 改进。要使用命令行中的新 ElastiCache 功能，请使用[Amazon 命令行界面](https://www.amazonaws.cn/cli)。

**Topics**
+ [先决条件](#prerequisites)
+ [获得命令行工具](#Overview.SetupTools.Getting)
+ [设置工具](#Overview.SetupTools.WhereTheyAre)
+ [提供工具凭证](#Overview.SetupTools.WhoYouAre)
+ [环境变量](#Overview.SetupTools.EnvironmentalVariables)

### 先决条件
<a name="prerequisites"></a>

 本文档假设你可以在 Linux/UNIX 或 Windows 环境中工作。Amazon ElastiCache 命令行工具也适用于 Mac OS X（一种 UNIX-based环境）；但是，本指南中没有具体的 Mac OS X 指令。

 就惯例而言，所有命令行文本以通配的 **`PROMPT> `** 命令行提示符作为前缀。您的机器上的实际命令行提示符可能有所不同。我们还**`$ `**用来表示 Linux/UNIX 特定的命令和特定**`C:\> `**于 Windows 的命令。由命令得出的示例输出在其后立即显示，同时不带任何前缀。

#### Java 运行时环境
<a name="java-runtime"></a>

 本指南中使用的命令行工具需要 Java 版本 5 或更高版本，方可运行。JRE 或 JDK 安装均可行。要查看和下载适用于各种平台（包括 Linux/UNIX 和 Windows）的 JRE，请参阅 [Java SE 下载](http://www.oracle.com/technetwork/java/javase/downloads/index.html)。

##### 设置 Java home 变量
<a name="java-home"></a>

 命令行工具根据环境变量 (`JAVA_HOME`) 定位 Java Runtime。此环境变量应该被设为目录的完整路径，其中包含一个名称为 `bin` 的子目录，而该子目录中包含可执行的 `java` 文件（在 Linux 和 UNIX 上）或 `java.exe`可执行文件（在 Windows 上）。

 **设置 Java Home 变量** 

1. 设置 Java Home 变量。
   + 在 Linux 和 UNIX 操作系统上，输入以下命令：

     ```
     $ export JAVA_HOME={{<PATH>}}
     ```
   + 在 Windows 操作系统上，输入以下命令：

     ```
     C:\> set JAVA_HOME={{<PATH>}}
     ```

1.  通过运行 **$JAVA\_HOME/bin/java -version** 并检查输出，确认路径设置。
   + 开启后 Linux/UNIX，您将看到类似于以下内容的输出：

     ```
     $ $JAVA_HOME/bin/java -version
     java version "1.6.0_23"
     Java(TM) SE Runtime Environment (build 1.6.0_23-b05)
     Java HotSpot(TM) Client VM (build 19.0-b09, mixed mode, sharing)
     ```
   + 在 Windows 上，您将看到类似于下述信息的输出：

     ```
     C:\> %JAVA_HOME%\bin\java -version
     java version "1.6.0_23"
     Java(TM) SE Runtime Environment (build 1.6.0_23-b05)
     Java HotSpot(TM) Client VM (build 19.0-b09, mixed mode, sharing)
     ```

### 获得命令行工具
<a name="Overview.SetupTools.Getting"></a>

命令行工具可作为 ZIP 文件在 [ElastiCache 开发工具网站](https://www.amazonaws.cn/developertools/Amazon-ElastiCache)上提供。这些工具是用 Java 编写的，包括适用于 Windows 2000/XP/Vista/Windows 7 和 Mac OSX 的 shell 脚本。 Linux/UNIXZIP 文件是一种自含式文件，无需安装；只需下载 Zip 文件，然后将其解压到本地计算机的目录上即可。

### 设置工具
<a name="Overview.SetupTools.WhereTheyAre"></a>

命令行工具依靠环境变量 (Amazon\_ELASTICACHE\_HOME) 来查找支持库。您需要设置此环境变量后，方可使用工具。请将它设为您解压缩命令行工具的目录路径。此目录名为 ElastiCacheCli-A.B.nnnn （A、B 和 n 是 version/release数字），包含名为 bin 和 lib 的子目录。

 **设置 Amazon\_ELASTICACHE\_HOME 环境变量** 
+ 打开命令行窗口并输入以下命令之一来设置 Amazon\_ELASTICACHE\_HOME 环境变量。
  + 在 Linux 和 UNIX 操作系统上，输入以下命令：

    ```
    $ export &AWS;_ELASTICACHE_HOME=<path-to-tools>
    ```
  + 在 Windows 操作系统上，输入以下命令：

    ```
    C:\> set &AWS;_ELASTICACHE_HOME=<path-to-tools>
    ```

为了使工具更易使用，我们建议您将工具的 BIN 目录添加至您的系统路径。本指南的其余部分假定 BIN 目录位于您的系统路径中。

 **将工具的 BIN 目录添加至您的系统路径** 
+ 输入下述命令，即可将工具的 BIN 目录添加至您的系统路径。
  + 在 Linux 和 UNIX 操作系统上，输入以下命令：

    ```
    $ export PATH=$PATH:$&AWS;_ELASTICACHE_HOME/bin
    ```
  + 在 Windows 操作系统上，输入以下命令：

    ```
    C:\> set PATH=%PATH%;%&AWS;_ELASTICACHE_HOME%\bin
    ```

**注意**  
当您关闭命令窗口时，Windows 环境变量会重置。您可能想要永久性设置它们。请参阅文档，了解有关您的 Windows 版本的更多信息。

**注意**  
如果路径中包含空格，必须使用双引号将路径括起来，例如：  
"C:\\Program Files\\Java"

### 提供工具凭证
<a name="Overview.SetupTools.WhoYouAre"></a>

 命令行工具需要您的 Amazon 账户随附 Amazon 访问密钥和私有访问密钥。可以使用命令行或从位于您本地系统上的证书文件获取它们。

部署包括一份您需要使用您的信息进行编辑的模板文件 ${Amazon\_ELASTICACHE\_HOME}/credential-file-path.template。模板文件内容如下：

```
Amazon AccessKeyId=<Write your Amazon access ID>
Amazon SecretKey=<Write your Amazon secret key>
```

**重要**  
在 UNIX 上，限制凭证文件拥有者的权限：  

```
$ chmod 600 <the file created above>
```

在设置凭据文件时，你需要设置 \_CREDENTI Amazon AL\_FILE 环境变量，这样 ElastiCache 工具才能找到你的信息。

 **设置 \_CREDENTI Amazon AL\_FILE 环境变量** 

1. 设置 环境变量：
   + 在 Linux 和 UNIX 上，使用以下命令更新变量：

     ```
     $ export &AWS;_CREDENTIAL_FILE=<the file created above>
     ```
   + 在 Windows 上，使用以下命令设置变量：

     ```
     C:\> set &AWS;_CREDENTIAL_FILE=<the file created above>
     ```

1. 检查您的设置是否正常工作，然后运行以下命令：

   ```
   elasticache --help
   ```

   您应该参阅所有 ElastiCache 命令的使用页面。

### 环境变量
<a name="Overview.SetupTools.EnvironmentalVariables"></a>

在编写脚本、配置默认值或临时覆盖这些值时，环境变量很有用处。

除了 \_CREDENTI Amazon AL\_FILE 环境变量外， ElastiCache 命令行界面中包含的大多数 API 工具都支持以下变量：
+ **EC2\_REGION**-要使用的 Amazon 区域。
+ **Amazon\_ELASTICACHE\_URL** – 要用于服务调用的 URL。如果指定了 EC2\_REGION 或传递了 --region 参数，则无需指定不同的区域终端节点。

以下示例演示如何设置环境变量 EC2\_REGION 以配置 API 工具所使用的区域：

Linux、OS X 或 Unix

```
1. $ export EC2_REGION=us-west-1 
```

Windows

```
1. $ set EC2_REGION=us-west-1 
```