Creazione di un CloudSearch dominio Amazon - Amazon CloudSearch
Creazione di un dominio con la consoleCreazione di un dominio con AWS CLICreazione di un dominio con gli SDK AWS

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 a un nuovo dominio, devi anche configurare le policy di accesso, configurare i campi dell'indice e caricare i dati da ricercare.

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 (_) 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. Per ulteriori informazioni su come scegliere una regione, consultare Regioni ed endpoint per Amazon CloudSearch.

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.

Puoi creare un dominio di ricerca dalla console Amazon CloudSearch console utilizzando il comando aws cloudsearch create-domain o uno degli SDK AWS.

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 all'indirizzo https://console.aws.amazon.com/cloudsearch/home.

  2. Scegli Crea dominio.

  3. 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 (_) 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 la pagina Configurazione delle opzioni di scalabilità in Amazon CloudSearch.

  4. Seleziona Next (Successivo).

  5. Nelle opzioni di configurazione, seleziona Configurazione manuale e scegli Avanti.

  6. Configura i campi indice per il dominio. Per istruzioni, consulta configure indexing options.

  7. Seleziona Avanti.

  8. Configura la politica di accesso al dominio. Per istruzioni, consulta configure access policies.

    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.

  9. Seleziona Avanti.

  10. 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 con AWS CLI

Il aws cloudsearch create-domain comando viene utilizzato per creare domini di ricerca. Per ulteriori informazioni sull'installazione e la configurazione di AWS CLI, consultare la Guida per l'utente di AWS Command Line Interface.

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:

    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.

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 gli SDK AWS

Gli SDK AWS (eccetto gli SDK per Android e iOS) supportano tutte le CloudSearch azioni Amazon definite nell'API di CloudSearch configurazione di Amazon, tra cui. CreateDomain Per ulteriori informazioni sull'installazione e sull'uso degli SDK AWS, consulta Centro Sviluppatori AWS.