기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# 레퍼런스
<a name="elasticache-api-reference"></a>

이 섹션의 본 주제에서는 Amazon ElastiCache API 및 AWS CLI의 ElastiCache 섹션 관련 작업을 다룹니다. 또한 여기에는 일반적인 오류 메시지와 서비스 알림에 관한 설명이 포함되어 있습니다.
+ [ElastiCache API 사용](ProgrammingGuide.md)
+ [ElastiCache API 참조](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/Welcome.html)
+ [AWS CLI 참조의 ElastiCache 섹션](https://docs.aws.amazon.com/cli/latest/reference/elasticache/index.html)
+ [Amazon ElastiCache 오류 메시지](ErrorMessages.md)
+ [알림](elasticache-notifications.md)

## ElastiCache 명령줄 인터페이스 설정
<a name="StartCLI"></a>

이 섹션은 명령줄 도구 실행을 위한 필수 조건, 명령줄 도구를 구할 수 있는 위치, 도구 및 환경 설정 방법을 설명하고 도구 사용의 몇몇 일반적인 예를 포함하고 있습니다.

ElastiCache용 AWS CLI로 이동하는 경우에만 이 주제의 지침을 따르십시오.

**중요**  
Amazon ElastiCache 명령줄 인터페이스(CLI)는 API 버전 2014-09-30 이후의 ElastiCache 개선 사항을 지원하지 않습니다. 명령줄에서 최신 ElastiCache 기능을 사용하려면 [AWS 명령줄 인터페이스](https://aws.amazon.com/cli)를 사용합니다.

**Topics**
+ [사전 조건](#prerequisites)
+ [명령줄 도구 얻기](#Overview.SetupTools.Getting)
+ [도구 설정](#Overview.SetupTools.WhereTheyAre)
+ [도구에 대한 자격 증명 제공](#Overview.SetupTools.WhoYouAre)
+ [환경 변수](#Overview.SetupTools.EnvironmentalVariables)

### 사전 조건
<a name="prerequisites"></a>

 이 문서는 Linux/UNIX 또는 Windows 환경에서 작업할 수 있음을 가정합니다. 또한 Amazon ElastiCache 명령줄 도구는 UNIX 기반 환경인 Mac OS X에서도 작동하지만 이 설명서에는 특정 Mac OS X 지침이 포함되어 있지 않습니다.

 하나의 규칙으로서 모든 명령줄 텍스트 앞에 일반적인 **`PROMPT> `** 명령줄 프롬프트가 나옵니다. 머신의 실제 명령줄 프롬프트는 다를 수 있습니다. 또한 Linux/UNIX 고유 명령을 표시하기 위해서는 **`$ `**를, Windows 고유 명령에 대해서는 **`C:\> `**을 사용합니다. 명령의 결과인 출력 예는 접두사 없이 그 후에 즉시 표시됩니다.

#### Java 런타임 환경
<a name="java-runtime"></a>

 이 설명서에 사용된 명령줄 도구를 실행하려면 Java 버전 5 이상이 있어야 합니다. JRE 또는 JDK 설치가 허용됩니다. Linux/UNIX 및 Windows를 포함한 다양한 플랫폼 용도의 JRE를 살펴보고 다운로드하려면 [Java SE Downloads](http://www.oracle.com/technetwork/java/javase/downloads/index.html)를 참조하세요.

##### Java Home 변수 설정
<a name="java-home"></a>

 명령줄 도구는 Java 런타임을 찾기 위해 환경 변수(`JAVA_HOME`)를 사용합니다. 이 환경 변수는 실행 가능한 `java`(Linux 및 UNIX) 또는 `java.exe`(Windows) 실행 파일을 차례로 포함하고 있는 `bin`이라는 하위 디렉토리가 있는 디렉토리의 전체 경로로 설정되어야 합니다.

 **Java Home 변수를 설정하려면** 

1. Java Home 변수를 설정합니다.
   + Linux 및 UNIX에서 다음 명령을 입력합니다.

     ```
     $ export JAVA_HOME=<PATH>
     ```
   + Windows에서 다음 명령을 입력합니다.

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

1.  **\$1JAVA\$1HOME/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>

명령줄 도구는 [ElastiCache 개발자 도구 웹 사이트](https://aws.amazon.com/developertools/Amazon-ElastiCache)에서 ZIP 파일로 제공합니다. 이러한 도구는 Java로 작성되었으며 Windows 2000/XP/Vista/Windows 7, Linux/UNIX 및 Mac OSX에 대한 셸 스크립트를 포함하고 있습니다. ZIP 파일은 자체 포함되어 있고 설치가 필요 없으므로 간단히 해당 Zip 파일을 다운로드하여 로컬 머신의 디렉토리에 압축을 풉니다.

### 도구 설정
<a name="Overview.SetupTools.WhereTheyAre"></a>

명령줄 도구는 지원 라이브러리를 찾기 위해 환경 변수(AWS\$1ELASTICACHE\$1HOME)를 사용합니다. 이 환경 변수를 먼저 설정해야 도구를 사용할 수 있습니다. 환경 변수를 명령줄 도구의 압축을 푼 디렉토리 경로로 설정합니다. 이 디렉토리 이름은 ElastiCacheCli-A.B.nnnn(A, B 및 n은 버전/릴리스 번호)이며 bin 및 lib라는 하위 디렉토리를 포함하고 있습니다.

 **AWS\$1ELASTICACHE\$1HOME 환경 변수를 설정하려면** 
+ 명령줄 창을 열고 다음 명령 중 하나를 입력하여 AWS\$1ELASTICACHE\$1HOME 환경 변수를 설정합니다.
  + 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:\$1Program Files\$1Java"

### 도구에 대한 자격 증명 제공
<a name="Overview.SetupTools.WhoYouAre"></a>

 명령줄 도구에는 AWS 계정과 함께 제공되는 AWS 액세스 키 및 보안 액세스 키가 필요합니다. 명령줄을 사용하거나 로컬 시스템에 위치하는 자격 증명 파일에서 이러한 키를 얻을 수 있습니다.

배포 파일에는 개별 정보를 사용하여 수정해야 하는 템플릿 파일인 \$1\$1AWS\$1ELASTICACHE\$1HOME\$1/credential-file-path.template가 포함되어 있습니다. 다음은 템플릿 파일의 콘텐츠입니다.

```
AWSAccessKeyId=<Write your AWS access ID>
AWSSecretKey=<Write your AWS secret key>
```

**중요**  
UNIX에서는 자격 증명 파일의 소유자로 권한을 제한합니다.  

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

자격 증명 파일 설정을 사용하여 AWS\$1CREDENTIAL\$1FILE 환경 변수를 설정해야 ElastiCache 도구가 정보를 찾을 수 있습니다.

 **AWS\$1CREDENTIAL\$1FILE 환경 변수를 설정하려면** 

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>

환경 변수는 스크립팅, 기본값 구성 또는 기본값 임시 재정의에 유용할 수 있습니다.

AWS\$1CREDENTIAL\$1FILE 환경 변수뿐만 아니라 ElastiCache 명령줄 인터페이스와 함께 포함된 API 도구는 대부분 다음 변수를 지원하지 않습니다.
+ **EC2\$1REGION** - 사용할 AWS 리전입니다.
+ **AWS\$1ELASTICACHE\$1URL** - 서비스 호출에 사용할 URL입니다. EC2\$1REGION이 지정되어 있거나 --region 파라미터가 전달되는 경우 다른 리전 엔드포인트를 지정할 필요가 없습니다.

다음 예제에서는 EC2\$1REGION이라는 환경 변수를 설정하여 API 도구에서 사용하는 리전을 구성하는 방법을 보여줍니다.

Linux, OS X 또는 Unix

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

Windows

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