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à.
# Invio di richieste di configurazione in Amazon CloudSearch
**Importante**
Il modo più semplice per inviare richieste di configurazione consiste nell'utilizzare la CloudSearch console Amazon, gli strumenti a riga di CloudSearch comando di Amazon o l'SDK AWS per Java JavaScript, .NET, PHP, Ruby o Python (Boto). Gli strumenti a riga di comando SDKs gestiscono il processo di firma per te e assicurano che le richieste di CloudSearch configurazione di Amazon vengano formate correttamente. Per ulteriori informazioni su AWS SDKs, consulta [AWS Software Development Kits](https://aws.amazon.com/code).
Invia richieste di CloudSearch configurazione Amazon all' CloudSearch endpoint Amazon per la tua regione utilizzando il protocollo AWS Query. Per l'elenco corrente delle regioni e degli endpoint supportati, consulta [Regioni ed endpoint](https://docs.aws.amazon.com/general/latest/gr/rande.html#cloudsearch_region).
Le richieste di query AWS sono richieste HTTP o HTTPS inviate tramite HTTP GET o POST con un parametro di query denominato Action. In tutte le richieste di configurazione, devi specificare la versione API, che deve corrispondere alla versione API specificata al momento della creazione del dominio.
È necessario includere parametri di autorizzazione e una firma digitale in ogni richiesta. Amazon CloudSearch supporta AWS Signature versione 4. Per istruzioni dettagliate sulle firme, consulta [Signature V4 Signing Process](https://docs.aws.amazon.com/general/latest/gr/signature-version-4.html) in Riferimenti generali di AWS.
**Nota**
Amazon CloudSearch limita le richieste eccessive al servizio di configurazione. La limitazione avviene *per azione*, quindi `DescribeDomains` le richieste eccessive non inducono Amazon CloudSearch a limitarle. `DescribeIndexFields` Il limite di richieste cambia in base alle esigenze del servizio, ma consente molte chiamate a ogni operazione all'ora.
## Struttura di una richiesta di configurazione
Questo riferimento mostra le richieste CloudSearch di configurazione di Amazon come URLs, che possono essere utilizzate direttamente in un browser. (Sebbene le richieste GET siano mostrate come URLs, i valori dei parametri vengono mostrati non codificati per facilitarne la lettura. Tieni presente che devi codificare i valori dei parametri tramite URL quando invii le richieste.) L'URL contiene tre parti:
+ Endpoint: punto di ingresso per un servizio Web su cui agire, `cloudsearch.us-east-1.amazonaws.com`.
+ Azione: l'azione di configurazione di CloudSearch Amazon che desideri eseguire. Per l'elenco completo delle operazioni, consulta [Azioni](API_Operations.md).
+ Parametri: qualsiasi parametro di richiesta richiesto per l'azione specificata. Ogni richiesta di query deve includere anche alcuni parametri comuni per gestire l'autenticazione. Per ulteriori informazioni, consulta [Autenticazione delle richieste](#configuration-request-authentication).
È necessario specificare il `Version` parametro in ogni richiesta CloudSearch di configurazione Amazon. L'attuale versione dell' CloudSearch API Amazon è il 01/01/2013.
Ad esempio, la seguente richiesta GET crea un nuovo dominio di ricerca chiamato *movies*:
```
https://cloudsearch.us-east-1.amazonaws.com
?Action=CreateDomain
&DomainName=movies
&Version=2013-01-01
&X-Amz-Algorithm=AWS4-HMAC-SHA256
&X-Amz-Credential=AKIAIOSFODNN7EXAMPLE/20120712/us-east-1/cloudsearch/aws4
_request
&X-Amz-Date=2012-07-12T21:41:29.094Z
&X-Amz-SignedHeaders=host
&X-Amz-Signature=c7600a00fea082dac002b247f9d6812f25195fbaf7f0a6fc4ce08a39666c6a10
3c8dcb
```
## Autenticazione delle richieste
Le richieste inviate all'API di configurazione vengono autenticate utilizzando le chiavi di accesso AWS. È necessario includere parametri di autorizzazione e una firma digitale in ogni richiesta. Amazon CloudSearch supporta AWS Signature versione 4. Per istruzioni dettagliate sulle firme, consulta [Signature V4 Signing Process](https://docs.aws.amazon.com/general/latest/gr/signature-version-4.html) in Riferimenti generali di AWS.
**Nota**
Se hai appena iniziato a firmare le tue richieste AWS, dai un'occhiata a come SDKs implementa la firma. Il codice sorgente per la maggior parte di AWS SDKs è disponibile all'indirizzo [https://github.com/aws.](https://github.com/aws)
Ad esempio, per creare una richiesta `CreateDomain`, avrai bisogno delle seguenti informazioni:
```
Region name: us-east-1
Service name: cloudsearch
API version: 2013-01-01
Date: 2014-03-12T21:41:29.094Z
Access key: AKIAIOSFODNN7EXAMPLE
Secret key: wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
Action: CreateDomain
Action Parameters: DomainName=movies
```
La stringa di query standard per una richiesta `CreateDomain` ha il seguente aspetto:
```
Action=CreateDomain
&DomainName=movies
&Version=2013-01-01
&X-Amz-Algorithm=AWS4-HMAC-SHA256
&X-Amz-Credential=AKIAIOSFODNN7EXAMPLE/20120712/us-east-1/cloudsearch/aws4
_request
&X-Amz-Date=2012-07-12T21:41:29.094Z
&X-Amz-SignedHeaders=host
```
La richiesta di firma finale ha il seguente aspetto:
```
https://cloudsearch.us-east-1.amazonaws.com
?Action=CreateDomain
&DomainName=movies
&Version=2013-01-01
&X-Amz-Algorithm=AWS4-HMAC-SHA256
&X-Amz-Credential=AKIAIOSFODNN7EXAMPLE/20120712/us-east-1/cloudsearch/aws4
_request
&X-Amz-Date=2014-03-12T21:41:29.094Z
&X-Amz-SignedHeaders=host
&X-Amz-Signature=c7600a00fea082dac002b247f9d6812f25195fbaf7f0a6fc4ce08a39666c6a10
```