Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Riferimento
Gli argomenti di questa sezione riguardano l'utilizzo dell' ElastiCache API Amazon e la ElastiCache sezione di AWS CLI. Sono inclusi anche i messaggi di errore e le notifiche di servizio più frequenti.
+ [Utilizzo dell' ElastiCache API](ProgrammingGuide.md)
+ [ElastiCache Documentazione di riferimento delle API](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/Welcome.html)
+ [ElastiCache sezione del AWS CLI Reference](https://docs.aws.amazon.com/cli/latest/reference/elasticache/index.html)
+ [Messaggi ElastiCache di errore Amazon](ErrorMessages.md)
+ [Notifications](elasticache-notifications.md)
## Configurazione dell'interfaccia ElastiCache a riga di comando
Questa sezione descrive i prerequisiti per ottenere gli strumenti a riga di comando, dove trovarli, come impostare gli strumenti e il loro ambiente; include una serie di esempi comuni di utilizzo degli strumenti.
Segui le istruzioni riportate in questo argomento solo se intendi utilizzare AWS CLI la ElastiCache forchetta.
**Importante**
L'Amazon ElastiCache Command Line Interface (CLI) non supporta alcun ElastiCache miglioramento dopo la versione dell'API 2014-09-30. [Per utilizzare ElastiCache funzionalità più recenti dalla riga di comando, usa l'interfaccia a riga di comando.AWS](https://aws.amazon.com/cli)
**Topics**
+ [Prerequisiti](#prerequisites)
+ [Ottenere gli strumenti a riga di comando](#Overview.SetupTools.Getting)
+ [Configurazione degli strumenti](#Overview.SetupTools.WhereTheyAre)
+ [Fornire le credenziali per gli strumenti](#Overview.SetupTools.WhoYouAre)
+ [Variabili di ambiente](#Overview.SetupTools.EnvironmentalVariables)
### Prerequisiti
Questo documento presuppone che sia possibile lavorare in un ambiente Linux/UNIX Windows. Gli strumenti a riga di ElastiCache comando di Amazon funzionano anche su Mac OS X, che è un UNIX-based ambiente; tuttavia, in questa guida non sono incluse istruzioni specifiche per Mac OS X.
Per convenzione, tutti i testi a riga di comando hanno un prefisso costituito da un prompt generico **`PROMPT> `**della riga di comando. Il prompt della riga di comando sul tuo computer potrebbe essere diverso. Utilizziamo anche **`$ `** per indicare un comando Linux/UNIX specifico e **`C:\> `** per un comando specifico di Windows. L'output di esempio derivante dal comando viene visualizzato subito dopo, senza alcun prefisso.
#### Java Runtime Environment
Per l'esecuzione, gli strumenti a riga di comando utilizzati in questa guida richiedono almeno la versione 5 di Java. È accettabile l'installazione di JRE o di JDK. Per visualizzare e scaricare JRE per una vasta gamma di piattaforme, tra cui Linux/UNIX Windows, consulta [Java SE Downloads](http://www.oracle.com/technetwork/java/javase/downloads/index.html).
##### Impostazione della variabile Java Home
Gli strumenti a riga di comando dipendono da una variabile di ambiente (`JAVA_HOME`) per l'individuazione di Java Runtime. Tale variabile deve essere impostata sul percorso completo della directory contenente una sottodirectory denominata `bin`, che a sua volta contiene il file eseguibile `java` (su Linux e UNIX) o il file eseguibile `java.exe` (su Windows).
**Per impostare la variabile Java Home**
1. Impostare la variabile Java Home.
+ In Linux e UNIX, immettere il seguente comando:
```
$ export JAVA_HOME={{}}
```
+ In Windows immetti il seguente comando:
```
C:\> set JAVA_HOME={{}}
```
1. Confermare l'impostazione del percorso eseguendo il comando **$JAVA\_HOME/bin/java -version** e verificando l'output.
+ Su Linux/UNIX, vedrai un output simile al seguente:
```
$ $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)
```
+ Su Windows, l'aspetto dell'output sarà simile al seguente:
```
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)
```
### Ottenere gli strumenti a riga di comando
Gli strumenti a riga di comando sono disponibili come file .zip sul [Sito Web degli strumenti per sviluppatori di ElastiCache ](https://aws.amazon.com/developertools/Amazon-ElastiCache). Questi strumenti sono scritti in Java e includono script di shell per 2000/XP Vista/Windows Windows/7 e Mac OSX. Linux/UNIX Il file .zip è autonomo e non occorre installarlo; basta scaricarlo e decomprimerlo in una directory sul computer locale.
### Configurazione degli strumenti
Gli strumenti a riga di comando dipendono da una variabile di ambiente (AWS\_ELASTICACHE\_HOME) per l'individuazione delle librerie di support. Prima di poter utilizzare gli strumenti, occorre impostare questa variabile. Impostala sul percorso della directory in cui hai decompresso gli strumenti a riga di comando. Questa cartella è denominata ElastiCacheCli-A.B.nnnn (A, B e n sono version/release numeri) e contiene sottodirectory denominate bin e lib.
**Per impostare la variabile di ambiente AWS\_ELASTICACHE\_HOME**
+ Apri una finestra della riga di comando e inserisci uno dei seguenti comandi per impostare la variabile di ambiente \_ELASTICACHE\_HOME. AWS
+ In Linux e UNIX, immettere il seguente comando:
```
$ export &AWS;_ELASTICACHE_HOME=
```
+ In Windows immetti il seguente comando:
```
C:\> set &AWS;_ELASTICACHE_HOME=
```
Per semplificare l'utilizzo degli strumenti, consigliamo di aggiungere la directory BIN degli strumenti al PATH di sistema. Il resto della guida presuppone che la directory BIN si trovi nel percorso di sistema.
**Per aggiungere la directory BIN degli strumenti al percorso di sistema**
+ Immettere i seguenti comandi per aggiungere la directory BIN degli strumenti al PATH di sistema.
+ In Linux e UNIX, immettere il seguente comando:
```
$ export PATH=$PATH:$&AWS;_ELASTICACHE_HOME/bin
```
+ In Windows immetti il seguente comando:
```
C:\> set PATH=%PATH%;%&AWS;_ELASTICACHE_HOME%\bin
```
**Nota**
Quando si chiude la finestra dei comandi, le variabili di ambiente Windows vengono resettate. Si possono anche impostare in modo definitivo. Per ulteriori informazioni, consulta la documentazione relativa alla versione di Windows in uso.
**Nota**
I percorsi che contengono uno spazio devono essere racchiusi tra virgolette, ad esempio:
"C:\\Program Files\\Java"
### Fornire le credenziali per gli strumenti
Gli strumenti da riga di comando richiedono la chiave di AWS accesso e la chiave di accesso segreta fornite con l'account. AWS Puoi ottenerle tramite la riga di comando o da un file di credenziali presente nel sistema locale.
L’implementazione include un file di modello ${AWS\_ELASTICACHE\_HOME}/credential-file-path.template che va modificato con le informazioni. Di seguito i contenuti del file di modello:
```
AWS AccessKeyId=
AWS SecretKey=
```
**Importante**
In UNIX, limita le autorizzazioni al proprietario del file delle credenziali:
```
$ chmod 600
```
Con la configurazione del file di credenziali, dovrai impostare la variabile di ambiente AWS\_CREDENTIAL\_FILE in modo che gli strumenti possano trovare le ElastiCache tue informazioni.
**Per impostare la variabile di ambiente \_CREDENTIAL\_FILE AWS**
1. Imposta la variabile di ambiente :
+ Su Linux e UNIX, impostare la variabile di ambiente utilizzando il comando seguente:
```
$ export &AWS;_CREDENTIAL_FILE=
```
+ Su Windows, impostare la variabile di ambiente utilizzando il comando seguente:
```
C:\> set &AWS;_CREDENTIAL_FILE=
```
1. Verificare il corretto funzionamento della configurazione tramite il comando seguente:
```
elasticache --help
```
Dovrebbe comparire la pagina di utilizzo di tutti i comandi ElastiCache.
### Variabili di ambiente
Le variabili di ambiente possono essere utili per lo script e la configurazione delle impostazioni predefinite o per la loro provvisoria sostituzione.
Oltre alla variabile di ambiente AWS\_CREDENTIAL\_FILE, la maggior parte degli strumenti API inclusi nell'interfaccia a riga di comando supporta le seguenti variabili: ElastiCache
+ **EC2\_REGION** — La regione da utilizzare. AWS
+ **AWS\_ELASTICACHE\_URL**— L'URL da utilizzare per la chiamata di servizio. Non occorre specificare un endpoint regionale diverso se viene specificata la variabile EC2\_REGION o se viene trasferito il parametro --region.
I seguenti esempi mostrano come impostare la variabile di ambiente EC2\_REGION per configurare la regione utilizzata dagli strumenti dell'API:
Linux, OS X o Unix
```
1. $ export EC2_REGION=us-west-1
```
Windows
```
1. $ set EC2_REGION=us-west-1
```