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à.
# Creazione di un CloudSearch dominio Amazon
Per cercare i tuoi dati con Amazon CloudSearch, la prima cosa che devi fare è creare un dominio di ricerca. Se hai più raccolte di dati che desideri rendere ricercabili, puoi creare domini di ricerca multipli. Prima di poter [inviare richieste di ricerca](searching.md) a un nuovo dominio, devi anche [configurare le policy di accesso](configuring-access.md), [configurare i campi dell'indice](configuring-index-fields.md) e [caricare i dati da ricercare](uploading-data.md).
Quando crei un dominio di ricerca, devi assegnargli un nome univoco. I nomi di dominio devono iniziare con una lettera o un numero e avere una lunghezza compresa tra 3 e 28 caratteri. I caratteri consentiti sono a–z, A-Z, 0–9 e trattino (-). Nei nomi di dominio non sono consentiti lettere maiuscole, caratteri di sottolineatura (\$1) e altri caratteri speciali.
Per impostazione predefinita, tutti i nuovi domini vengono creati utilizzando la versione dell'API 2013-01-01. Se in precedenza hai creato domini di ricerca con la versione dell'API 2011-02-01, puoi scegliere di utilizzare la vecchia API per il tuo nuovo dominio. Tuttavia, consigliamo di utilizzare l'API 2013-01-01 per tutti i nuovi casi d'uso. Tutti i domini dovranno migrare all'API 2013-01-01 quando l'API 2011-02-01 verrà ritirata.
Puoi scegliere la regione AWS in cui desideri creare il dominio di ricerca. Solitamente, è opportuno scegliere la regione più vicina alle proprie operazioni. Ad esempio, se risiedi in Europa, crea il tuo dominio di ricerca nella regione Europa (Irlanda) (eu-west-1). Per l'elenco corrente delle regioni e degli endpoint supportati, consultare [Regioni ed endpoint](https://docs.aws.amazon.com/general/latest/gr/rande.html). Per ulteriori informazioni su come scegliere una regione, consultare [Regioni ed endpoint per Amazon CloudSearch](what-is-cloudsearch.md#endpoints).
**Nota**
CloudSearch I domini Amazon in diverse regioni sono completamente indipendenti. Ad esempio, se crei un dominio di ricerca denominato *my-domain* in us-east-1 e un altro dominio denominato *my-domain* in eu-west-1, saranno completamente indipendenti e non condivideranno alcun dato.
Ogni dominio di ricerca dispone di endpoint univoci attraverso i quali puoi caricare i dati per l'indicizzazione e l'invio delle richieste di ricerca. Gli endpoint di ricerca e il documento di un dominio rimangono invariati per tutta la durata del dominio. Ad esempio, gli endpoint di un dominio chiamato imdb-movies potrebbe essere:
```
doc-imdb-movies-nypdffbzrfkoudsurkxvgwbpi4.us-east-1.cloudsearch.amazonaws.com
search-imdb-movies-nypdffbzrfkoudsurkxvgwbpi4.us-east-1.cloudsearch.amazonaws.com
```
**Importante**
Per impostazione predefinita, l'accesso agli endpoint di ricerca e documenti di un nuovo dominio è bloccato per tutti gli indirizzi IP. È necessario configurare le policy di accesso affinché il dominio possa inviare le richieste di ricerca all'apposito endpoint del dominio e caricare i dati dalla riga di comando o tramite l'endpoint dei documenti del dominio. Puoi caricare documenti e cercare nel dominio tramite la CloudSearch console Amazon senza configurare le politiche di accesso.
È possibile creare un dominio di ricerca da[Amazon CloudSearch console](#create-domain-console), utilizzando il `aws cloudsearch create-domain` comando o utilizzando uno degli AWS SDKs.
**Topics**
+ [Amazon CloudSearch console](#create-domain-console)
+ [create-domain](#create-domain-clt)
+ [Creazione di un CloudSearch dominio Amazon utilizzando AWS SDKs](#create-domain-sdk)
## Creazione di un dominio utilizzando la CloudSearch console Amazon
La CloudSearch console Amazon ti consente di creare facilmente nuovi domini di ricerca e offre una varietà di opzioni per configurare le opzioni di indicizzazione.
**Per creare un dominio.**
1. Accedi alla Console di gestione AWS e apri la CloudSearch console Amazon da [https://console.aws.amazon.com/cloudsearch/casa](https://console.aws.amazon.com/cloudsearch/home).
1. Scegli **Crea dominio**.
1. Inserisci un nome per il tuo nuovo dominio. I nomi di dominio devono iniziare con una lettera o un numero e avere una lunghezza compresa tra 3 e 28 caratteri. I nomi di dominio possono contenere i seguenti caratteri: a-z (minuscoli), 0-9 e - (trattino). Nei nomi di dominio non sono consentiti lettere maiuscole, caratteri di sottolineatura (\$1) e altri caratteri speciali.
Facoltativamente, puoi impostare il **tipo di istanza desiderato** e il **numero di repliche desiderato** per prescalare il tuo dominio. Per ulteriori informazioni, consulta [Configurazione delle opzioni di scalabilità in Amazon CloudSearch](configuring-scaling-options.md).
1. Scegli **Next (Successivo)**.
1. **Nelle opzioni di configurazione, seleziona Configurazione **manuale** e scegli Avanti.**
1. Configura i campi indice per il dominio. Per istruzioni, consulta [Configurazione dei campi dell'indice](configuring-index-fields.md).
1. Scegli **Next (Successivo)**.
1. Configura la politica di accesso al dominio. Per istruzioni, consulta [Configurazione di Access per Amazon CloudSearch](configuring-access.md).
**Nota**
Finché non configuri le policy di accesso, non potrai caricare i documenti e inviare le query di ricerca tramite la console. Per impostazione predefinita, i documenti e gli endpoint di ricerca sono configurati per bloccare tutti gli indirizzi IP.
1. Scegli **Next (Successivo)**.
1. Controlla la configurazione del dominio e scegli **Crea**.
I documenti e gli endpoint del servizio di ricerca del dominio vengono visualizzati nella dashboard del dominio quando il dominio diventa attivo. A questo punto, è possibile caricare i documenti per l'indicizzazione e avviare la ricerca dei dati.
## Creazione di un dominio utilizzando AWS CLI
Si utilizza il `aws cloudsearch create-domain` comando per creare domini di ricerca. Per informazioni sull'installazione e la configurazione di AWS CLI, consulta la [Guida per l'AWS Command Line Interface utente](https://docs.aws.amazon.com/cli/latest/userguide/).
**Per creare un dominio.**
+ Eseguire il comando `aws cloudsearch create-domain` e specificare il nome del dominio da creare con l'opzione `--domain-name`. Ad esempio, per creare un dominio denominato *movies*:
**Example**
```
aws cloudsearch create-domain --domain-name movies
{
"DomainStatus": {
"DomainId": "965407640801/movies",
"Created": true,
"Deleted": false,
"SearchInstanceCount": 0,
"DomainName": "movies",
"SearchService": {},
"RequiresIndexDocuments": false,
"Processing": false,
"DocService": {},
"ARN": "arn:aws:cloudsearch:us-east-1:965407640801:domain/movies",
"SearchPartitionCount": 0
}
}
```
Viene restituito immediatamente il comando `aws cloudsearch create-domain`. La creazione di endpoint per un nuovo dominio richiede circa dieci minuti. Puoi utilizzare il comando `aws cloudsearch describe-domains` per visualizzare un riepilogo dello stato e la configurazione del dominio. Per ulteriori informazioni, consulta [Ottenere informazioni su un CloudSearch dominio Amazon](getting-domain-info.md).
**Importante**
Una volta che gli endpoint del dominio sono attivi, rimangono tali per tutta la durata del dominio. È consigliabile memorizzare nella cache gli endpoint; non occorre eseguire una query per l'endpoint prima di inviare una richiesta del servizio documenti o di ricerca, altrimenti è probabile che le richieste vengano limitate.
## Creazione di un CloudSearch dominio Amazon utilizzando AWS SDKs
AWS SDKs (ad eccezione di Android e iOS SDKs) supporta tutte le CloudSearch azioni Amazon definite nell'API di CloudSearch configurazione di Amazon, tra cui`CreateDomain`. Per ulteriori informazioni sull'installazione e l'utilizzo di AWS SDKs, consulta [AWS Software Development Kits](https://aws.amazon.com/code).