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 alle CloudSearch API Amazon
Ne usi tre APIs per interagire con Amazon CloudSearch:
+ [API di configurazione](configuration-api.md): per configurare e gestire il dominio di ricerca.
+ [API del servizio documenti](document-service-api.md): per inviare i dati da ricercare.
+ [API di ricerca](search-api.md): per effettuare ricerche nel dominio.
# Riferimento all'API di configurazione per Amazon CloudSearch
Utilizzi l'API di CloudSearch configurazione Amazon per creare, configurare e gestire i domini di ricerca. Per ulteriori informazioni sulla configurazione dei domini di ricerca, consultare [Creazione e gestione dei domini di ricerca](creating-managing-domains.md).
Gli altri APIs che usi per interagire con Amazon CloudSearch sono:
+ [Riferimento dell'API del servizio documenti](document-service-api.md): per inviare i dati da ricercare.
+ [Informazioni di riferimento sull'API di ricerca](search-api.md): per eseguire ricerche nel dominio.
**Topics**
+ [Invio di richieste di configurazione in Amazon CloudSearch](submitting-configuration-requests.md)
+ [Azioni](API_Operations.md)
+ [Tipi di dati](API_Types.md)
+ [Parametri comuni](CommonParameters.md)
+ [Errori comuni](CommonErrors.md)
# 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
```
# Azioni
Sono supportate le operazioni seguenti:
+ [BuildSuggesters](API_BuildSuggesters.md)
+ [CreateDomain](API_CreateDomain.md)
+ [DefineAnalysisScheme](API_DefineAnalysisScheme.md)
+ [DefineExpression](API_DefineExpression.md)
+ [DefineIndexField](API_DefineIndexField.md)
+ [DefineSuggester](API_DefineSuggester.md)
+ [DeleteAnalysisScheme](API_DeleteAnalysisScheme.md)
+ [DeleteDomain](API_DeleteDomain.md)
+ [DeleteExpression](API_DeleteExpression.md)
+ [DeleteIndexField](API_DeleteIndexField.md)
+ [DeleteSuggester](API_DeleteSuggester.md)
+ [DescribeAnalysisSchemes](API_DescribeAnalysisSchemes.md)
+ [DescribeAvailabilityOptions](API_DescribeAvailabilityOptions.md)
+ [DescribeDomains](API_DescribeDomains.md)
+ [DescribeExpressions](API_DescribeExpressions.md)
+ [DescribeIndexFields](API_DescribeIndexFields.md)
+ [DescribeScalingParameters](API_DescribeScalingParameters.md)
+ [DescribeServiceAccessPolicies](API_DescribeServiceAccessPolicies.md)
+ [DescribeSuggesters](API_DescribeSuggesters.md)
+ [IndexDocuments](API_IndexDocuments.md)
+ [ListDomainNames](API_ListDomainNames.md)
+ [UpdateAvailabilityOptions](API_UpdateAvailabilityOptions.md)
+ [UpdateScalingParameters](API_UpdateScalingParameters.md)
+ [UpdateServiceAccessPolicies](API_UpdateServiceAccessPolicies.md)
# BuildSuggesters
## Descrizione
Indicizza i suggerimenti di ricerca. Per ulteriori informazioni, consulta [Configuring Suggesters](https://docs.aws.amazon.com/cloudsearch/latest/developerguide/getting-suggestions.html#configuring-suggesters) nella *Amazon CloudSearch Developer Guide*.
## Parametri della richiesta
Per informazioni sui parametri comuni utilizzati da tutte le operazioni, vedi [Parametri comuni](CommonParameters.md).
**DomainName**
Stringa che rappresenta il nome di un dominio. I nomi di dominio sono univoci tra i domini di proprietà di un account all'interno di una regione AWS. I nomi di dominio devono iniziare con una lettera o un numero e possono includere i seguenti caratteri: a-z (minuscoli), 0-9 e - (trattino).
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima di 3. La lunghezza massima è 28 caratteri.
Campo obbligatorio: sì
## Elementi di risposta
Viene restituito l'elemento seguente in una struttura denominata `BuildSuggestersResult`.
**FieldNames**
Elenco di nomi di campo.
Tipo: elenco di stringhe
Vincoli della lunghezza: lunghezza minima 1. La lunghezza massima è 64 caratteri.
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).
**Base**
Si è verificato un errore durante l'elaborazione della richiesta.
Codice di stato HTTP: 400
**Interno**
Si è verificato un errore interno durante l'elaborazione della richiesta. Se il problema persiste, segnalalo dal [Pannello di controllo stato servizi](https://status.aws.amazon.com/).
Codice di stato HTTP: 500
**ResourceNotFound**
La richiesta è stata respinta perché ha provato a fare riferimento a una risorsa inesistente.
Codice di stato HTTP: 409
# CreateDomain
## Descrizione
Crea un nuovo dominio di ricerca Per ulteriori informazioni, consulta [Creating a Search Domain](https://docs.aws.amazon.com/cloudsearch/latest/developerguide/creating-domains.html) nella *Amazon CloudSearch Developer Guide*.
## Parametri della richiesta
Per informazioni sui parametri comuni utilizzati da tutte le operazioni, vedi [Parametri comuni](CommonParameters.md).
**DomainName**
Nome per il dominio che si sta creando. I caratteri consentiti sono a-z (minuscole), 0-9 e trattino (-). I nomi di dominio devono iniziare con una lettera o un numero e avere una lunghezza compresa tra 3 e 28 caratteri.
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima di 3. La lunghezza massima è 28 caratteri.
Campo obbligatorio: sì
## Elementi di risposta
Viene restituito l'elemento seguente in una struttura denominata `CreateDomainResult`.
**DomainStatus**
Lo stato corrente del dominio di ricerca.
Tipo: [DomainStatus](API_DomainStatus.md)
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).
**Base**
Si è verificato un errore durante l'elaborazione della richiesta.
Codice di stato HTTP: 400
**Interno**
Si è verificato un errore interno durante l'elaborazione della richiesta. Se il problema persiste, segnalalo dal [Pannello di controllo stato servizi](https://status.aws.amazon.com/).
Codice di stato HTTP: 500
**LimitExceeded**
La richiesta è stata respinta perché è già stato raggiunto un limite di risorse.
Codice di stato HTTP: 409
# DefineAnalysisScheme
## Descrizione
Configura uno schema di analisi che può essere applicato a un campo `text` o `text-array` per definire le opzioni di elaborazione del testo specifiche della lingua. Per ulteriori informazioni, consulta [Configuring Analysis Schemes](https://docs.aws.amazon.com/cloudsearch/latest/developerguide/configuring-analysis-schemes.html) nella *Amazon CloudSearch Developer Guide*.
## Parametri della richiesta
Per informazioni sui parametri comuni utilizzati da tutte le operazioni, vedi [Parametri comuni](CommonParameters.md).
**AnalysisScheme**
Informazioni di configurazione per uno schema di analisi. Ogni schema di analisi ha un nome univoco e specifica la lingua del testo da elaborare. Per uno schema di analisi è possibile configurare le seguenti opzioni: `Synonyms`, `Stopwords`, `StemmingDictionary`, `JapaneseTokenizationDictionary` e `AlgorithmicStemming`.
Tipo: [AnalysisScheme](API_AnalysisScheme.md)
Campo obbligatorio: sì
**DomainName**
Stringa che rappresenta il nome di un dominio. I nomi di dominio sono univoci tra i domini di proprietà di un account all'interno di una regione AWS. I nomi di dominio devono iniziare con una lettera o un numero e possono includere i seguenti caratteri: a-z (minuscoli), 0-9 e - (trattino).
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima di 3. La lunghezza massima è 28 caratteri.
Campo obbligatorio: sì
## Elementi di risposta
Viene restituito l'elemento seguente in una struttura denominata `DefineAnalysisSchemeResult`.
**AnalysisScheme**
Stato e configurazione di un `AnalysisScheme`.
Tipo: [AnalysisSchemeStatus](API_AnalysisSchemeStatus.md)
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).
**Base**
Si è verificato un errore durante l'elaborazione della richiesta.
Codice di stato HTTP: 400
**Interno**
Si è verificato un errore interno durante l'elaborazione della richiesta. Se il problema persiste, segnalalo dal [Pannello di controllo stato servizi](https://status.aws.amazon.com/).
Codice di stato HTTP: 500
**InvalidType**
La richiesta è stata respinta perché ha specificato una definizione di tipo non valido.
Codice di stato HTTP: 409
**LimitExceeded**
La richiesta è stata respinta perché è già stato raggiunto un limite di risorse.
Codice di stato HTTP: 409
**ResourceNotFound**
La richiesta è stata respinta perché ha provato a fare riferimento a una risorsa inesistente.
Codice di stato HTTP: 409
# DefineExpression
## Descrizione
Configura un ` Expression ` per il dominio di ricerca. Utilizzato per creare nuove espressioni e modificare quelle esistenti. Se l'espressione esiste, la nuova configurazione sostituisce quella precedente. Per ulteriori informazioni, consulta [Configuring Expressions](https://docs.aws.amazon.com/cloudsearch/latest/developerguide/configuring-expressions.html) nell'*Amazon CloudSearch Developer Guide*.
## Parametri della richiesta
Per informazioni sui parametri comuni utilizzati da tutte le operazioni, vedi [Parametri comuni](CommonParameters.md).
**DomainName**
Stringa che rappresenta il nome di un dominio. I nomi di dominio sono univoci tra i domini di proprietà di un account all'interno di una regione AWS. I nomi di dominio devono iniziare con una lettera o un numero e possono includere i seguenti caratteri: a-z (minuscoli), 0-9 e - (trattino).
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima di 3. La lunghezza massima è 28 caratteri.
Campo obbligatorio: sì
**Expression**
Espressione con nome che può essere valutata al momento della ricerca. Può essere utilizzata per ordinare i risultati di ricerca, definire altre espressioni o restituire informazioni calcolate nei risultati di ricerca.
Tipo: [Expression](API_Expression.md)
Campo obbligatorio: sì
## Elementi di risposta
Viene restituito l'elemento seguente in una struttura denominata `DefineExpressionResult`.
**Expression**
Il valore di un'`Expression` e il rispettivo stato corrente.
Tipo: [ExpressionStatus](API_ExpressionStatus.md)
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).
**Base**
Si è verificato un errore durante l'elaborazione della richiesta.
Codice di stato HTTP: 400
**Interno**
Si è verificato un errore interno durante l'elaborazione della richiesta. Se il problema persiste, segnalalo dal [Pannello di controllo stato servizi](https://status.aws.amazon.com/).
Codice di stato HTTP: 500
**InvalidType**
La richiesta è stata respinta perché ha specificato una definizione di tipo non valido.
Codice di stato HTTP: 409
**LimitExceeded**
La richiesta è stata respinta perché è già stato raggiunto un limite di risorse.
Codice di stato HTTP: 409
**ResourceNotFound**
La richiesta è stata respinta perché ha provato a fare riferimento a una risorsa inesistente.
Codice di stato HTTP: 409
# DefineIndexField
## Descrizione
Configura un ` IndexField ` per il dominio di ricerca. Utilizzato per creare nuovi campi e modificare quelli esistenti. È necessario specificare il nome del dominio che si configura e una configurazione del campo dell'indice. La configurazione del campo dell'indice specifica il nome, il tipo di campo dell'indice e le opzioni da configurare per il campo. Le opzioni che è possibile specificare dipendono dal ` IndexFieldType `. Se il campo esiste, la nuova configurazione sostituisce quella precedente. Per ulteriori informazioni, consulta [Configurazione dei campi indice](https://docs.aws.amazon.com/cloudsearch/latest/developerguide/configuring-index-fields.html) nella *Amazon CloudSearch Developer Guide*.
## Parametri della richiesta
Per informazioni sui parametri comuni utilizzati da tutte le operazioni, vedi [Parametri comuni](CommonParameters.md).
**DomainName**
Stringa che rappresenta il nome di un dominio. I nomi di dominio sono univoci tra i domini di proprietà di un account all'interno di una regione AWS. I nomi di dominio devono iniziare con una lettera o un numero e possono includere i seguenti caratteri: a-z (minuscoli), 0-9 e - (trattino).
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima di 3. La lunghezza massima è 28 caratteri.
Campo obbligatorio: sì
**IndexField**
Le opzioni dei campi e dei campi dell'indice che si desidera configurare.
Tipo: [IndexField](API_IndexField.md)
Campo obbligatorio: sì
## Elementi di risposta
Viene restituito l'elemento seguente in una struttura denominata `DefineIndexFieldResult`.
**IndexField**
Il valore di un'`IndexField` e il rispettivo stato corrente.
Tipo: [IndexFieldStatus](API_IndexFieldStatus.md)
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).
**Base**
Si è verificato un errore durante l'elaborazione della richiesta.
Codice di stato HTTP: 400
**Interno**
Si è verificato un errore interno durante l'elaborazione della richiesta. Se il problema persiste, segnalalo dal [Pannello di controllo stato servizi](https://status.aws.amazon.com/).
Codice di stato HTTP: 500
**InvalidType**
La richiesta è stata respinta perché ha specificato una definizione di tipo non valido.
Codice di stato HTTP: 409
**LimitExceeded**
La richiesta è stata respinta perché è già stato raggiunto un limite di risorse.
Codice di stato HTTP: 409
**ResourceNotFound**
La richiesta è stata respinta perché ha provato a fare riferimento a una risorsa inesistente.
Codice di stato HTTP: 409
# DefineSuggester
## Descrizione
Configura un suggeritore per un dominio. Un suggeritore visualizza le corrispondenze possibili prima che si finisca di digitare le query. Quando si configura un suggeritore, è necessario specificare il nome del campo di testo per cercare possibili corrispondenze e un nome univoco per il suggeritore. Per ulteriori informazioni, consulta [Ottenere suggerimenti per la ricerca](https://docs.aws.amazon.com/cloudsearch/latest/developerguide/getting-suggestions.html) nella *Amazon CloudSearch Developer Guide*.
## Parametri della richiesta
Per informazioni sui parametri comuni utilizzati da tutte le operazioni, vedi [Parametri comuni](CommonParameters.md).
**DomainName**
Stringa che rappresenta il nome di un dominio. I nomi di dominio sono univoci tra i domini di proprietà di un account all'interno di una regione AWS. I nomi di dominio devono iniziare con una lettera o un numero e possono includere i seguenti caratteri: a-z (minuscoli), 0-9 e - (trattino).
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima di 3. La lunghezza massima è 28 caratteri.
Campo obbligatorio: sì
**Suggeritore**
Le informazioni di configurazione per un suggeritore di ricerche. Ogni suggeritore ha un nome univoco e specifica il campo di testo da utilizzare per i suggerimenti. È possibile configurare le opzioni seguenti per un suggeritore: `FuzzyMatching`, `SortExpression`.
Tipo: [Suggeritore](API_Suggester.md)
Campo obbligatorio: sì
## Elementi di risposta
Viene restituito l'elemento seguente in una struttura denominata `DefineSuggesterResult`.
**Suggeritore**
Il valore di un `Suggester` e il rispettivo stato corrente.
Tipo: [SuggesterStatus](API_SuggesterStatus.md)
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).
**Base**
Si è verificato un errore durante l'elaborazione della richiesta.
Codice di stato HTTP: 400
**Interno**
Si è verificato un errore interno durante l'elaborazione della richiesta. Se il problema persiste, segnalalo dal [Pannello di controllo stato servizi](https://status.aws.amazon.com/).
Codice di stato HTTP: 500
**InvalidType**
La richiesta è stata respinta perché ha specificato una definizione di tipo non valido.
Codice di stato HTTP: 409
**LimitExceeded**
La richiesta è stata respinta perché è già stato raggiunto un limite di risorse.
Codice di stato HTTP: 409
**ResourceNotFound**
La richiesta è stata respinta perché ha provato a fare riferimento a una risorsa inesistente.
Codice di stato HTTP: 409
# DeleteAnalysisScheme
## Descrizione
Elimina uno schema di analisi. Per ulteriori informazioni, consulta [Configuring Analysis Schemes](https://docs.aws.amazon.com/cloudsearch/latest/developerguide/configuring-analysis-schemes.html) nella *Amazon CloudSearch Developer Guide*.
## Parametri della richiesta
Per informazioni sui parametri comuni utilizzati da tutte le operazioni, vedi [Parametri comuni](CommonParameters.md).
**AnalysisSchemeName**
Nome dello schema di analisi che vuoi eliminare.
Tipo: stringa
Vincoli della lunghezza: lunghezza minima 1. La lunghezza massima è 64 caratteri.
Campo obbligatorio: sì
**DomainName**
Stringa che rappresenta il nome di un dominio. I nomi di dominio sono univoci tra i domini di proprietà di un account all'interno di una regione AWS. I nomi di dominio devono iniziare con una lettera o un numero e possono includere i seguenti caratteri: a-z (minuscoli), 0-9 e - (trattino).
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima di 3. La lunghezza massima è 28 caratteri.
Campo obbligatorio: sì
## Elementi di risposta
Viene restituito l'elemento seguente in una struttura denominata `DeleteAnalysisSchemeResult`.
**AnalysisScheme**
Stato dello schema di analisi in fase di eliminazione.
Tipo: [AnalysisSchemeStatus](API_AnalysisSchemeStatus.md)
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).
**Base**
Si è verificato un errore durante l'elaborazione della richiesta.
Codice di stato HTTP: 400
**Interno**
Si è verificato un errore interno durante l'elaborazione della richiesta. Se il problema persiste, segnalalo dal [Pannello di controllo stato servizi](https://status.aws.amazon.com/).
Codice di stato HTTP: 500
**InvalidType**
La richiesta è stata respinta perché ha specificato una definizione di tipo non valido.
Codice di stato HTTP: 409
**ResourceNotFound**
La richiesta è stata respinta perché ha provato a fare riferimento a una risorsa inesistente.
Codice di stato HTTP: 409
# DeleteDomain
## Descrizione
Elimina in modo definitivo un dominio di ricerca e tutti i relativi dati. Una volta che eliminato, un dominio non può essere ripristinato. Per ulteriori informazioni, consulta [Eliminazione di un dominio di ricerca](https://docs.aws.amazon.com/cloudsearch/latest/developerguide/deleting-domains.html) nella *Amazon CloudSearch Developer Guide*.
## Parametri della richiesta
Per informazioni sui parametri comuni utilizzati da tutte le operazioni, vedi [Parametri comuni](CommonParameters.md).
**DomainName**
Il nome del dominio che si desidera eliminare in modo definitivo.
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima di 3. La lunghezza massima è 28 caratteri.
Campo obbligatorio: sì
## Elementi di risposta
Viene restituito l'elemento seguente in una struttura denominata `DeleteDomainResult`.
**DomainStatus**
Lo stato corrente del dominio di ricerca.
Tipo: [DomainStatus](API_DomainStatus.md)
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).
**Base**
Si è verificato un errore durante l'elaborazione della richiesta.
Codice di stato HTTP: 400
**Interno**
Si è verificato un errore interno durante l'elaborazione della richiesta. Se il problema persiste, segnalalo dal [Pannello di controllo stato servizi](https://status.aws.amazon.com/).
Codice di stato HTTP: 500
# DeleteExpression
## Descrizione
Rimuove un ` Expression ` dal dominio di ricerca. Per ulteriori informazioni, consulta [Configuring Expressions](https://docs.aws.amazon.com/cloudsearch/latest/developerguide/configuring-expressions.html) nell'*Amazon CloudSearch Developer Guide*.
## Parametri della richiesta
Per informazioni sui parametri comuni utilizzati da tutte le operazioni, vedi [Parametri comuni](CommonParameters.md).
**DomainName**
Stringa che rappresenta il nome di un dominio. I nomi di dominio sono univoci tra i domini di proprietà di un account all'interno di una regione AWS. I nomi di dominio devono iniziare con una lettera o un numero e possono includere i seguenti caratteri: a-z (minuscoli), 0-9 e - (trattino).
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima di 3. La lunghezza massima è 28 caratteri.
Campo obbligatorio: sì
**ExpressionName**
Nome dell'` Expression ` da eliminare.
Tipo: stringa
Vincoli della lunghezza: lunghezza minima 1. La lunghezza massima è 64 caratteri.
Campo obbligatorio: sì
## Elementi di risposta
Viene restituito l'elemento seguente in una struttura denominata `DeleteExpressionResult`.
**Expression**
Stato dell'espressione in fase di eliminazione.
Tipo: [ExpressionStatus](API_ExpressionStatus.md)
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).
**Base**
Si è verificato un errore durante l'elaborazione della richiesta.
Codice di stato HTTP: 400
**Interno**
Si è verificato un errore interno durante l'elaborazione della richiesta. Se il problema persiste, segnalalo dal [Pannello di controllo stato servizi](https://status.aws.amazon.com/).
Codice di stato HTTP: 500
**InvalidType**
La richiesta è stata respinta perché ha specificato una definizione di tipo non valido.
Codice di stato HTTP: 409
**ResourceNotFound**
La richiesta è stata respinta perché ha provato a fare riferimento a una risorsa inesistente.
Codice di stato HTTP: 409
# DeleteIndexField
## Descrizione
Rimuove un ` IndexField ` dal dominio di ricerca. Per ulteriori informazioni, consulta [Configurazione dei campi indice](https://docs.aws.amazon.com/cloudsearch/latest/developerguide/configuring-index-fields.html) nella *Amazon CloudSearch Developer Guide*.
## Parametri della richiesta
Per informazioni sui parametri comuni utilizzati da tutte le operazioni, vedi [Parametri comuni](CommonParameters.md).
**DomainName**
Stringa che rappresenta il nome di un dominio. I nomi di dominio sono univoci tra i domini di proprietà di un account all'interno di una regione AWS. I nomi di dominio devono iniziare con una lettera o un numero e possono includere i seguenti caratteri: a-z (minuscoli), 0-9 e - (trattino).
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima di 3. La lunghezza massima è 28 caratteri.
Campo obbligatorio: sì
**IndexFieldName**
Il nome del campo dell'indice da rimuovere dalle opzioni di indicizzazione del dominio.
Tipo: stringa
Vincoli della lunghezza: lunghezza minima 1. La lunghezza massima è 64 caratteri.
Campo obbligatorio: sì
## Elementi di risposta
Viene restituito l'elemento seguente in una struttura denominata `DeleteIndexFieldResult`.
**IndexField**
Stato del campo dell'indice da eliminare.
Tipo: [IndexFieldStatus](API_IndexFieldStatus.md)
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).
**Base**
Si è verificato un errore durante l'elaborazione della richiesta.
Codice di stato HTTP: 400
**Interno**
Si è verificato un errore interno durante l'elaborazione della richiesta. Se il problema persiste, segnalalo dal [Pannello di controllo stato servizi](https://status.aws.amazon.com/).
Codice di stato HTTP: 500
**InvalidType**
La richiesta è stata respinta perché ha specificato una definizione di tipo non valido.
Codice di stato HTTP: 409
**ResourceNotFound**
La richiesta è stata respinta perché ha provato a fare riferimento a una risorsa inesistente.
Codice di stato HTTP: 409
# DeleteSuggester
## Descrizione
Elimina un suggeritore. Per ulteriori informazioni, consulta [Ottenere suggerimenti per la ricerca](https://docs.aws.amazon.com/cloudsearch/latest/developerguide/getting-suggestions.html) nella *Amazon CloudSearch Developer Guide*.
## Parametri della richiesta
Per informazioni sui parametri comuni utilizzati da tutte le operazioni, vedi [Parametri comuni](CommonParameters.md).
**DomainName**
Stringa che rappresenta il nome di un dominio. I nomi di dominio sono univoci tra i domini di proprietà di un account all'interno di una regione AWS. I nomi di dominio devono iniziare con una lettera o un numero e possono includere i seguenti caratteri: a-z (minuscoli), 0-9 e - (trattino).
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima di 3. La lunghezza massima è 28 caratteri.
Campo obbligatorio: sì
**SuggesterName**
Specifica il nome del suggeritore che vuoi eliminare.
Tipo: stringa
Vincoli della lunghezza: lunghezza minima 1. La lunghezza massima è 64 caratteri.
Campo obbligatorio: sì
## Elementi di risposta
Viene restituito l'elemento seguente in una struttura denominata `DeleteSuggesterResult`.
**Suggeritore**
Stato del suggeritore in fase di eliminazione.
Tipo: [SuggesterStatus](API_SuggesterStatus.md)
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).
**Base**
Si è verificato un errore durante l'elaborazione della richiesta.
Codice di stato HTTP: 400
**Interno**
Si è verificato un errore interno durante l'elaborazione della richiesta. Se il problema persiste, segnalalo dal [Pannello di controllo stato servizi](https://status.aws.amazon.com/).
Codice di stato HTTP: 500
**InvalidType**
La richiesta è stata respinta perché ha specificato una definizione di tipo non valido.
Codice di stato HTTP: 409
**ResourceNotFound**
La richiesta è stata respinta perché ha provato a fare riferimento a una risorsa inesistente.
Codice di stato HTTP: 409
# DescribeAnalysisSchemes
## Descrizione
Ottiene gli schemi di analisi configurati per un dominio. Uno schema di analisi definisce le opzioni di elaborazione del testo specifiche della lingua per un campo `text`. Può essere limitato a schemi di analisi specifici in base al nome. Per impostazione predefinita, mostra tutti gli schemi di analisi e include eventuali modifiche in sospeso alla configurazione. Imposta l'opzione `Deployed` su `true` per visualizzare la configurazione attiva ed escludere le modifiche in sospeso. Per ulteriori informazioni, consulta [Configuring Analysis Schemes](https://docs.aws.amazon.com/cloudsearch/latest/developerguide/configuring-analysis-schemes.html) nella *Amazon CloudSearch Developer Guide*.
## Parametri della richiesta
Per informazioni sui parametri comuni utilizzati da tutte le operazioni, vedi [Parametri comuni](CommonParameters.md).
**AnalysisSchemeNames.Membern.**
Gli schemi di analisi che si desidera descrivere.
Tipo: elenco di stringhe
Vincoli della lunghezza: lunghezza minima 1. La lunghezza massima è 64 caratteri.
Campo obbligatorio: no
**Deployed (Distribuito)**
Indica se visualizzare la configurazione distribuita (`true`) o includere eventuali modifiche in sospeso (`false`). L'impostazione predefinita è `false`.
Tipo: Booleano
Campo obbligatorio: no
**DomainName**
Nome del dominio che si intende descrivere.
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima di 3. La lunghezza massima è 28 caratteri.
Campo obbligatorio: sì
## Elementi di risposta
Viene restituito l'elemento seguente in una struttura denominata `DescribeAnalysisSchemesResult`.
**AnalysisSchemes**
Le descrizioni degli schemi di analisi.
Type:[AnalysisSchemeStatus](API_AnalysisSchemeStatus.md) elenco
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).
**Base**
Si è verificato un errore durante l'elaborazione della richiesta.
Codice di stato HTTP: 400
**Interno**
Si è verificato un errore interno durante l'elaborazione della richiesta. Se il problema persiste, segnalalo dal [Pannello di controllo stato servizi](https://status.aws.amazon.com/).
Codice di stato HTTP: 500
**ResourceNotFound**
La richiesta è stata respinta perché ha provato a fare riferimento a una risorsa inesistente.
Codice di stato HTTP: 409
# DescribeAvailabilityOptions
## Descrizione
Ottiene le opzioni di disponibilità configurate per un dominio. Per impostazione predefinita, mostra la configurazione con eventuali modifiche in sospeso. Imposta l'opzione `Deployed` su `true` per visualizzare la configurazione attiva ed escludere le modifiche in sospeso. Per ulteriori informazioni, consulta [Configurazione delle opzioni di disponibilità](https://docs.aws.amazon.com/cloudsearch/latest/developerguide/configuring-availability-options.html) nella *Amazon CloudSearch Developer Guide*.
## Parametri della richiesta
Per informazioni sui parametri comuni utilizzati da tutte le operazioni, vedi [Parametri comuni](CommonParameters.md).
**Deployed (Distribuito)**
Indica se visualizzare la configurazione distribuita (`true`) o includere eventuali modifiche in sospeso (`false`). L'impostazione predefinita è `false`.
Tipo: Booleano
Campo obbligatorio: no
**DomainName**
Nome del dominio che si intende descrivere.
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima di 3. La lunghezza massima è 28 caratteri.
Campo obbligatorio: sì
## Elementi di risposta
Viene restituito l'elemento seguente in una struttura denominata `DescribeAvailabilityOptionsResult`.
**AvailabilityOptions**
Le opzioni di disponibilità configurate per il dominio. Indica se l'opzione Multi-AZ è abilitata per il dominio.
Tipo: [AvailabilityOptionsStatus](API_AvailabilityOptionsStatus.md)
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).
**Base**
Si è verificato un errore durante l'elaborazione della richiesta.
Codice di stato HTTP: 400
**DisabledOperation**
La richiesta è stata respinta perché ha tentato un'operazione non abilitata.
Codice di stato HTTP: 409
**Interno**
Si è verificato un errore interno durante l'elaborazione della richiesta. Se il problema persiste, segnalalo dal [Pannello di controllo stato servizi](https://status.aws.amazon.com/).
Codice di stato HTTP: 500
**InvalidType**
La richiesta è stata respinta perché ha specificato una definizione di tipo non valido.
Codice di stato HTTP: 409
**LimitExceeded**
La richiesta è stata respinta perché è già stato raggiunto un limite di risorse.
Codice di stato HTTP: 409
**ResourceNotFound**
La richiesta è stata respinta perché ha provato a fare riferimento a una risorsa inesistente.
Codice di stato HTTP: 409
# DescribeDomains
## Descrizione
Ottiene informazioni sui domini di ricerca di proprietà di questo account. Può essere limitato a domini specifici. Mostra tutti i domini per impostazione predefinita. Per ottenere il numero di documenti ricercabili in un dominio, utilizza la console oppure invia una richiesta `matchall` all'endpoint delle ricerche del tuo dominio: `q=matchall&q.parser=structured&size=0`. Per ulteriori informazioni, consulta [Ottenere informazioni su un dominio di ricerca](https://docs.aws.amazon.com/cloudsearch/latest/developerguide/getting-domain-info.html) nella *Amazon CloudSearch Developer Guide*.
## Parametri della richiesta
Per informazioni sui parametri comuni utilizzati da tutte le operazioni, vedi [Parametri comuni](CommonParameters.md).
**DomainNames.Membro.**
I nomi dei domini da includere nella risposta.
Tipo: elenco di stringhe
Limitazioni di lunghezza: lunghezza minima di 3. La lunghezza massima è 28 caratteri.
Campo obbligatorio: no
## Elementi di risposta
Viene restituito l'elemento seguente in una struttura denominata `DescribeDomainsResult`.
**DomainStatusList**
Elenco che contiene lo stato di ogni dominio richiesto.
Type:[DomainStatus](API_DomainStatus.md) elenco
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).
**Base**
Si è verificato un errore durante l'elaborazione della richiesta.
Codice di stato HTTP: 400
**Interno**
Si è verificato un errore interno durante l'elaborazione della richiesta. Se il problema persiste, segnalalo dal [Pannello di controllo stato servizi](https://status.aws.amazon.com/).
Codice di stato HTTP: 500
# DescribeExpressions
## Descrizione
Recupera le espressioni configurate per il dominio di ricerca. Può essere limitato a espressioni specifiche in base al nome. Per impostazione predefinita, mostra tutte le espressioni e include eventuali modifiche in sospeso per la configurazione. Imposta l'opzione `Deployed` su `true` per visualizzare la configurazione attiva ed escludere le modifiche in sospeso. Per ulteriori informazioni, consulta [Configuring Expressions](https://docs.aws.amazon.com/cloudsearch/latest/developerguide/configuring-expressions.html) nell'*Amazon CloudSearch Developer Guide*.
## Parametri della richiesta
Per informazioni sui parametri comuni utilizzati da tutte le operazioni, vedi [Parametri comuni](CommonParameters.md).
**Deployed (Distribuito)**
Indica se visualizzare la configurazione distribuita (`true`) o includere eventuali modifiche in sospeso (`false`). L'impostazione predefinita è `false`.
Tipo: Booleano
Campo obbligatorio: no
**DomainName**
Nome del dominio che si intende descrivere.
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima di 3. La lunghezza massima è 28 caratteri.
Campo obbligatorio: sì
**ExpressionNames.Membern.**
Limita la risposta di ` DescribeExpressions ` alle espressioni specificate. Se non sono specificate, vengono mostrate tutte le espressioni.
Tipo: elenco di stringhe
Vincoli della lunghezza: lunghezza minima 1. La lunghezza massima è 64 caratteri.
Campo obbligatorio: no
## Elementi di risposta
Viene restituito l'elemento seguente in una struttura denominata `DescribeExpressionsResult`.
**Espressioni**
Le espressioni configurate per il dominio.
Type:[ExpressionStatus](API_ExpressionStatus.md) elenco
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).
**Base**
Si è verificato un errore durante l'elaborazione della richiesta.
Codice di stato HTTP: 400
**Interno**
Si è verificato un errore interno durante l'elaborazione della richiesta. Se il problema persiste, segnalalo dal [Pannello di controllo stato servizi](https://status.aws.amazon.com/).
Codice di stato HTTP: 500
**ResourceNotFound**
La richiesta è stata respinta perché ha provato a fare riferimento a una risorsa inesistente.
Codice di stato HTTP: 409
# DescribeIndexFields
## Descrizione
Ottiene informazioni sui campi dell'indice configurati per il dominio di ricerca. Può essere limitato a campi specifici in base al nome. Per impostazione predefinita, mostra tutti i campi e include eventuali modifiche in sospeso per la configurazione. Imposta l'opzione `Deployed` su `true` per visualizzare la configurazione attiva ed escludere le modifiche in sospeso. Per ulteriori informazioni, consulta [Ottenere informazioni sul dominio](https://docs.aws.amazon.com/cloudsearch/latest/developerguide/getting-domain-info.html) nella *Amazon CloudSearch Developer Guide*.
## Parametri della richiesta
Per informazioni sui parametri comuni utilizzati da tutte le operazioni, vedi [Parametri comuni](CommonParameters.md).
**Deployed (Distribuito)**
Indica se visualizzare la configurazione distribuita (`true`) o includere eventuali modifiche in sospeso (`false`). L'impostazione predefinita è `false`.
Tipo: Booleano
Campo obbligatorio: no
**DomainName**
Nome del dominio che si intende descrivere.
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima di 3. La lunghezza massima è 28 caratteri.
Campo obbligatorio: sì
**FieldNames.Membern.**
Elenco dei campi dell'indice che desideri descrivere. Se non è specificato, vengono restituite le informazioni su tutti i campi dell'indice configurati.
Tipo: elenco di stringhe
Vincoli della lunghezza: lunghezza minima 1. La lunghezza massima è 64 caratteri.
Campo obbligatorio: no
## Elementi di risposta
Viene restituito l'elemento seguente in una struttura denominata `DescribeIndexFieldsResult`.
**IndexFields**
I campi dell'indice configurati per il dominio.
Type:[IndexFieldStatus](API_IndexFieldStatus.md) elenco
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).
**Base**
Si è verificato un errore durante l'elaborazione della richiesta.
Codice di stato HTTP: 400
**Interno**
Si è verificato un errore interno durante l'elaborazione della richiesta. Se il problema persiste, segnalalo dal [Pannello di controllo stato servizi](https://status.aws.amazon.com/).
Codice di stato HTTP: 500
**ResourceNotFound**
La richiesta è stata respinta perché ha provato a fare riferimento a una risorsa inesistente.
Codice di stato HTTP: 409
# DescribeScalingParameters
## Descrizione
Restituisce i parametri di dimensionamento configurati per un dominio. I parametri di dimensionamento di un dominio specificano il tipo di istanza di ricerca e il conteggio di replica desiderati. Per ulteriori informazioni, consulta la sezione [Configurazione delle opzioni di scalabilità](https://docs.aws.amazon.com/cloudsearch/latest/developerguide/configuring-scaling-options.html) nella *Amazon CloudSearch Developer Guide*.
## Parametri della richiesta
Per informazioni sui parametri comuni utilizzati da tutte le operazioni, vedi [Parametri comuni](CommonParameters.md).
**DomainName**
Stringa che rappresenta il nome di un dominio. I nomi di dominio sono univoci tra i domini di proprietà di un account all'interno di una regione AWS. I nomi di dominio devono iniziare con una lettera o un numero e possono includere i seguenti caratteri: a-z (minuscoli), 0-9 e - (trattino).
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima di 3. La lunghezza massima è 28 caratteri.
Campo obbligatorio: sì
## Elementi di risposta
Viene restituito l'elemento seguente in una struttura denominata `DescribeScalingParametersResult`.
**ScalingParameters**
Lo stato e la configurazione dei parametri di dimensionamento di un dominio di ricerca.
Tipo: [ScalingParametersStatus](API_ScalingParametersStatus.md)
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).
**Base**
Si è verificato un errore durante l'elaborazione della richiesta.
Codice di stato HTTP: 400
**Interno**
Si è verificato un errore interno durante l'elaborazione della richiesta. Se il problema persiste, segnalalo dal [Pannello di controllo stato servizi](https://status.aws.amazon.com/).
Codice di stato HTTP: 500
**ResourceNotFound**
La richiesta è stata respinta perché ha provato a fare riferimento a una risorsa inesistente.
Codice di stato HTTP: 409
# DescribeDomainEndpointOptions
## Description
Restituisce le opzioni dell'endpoint del dominio, in particolare se tutte le richieste al dominio devono arrivare tramite HTTPS. Per ulteriori informazioni, consulta [Configuring Domain Endpoint Options](https://docs.aws.amazon.com/cloudsearch/latest/developerguide/configuring-domain-endpoint-options.html) nella *Amazon CloudSearch Developer Guide*.
## Parametri della richiesta
Per informazioni sui parametri comuni utilizzati da tutte le operazioni, vedi [Parametri comuni](CommonParameters.md).
**DomainName**
Stringa che rappresenta il nome di un dominio.
Tipo: stringa
Obbligatorio: sì
**deployed**
Indica se recuperare la configurazione più recente (che potrebbe trovarsi in uno stato `Processing`) o la configurazione attiva (`?deployed=true`) corrente.
Tipo: Booleano
Obbligatorio: no
## Elementi di risposta
**DomainEndpointOptions**
Stato e configurazione delle opzioni endpoint di un dominio di ricerca.
Tipo: [DomainEndpointOptionsStatus](API_DomainEndpointOptionsStatus.md)
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).
**Base**
Si è verificato un errore durante l'elaborazione della richiesta.
Codice di stato HTTP: 400
**Interno**
Si è verificato un errore interno durante l'elaborazione della richiesta. Se il problema persiste, segnalalo dal [Pannello di controllo stato servizi](https://status.aws.amazon.com/).
Codice di stato HTTP: 500
**LimitExceeded**
La richiesta è stata respinta perché è già stato raggiunto un limite di risorse.
Codice di stato HTTP: 409
**ResourceNotFound**
La richiesta è stata respinta perché ha provato a fare riferimento a una risorsa inesistente.
Codice di stato HTTP: 409
# DescribeServiceAccessPolicies
## Descrizione
Ottiene informazioni sulle policy d'accesso che controllano l'accesso agli endpoint di ricerca e del documento del dominio. Per impostazione predefinita, mostra la configurazione con eventuali modifiche in sospeso. Imposta l'opzione `Deployed` su `true` per visualizzare la configurazione attiva ed escludere le modifiche in sospeso. Per ulteriori informazioni, consulta [Configurazione dell'accesso per un dominio di ricerca](https://docs.aws.amazon.com/cloudsearch/latest/developerguide/configuring-access.html) nella *Amazon CloudSearch Developer Guide*.
## Parametri della richiesta
Per informazioni sui parametri comuni utilizzati da tutte le operazioni, vedi [Parametri comuni](CommonParameters.md).
**Deployed (Distribuito)**
Indica se visualizzare la configurazione distribuita (`true`) o includere eventuali modifiche in sospeso (`false`). L'impostazione predefinita è `false`.
Tipo: Booleano
Campo obbligatorio: no
**DomainName**
Nome del dominio che si intende descrivere.
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima di 3. La lunghezza massima è 28 caratteri.
Campo obbligatorio: sì
## Elementi di risposta
Viene restituito l'elemento seguente in una struttura denominata `DescribeServiceAccessPoliciesResult`.
**AccessPolicies**
Le regole di accesso configurate per il dominio specificato nella richiesta.
Tipo: [AccessPoliciesStatus](API_AccessPoliciesStatus.md)
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).
**Base**
Si è verificato un errore durante l'elaborazione della richiesta.
Codice di stato HTTP: 400
**Interno**
Si è verificato un errore interno durante l'elaborazione della richiesta. Se il problema persiste, segnalalo dal [Pannello di controllo stato servizi](https://status.aws.amazon.com/).
Codice di stato HTTP: 500
**ResourceNotFound**
La richiesta è stata respinta perché ha provato a fare riferimento a una risorsa inesistente.
Codice di stato HTTP: 409
# DescribeSuggesters
## Descrizione
Restituisce i suggeritori configurati per un dominio. Un suggeritore visualizza le corrispondenze possibili prima che si finisca di digitare le query. Può essere limitato a suggeritori specifici in base al nome. Per impostazione predefinita, mostra tutti i suggeritori e include eventuali modifiche in sospeso per la configurazione. Imposta l'opzione `Deployed` su `true` per visualizzare la configurazione attiva ed escludere le modifiche in sospeso. Per ulteriori informazioni, consulta [Ottenere suggerimenti per la ricerca](https://docs.aws.amazon.com/cloudsearch/latest/developerguide/getting-suggestions.html) nella *Amazon CloudSearch Developer Guide*.
## Parametri della richiesta
Per informazioni sui parametri comuni utilizzati da tutte le operazioni, vedi [Parametri comuni](CommonParameters.md).
**Deployed (Distribuito)**
Indica se visualizzare la configurazione distribuita (`true`) o includere eventuali modifiche in sospeso (`false`). L'impostazione predefinita è `false`.
Tipo: Booleano
Campo obbligatorio: no
**DomainName**
Nome del dominio che si intende descrivere.
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima di 3. La lunghezza massima è 28 caratteri.
Campo obbligatorio: sì
**SuggesterNames.Membro.**
I suggeritori che si desidera descrivere.
Tipo: elenco di stringhe
Vincoli della lunghezza: lunghezza minima 1. La lunghezza massima è 64 caratteri.
Campo obbligatorio: no
## Elementi di risposta
Viene restituito l'elemento seguente in una struttura denominata `DescribeSuggestersResult`.
**Suggesters**
I suggeritori configurati per il dominio specificato nella richiesta.
Type:[SuggesterStatus](API_SuggesterStatus.md) elenco
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).
**Base**
Si è verificato un errore durante l'elaborazione della richiesta.
Codice di stato HTTP: 400
**Interno**
Si è verificato un errore interno durante l'elaborazione della richiesta. Se il problema persiste, segnalalo dal [Pannello di controllo stato servizi](https://status.aws.amazon.com/).
Codice di stato HTTP: 500
**ResourceNotFound**
La richiesta è stata respinta perché ha provato a fare riferimento a una risorsa inesistente.
Codice di stato HTTP: 409
# IndexDocuments
## Descrizione
Indica il dominio di ricerca per avviare l'indicizzazione dei rispettivi documenti utilizzando le ultime opzioni di indicizzazione. Questa operazione deve essere invocata per attivare le opzioni il cui [OptionStatus](API_OptionStatus.md) è `RequiresIndexDocuments`.
## Parametri della richiesta
Per informazioni sui parametri comuni utilizzati da tutte le operazioni, vedi [Parametri comuni](CommonParameters.md).
**DomainName**
Stringa che rappresenta il nome di un dominio. I nomi di dominio sono univoci tra i domini di proprietà di un account all'interno di una regione AWS. I nomi di dominio devono iniziare con una lettera o un numero e possono includere i seguenti caratteri: a-z (minuscoli), 0-9 e - (trattino).
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima di 3. La lunghezza massima è 28 caratteri.
Campo obbligatorio: sì
## Elementi di risposta
Viene restituito l'elemento seguente in una struttura denominata `IndexDocumentsResult`.
**FieldNames**
I nomi dei campi attualmente sottoposti a indicizzazione.
Tipo: elenco di stringhe
Vincoli della lunghezza: lunghezza minima 1. La lunghezza massima è 64 caratteri.
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).
**Base**
Si è verificato un errore durante l'elaborazione della richiesta.
Codice di stato HTTP: 400
**Interno**
Si è verificato un errore interno durante l'elaborazione della richiesta. Se il problema persiste, segnalalo dal [Pannello di controllo stato servizi](https://status.aws.amazon.com/).
Codice di stato HTTP: 500
**ResourceNotFound**
La richiesta è stata respinta perché ha provato a fare riferimento a una risorsa inesistente.
Codice di stato HTTP: 409
# ListDomainNames
## Descrizione
Elenca tutti i domini di ricerca di proprietà di un account.
## Elementi di risposta
Viene restituito l'elemento seguente in una struttura denominata `ListDomainNamesResult`.
**DomainNames**
Nomi dei domini di ricerca di proprietà di un account.
Tipo: mappatura stringa a stringa
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).
**Base**
Si è verificato un errore durante l'elaborazione della richiesta.
Codice di stato HTTP: 400
# UpdateAvailabilityOptions
## Descrizione
Configura le opzioni di disponibilità per un dominio. L'attivazione dell'opzione Multi-AZ espande un CloudSearch dominio Amazon in una zona di disponibilità aggiuntiva nella stessa regione per aumentare la tolleranza ai guasti in caso di interruzione del servizio. Le modifiche apportate all'opzione di Multi-AZ possono impiegare circa mezz'ora per diventare attive. Per ulteriori informazioni, consulta la sezione [Configurazione delle opzioni di disponibilità](https://docs.aws.amazon.com/cloudsearch/latest/developerguide/configuring-availability-options.html) nella *Amazon CloudSearch Developer Guide*.
## Parametri della richiesta
Per informazioni sui parametri comuni utilizzati da tutte le operazioni, vedi [Parametri comuni](CommonParameters.md).
**DomainName**
Stringa che rappresenta il nome di un dominio. I nomi di dominio sono univoci tra i domini di proprietà di un account all'interno di una regione AWS. I nomi di dominio devono iniziare con una lettera o un numero e possono includere i seguenti caratteri: a-z (minuscoli), 0-9 e - (trattino).
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima di 3. La lunghezza massima è 28 caratteri.
Campo obbligatorio: sì
**MultiAZ**
Puoi espandere un dominio di ricerca esistente a una seconda zona di disponibilità impostando l'opzione Multi-AZ su true. Analogamente, puoi disattivare l'opzione Multi-AZ per eseguire il downgrade del dominio in una sola zona di disponibilità impostando l'opzione Multi-AZ su `false`.
Tipo: Booleano
Campo obbligatorio: sì
## Elementi di risposta
Viene restituito l'elemento seguente in una struttura denominata `UpdateAvailabilityOptionsResult`.
**AvailabilityOptions**
Le opzioni di disponibilità appena configurate. Indica se l'opzione Multi-AZ è abilitata per il dominio.
Tipo: [AvailabilityOptionsStatus](API_AvailabilityOptionsStatus.md)
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).
**Base**
Si è verificato un errore durante l'elaborazione della richiesta.
Codice di stato HTTP: 400
**DisabledOperation**
La richiesta è stata respinta perché ha tentato un'operazione non abilitata.
Codice di stato HTTP: 409
**Interno**
Si è verificato un errore interno durante l'elaborazione della richiesta. Se il problema persiste, segnalalo dal [Pannello di controllo stato servizi](https://status.aws.amazon.com/).
Codice di stato HTTP: 500
**InvalidType**
La richiesta è stata respinta perché ha specificato una definizione di tipo non valido.
Codice di stato HTTP: 409
**LimitExceeded**
La richiesta è stata respinta perché è già stato raggiunto un limite di risorse.
Codice di stato HTTP: 409
**ResourceNotFound**
La richiesta è stata respinta perché ha provato a fare riferimento a una risorsa inesistente.
Codice di stato HTTP: 409
# UpdateScalingParameters
## Descrizione
Configura i parametri di dimensionamento per un dominio. I parametri di dimensionamento di un dominio specificano il tipo di istanza di ricerca e il conteggio di replica desiderati. Amazon CloudSearch continuerà a scalare automaticamente il tuo dominio in base al volume di dati e traffico, ma non al di sotto del tipo di istanza e del numero di repliche desiderati. Se l'opzione Multi-AZ è abilitata, questi valori controllano le risorse utilizzate per la zona di disponibilità. Per ulteriori informazioni, consulta la sezione [Configurazione delle opzioni di scalabilità](https://docs.aws.amazon.com/cloudsearch/latest/developerguide/configuring-scaling-options.html) nella *Amazon CloudSearch Developer Guide*.
## Parametri della richiesta
Per informazioni sui parametri comuni utilizzati da tutte le operazioni, vedi [Parametri comuni](CommonParameters.md).
**DomainName**
Stringa che rappresenta il nome di un dominio. I nomi di dominio sono univoci tra i domini di proprietà di un account all'interno di una regione AWS. I nomi di dominio devono iniziare con una lettera o un numero e possono includere i seguenti caratteri: a-z (minuscoli), 0-9 e - (trattino).
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima di 3. La lunghezza massima è 28 caratteri.
Campo obbligatorio: sì
**ScalingParameters**
Il tipo di istanza e il numero di repliche desiderati di ciascuna partizione di indice.
Tipo: [ScalingParameters](API_ScalingParameters.md)
Campo obbligatorio: sì
## Elementi di risposta
Viene restituito l'elemento seguente in una struttura denominata `UpdateScalingParametersResult`.
**ScalingParameters**
Lo stato e la configurazione dei parametri di dimensionamento di un dominio di ricerca.
Tipo: [ScalingParametersStatus](API_ScalingParametersStatus.md)
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).
**Base**
Si è verificato un errore durante l'elaborazione della richiesta.
Codice di stato HTTP: 400
**Interno**
Si è verificato un errore interno durante l'elaborazione della richiesta. Se il problema persiste, segnalalo dal [Pannello di controllo stato servizi](https://status.aws.amazon.com/).
Codice di stato HTTP: 500
**InvalidType**
La richiesta è stata respinta perché ha specificato una definizione di tipo non valido.
Codice di stato HTTP: 409
**LimitExceeded**
La richiesta è stata respinta perché è già stato raggiunto un limite di risorse.
Codice di stato HTTP: 409
**ResourceNotFound**
La richiesta è stata respinta perché ha provato a fare riferimento a una risorsa inesistente.
Codice di stato HTTP: 409
# UpdateDomainEndpointOptions
## Description
Aggiorna le opzioni dell'endpoint del dominio, in particolare se tutte le richieste al dominio devono arrivare tramite HTTPS. Per ulteriori informazioni, consulta [Configuring Domain Endpoint Options](https://docs.aws.amazon.com/cloudsearch/latest/developerguide/configuring-domain-endpoint-options.html) nella *Amazon CloudSearch Developer Guide*.
## Parametri della richiesta
**DomainName**
Stringa che rappresenta il nome di un dominio.
Tipo: stringa
Obbligatorio: sì
**DomainEndpointOptions**
Contenitore per le opzioni dell'endpoint.
Tipo: [DomainEndpointOptions](API_DomainEndpointOptions.md)
Obbligatorio: sì
## Elementi di risposta
**DomainEndpointOptionsStatus**
Stato e configurazione delle opzioni endpoint di un dominio.
Tipo: [DomainEndpointOptionsStatus](API_DomainEndpointOptionsStatus.md)
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).
**Base**
Si è verificato un errore durante l'elaborazione della richiesta.
Codice di stato HTTP: 400
**Interno**
Si è verificato un errore interno durante l'elaborazione della richiesta. Se il problema persiste, segnalalo dal [Pannello di controllo stato servizi](https://status.aws.amazon.com/).
Codice di stato HTTP: 500
InvalidType
La richiesta è stata respinta perché ha specificato una definizione di tipo non valido.
Codice di stato HTTP: 409
**LimitExceeded**
La richiesta è stata respinta perché è già stato raggiunto un limite di risorse.
Codice di stato HTTP: 409
**ResourceNotFound**
La richiesta è stata respinta perché ha provato a fare riferimento a una risorsa inesistente.
Codice di stato HTTP: 409
**ValidationException**
La richiesta HTTP contiene input non valido o l'input richiesto non è presente.
Codice di stato HTTP 400
**DisabledOperation**
La richiesta è stata respinta perché ha tentato un'operazione non abilitata.
Codice di stato HTTP: 409
# UpdateServiceAccessPolicies
## Descrizione
Configura le regole di accesso che controllano l'accesso agli endpoint dei documenti e di ricerca del dominio. Per ulteriori informazioni, consulta [Configurazione dell'accesso per un CloudSearch dominio Amazon](https://docs.aws.amazon.com/cloudsearch/latest/developerguide/configuring-access.html).
## Parametri della richiesta
Per informazioni sui parametri comuni utilizzati da tutte le operazioni, vedi [Parametri comuni](CommonParameters.md).
**AccessPolicies**
Le regole di accesso da configurare. Tali regole sostituiscono eventuali regole esistenti.
Tipo: stringa
Campo obbligatorio: sì
**DomainName**
Stringa che rappresenta il nome di un dominio. I nomi di dominio sono univoci tra i domini di proprietà di un account all'interno di una regione AWS. I nomi di dominio devono iniziare con una lettera o un numero e possono includere i seguenti caratteri: a-z (minuscoli), 0-9 e - (trattino).
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima di 3. La lunghezza massima è 28 caratteri.
Campo obbligatorio: sì
## Elementi di risposta
Viene restituito l'elemento seguente in una struttura denominata `UpdateServiceAccessPoliciesResult`.
**AccessPolicies**
Le regole di accesso configurate per il dominio.
Tipo: [AccessPoliciesStatus](API_AccessPoliciesStatus.md)
## Errori
Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).
**Base**
Si è verificato un errore durante l'elaborazione della richiesta.
Codice di stato HTTP: 400
**Interno**
Si è verificato un errore interno durante l'elaborazione della richiesta. Se il problema persiste, segnalalo dal [Pannello di controllo stato servizi](https://status.aws.amazon.com/).
Codice di stato HTTP: 500
**InvalidType**
La richiesta è stata respinta perché ha specificato una definizione di tipo non valido.
Codice di stato HTTP: 409
**LimitExceeded**
La richiesta è stata respinta perché è già stato raggiunto un limite di risorse.
Codice di stato HTTP: 409
**ResourceNotFound**
La richiesta è stata respinta perché ha provato a fare riferimento a una risorsa inesistente.
Codice di stato HTTP: 409
# Tipi di dati
L'API Amazon CloudSearch Configuration Service contiene diversi tipi di dati utilizzati da varie azioni. Questa sezione descrive ogni tipo di dati in dettaglio.
**Nota**
L'ordine di ciascun elemento nella risposta non è garantito. Le applicazioni non devono assumere un determinato ordine.
Sono supportati i tipi di dati seguenti:
+ [AccessPoliciesStatus](API_AccessPoliciesStatus.md)
+ [AnalysisOptions](API_AnalysisOptions.md)
+ [AnalysisScheme](API_AnalysisScheme.md)
+ [AnalysisSchemeStatus](API_AnalysisSchemeStatus.md)
+ [AvailabilityOptionsStatus](API_AvailabilityOptionsStatus.md)
+ [BuildSuggestersResult](API_BuildSuggestersResult.md)
+ [CreateDomainResult](API_CreateDomainResult.md)
+ [DateArrayOptions](API_DateArrayOptions.md)
+ [DateOptions](API_DateOptions.md)
+ [DefineAnalysisSchemeResult](API_DefineAnalysisSchemeResult.md)
+ [DefineExpressionResult](API_DefineExpressionResult.md)
+ [DefineIndexFieldResult](API_DefineIndexFieldResult.md)
+ [DefineSuggesterResult](API_DefineSuggesterResult.md)
+ [DeleteAnalysisSchemeResult](API_DeleteAnalysisSchemeResult.md)
+ [DeleteDomainResult](API_DeleteDomainResult.md)
+ [DeleteExpressionResult](API_DeleteExpressionResult.md)
+ [DeleteIndexFieldResult](API_DeleteIndexFieldResult.md)
+ [DeleteSuggesterResult](API_DeleteSuggesterResult.md)
+ [DescribeAnalysisSchemesResult](API_DescribeAnalysisSchemesResult.md)
+ [DescribeAvailabilityOptionsResult](API_DescribeAvailabilityOptionsResult.md)
+ [DescribeDomainsResult](API_DescribeDomainsResult.md)
+ [DescribeExpressionsResult](API_DescribeExpressionsResult.md)
+ [DescribeIndexFieldsResult](API_DescribeIndexFieldsResult.md)
+ [DescribeScalingParametersResult](API_DescribeScalingParametersResult.md)
+ [DescribeServiceAccessPoliciesResult](API_DescribeServiceAccessPoliciesResult.md)
+ [DescribeSuggestersResult](API_DescribeSuggestersResult.md)
+ [DocumentSuggesterOptions](API_DocumentSuggesterOptions.md)
+ [DomainStatus](API_DomainStatus.md)
+ [DoubleArrayOptions](API_DoubleArrayOptions.md)
+ [DoubleOptions](API_DoubleOptions.md)
+ [Expression](API_Expression.md)
+ [ExpressionStatus](API_ExpressionStatus.md)
+ [IndexDocumentsResult](API_IndexDocumentsResult.md)
+ [IndexField](API_IndexField.md)
+ [IndexFieldStatus](API_IndexFieldStatus.md)
+ [IntArrayOptions](API_IntArrayOptions.md)
+ [IntOptions](API_IntOptions.md)
+ [LatLonOptions](API_LatLonOptions.md)
+ [Limiti](API_Limits.md)
+ [ListDomainNamesResult](API_ListDomainNamesResult.md)
+ [LiteralArrayOptions](API_LiteralArrayOptions.md)
+ [LiteralOptions](API_LiteralOptions.md)
+ [BuildSuggestersResult](API_BuildSuggestersResult.md)
+ [OptionStatus](API_OptionStatus.md)
+ [ScalingParameters](API_ScalingParameters.md)
+ [ScalingParametersStatus](API_ScalingParametersStatus.md)
+ [ServiceEndpoint](API_ServiceEndpoint.md)
+ [Suggeritore](API_Suggester.md)
+ [SuggesterStatus](API_SuggesterStatus.md)
+ [TextArrayOptions](API_TextArrayOptions.md)
+ [TextOptions](API_TextOptions.md)
+ [UpdateAvailabilityOptionsResult](API_UpdateAvailabilityOptionsResult.md)
+ [UpdateScalingParametersResult](API_UpdateScalingParametersResult.md)
+ [UpdateServiceAccessPoliciesResult](API_UpdateServiceAccessPoliciesResult.md)
# AccessPoliciesStatus
## Descrizione
Regole di accesso configurate per gli endpoint di ricerca e dei documenti del dominio e stato corrente delle regole.
## Indice
**Opzioni**
Regole di accesso per gli endpoint del servizio documenti e di ricerca di un dominio. Per ulteriori informazioni, consulta [Configurazione dell'accesso per un dominio di ricerca](https://docs.aws.amazon.com/cloudsearch/latest/developerguide/configuring-access.html) nella *Amazon CloudSearch Developer Guide*. La dimensione massima di un documento di policy è 100 KB.
Tipo: stringa
Campo obbligatorio: sì
**Stato**
Stato dell'opzione di configurazione del dominio.
Tipo: [OptionStatus](API_OptionStatus.md)
Campo obbligatorio: sì
# AnalysisOptions
## Descrizione
Sinonimi, stopword e opzioni di stemming per uno schema di analisi. Include il dizionario di tokenizzazione per il giapponese.
## Indice
**AlgorithmicStemming**
Livello di stemming algoritmico per eseguire: `none`, `minimal`, `light` o `full`. I livelli disponibili variano in base alla lingua. Per ulteriori informazioni, consulta [Impostazioni di elaborazione del testo specifiche della lingua](https://docs.aws.amazon.com/cloudsearch/latest/developerguide/text-processing.html#text-processing-settings) nella *Amazon CloudSearch Developer Guide*
Tipo: stringa
Valori validi: `none | minimal | light | full`
Campo obbligatorio: no
**JapaneseTokenizationDictionary**
Un array JSON che contiene una raccolta di termini, token, letture e part-of-speech per la tokenizzazione del giapponese. Il dizionario di tokenizzazione del giapponese ti permette di sostituire la tokenizzazione predefinita per i termini selezionati. Questa azione è valida solo per i campi in lingua giapponese.
Tipo: string
Campo obbligatorio: no
**StemmingDictionary**
Oggetto JSON che contiene una raccolta di coppie stringa:valore ciascuna delle quali mappa un termine alla propria radice. Ad esempio `{"term1": "stem1", "term2": "stem2", "term3": "stem3"}`. Il dizionario di stemming viene applicato in aggiunta a qualsiasi stemming algoritmico. In questo modo puoi sostituire i risultati dello stemming algoritmico per correggere casi specifici di overstemming o understemming. Le dimensioni massime di un dizionario di stemming è di 500 KB.
Tipo: string
Campo obbligatorio: no
**Stopwords**
Un array JSON di termini da ignorare durante l'indicizzazione e la ricerca. Ad esempio `["a", "an", "the", "of"]`. Nel dizionario delle stopword deve essere elencata esplicitamente ciascuna parola da ignorare. I caratteri jolly e le espressioni regolari non sono supportati.
Tipo: string
Campo obbligatorio: no
**Synonyms**
Oggetto JSON che definisce gli alias e i gruppi di sinonimi. Un gruppo di sinonimi è un insieme di array, in cui ogni array secondario è un gruppo di termini, dove ogni termine nel gruppo è considerato un sinonimo di ogni altro termine del gruppo. Il valore degli alias è un oggetto che contiene una raccolta di coppie stringa:valore in cui la stringa specifica un termine e l'array di valori specifica ogni sinonimo di quel termine. Un alias è considerato un sinonimo del termine specificato, ma il termine non è considerato un sinonimo dell'alias. Per ulteriori informazioni sulla specificazione dei sinonimi, consulta [Synonymes](https://docs.aws.amazon.com/cloudsearch/latest/developerguide/configuring-analysis-schemes.html#synonyms) nell'*Amazon CloudSearch Developer Guide*.
Tipo: string
Campo obbligatorio: no
# AnalysisScheme
## Descrizione
Informazioni di configurazione per uno schema di analisi. Ogni schema di analisi ha un nome univoco e specifica la lingua del testo da elaborare. Per uno schema di analisi è possibile configurare le seguenti opzioni: `Synonyms`, `Stopwords`, `StemmingDictionary`, `JapaneseTokenizationDictionary` e `AlgorithmicStemming`.
## Indice
**AnalysisOptions**
Sinonimi, stopword e opzioni di stemming per uno schema di analisi. Include il dizionario di tokenizzazione per il giapponese.
Tipo: [AnalysisOptions](API_AnalysisOptions.md)
Campo obbligatorio: no
**AnalysisSchemeLanguage**
Codice della lingua [IETF RFC 4646](http://tools.ietf.org/html/rfc4646) o `mul` per più lingue.
Tipo: stringa
Valori validi: `ar | bg | ca | cs | da | de | el | en | es | eu | fa | fi | fr | ga | gl | he | hi | hu | hy | id | it | ja | ko | lv | mul | nl | no | pt | ro | ru | sv | th | tr | zh-Hans | zh-Hant`
Campo obbligatorio: sì
**AnalysisSchemeName**
I nomi devono iniziare con una lettera e possono includere i seguenti caratteri: a-z (minuscoli), 0-9 e \$1 (carattere di sottolineatura).
Tipo: stringa
Vincoli della lunghezza: lunghezza minima 1. La lunghezza massima è 64 caratteri.
Campo obbligatorio: sì
# AnalysisSchemeStatus
## Descrizione
Stato e configurazione di un `AnalysisScheme`.
## Indice
**Opzioni**
Informazioni di configurazione per uno schema di analisi. Ogni schema di analisi ha un nome univoco e specifica la lingua del testo da elaborare. Per uno schema di analisi è possibile configurare le seguenti opzioni: `Synonyms`, `Stopwords`, `StemmingDictionary`, `JapaneseTokenizationDictionary` e `AlgorithmicStemming`.
Tipo: [AnalysisScheme](API_AnalysisScheme.md)
Campo obbligatorio: sì
**Stato**
Stato dell'opzione di configurazione del dominio.
Tipo: [OptionStatus](API_OptionStatus.md)
Campo obbligatorio: sì
# AvailabilityOptionsStatus
## Descrizione
Lo stato e la configurazione delle opzioni di disponibilità del dominio.
## Indice
**Opzioni**
Le opzioni di disponibilità configurate per il dominio.
Tipo: Booleano
Campo obbligatorio: sì
**Stato**
Stato dell'opzione di configurazione del dominio.
Tipo: [OptionStatus](API_OptionStatus.md)
Campo obbligatorio: sì
# BuildSuggestersResult
## Descrizione
Il risultato di una richiesta `BuildSuggester`. Contiene un elenco di campi utilizzati per i suggerimenti.
## Indice
**FieldNames**
Elenco di nomi di campo.
Tipo: elenco di stringhe
Vincoli della lunghezza: lunghezza minima 1. La lunghezza massima è 64 caratteri.
Campo obbligatorio: no
# CreateDomainResult
## Descrizione
Il risultato di una richiesta `CreateDomainRequest`. Contiene lo stato di un dominio appena creato.
## Indice
**DomainStatus**
Lo stato corrente del dominio di ricerca.
Tipo: [DomainStatus](API_DomainStatus.md)
Campo obbligatorio: no
# DateArrayOptions
## Descrizione
Opzioni per un campo che contiene una serie di date. Questo campo è presente se `IndexFieldType` specifica che il campo è del tipo `date-array`. Tutte le opzioni sono abilitate per impostazione predefinita.
## Indice
**DefaultValue**
Un valore da utilizzare per il campo, se il campo non è specificato per un documento.
Tipo: stringa
Vincoli della lunghezza: lunghezza minima 0. La lunghezza massima è 1024 caratteri.
Campo obbligatorio: no
**FacetEnabled**
Indica se per il campo possono essere restituite informazioni sui facet.
Tipo: Booleano
Campo obbligatorio: no
**ReturnEnabled**
Indica se nei risultati di ricerca possono essere restituiti i contenuti del campo.
Tipo: Booleano
Campo obbligatorio: no
**SearchEnabled**
Indica se nei contenuti del campo si possono eseguire le ricerche.
Tipo: Booleano
Campo obbligatorio: no
**SourceFields**
Elenco di campi di origine da mappare al campo.
Tipo: string
Campo obbligatorio: no
# DateOptions
## Descrizione
Opzioni per un campo di data. Le date e gli orari sono specificati in UTC (Coordinated Universal Time) secondo IETF RFC3339: yyyy-mm-ddT 00:00:00 Z. Questo campo è presente se `IndexFieldType` specifica che il campo è del tipo `date`. Tutte le opzioni sono abilitate per impostazione predefinita.
## Indice
**DefaultValue**
Un valore da utilizzare per il campo, se il campo non è specificato per un documento.
Tipo: stringa
Vincoli della lunghezza: lunghezza minima 0. La lunghezza massima è 1024 caratteri.
Campo obbligatorio: no
**FacetEnabled**
Indica se per il campo possono essere restituite informazioni sui facet.
Tipo: Booleano
Campo obbligatorio: no
**ReturnEnabled**
Indica se nei risultati di ricerca possono essere restituiti i contenuti del campo.
Tipo: Booleano
Campo obbligatorio: no
**SearchEnabled**
Indica se nei contenuti del campo si possono eseguire le ricerche.
Tipo: Booleano
Campo obbligatorio: no
**SortEnabled**
Specifica se il campo può essere utilizzato per ordinare i risultati di ricerca.
Tipo: Booleano
Campo obbligatorio: no
**SourceField**
Una stringa che rappresenta il nome di un campo indice. CloudSearch supporta campi indice regolari e campi dinamici. Un nome di campo dinamico definisce un modello che inizia o termina con un carattere jolly. I campi di documento che non corrispondono a un campo di indice normale ma a un modello di campo dinamico vengono configurati con le opzioni di indicizzazione del campo dinamico.
I nomi di campo normali iniziano con una lettera e possono includere i seguenti caratteri: a-z (minuscoli), 0-9 e \$1 (carattere di sottolineatura). I nomi dei campi dinamici devono iniziare o terminare con un carattere jolly (\$1). Il carattere jolly può anche essere l'unico carattere in un nome di campo dinamico. Non sono supportati caratteri jolly multipli e caratteri jolly incorporati all'interno di una stringa.
Il nome `score` è riservato e non può essere utilizzato come nome di campo. Per fare riferimento all'ID di un documento si può utilizzare il nome `_id`.
Tipo: stringa
Vincoli della lunghezza: lunghezza minima 1. La lunghezza massima è 64 caratteri.
Campo obbligatorio: no
# DefineAnalysisSchemeResult
## Descrizione
Il risultato di una richiesta ` DefineAnalysisScheme `. Contiene lo stato dello schema di analisi appena configurato.
## Indice
**AnalysisScheme**
Stato e configurazione di un `AnalysisScheme`.
Tipo: [AnalysisSchemeStatus](API_AnalysisSchemeStatus.md)
Campo obbligatorio: sì
# DefineExpressionResult
## Descrizione
Il risultato di una richiesta `DefineExpression`. Contiene lo stato dell'espressione appena configurata.
## Indice
**Expression**
Il valore di un'`Expression` e il rispettivo stato corrente.
Tipo: [ExpressionStatus](API_ExpressionStatus.md)
Campo obbligatorio: sì
# DefineIndexFieldResult
## Descrizione
Il risultato di una richiesta ` DefineIndexField `. Contiene lo stato del campo dell'indice appena configurato.
## Indice
**IndexField**
Il valore di un'`IndexField` e il rispettivo stato corrente.
Tipo: [IndexFieldStatus](API_IndexFieldStatus.md)
Campo obbligatorio: sì
# DefineSuggesterResult
## Descrizione
Il risultato di una richiesta `DefineSuggester`. Contiene lo stato del suggeritore appena configurato.
## Indice
**Suggeritore**
Il valore di un `Suggester` e il rispettivo stato corrente.
Tipo: [SuggesterStatus](API_SuggesterStatus.md)
Campo obbligatorio: sì
# DeleteAnalysisSchemeResult
## Descrizione
Il risultato di una richiesta `DeleteAnalysisScheme`. Contiene lo stato dello schema di analisi eliminato.
## Indice
**AnalysisScheme**
Stato dello schema di analisi in fase di eliminazione.
Tipo: [AnalysisSchemeStatus](API_AnalysisSchemeStatus.md)
Campo obbligatorio: sì
# DeleteDomainResult
## Descrizione
Il risultato di una richiesta `DeleteDomain`. Contiene lo stato di un dominio appena eliminato o nessuno stato, se il dominio è già stato completamente eliminato.
## Indice
**DomainStatus**
Lo stato corrente del dominio di ricerca.
Tipo: [DomainStatus](API_DomainStatus.md)
Campo obbligatorio: no
# DeleteExpressionResult
## Descrizione
Il risultato di una richiesta ` DeleteExpression `. Specifica l'espressione in fase di eliminazione.
## Indice
**Expression**
Stato dell'espressione in fase di eliminazione.
Tipo: [ExpressionStatus](API_ExpressionStatus.md)
Campo obbligatorio: sì
# DeleteIndexFieldResult
## Descrizione
Il risultato di una richiesta ` DeleteIndexField `.
## Indice
**IndexField**
Stato del campo dell'indice da eliminare.
Tipo: [IndexFieldStatus](API_IndexFieldStatus.md)
Campo obbligatorio: sì
# DeleteSuggesterResult
## Descrizione
Il risultato di una richiesta `DeleteSuggester`. Contiene lo stato del suggeritore eliminato.
## Indice
**Suggeritore**
Stato del suggeritore in fase di eliminazione.
Tipo: [SuggesterStatus](API_SuggesterStatus.md)
Campo obbligatorio: sì
# DescribeAnalysisSchemesResult
## Descrizione
Il risultato di una richiesta `DescribeAnalysisSchemes`. Contiene gli schemi di analisi configurati per il dominio specificato nella richiesta.
## Indice
**AnalysisSchemes**
Le descrizioni degli schemi di analisi.
Type:[AnalysisSchemeStatus](API_AnalysisSchemeStatus.md) elenco
Campo obbligatorio: sì
# DescribeAvailabilityOptionsResult
## Descrizione
Il risultato di una richiesta `DescribeAvailabilityOptions`. Indica se l'opzione Multi-AZ è abilitata per il dominio specificato nella richiesta.
## Indice
**AvailabilityOptions**
Le opzioni di disponibilità configurate per il dominio. Indica se l'opzione Multi-AZ è abilitata per il dominio.
Tipo: [AvailabilityOptionsStatus](API_AvailabilityOptionsStatus.md)
Campo obbligatorio: no
# DescribeDomainsResult
## Descrizione
Il risultato di una richiesta `DescribeDomains`. Contiene lo stato dei domini specificati nella richiesta o tutti i domini di proprietà dell'account.
## Indice
**DomainStatusList**
Elenco che contiene lo stato di ogni dominio richiesto.
Type:[DomainStatus](API_DomainStatus.md) elenco
Campo obbligatorio: sì
# DescribeExpressionsResult
## Descrizione
Il risultato di una richiesta `DescribeExpressions`. Contiene le espressioni configurate per il dominio specificato nella richiesta.
## Indice
**Espressioni**
Le espressioni configurate per il dominio.
Type:[ExpressionStatus](API_ExpressionStatus.md) elenco
Campo obbligatorio: sì
# DescribeIndexFieldsResult
## Descrizione
Il risultato di una richiesta `DescribeIndexFields`. Contiene i campi di indice configurati per il dominio specificato nella richiesta.
## Indice
**IndexFields**
I campi dell'indice configurati per il dominio.
Type:[IndexFieldStatus](API_IndexFieldStatus.md) elenco
Campo obbligatorio: sì
# DescribeScalingParametersResult
## Descrizione
Il risultato di una richiesta `DescribeScalingParameters`. Contiene i parametri di dimensionamento configurati per il dominio specificato nella richiesta.
## Indice
**ScalingParameters**
Lo stato e la configurazione dei parametri di dimensionamento di un dominio di ricerca.
Tipo: [ScalingParametersStatus](API_ScalingParametersStatus.md)
Campo obbligatorio: sì
# DescribeServiceAccessPoliciesResult
## Descrizione
Il risultato di una richiesta `DescribeServiceAccessPolicies`.
## Indice
**AccessPolicies**
Le regole di accesso configurate per il dominio specificato nella richiesta.
Tipo: [AccessPoliciesStatus](API_AccessPoliciesStatus.md)
Campo obbligatorio: sì
# DescribeSuggestersResult
## Descrizione
Il risultato di una richiesta `DescribeSuggesters`.
## Indice
**Suggesters**
I suggeritori configurati per il dominio specificato nella richiesta.
Type:[SuggesterStatus](API_SuggesterStatus.md) elenco
Campo obbligatorio: sì
# DocumentSuggesterOptions
## Descrizione
Opzioni per un suggeritore delle ricerche.
## Indice
**FuzzyMatching**
Livello fuzzy consentito per il suggerimento delle corrispondenze di una stringa: `none`, `low` o `high`. "none" indica che la stringa specificata viene considerata come un prefisso esatto. "low" indica che i suggerimenti devono essere diversi dalla stringa specificata di non oltre un carattere. "high" indica che i suggerimenti possono essere diversi di un massimo di due caratteri. Il valore predefinito è none.
Tipo: stringa
Valori validi: `none | low | high`
Campo obbligatorio: no
**SortExpression**
Espressione che calcola un punteggio per ogni suggerimento per controllare il modo in cui vengono ordinati. I punteggi vengono arrotondati all'intero più vicino, con un limite minimo di 0 e uno massimo di 2^31-1. Il punteggio di rilevanza di un documento non viene calcolato per i suggerimenti, pertanto le espressioni di ordinamento non possono fare riferimento al valore `_score`. Per ordinare i suggerimenti utilizzando un campo numerico o un'espressione esistente, è sufficiente che specifichi il nome del campo o dell'espressione. Se per il suggeritore non è configurata alcuna espressione, i suggerimenti vengono ordinati con le corrispondenze più vicine elencate per prime.
Tipo: string
Campo obbligatorio: no
**SourceField**
Nome del campo dell'indice da utilizzare per i suggerimenti.
Tipo: stringa
Vincoli della lunghezza: lunghezza minima 1. La lunghezza massima è 64 caratteri.
Campo obbligatorio: sì
# DomainEndpointOptions
## Descrizione
Indica se richiedere che tutte le richieste al dominio arrivino tramite HTTPS. Consigliamo `Policy-Min-TLS-1-2-2019-07` per `TLSSecurityPolicy`. Per la compatibilità con i client più recenti, l'impostazione predefinita è `Policy-Min-TLS-1-0-2019-07`.
## Indice
**EnforceHTTPS**
Abilita o disabilita il requisito che tutte le richieste al dominio arrivano tramite HTTPS.
Tipo: Booleano
Valori validi: `true | false`
Campo obbligatorio: no
**TLSSecurityPolicy**
La versione TLS minima richiesta.
Tipo: stringa
Valori validi: `Policy-Min-TLS-1-2-2019-07 | Policy-Min-TLS-1-0-2019-07`
Campo obbligatorio: no
# DomainEndpointOptionsStatus
## Descrizione
Configurazione e stato delle opzioni endpoint del dominio.
## Indice
**Opzioni**
La configurazione corrente
Tipo: [DomainEndpointOptions](API_DomainEndpointOptions.md)
**Stato**
Lo stato dell'opzione di configurazione.
Tipo: [OptionStatus](API_OptionStatus.md)
# DomainStatus
## Descrizione
Lo stato corrente del dominio di ricerca.
## Indice
**ARN**
Amazon Resource Name (ARN) del dominio di ricerca. Per ulteriori informazioni, consultare [Identifiers for IAM Entities](https://docs.aws.amazon.com/IAM/latest/UserGuide/index.html?Using_Identifiers.html) in *Using AWS Identity and Access Management*.
Tipo: string
Campo obbligatorio: no
**Creato**
True se il dominio di ricerca viene creato. Potrebbe essere necessario qualche minuto per inizializzare un dominio se viene chiamato [CreateDomain](API_CreateDomain.md). I domini di ricerca appena creati vengono restituiti da [DescribeDomains](API_DescribeDomains.md) con un valore false per Created finché la creazione del dominio non è completata.
Tipo: Booleano
Campo obbligatorio: no
**Deleted (Eliminato)**
True se il dominio di ricerca è stato eliminato. Il sistema deve eliminare le risorse dedicate al dominio di ricerca se viene chiamato [DeleteDomain](API_DeleteDomain.md). I domini di ricerca appena eliminati vengono restituiti [DescribeDomains](API_DescribeDomains.md) con un valore vero IsDeleted per diversi minuti fino al completamento della pulizia delle risorse.
Tipo: Booleano
Campo obbligatorio: no
**DocService**
Endpoint del servizio per l'aggiornamento dei documenti in un dominio di ricerca.
Tipo: [ServiceEndpoint](API_ServiceEndpoint.md)
Campo obbligatorio: no
**DomainId**
Identificatore univoco generato internamente per un dominio.
Tipo: stringa
Vincoli della lunghezza: lunghezza minima 1. La lunghezza massima è 64 caratteri.
Campo obbligatorio: sì
**DomainName**
Stringa che rappresenta il nome di un dominio. I nomi di dominio sono univoci tra i domini di proprietà di un account all'interno di una regione AWS. I nomi di dominio devono iniziare con una lettera o un numero e possono includere i seguenti caratteri: a-z (minuscoli), 0-9 e - (trattino).
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima di 3. La lunghezza massima è 28 caratteri.
Campo obbligatorio: sì
**Limiti**
Tipo: [Limiti](API_Limits.md)
Campo obbligatorio: no
**Processing**
True se l'elaborazione viene eseguita per attivare l'attuale configurazione del dominio.
Tipo: Booleano
Campo obbligatorio: no
**RequiresIndexDocuments**
True se [IndexDocuments](API_IndexDocuments.md) deve essere chiamato per attivare l'attuale configurazione del dominio.
Tipo: Booleano
Campo obbligatorio: sì
**SearchInstanceCount**
Numero di istanze di ricerca disponibili per elaborare le richieste di ricerca.
Tipo: integer
Campo obbligatorio: no
**SearchInstanceType**
Tipo di istanza utilizzato per elaborare le richieste di ricerca.
Tipo: string
Campo obbligatorio: no
**SearchPartitionCount**
Numero di partizioni in cui è distribuito l'indice di ricerca.
Tipo: integer
Campo obbligatorio: no
**SearchService**
Endpoint del servizio per la richiesta dei risultati di ricerca da un dominio di ricerca.
Tipo: [ServiceEndpoint](API_ServiceEndpoint.md)
Campo obbligatorio: no
# DoubleArrayOptions
## Descrizione
Opzioni per un campo che contiene un array di valori in virgola mobile a 64 bit a precisione doppia. Questo campo è presente se `IndexFieldType` specifica che il campo è del tipo `double-array`. Tutte le opzioni sono abilitate per impostazione predefinita.
## Indice
**DefaultValue**
Un valore da utilizzare per il campo, se il campo non è specificato per un documento.
Tipo: double
Campo obbligatorio: no
**FacetEnabled**
Indica se per il campo possono essere restituite informazioni sui facet.
Tipo: Booleano
Campo obbligatorio: no
**ReturnEnabled**
Indica se nei risultati di ricerca possono essere restituiti i contenuti del campo.
Tipo: Booleano
Campo obbligatorio: no
**SearchEnabled**
Indica se nei contenuti del campo si possono eseguire le ricerche.
Tipo: Booleano
Campo obbligatorio: no
**SourceFields**
Elenco di campi di origine da mappare al campo.
Tipo: string
Campo obbligatorio: no
# DoubleOptions
## Descrizione
Opzioni per un campo in virgola mobile da 64 bit a precisione doppia. Questo campo è presente se `IndexFieldType` specifica che il campo è del tipo `double`. Tutte le opzioni sono abilitate per impostazione predefinita.
## Indice
**DefaultValue**
Un valore da utilizzare per il campo, se il campo non è specificato per un documento. Specificare un valore può essere importante se in un'espressione si utilizza un campo che non è presente in ogni documento.
Tipo: double
Campo obbligatorio: no
**FacetEnabled**
Indica se per il campo possono essere restituite informazioni sui facet.
Tipo: Booleano
Campo obbligatorio: no
**ReturnEnabled**
Indica se nei risultati di ricerca possono essere restituiti i contenuti del campo.
Tipo: Booleano
Campo obbligatorio: no
**SearchEnabled**
Indica se nei contenuti del campo si possono eseguire le ricerche.
Tipo: Booleano
Campo obbligatorio: no
**SortEnabled**
Specifica se il campo può essere utilizzato per ordinare i risultati di ricerca.
Tipo: Booleano
Campo obbligatorio: no
**SourceField**
Nome del campo di origine da mappare al campo.
Tipo: stringa
Vincoli della lunghezza: lunghezza minima 1. La lunghezza massima è 64 caratteri.
Campo obbligatorio: no
# Expression
## Descrizione
Espressione con nome che può essere valutata al momento della ricerca. Può essere utilizzata per ordinare i risultati di ricerca, definire altre espressioni o restituire informazioni calcolate nei risultati di ricerca.
## Indice
**ExpressionName**
I nomi devono iniziare con una lettera e possono includere i seguenti caratteri: a-z (minuscoli), 0-9 e \$1 (carattere di sottolineatura).
Tipo: stringa
Vincoli della lunghezza: lunghezza minima 1. La lunghezza massima è 64 caratteri.
Campo obbligatorio: sì
**ExpressionValue**
L'espressione da valutare per l'ordinamento durante l'elaborazione di una richiesta di ricerca. La `Expression` sintassi si basa sulle JavaScript espressioni. Per ulteriori informazioni, consulta [Configuring Expressions](https://docs.aws.amazon.com/cloudsearch/latest/developerguide/configuring-expressions.html) nell'*Amazon CloudSearch Developer Guide*.
Tipo: stringa
Vincoli della lunghezza: lunghezza minima 1. La lunghezza massima è 10240 caratteri.
Campo obbligatorio: sì
# ExpressionStatus
## Descrizione
Il valore di un'`Expression` e il rispettivo stato corrente.
## Indice
**Opzioni**
L'espressione valutata per l'ordinamento durante l'elaborazione di una richiesta di ricerca.
Tipo: [Expression](API_Expression.md)
Campo obbligatorio: sì
**Stato**
Stato dell'opzione di configurazione del dominio.
Tipo: [OptionStatus](API_OptionStatus.md)
Campo obbligatorio: sì
# IndexDocumentsResult
## Descrizione
Il risultato di una richiesta `IndexDocuments`. Contiene lo stato dell'operazione di indicizzazione, inclusi i campi sottoposti a indicizzazione.
## Indice
**FieldNames**
I nomi dei campi attualmente sottoposti a indicizzazione.
Tipo: elenco di stringhe
Vincoli della lunghezza: lunghezza minima 1. La lunghezza massima è 64 caratteri.
Campo obbligatorio: no
# IndexField
## Descrizione
Le informazioni di configurazione per un campo dell'indice, tra cui il nome, il tipo e le opzioni. Le opzioni supportate dipendono da ` IndexFieldType `.
## Indice
**DateArrayOptions**
Opzioni per un campo che contiene una serie di date. Questo campo è presente se `IndexFieldType` specifica che il campo è del tipo `date-array`. Tutte le opzioni sono abilitate per impostazione predefinita.
Tipo: [DateArrayOptions](API_DateArrayOptions.md)
Campo obbligatorio: no
**DateOptions**
Opzioni per un campo di data. Le date e gli orari sono specificati in UTC (Coordinated Universal Time) secondo IETF RFC3339: yyyy-mm-ddT 00:00:00 Z. Questo campo è presente se `IndexFieldType` specifica che il campo è del tipo `date`. Tutte le opzioni sono abilitate per impostazione predefinita.
Tipo: [DateOptions](API_DateOptions.md)
Campo obbligatorio: no
**DoubleArrayOptions**
Opzioni per un campo che contiene un array di valori in virgola mobile a 64 bit a precisione doppia. Questo campo è presente se `IndexFieldType` specifica che il campo è del tipo `double-array`. Tutte le opzioni sono abilitate per impostazione predefinita.
Tipo: [DoubleArrayOptions](API_DoubleArrayOptions.md)
Campo obbligatorio: no
**DoubleOptions**
Opzioni per un campo in virgola mobile da 64 bit a precisione doppia. Questo campo è presente se `IndexFieldType` specifica che il campo è del tipo `double`. Tutte le opzioni sono abilitate per impostazione predefinita.
Tipo: [DoubleOptions](API_DoubleOptions.md)
Campo obbligatorio: no
**IndexFieldName**
Una stringa che rappresenta il nome di un campo indice. CloudSearch supporta campi indice regolari e campi dinamici. Un nome di campo dinamico definisce un modello che inizia o termina con un carattere jolly. I campi di documento che non corrispondono a un campo di indice normale ma a un modello di campo dinamico vengono configurati con le opzioni di indicizzazione del campo dinamico.
I nomi di campo normali iniziano con una lettera e possono includere i seguenti caratteri: a-z (minuscoli), 0-9 e \$1 (carattere di sottolineatura). I nomi dei campi dinamici devono iniziare o terminare con un carattere jolly (\$1). Il carattere jolly può anche essere l'unico carattere in un nome di campo dinamico. Non sono supportati caratteri jolly multipli e caratteri jolly incorporati all'interno di una stringa.
Il nome `score` è riservato e non può essere utilizzato come nome di campo. Per fare riferimento all'ID di un documento si può utilizzare il nome `_id`.
Tipo: stringa
Vincoli della lunghezza: lunghezza minima 1. La lunghezza massima è 64 caratteri.
Campo obbligatorio: sì
**IndexFieldType**
Tipo di campo. Le opzioni valide per un campo dipendono dal tipo di campo. Per ulteriori informazioni sui tipi di campo supportati, consulta [Configuring Index Fields](https://docs.aws.amazon.com/cloudsearch/latest/developerguide/configuring-index-fields.html) nella *Amazon CloudSearch Developer Guide*.
Tipo: stringa
Valori validi: `int | double | literal | text | date | latlon | int-array | double-array | literal-array | text-array | date-array`
Campo obbligatorio: sì
**IntArrayOptions**
Opzioni per un campo che contiene una serie di valori interi con firma a 64 bit. Questo campo è presente se `IndexFieldType` specifica che il campo è del tipo `int-array`. Tutte le opzioni sono abilitate per impostazione predefinita.
Tipo: [IntArrayOptions](API_IntArrayOptions.md)
Campo obbligatorio: no
**IntOptions**
Opzioni per un campo valore intero con firma a 64 bit. Questo campo è presente se `IndexFieldType` specifica che il campo è del tipo `int`. Tutte le opzioni sono abilitate per impostazione predefinita.
Tipo: [IntOptions](API_IntOptions.md)
Campo obbligatorio: no
**LatLonOptions**
Opzioni per un campo latlon. Un campo latlon contiene una posizione memorizzata come coppia di valori di latitudine e longitudine. Questo campo è presente se `IndexFieldType` specifica che il campo è del tipo `latlon`. Tutte le opzioni sono abilitate per impostazione predefinita.
Tipo: [LatLonOptions](API_LatLonOptions.md)
Campo obbligatorio: no
**LiteralArrayOptions**
Opzioni per un campo che contiene una serie di stringhe letterali. Questo campo è presente se `IndexFieldType` specifica che il campo è del tipo `literal-array`. Tutte le opzioni sono abilitate per impostazione predefinita.
Tipo: [LiteralArrayOptions](API_LiteralArrayOptions.md)
Campo obbligatorio: no
**LiteralOptions**
Opzioni per un campo letterale. Questo campo è presente se `IndexFieldType` specifica che il campo è del tipo `literal`. Tutte le opzioni sono abilitate per impostazione predefinita.
Tipo: [LiteralOptions](API_LiteralOptions.md)
Campo obbligatorio: no
**TextArrayOptions**
Opzioni per un campo che contiene una serie di stringhe di testo. Questo campo è presente se `IndexFieldType` specifica che il campo è del tipo `text-array`. In un campo `text-array` è sempre possibile eseguire ricerche. Tutte le opzioni sono abilitate per impostazione predefinita.
Tipo: [TextArrayOptions](API_TextArrayOptions.md)
Campo obbligatorio: no
**TextOptions**
Opzioni per un campo di testo. Questo campo è presente se `IndexFieldType` specifica che il campo è del tipo `text`. In un campo `text` è sempre possibile eseguire ricerche. Tutte le opzioni sono abilitate per impostazione predefinita.
Tipo: [TextOptions](API_TextOptions.md)
Campo obbligatorio: no
# IndexFieldStatus
## Descrizione
Il valore di un'`IndexField` e il rispettivo stato corrente.
## Indice
**Opzioni**
Le informazioni di configurazione per un campo dell'indice, tra cui il nome, il tipo e le opzioni. Le opzioni supportate dipendono da ` IndexFieldType `.
Tipo: [IndexField](API_IndexField.md)
Campo obbligatorio: sì
**Stato**
Stato dell'opzione di configurazione del dominio.
Tipo: [OptionStatus](API_OptionStatus.md)
Campo obbligatorio: sì
# IntArrayOptions
## Descrizione
Opzioni per un campo che contiene una serie di valori interi con firma a 64 bit. Questo campo è presente se `IndexFieldType` specifica che il campo è del tipo `int-array`. Tutte le opzioni sono abilitate per impostazione predefinita.
## Indice
**DefaultValue**
Un valore da utilizzare per il campo, se il campo non è specificato per un documento.
Tipo: long
Campo obbligatorio: no
**FacetEnabled**
Indica se per il campo possono essere restituite informazioni sui facet.
Tipo: Booleano
Campo obbligatorio: no
**ReturnEnabled**
Indica se nei risultati di ricerca possono essere restituiti i contenuti del campo.
Tipo: Booleano
Campo obbligatorio: no
**SearchEnabled**
Indica se nei contenuti del campo si possono eseguire le ricerche.
Tipo: Booleano
Campo obbligatorio: no
**SourceFields**
Elenco di campi di origine da mappare al campo.
Tipo: string
Campo obbligatorio: no
# IntOptions
## Descrizione
Opzioni per un campo valore intero con firma a 64 bit. Questo campo è presente se `IndexFieldType` specifica che il campo è del tipo `int`. Tutte le opzioni sono abilitate per impostazione predefinita.
## Indice
**DefaultValue**
Un valore da utilizzare per il campo, se il campo non è specificato per un documento. Specificare un valore può essere importante se in un'espressione si utilizza un campo che non è presente in ogni documento.
Tipo: long
Campo obbligatorio: no
**FacetEnabled**
Indica se per il campo possono essere restituite informazioni sui facet.
Tipo: Booleano
Campo obbligatorio: no
**ReturnEnabled**
Indica se nei risultati di ricerca possono essere restituiti i contenuti del campo.
Tipo: Booleano
Campo obbligatorio: no
**SearchEnabled**
Indica se nei contenuti del campo si possono eseguire le ricerche.
Tipo: Booleano
Campo obbligatorio: no
**SortEnabled**
Specifica se il campo può essere utilizzato per ordinare i risultati di ricerca.
Tipo: Booleano
Campo obbligatorio: no
**SourceField**
Nome del campo di origine da mappare al campo.
Tipo: stringa
Vincoli della lunghezza: lunghezza minima 1. La lunghezza massima è 64 caratteri.
Campo obbligatorio: no
# LatLonOptions
## Descrizione
Opzioni per un campo latlon. Un campo latlon contiene una posizione memorizzata come coppia di valori di latitudine e longitudine. Questo campo è presente se `IndexFieldType` specifica che il campo è del tipo `latlon`. Tutte le opzioni sono abilitate per impostazione predefinita.
## Indice
**DefaultValue**
Un valore da utilizzare per il campo, se il campo non è specificato per un documento.
Tipo: stringa
Vincoli della lunghezza: lunghezza minima 0. La lunghezza massima è 1024 caratteri.
Campo obbligatorio: no
**FacetEnabled**
Indica se per il campo possono essere restituite informazioni sui facet.
Tipo: Booleano
Campo obbligatorio: no
**ReturnEnabled**
Indica se nei risultati di ricerca possono essere restituiti i contenuti del campo.
Tipo: Booleano
Campo obbligatorio: no
**SearchEnabled**
Indica se nei contenuti del campo si possono eseguire le ricerche.
Tipo: Booleano
Campo obbligatorio: no
**SortEnabled**
Specifica se il campo può essere utilizzato per ordinare i risultati di ricerca.
Tipo: Booleano
Campo obbligatorio: no
**SourceField**
Una stringa che rappresenta il nome di un campo indice. CloudSearch supporta campi indice regolari e campi dinamici. Un nome di campo dinamico definisce un modello che inizia o termina con un carattere jolly. I campi di documento che non corrispondono a un campo di indice normale ma a un modello di campo dinamico vengono configurati con le opzioni di indicizzazione del campo dinamico.
I nomi di campo normali iniziano con una lettera e possono includere i seguenti caratteri: a-z (minuscoli), 0-9 e \$1 (carattere di sottolineatura). I nomi dei campi dinamici devono iniziare o terminare con un carattere jolly (\$1). Il carattere jolly può anche essere l'unico carattere in un nome di campo dinamico. Non sono supportati caratteri jolly multipli e caratteri jolly incorporati all'interno di una stringa.
Il nome `score` è riservato e non può essere utilizzato come nome di campo. Per fare riferimento all'ID di un documento si può utilizzare il nome `_id`.
Tipo: stringa
Vincoli della lunghezza: lunghezza minima 1. La lunghezza massima è 64 caratteri.
Campo obbligatorio: no
# Limiti
## Descrizione
Nessuna documentazione sulle operazioni disponibile.
## Indice
**MaximumPartitionCount**
Tipo: integer
Campo obbligatorio: sì
**MaximumReplicationCount**
Tipo: integer
Campo obbligatorio: sì
# ListDomainNamesResult
## Descrizione
Il risultato di una richiesta `ListDomainNames`. Contiene un elenco dei domini di proprietà di un account.
## Indice
**DomainNames**
Nomi dei domini di ricerca di proprietà di un account.
Tipo: mappatura stringa a stringa
Campo obbligatorio: no
# LiteralArrayOptions
## Descrizione
Opzioni per un campo che contiene una serie di stringhe letterali. Questo campo è presente se `IndexFieldType` specifica che il campo è del tipo `literal-array`. Tutte le opzioni sono abilitate per impostazione predefinita.
## Indice
**DefaultValue**
Un valore da utilizzare per il campo, se il campo non è specificato per un documento.
Tipo: stringa
Vincoli della lunghezza: lunghezza minima 0. La lunghezza massima è 1024 caratteri.
Campo obbligatorio: no
**FacetEnabled**
Indica se per il campo possono essere restituite informazioni sui facet.
Tipo: Booleano
Campo obbligatorio: no
**ReturnEnabled**
Indica se nei risultati di ricerca possono essere restituiti i contenuti del campo.
Tipo: Booleano
Campo obbligatorio: no
**SearchEnabled**
Indica se nei contenuti del campo si possono eseguire le ricerche.
Tipo: Booleano
Campo obbligatorio: no
**SourceFields**
Elenco di campi di origine da mappare al campo.
Tipo: string
Campo obbligatorio: no
# LiteralOptions
## Descrizione
Opzioni per un campo letterale. Questo campo è presente se `IndexFieldType` specifica che il campo è del tipo `literal`. Tutte le opzioni sono abilitate per impostazione predefinita.
## Indice
**DefaultValue**
Un valore da utilizzare per il campo, se il campo non è specificato per un documento.
Tipo: stringa
Vincoli della lunghezza: lunghezza minima 0. La lunghezza massima è 1024 caratteri.
Campo obbligatorio: no
**FacetEnabled**
Indica se per il campo possono essere restituite informazioni sui facet.
Tipo: Booleano
Campo obbligatorio: no
**ReturnEnabled**
Indica se nei risultati di ricerca possono essere restituiti i contenuti del campo.
Tipo: Booleano
Campo obbligatorio: no
**SearchEnabled**
Indica se nei contenuti del campo si possono eseguire le ricerche.
Tipo: Booleano
Campo obbligatorio: no
**SortEnabled**
Specifica se il campo può essere utilizzato per ordinare i risultati di ricerca.
Tipo: Booleano
Campo obbligatorio: no
**SourceField**
Una stringa che rappresenta il nome di un campo indice. CloudSearch supporta campi indice regolari e campi dinamici. Un nome di campo dinamico definisce un modello che inizia o termina con un carattere jolly. I campi di documento che non corrispondono a un campo di indice normale ma a un modello di campo dinamico vengono configurati con le opzioni di indicizzazione del campo dinamico.
I nomi di campo normali iniziano con una lettera e possono includere i seguenti caratteri: a-z (minuscoli), 0-9 e \$1 (carattere di sottolineatura). I nomi dei campi dinamici devono iniziare o terminare con un carattere jolly (\$1). Il carattere jolly può anche essere l'unico carattere in un nome di campo dinamico. Non sono supportati caratteri jolly multipli e caratteri jolly incorporati all'interno di una stringa.
Il nome `score` è riservato e non può essere utilizzato come nome di campo. Per fare riferimento all'ID di un documento si può utilizzare il nome `_id`.
Tipo: stringa
Vincoli della lunghezza: lunghezza minima 1. La lunghezza massima è 64 caratteri.
Campo obbligatorio: no
# OptionStatus
## Descrizione
Stato dell'opzione di configurazione del dominio.
## Indice
**CreationDate**
Timestamp relativo al momento della creazione dell'opzione.
Tipo: DateTime
Campo obbligatorio: sì
**PendingDeletion**
Indica che l'opzione verrà eliminata una volta completata l'elaborazione.
Tipo: Booleano
Campo obbligatorio: no
**Stato**
Stato di elaborazione di una modifica a un'opzione. Valori possibili:
+ `RequiresIndexDocuments`: il valore più recente dell'opzione non verrà distribuito finché non è stato chiamato [IndexDocuments](API_IndexDocuments.md) e l'indicizzazione non è completa.
+ `Processing`: il valore più recente dell'opzione è in fase di attivazione.
+ `Active`: il valore più recente dell'opzione viene distribuito completamente.
+ `FailedToValidate`: il valore dell'opzione non è compatibile con il dominio dei dati e non può essere utilizzato per indicizzare i dati. È necessario modificare il valore dell'opzione o aggiornare o rimuovere i documenti incompatibili.
Tipo: stringa
Valori validi: `RequiresIndexDocuments | Processing | Active | FailedToValidate`
Campo obbligatorio: sì
**UpdateDate**
Timestamp relativo al momento dell'ultimo aggiornamento dell'opzione.
Tipo: DateTime
Campo obbligatorio: sì
**UpdateVersion**
Numero intero univoco che indica l'ultima volta che l'opzione è stata aggiornata.
Tipo: integer
Campo obbligatorio: no
# ScalingParameters
## Descrizione
Il tipo di istanza e il numero di repliche desiderati di ciascuna partizione di indice.
## Indice
**DesiredInstanceType**
Tipo di istanza da preconfigurare per il tuo dominio. Ad esempio `search.medium`.
Tipo: stringa
Valori validi: `search.small | search.medium | search.large | search.xlarge | search.2xlarge`
Per i domini precedenti, i valori validi possono includere anche `search.m1.small``search.m1.large`,`search.m2.xlarge`,`search.m2.2xlarge`,`search.m3.medium`, `search.m3.large``search.m3.xlarge`, e`search.m3.2xlarge`.
Campo obbligatorio: no
**DesiredPartitionCount**
Numero di partizioni da preconfigurare per il tuo dominio. Valido solo se selezioni `search.2xlarge` come tipo di istanza.
Tipo: integer
Campo obbligatorio: no
**DesiredReplicationCount**
Numero di repliche da preconfigurare per ogni partizione dell'indice.
Tipo: integer
Campo obbligatorio: no
# ScalingParametersStatus
## Descrizione
Lo stato e la configurazione dei parametri di dimensionamento di un dominio di ricerca.
## Indice
**Opzioni**
Il tipo di istanza e il numero di repliche desiderati di ciascuna partizione di indice.
Tipo: [ScalingParameters](API_ScalingParameters.md)
Campo obbligatorio: sì
**Stato**
Stato dell'opzione di configurazione del dominio.
Tipo: [OptionStatus](API_OptionStatus.md)
Campo obbligatorio: sì
# ServiceEndpoint
## Descrizione
Endpoint al quale è possibile inviare le richieste di servizio.
## Indice
**Endpoint**
Endpoint al quale è possibile inviare le richieste di servizio. Ad esempio, `search-imdb-movies-oopcnjfn6ugofer3zx5iadxxca.eu-west-1.cloudsearch.amazonaws.com` o `doc-imdb-movies-oopcnjfn6ugofer3zx5iadxxca.eu-west-1.cloudsearch.amazonaws.com`.
Tipo: string
Campo obbligatorio: no
# Suggeritore
## Descrizione
Le informazioni di configurazione per un suggeritore di ricerche. Ogni suggeritore ha un nome univoco e specifica il campo di testo da utilizzare per i suggerimenti. È possibile configurare le opzioni seguenti per un suggeritore: `FuzzyMatching`, `SortExpression`.
## Indice
**DocumentSuggesterOptions**
Opzioni per un suggeritore delle ricerche.
Tipo: [DocumentSuggesterOptions](API_DocumentSuggesterOptions.md)
Campo obbligatorio: sì
**SuggesterName**
I nomi devono iniziare con una lettera e possono includere i seguenti caratteri: a-z (minuscoli), 0-9 e \$1 (carattere di sottolineatura).
Tipo: stringa
Vincoli della lunghezza: lunghezza minima 1. La lunghezza massima è 64 caratteri.
Campo obbligatorio: sì
# SuggesterStatus
## Descrizione
Il valore di un `Suggester` e il rispettivo stato corrente.
## Indice
**Opzioni**
Le informazioni di configurazione per un suggeritore di ricerche. Ogni suggeritore ha un nome univoco e specifica il campo di testo da utilizzare per i suggerimenti. È possibile configurare le opzioni seguenti per un suggeritore: `FuzzyMatching`, `SortExpression`.
Tipo: [Suggeritore](API_Suggester.md)
Campo obbligatorio: sì
**Stato**
Stato dell'opzione di configurazione del dominio.
Tipo: [OptionStatus](API_OptionStatus.md)
Campo obbligatorio: sì
# TextArrayOptions
## Descrizione
Opzioni per un campo che contiene una serie di stringhe di testo. Questo campo è presente se `IndexFieldType` specifica che il campo è del tipo `text-array`. In un campo `text-array` è sempre possibile eseguire ricerche. Tutte le opzioni sono abilitate per impostazione predefinita.
## Indice
**AnalysisScheme**
Nome di uno schema di analisi per un campo `text-array`.
Tipo: string
Campo obbligatorio: no
**DefaultValue**
Un valore da utilizzare per il campo, se il campo non è specificato per un documento.
Tipo: stringa
Vincoli della lunghezza: lunghezza minima 0. La lunghezza massima è 1024 caratteri.
Campo obbligatorio: no
**HighlightEnabled**
Se per il campo possono essere restituite evidenziazioni.
Tipo: Booleano
Campo obbligatorio: no
**ReturnEnabled**
Indica se nei risultati di ricerca possono essere restituiti i contenuti del campo.
Tipo: Booleano
Campo obbligatorio: no
**SourceFields**
Elenco di campi di origine da mappare al campo.
Tipo: string
Campo obbligatorio: no
# TextOptions
## Descrizione
Opzioni per un campo di testo. Questo campo è presente se `IndexFieldType` specifica che il campo è del tipo `text`. In un campo `text` è sempre possibile eseguire ricerche. Tutte le opzioni sono abilitate per impostazione predefinita.
## Indice
**AnalysisScheme**
Nome di uno schema di analisi per un campo `text`.
Tipo: string
Campo obbligatorio: no
**DefaultValue**
Un valore da utilizzare per il campo, se il campo non è specificato per un documento.
Tipo: stringa
Vincoli della lunghezza: lunghezza minima 0. La lunghezza massima è 1024 caratteri.
Campo obbligatorio: no
**HighlightEnabled**
Se per il campo possono essere restituite evidenziazioni.
Tipo: Booleano
Campo obbligatorio: no
**ReturnEnabled**
Indica se nei risultati di ricerca possono essere restituiti i contenuti del campo.
Tipo: Booleano
Campo obbligatorio: no
**SortEnabled**
Specifica se il campo può essere utilizzato per ordinare i risultati di ricerca.
Tipo: Booleano
Campo obbligatorio: no
**SourceField**
Una stringa che rappresenta il nome di un campo indice. CloudSearch supporta campi indice regolari e campi dinamici. Un nome di campo dinamico definisce un modello che inizia o termina con un carattere jolly. I campi di documento che non corrispondono a un campo di indice normale ma a un modello di campo dinamico vengono configurati con le opzioni di indicizzazione del campo dinamico.
I nomi di campo normali iniziano con una lettera e possono includere i seguenti caratteri: a-z (minuscoli), 0-9 e \$1 (carattere di sottolineatura). I nomi dei campi dinamici devono iniziare o terminare con un carattere jolly (\$1). Il carattere jolly può anche essere l'unico carattere in un nome di campo dinamico. Non sono supportati caratteri jolly multipli e caratteri jolly incorporati all'interno di una stringa.
Il nome `score` è riservato e non può essere utilizzato come nome di campo. Per fare riferimento all'ID di un documento si può utilizzare il nome `_id`.
Tipo: stringa
Vincoli della lunghezza: lunghezza minima 1. La lunghezza massima è 64 caratteri.
Campo obbligatorio: no
# UpdateAvailabilityOptionsResult
## Descrizione
Il risultato di una richiesta `UpdateAvailabilityOptions`. Contiene lo stato delle opzioni di disponibilità del dominio.
## Indice
**AvailabilityOptions**
Le opzioni di disponibilità appena configurate. Indica se l'opzione Multi-AZ è abilitata per il dominio.
Tipo: [AvailabilityOptionsStatus](API_AvailabilityOptionsStatus.md)
Campo obbligatorio: no
# UpdateScalingParametersResult
## Descrizione
Il risultato di una richiesta `UpdateScalingParameters`. Contiene lo stato dei parametri di dimensionamento appena configurati.
## Indice
**ScalingParameters**
Lo stato e la configurazione dei parametri di dimensionamento di un dominio di ricerca.
Tipo: [ScalingParametersStatus](API_ScalingParametersStatus.md)
Campo obbligatorio: sì
# UpdateServiceAccessPoliciesResult
## Descrizione
Il risultato di una richiesta `UpdateServiceAccessPolicies`. Contiene le nuove policy d'accesso.
## Indice
**AccessPolicies**
Le regole di accesso configurate per il dominio.
Tipo: [AccessPoliciesStatus](API_AccessPoliciesStatus.md)
Campo obbligatorio: sì
# Parametri comuni
Questa sezione elenca i parametri della richiesta utilizzati da tutte le operazioni. Qualsiasi parametro specifico di un'operazione è elencato nell'argomento relativo all'operazione.
**Azione**
azione da eseguire.
Impostazione predefinita: nessuna
Tipo: stringa
Obbligatorio: sì
**AuthParams**
Parametri obbligatori per autenticare una richiesta condizionale. Contiene:
+ AWSAccessKeyID
+ SignatureVersion
+ Time stamp
+ Firma
Impostazione predefinita: nessuna
Obbligatorio: condizionale
**AWSAccessKeyId**
ID chiave di accesso corrispondente alla chiave di accesso segreta utilizzata per firmare la richiesta.
Impostazione predefinita: nessuna
Tipo: stringa
Obbligatorio: sì
**Scade**
La data e l'ora di scadenza della firma della richiesta, espressa nel formato YYYY-MM DDThh -:MM:SSZ, come specificato nello standard ISO 8601.
Condizione: le richieste devono includere i parametri *Timestamp* o *Expires*, ma non entrambi.
Impostazione predefinita: nessuna
Tipo: stringa
Obbligatorio: condizionale
**SecurityToken**
Token di sicurezza provvisorio ottenuto tramite una chiamata ad AWS Security Token Service. Per un elenco dei servizi che supportano l'AWS Security Token Service, consultare [Utilizzo di credenziali di sicurezza temporanee per accedere ad AWS](https://docs.aws.amazon.com/IAM/latest/UsingSTS/UsingTokens.html) in **Utilizzo di credenziali di sicurezza temporanee**.
Impostazione predefinita: nessuna
Tipo: stringa
Obbligatorio: no
**Firma**
Firma digitale creata per la richiesta. Per informazioni sulla generazione di una firma, consultare la documentazione per gli sviluppatori del servizio.
Impostazione predefinita: nessuna
Tipo: stringa
Obbligatorio: sì
**SignatureMethod**
Algoritmo hash utilizzato per creare la firma della richiesta.
Impostazione predefinita: nessuna
Tipo: stringa
Valori validi: `HmacSHA256 | HmacSHA1`
Obbligatorio: sì
**SignatureVersion**
Versione della firma da utilizzare per firmare la richiesta. Impostare sul valore consigliato per il tuo servizio.
Impostazione predefinita: nessuna
Tipo: stringa
Obbligatorio: sì
**Time stamp**
La data e l'ora in cui è stata firmata la richiesta, espresse nel formato YYYY-MM-:MM:SSZ, come specificato nello standard ISO 8601. DDThh
Condizione: le richieste devono includere i parametri *Timestamp* o *Expires*, ma non entrambi.
Impostazione predefinita: nessuna
Tipo: stringa
Obbligatorio: condizionale
**Versione**
Versione dell'API per cui è scritta la richiesta, espressa nel formato AAAA-MM-GG.
Impostazione predefinita: nessuna
Tipo: stringa
Obbligatorio: sì
# Errori comuni
Questa sezione elenca gli errori comuni restituiti da tutte le operazioni. Qualsiasi errore specifico di un'operazione è elencato nell'argomento relativo all'operazione.
**IncompleteSignature**
La firma della richiesta non è conforme agli standard AWS.
Codice di stato HTTP: 400
**InternalFailure**
L'elaborazione della richiesta non è riuscita a causa di un errore, un'eccezione o un guasto interno sconosciuto.
Codice di stato HTTP: 500
**InvalidAction**
L'azione o l'operazione richiesta non è valida. Verifica che l'operazione sia digitata correttamente.
Codice di stato HTTP: 400
**InvalidClientTokenId**
Il certificato X.509 o l'ID chiave di accesso AWS forniti non sono presenti nei nostri record.
Codice di stato HTTP: 403
**InvalidParameterCombination**
Parametri che non possono essere utilizzati insieme sono stati utilizzati insieme.
Codice di stato HTTP: 400
**InvalidParameterValue**
È stato fornito un valore or non valido per il parametro di input. out-of-range
Codice di stato HTTP: 400
**InvalidQueryParameter**
La stringa di query AWS non è in formato corretto o non rispetta gli standard AWS.
Codice di stato HTTP: 400
**MalformedQueryString**
La stringa di query contiene un errore di sintassi.
Codice di stato HTTP: 404
**MissingAction**
Nella richiesta manca un'operazione o un parametro obbligatorio.
Codice di stato HTTP: 400
**MissingAuthenticationToken**
La richiesta deve contenere un ID chiave di accesso AWS valido (registrato) o un certificato X.509.
Codice di stato HTTP: 403
**MissingParameter**
Un parametro richiesto per l'operazione specificata non è stato fornito.
Codice di stato HTTP: 400
**OptInRequired**
L'ID chiave di accesso AWS necessita di una sottoscrizione al servizio.
Codice di stato HTTP: 403
**RequestExpired**
La richiesta ha raggiunto il servizio più di 15 minuti dopo la data indicata sulla richiesta o più di 15 minuti dopo la data di scadenza della richiesta (ad esempio nel caso di pre-firmata URLs), oppure la data indicata sulla richiesta è tra più di 15 minuti.
Codice di stato HTTP: 400
**ServiceUnavailable**
La richiesta non è riuscita a causa di un errore temporaneo del server.
Codice di stato HTTP: 503
**Throttling**
La richiesta è stata negata a causa del throttling della richiesta.
Codice di stato HTTP: 400
**ValidationError**
L'input non riesce a soddisfare i vincoli specificati da un servizio AWS.
Codice di stato HTTP: 400
# Riferimento all'API Document Service per Amazon CloudSearch
Utilizzi l'API del servizio documenti per aggiungere, sostituire o eliminare documenti nel tuo CloudSearch dominio Amazon. Per ulteriori informazioni sulla gestione dei documenti nel dominio di ricerca, consultare [Caricamento di dati su un dominio Amazon CloudSearch](uploading-data.md).
Gli altri APIs che usi per interagire con Amazon CloudSearch sono:
+ [Riferimento all'API di configurazione per Amazon CloudSearch](configuration-api.md): per configurare e gestire il dominio di ricerca.
+ [Informazioni di riferimento sull'API di ricerca](search-api.md): per eseguire ricerche nel dominio.
# documents/batch
Questa sezione descrive i messaggi di richiesta e risposta HTTP per la risorsa `documents/batch`.
Crei batch di documenti per descrivere i dati che desideri caricare su un CloudSearch dominio Amazon. Un batch di documenti è una raccolta di operazioni di aggiunta ed eliminazione che rappresentano i documenti che desideri aggiungere, aggiornare o eliminare da un tuo dominio. I batch possono essere descritti in formato JSON o XML. Un batch fornisce tutte le informazioni di cui Amazon CloudSearch ha bisogno per l'indicizzazione. Ogni articolo che desideri restituire come risultato di ricerca (ad esempio un prodotto) è rappresentato come un documento: un batch è semplicemente una raccolta di richieste di aggiunta ed eliminazione per singoli documenti. Ogni documento ha un ID univoco e uno o più campi che contengono i dati che si desidera ricercare e restituire all'interno dei risultati.
Per aggiornare un documento, devi specificare una richiesta di aggiunta con l'ID del documento che vuoi aggiornare. Per ulteriori informazioni, consulta [Aggiungere e aggiornare documenti in Amazon CloudSearch](preparing-data.md#adding-documents). Analogamente, per eliminare un documento devi inviare una richiesta di eliminazione con l'ID del documento che vuoi eliminare. Per informazioni sull'eliminazione dei documenti, consultare [Eliminazione di documenti in Amazon CloudSearch](preparing-data.md#deleting-documents).
Per ulteriori informazioni sull'invio di dati per l'indicizzazione, consultare [Caricamento di dati su un dominio Amazon CloudSearch](uploading-data.md).
## documents/batch JSON API
### Richieste JSON documents/batch
Il corpo di una richiesta `documents/batch` utilizza i formati JSON o XML per specificare le operazioni che vuoi eseguire per i documenti. La rappresentazione JSON di un batch è una raccolta di oggetti che definiscono le singole operazioni di aggiunta ed eliminazione. La proprietà `type` indica se un oggetto rappresenta un'operazione di aggiunta o di eliminazione. Ad esempio, il seguente batch JSON aggiunge un documento ed elimina un documento:
```
[
{ "type": "add",
"id": "tt0484562",
"fields": {
"title": "The Seeker: The Dark Is Rising",
"directors": ["Cunningham, David L."],
"genres": ["Adventure","Drama","Fantasy","Thriller"],
"actors": ["McShane, Ian","Eccleston, Christopher","Conroy, Frances",
"Crewson, Wendy","Ludwig, Alexander","Cosmo, James",
"Warner, Amelia","Hickey, John Benjamin","Piddock, Jim",
"Lockhart, Emma"]
}
},
{ "type": "delete",
"id": "tt0484575"
}]
```
**Nota**
Quando specifichi i batch di documenti nel formato JSON, il valore di un campo non può essere `null`.
Di seguito è riportato lo [schema JSON](http://json-schema.org/) di un batch:
```
{
"type": "array",
"minItems": 1,
"items": {
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": ["add", "delete"],
"required": true
},
"id": {
"type": "string",
"pattern": "[a-z0-9][a-z0-9_]{0,127}",
"minLength": 1,
"maxLength": 128,
"required": true
},
"fields": {
"type": "object",
"patternProperties": {
"[a-zA-Z0-9][a-zA-Z0-9_]{0,63}": {
"type": "string",
}
}
}
}
}
}
```
#### Proprietà della richiesta documents/batch (JSON)
****
| Proprietà | Description | Richiesto |
| --- | --- | --- |
| tipo | Tipo di operazione: add o delete. | Sì |
| id | Stringa alfanumerica. I caratteri consentiti sono: A-Z (maiuscole), -a-z (minuscole), 0-9, \$1 (carattere di sottolineatura), - (trattino), / (barra), \$1 (cancelletto), : (due punti). La lunghezza massima è 128 caratteri. | Sì |
| campi | Insieme di una o più proprietà field\$1name che definiscono i campi contenuti nel documento. Condizione: obbligatoria per le operazioni di aggiunta. Deve contenere almeno una proprietà *field\$1name*. | Condizionale |
| field\$1name | Specifica una campo nel documento in fase di aggiunta. I nomi di campo devono iniziare con una lettera e possono includere i seguenti caratteri: a-z (minuscole), 0-9 e \$1 (carattere di sottolineatura). I nomi di campo devono avere una lunghezza compresa tra 3 e 64 caratteri. Il nome score è riservato e non può essere utilizzato come nome di campo. Per specificare più valori per un campo, è necessario specificare un array di valori invece di un singolo valore. Esempio: `"genre": ["Adventure","Drama","Fantasy","Thriller"]` Condizione: deve essere specificato almeno un campo nell'oggetto campi. | Condizionale |
### Risposta documents/batch (JSON)
Il corpo della risposta elenca il numero di operazioni di aggiunta ed eliminazione eseguite e gli eventuali errori o avvisi generati.
Di seguito è riportata la rappresentazione dello schema JSON di una risposta dell'API del servizio documenti:
```
{
"type": "object",
"properties": {
"status": {
"type": "text",
"enum": ["success", "error"],
"required": true
},
"adds": {
"type": "integer",
"minimum": 0,
"required": true
},
"deletes": {
"type": "integer",
"minimum": 0,
"required": true
},
"errors": {
"type": "array",
"required": false,
"items": {
"type": "object",
"properties": {
"message": {
"type": "string",
"required": true
}
}
}
},
"warnings": {
"type": "array",
"required": false,
"items": {
"type": "object",
"properties": {
"message": {
"type": "string",
"required": true
}
}
}
}
}
}
```
#### Proprietà della risposta documents/batch (JSON)
****
| Proprietà | Description |
| --- | --- |
| status | Stato del risultato: success o error. |
| adds | Numero di operazioni di aggiunta di documenti eseguite. Sempre zero quando lo stato è error. |
| deletes | Numero di operazioni di eliminazione di documenti eseguite. Sempre zero quando lo stato è error. Per informazioni sull'eliminazione permanente dei documenti, consultare [Eliminazione di documenti in Amazon CloudSearch](preparing-data.md#deleting-documents). |
| errori | Fornisce informazioni su un errore di analisi o convalida. Specificato solo se lo stato è error. |
| attenzione | Fornisce informazioni su un avviso generato durante l'analisi o la convalida. |
# documents/batch XML API
## Richieste XML documents/batch
Il corpo di una richiesta `documents/batch` specifica le operazioni dei documenti che vuoi eseguire in XML. Esempio:
```
The Seeker: The Dark Is Rising
Cunningham, David L.
Adventure
Drama
Fantasy
Thriller
McShane, Ian
Eccleston, Christopher
Conroy, Frances
Ludwig, Alexander
Crewson, Wendy
Warner, Amelia
Cosmo, James
Hickey, John Benjamin
Piddock, Jim
Lockhart, Emma
```
### Elementi della richiesta documents/batch (XML)
****
| Elemento | Description | Richiesto |
| --- | --- | --- |
| batch | Raccolta di operazioni di aggiunta o eliminazione che vuoi inviare al tuo dominio di ricerca. Un batch deve contenere almeno un elemento di aggiunta o eliminazione. | Sì |
| aggiungi | Specifica un documento che vuoi aggiungere al tuo dominio di ricerca. Gli attributi id sono obbligatori e un elemento add deve contenere almeno un campo. Attributi: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/cloudsearch/latest/developerguide/documents-batch-xml.html) | No |
| field | Specifica un campo nel documento in fase di aggiunta. Sono obbligatori l'attributo name e un valore del campo. I nomi di campo devono iniziare con una lettera e possono includere i seguenti caratteri: a-z (minuscole), 0-9 e \$1 (carattere di sottolineatura). Il nome score è riservato e non può essere utilizzato come nome di campo. Il valore del campo può essere testo o CDATA. Per specificare più valori per un campo, includi più elementi field con lo stesso nome. Esempio: Adventure
Drama
Fantasy
Thriller
Vincoli: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/cloudsearch/latest/developerguide/documents-batch-xml.html) Condizione: deve essere specificato almeno un campo in un elemento add. | Condizionale |
| Elimina | Specifica un documento che vuoi rimuovere dal tuo dominio di ricerca. L'attributo id è obbligatorio. Un elemento delete deve essere vuoto. Per informazioni sull'eliminazione permanente dei documenti, consultare [Eliminazione di documenti in Amazon CloudSearch](preparing-data.md#deleting-documents).Vincoli: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/cloudsearch/latest/developerguide/documents-batch-xml.html) | No |
## Risposta documents/batch (XML)
Il corpo della risposta elenca il numero di operazioni di aggiunta ed eliminazione eseguite e gli eventuali errori o avvisi generati.
Lo schema RelaxNG di una risposta dell'API del servizio documenti è:
```
start = response
response = element response {
attribute status { "success" | "error" },
attribute adds { xsd:integer },
attribute deletes { xsd:integer },
element errors {
element error {
text
}+
}? &
element warnings {
element warning {
text
}+
}?
}
```
### Elementi della risposta documents/batch (XML)
****
| Elemento | Description |
| --- | --- |
| result | Contiene elementi che elencano gli errori e gli avvisi generati durante l'analisi e la convalida della richiesta. Attributi: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/cloudsearch/latest/developerguide/documents-batch-xml.html) Vincoli: se lo stato è `error`, l'elemento results contiene un elenco di errori. Se lo stato è `success`, l'elemento results può contenere un elenco di avvisi, ma nessun errore. |
| errori | Contiene un insieme di elementi error che individuano gli errori verificatisi durante l'analisi e la convalida della richiesta. |
| error | Fornisce informazioni su un errore di analisi o convalida. Il valore fornisce una descrizione dell'errore. |
| avvisi | Contiene un insieme di elementi warning che individuano gli avvisi generati durante l'analisi e la convalida della richiesta. |
| attenzione | Fornisce informazioni su un avviso relativo all'analisi o alla convalida. Il valore fornisce una descrizione dell'errore. |
## Codici di stato documents/batch
Una richiesta del servizio documenti può restituire tre tipi di codici di stato:
+ I codici di stato 5xx indicano che si è verificato un errore interno del server. Consigliamo di intercettare e riprovare tutti i codici di errore 5xx in quanto solitamente rappresentano condizioni di errore transitorie.
+ I codici di stato 4xx indicano che la richiesta non è stata formulata correttamente.
+ I codici di stato 2xx indicano che la richiesta è riuscita.
****
| Errore | Description | Codice di stato HTTP |
| --- | --- | --- |
| No Content-Type | L'intestazione Content-Type è assente. | 400 |
| No Content-Length | L'intestazione Content-Lenght è assente. | 411 |
| Incorrect Path | Il percorso dell'URL non corrisponde a «/YYYY-MM-». DD/documents/batch | 404 |
| Invalid HTTP Method | Il metodo HTTP non è POST. Le richieste devono essere inviate a documenti/batch. | 405 |
| Invalid Accept Type | L'intestazione Accept specifica un tipo di contenuto diverso da "». application/xml'' or ''application/json Le risposte possono essere inviate solo come XML o JSON. | 406 |
| Request Too Large | La lunghezza del corpo della richiesta è superiore al valore massimo consentito. | 413 |
| Invalid Content Type | Il tipo di contenuto è diverso da "»application/json" or "application/xml. | 415 |
| Invalid Character Set | Il set di caratteri è diverso da "'ASCII'', ''ISO-8859-1'' o ''UTF-8''. | 415 |
## Intestazioni di richiesta comuni
****
| Nome | Description | Richiesto |
| --- | --- | --- |
| Content-Type | Tipo MIME standard che descrive il formato dei dati oggetto. Per ulteriori informazioni, consultare la [sezione 14 del protocollo RFC 2616 di W3C](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.17). Predefinito: application/json Vincoli: application/json o solo application/xml | Richiesto |
| Content-Length | La lunghezza in byte del corpo della richiesta. | Sì |
| Accettare | Tipo MIME standard che descrive il formato dei dati della risposta. Per ulteriori informazioni, consultare la [sezione 14 del protocollo RFC 2616 di W3C](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.17). Impostazione predefinita: Content-Type della richiesta Vincoli: o solo application/json application/xml | No |
## Intestazioni di risposta comuni
****
| Nome | Description |
| --- | --- |
| Content-Type | Tipo MIME standard che descrive il formato dei dati oggetto. Per ulteriori informazioni, consultare la [sezione 14 del protocollo RFC 2616 di W3C](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.17). Predefinito: il valore dell'intestazione Accept nella richiesta o il Content-Type della richiesta se l'intestazione Accept è mancante o non specifica né application/json. application/xml Vincoli: application/xml o solo application/json |
| Content-Length | La lunghezza in byte del corpo della risposta. |
# Cerca riferimento all'API per Amazon CloudSearch
**Topics**
+ [Cerca](#search-request)
+ [Invio di richieste di suggerimenti in Amazon CloudSearch](#submitting-suggest-requests)
+ [Suggerimento](#suggest)
+ [Errori dei servizi di ricerca](#search-service-errors)
Utilizzi l'API di ricerca per inviare richieste di ricerca o suggerimenti al tuo CloudSearch dominio Amazon. Per ulteriori informazioni sulla ricerca, vedi [Ricerca nei tuoi dati con Amazon CloudSearch](searching.md). Per ulteriori informazioni sui suggerimenti, vedi [Ottenere suggerimenti per il completamento automatico in Amazon CloudSearch](getting-suggestions.md).
Gli altri APIs che usi per interagire con Amazon CloudSearch sono:
+ [API di configurazione](configuration-api.md): per configurare e gestire il dominio di ricerca.
+ [API del servizio documenti](document-service-api.md): per inviare i dati da ricercare.
## Cerca
In questa sezione vengono descritti i messaggi di richiesta e risposta HTTP per la risorsa di ricerca.
### Sintassi di ricerca
```
GET /2013-01-01/search
```
### Intestazioni delle richieste di ricerca
HOST
L'endpoint delle richieste di ricerca per il dominio sottoposto a query. Puoi utilizzare [DescribeDomains](API_DescribeDomains.md) per recuperare l'endpoint delle richieste di ricerca del dominio.
Obbligatorio: sì
### Parametri delle richieste di ricerca
cursor
Recupera un valore di cursore che puoi utilizzare per scorrere set di risultati i grandi dimensioni. Utilizza il parametro `size` per controllare il numero di occorrenze da includere in ogni risposta. In una richiesta è possibile specificare o il parametro `cursor` o il parametro `start`, in quanto si escludono a vicenda. Per ulteriori informazioni, consulta [Scorrere le pagine dei risultati](paginating-results.md).
Per ottenere il primo cursore, specifica `cursor=initial` nella tua richiesta iniziale. Nelle richieste successive specifica il valore di cursore restituito nella sezione delle occorrenze della risposta.
Ad esempio, i set di richieste seguenti impostano il valore del cursore su `initial` e il parametro `size` su 100 per ottenere il primo set di occorrenze. Il cursore per il set di occorrenze successivo è incluso nella risposta.
```
search?q=john&cursor=initial&size=100&return=_no_fields
{
"status": {
"rid": "+/Xu5s0oHwojC6o=",
"time-ms": 15
},
"hits": {
"found": 503,
"start": 0,
"cursor": "VegKzpYYQW9JSVFFRU1UeWwwZERBd09EUTNPRGM9ZA",
"hit": [
{"id": "tt0120601"},
{"id": "tt1801552"},
...
]
}
}
```
Per ottenere il set di occorrenze successivo, è necessario specificare il valore de cursore e il numero di occorrenze da recuperare.
```
search?q=john&cursor=VegKzpYYQW9JSVFFRU1UeWwwZERBd09EUTNPRGM9ZA&size=100
```
▬Tipo: stringa
Obbligatorio: no
expr.NAME
Definisce un'espressione che può essere utilizzata per ordinare i risultati. È anche possibile specificare un'espressione come campo incluso nei risultati. Per ulteriori informazioni sulla definizione e sull'utilizzo delle espressioni, vedi [Configurazione di espressioni](configuring-expressions.md).
È possibile definire e utilizzare più espressioni in una richiesta di ricerca. Ad esempio, la seguente richiesta crea due espressioni che vengono utilizzate per ordinare i risultati e le include nei risultati della ricerca:
```
search?q=(and (term field=genres 'Sci-Fi')(term field=genres 'Comedy'))&q.parser=structured
&expr.expression1=_score*rating
&expr.expression2=(1/rank)*year
&sort=expression1 desc,expression2 desc
&return=title,rating,rank,year,_score,expression1,expression2
```
▬Tipo: stringa
Obbligatorio: no
facet.FIELD
Speciifica un campo per il quale desideri ottenere informazioni sui facet: `FIELD` è il nome del campo. Il campo specificato deve essere abilitato per i facet nella configurazione del dominio. Le opzioni dei facet sono specificate come oggetto JSON. Se l'oggetto JSON è vuoto, `facet.FIELD={}`, il numero di facet viene calcolato per tutti i valori dei campi, i facet vengono archiviati in base al loro numero e nei risultati vengono restituiti i primi 10 facet.
Puoi specificare tre opzioni nell'oggetto JSON:
+ `sort` specifica il modo in cui si desidera ordinare i facet nei risultati: `bucket` o `count`. Specifica `bucket` per impostare l'ordine alfabetico o numerico in base al valore di facet (in ordine crescente). Specifica `count` per ordinare i facet in base ai conteggi calcolati per ciascun valore di facet (in ordine decrescente). Per recuperare i conteggi dei facet per determinati valori o intervalli di valori, utilizza l'opzione `buckets` anziché `sort`.
+ `buckets` specifica una serie di valori o intervalli di facet da conteggiare. I bucket vengono restituiti nell'ordine in cui sono specificati nella richiesta. Per specificare un intervallo di valori, utilizza una virgola (,) per separare i limiti superiore e inferiore e inserisci l'intervallo tra parentesi tonde o parentesi graffe. Una parentesi quadra, [o], indica che il limite è incluso nell'intervallo, una parentesi graffa, \$1o\$1, esclude il limite. Puoi omettere il limite superiore o inferiore per specificare un intervallo aperto. Quando si omette un limite, è necessario utilizzare un tutore riccio. Le `size` opzioni `sort` and non sono valide se specificate. `buckets`
+ `size` specifica il numero massimo di facet da includere nei risultati. Per impostazione predefinita, i CloudSearch resi di Amazon rientrano tra i primi 10. Il parametro `size` è valido solo quando si specifica l'opzione `sort`, ma non può essere utilizzato in combinazione con `buckets`.
Ad esempio, la seguente richiesta ottiene i conteggi dei facet per il campo `year`, ordina i conteggi dei facet in base al valore e restituisce i conteggi per i primi tre:
```
facet.year={sort:"bucket", size:3}
```
Per specificare i valori o l'intervallo di valori per cui calcolare i conteggi dei facet, utilizza l'opzione `buckets`. Ad esempio, la seguente richiesta calcola e restituisce i conteggi dei facet in base alla decade:
```
facet.year={buckets:["[1970,1979]","[1980,1989]",
"[1990,1999]","[2000,2009]",
"[2010,}"]}
```
È anche possibile specificare valori singoli come bucket:
```
facet.genres={buckets:["Action","Adventure","Sci-Fi"]}
```
Tieni presente che i valori delle sfaccettature fanno distinzione tra maiuscole e minuscole: per i dati del IMDb filmato di esempio, se specifichi `["action","adventure","sci-fi"]` invece di, tutti i conteggi delle `["Action","Adventure","Sci-Fi"]` faccette sono pari a zero.
▬Tipo: stringa
Obbligatorio: no
format
Specifica il tipo di contenuti della risposta.
Tipo: String
Valori validi: json\$1xml
Impostazione predefinita: json
Obbligatorio: no
fq
Specifica una query strutturata che filtra i risultati di una ricerca senza modificare il modo in cui i risultati vengono valutati e ordinati. Utilizza `fq` in combinazione con il parametro `q` per filtrare i documenti che soddisfano i vincoli specificati nel parametro `q`. L'applicazione di un filtro consente semplicemente di controllare i documenti corrispondenti che vengono inclusi nei risultati, senza influenzare il modo in cui vengono valutati e ordinati. Il parametro `fq` supporta la sintassi delle query strutturate. Per ulteriori informazioni sull'uso dei filtri, vedi [Filtraggio dei documenti corrispondenti](filtering-results.md). Per ulteriori informazioni sulle query strutturate, vedi [Sintassi di ricerca strutturata](#structured-search-syntax).
▬Tipo: stringa
Obbligatorio: no
highlight.FIELD
Recupera evidenziazioni per le corrispondenze nel campo `text` o `text-array` specificato. Le opzioni di evidenziazione sono specificate come oggetto JSON. Se l'oggetto JSON è vuoto, il testo del campo restituito viene trattato come testo HTML e la prima corrispondenza viene evidenziata con tag di enfasi: `search-term`.
Puoi specificare quattro opzioni nell'oggetto JSON:
+ `format`—specifica il formato dei dati nel campo di testo: o. `text` `html` Quando i dati vengono restituiti come HTML, tutti i caratteri non alfanumerici vengono codificati. Il valore predefinito è `html`.
+ `max_phrases`—specifica il numero massimo di occorrenze dei termini di ricerca che si desidera evidenziare. Per impostazione predefinita, la prima occorrenza è evidenziata.
+ `pre_tag`—specifica la stringa da anteporre a un'occorrenza di un termine di ricerca. Il valore predefinito per le evidenziazioni HTML è ``. Il valore predefinito per le evidenziazioni di testo è `*`.
+ `post_tag`—specifica la stringa da aggiungere a un'occorrenza di un termine di ricerca. Il valore predefinito per le evidenziazioni HTML è ``. Il valore predefinito per le evidenziazioni di testo è `*`.
Esempi: `highlight.plot={}`, `highlight.plot={format:'text',max_phrases:2,pre_tag:'',post_tag:''}`
▬Tipo: stringa
Obbligatorio: no
partial
Controlla se vengono restituiti risultati parziali se una o più partizioni di indice non sono disponibili. Quando l'indice di ricerca è partizionato su più istanze di ricerca, per impostazione predefinita Amazon restituisce risultati CloudSearch solo se è possibile interrogare ogni partizione. Ciò significa che l'errore di una singola istanza di ricerca può portare a errori di server interni (5xx). Quando lo specifichi. `partial=true` Amazon CloudSearch restituisce tutti i risultati disponibili e include la percentuale di documenti cercati nei risultati di ricerca (`percent-searched`). Ciò consente di attenuare la carenza dei risultati della ricerca agli occhi degli utenti. Ad esempio, invece di non visualizzare alcun risultato, è possibile visualizzare i risultati parziali e un messaggio che indica che i risultati potrebbero essere incompleti a causa di un'interruzione temporanea del sistema.
Tipo: Booleano
Impostazione predefinita: False
Obbligatorio: no
pretty
Formatta l'output JSON; in modo da renderlo più facilmente leggibile.
Tipo: Booleano
Impostazione predefinita: False
Obbligatorio: no
q
I criteri di ricerca per la richiesta. Il modo in cui si specificano criteri di ricerca dipende dal parser di query utilizzato per la richiesta e dalle opzioni di parser specificate nel parametro `q.options`. Per impostazione predefinita, il parser di query `simple` viene utilizzato per elaborare le richieste. Per utilizzare il parser di query `structured`, `lucene` o `dismax`, è necessario specificare anche il parametro `q.parser`. Per ulteriori informazioni sulla specifica dei criteri di ricerca, vedi [Ricerca nei tuoi dati con Amazon CloudSearch](searching.md).
Tipo: stringa
Obbligatorio: sì
q.options
Puoi configurare le opzioni per il parser di query specificato nel parametro `q.parser`. Le opzioni sono specificate come oggetto JSON, ad esempio: `q.options={defaultOperator: 'or', fields: ['title^5','description']}`.
Le opzioni che è possibile configurare variano in base al parser utilizzato:
+ `defaultOperator`—L'operatore predefinito utilizzato per combinare singoli termini nella stringa di ricerca. Ad esempio: `defaultOperator: 'or'`. Per il parser `dismax`, è necessario specificare un valore che rappresenta la percentuale di termini della stringa di ricerca (arrotondata per difetto) che deve corrispondere, anziché un operatore predefinito. Il valore `0%` equivale a OR e il valore `100%` equivale a AND. La percentuale deve essere specificata come valore compreso nell'intervallo 0-100, seguito dal simbolo di percentuale (%). Ad esempio, `defaultOperator: 50%`. Valori validi: `and`, `or`, una percentuale nell'intervallo 0%-100% (`dismax`). Impostazione predefinita: `and` (`simple`, `structured`, `lucene`) o `100` (`dismax`). Valida per: `simple`, `structured`, `lucene` e `dismax`.
+ `fields`—Una matrice dei campi in cui eseguire la ricerca quando non è specificato alcun campo in una ricerca. Se in una ricerca non sono specificati campi e non è specificata questa opzione, la ricerca viene eseguita in tutti i campi `text` e `text-array` configurati staticamente. Puoi specificare un peso per ogni campo per controllare l'importanza relativa di ogni campo quando Amazon CloudSearch calcola i punteggi di pertinenza. Per specificare una rilevanza del campo, aggiungi un accento circonflesso (`^`) e la rilevanza al nome del campo. Ad esempio, per aumentare la rilevanza del campo `title` rispetto al campo `description`, è possibile specificare: `fields: ['title^5','description']`. Valori validi: il nome di qualsiasi campo configurato e un valore numerico facoltativo maggiore di zero. Impostazione predefinita: tutti i campi `text` e `text-array` configurati staticamente. Per impostazione predefinita, i campi dinamici e i campi `literal` non sono oggetto di ricerca. Valida per: `simple`, `structured`, `lucene` e `dismax`.
+ `operators`—Un array di operatori o caratteri speciali che desideri disabilitare per il semplice parser di query. Se si disabilitano gli operatori `and`, `or` o `not`, gli operatori corrispondenti (`+`, `|`, `-`) non hanno alcun significato speciale e vengono eliminati dalla stringa di ricerca. Analogamente, disabilitando `prefix` si disabilita l'operatore carattere jolly (`*`) e disabilitando `phrase` si disabilita la possibilità di cercare periodi racchiudendoli tra doppie virgolette. Disabilitando la precedenza si disabilita la possibilità di controllare l'ordine di precedenza utilizzando le parentesi. Disabilitando `near` si disabilita la possibilità di utilizzare l'operatore \$1 per eseguire una ricerca di frasi simili. La disabilitazione dell'operatore `fuzzy` disabilita la possibilità di utilizzare l'operatore \$1 per eseguire una ricerca fuzzy. `escape` disabilita la possibilità di utilizzare una barra rovesciata (`\`) per inserire caratteri speciali di escape all'interno della stringa di ricerca. La disabilitazione dello spazio è un'opzione avanzata che impedisce al parser di trasformare le stringhe in token in corrispondenza degli spazi e che può essere utile per il vietnamita (impedisce la separazione non corretta delle parole vietnamite). Ad esempio, è possibile disabilitare tutti gli operatori diversi dall'operatore periodo per supportare solo le query di termini e periodi semplici: `operators:['and', 'not', 'or', 'prefix']`. Valori validi: `and`, `escape`, `fuzzy`, `near`, `not`, `or`, `phrase`, `precedence`, `prefix`, `whitespace`. Impostazione predefinita: tutti gli operatori e i caratteri speciali sono abilitati. Valida per: `simple`.
+ `phraseFields`—Una matrice dei `text-array` campi `text` o che si desidera utilizzare per la ricerca di frasi. Quando i termini della stringa di ricerca appaiono molto vicini all'interno di un campo, il campo ha un punteggio più elevato. È possibile aumentare tale punteggio specificando una rilevanza per ogni campo. L'opzione `phraseSlop` controlla in che misura le corrispondenze possono discostarsi dalla stringa di ricerca e avere comunque una rilevanza elevata. Per specificare una rilevanza del campo, aggiungi un accento circonflesso (`^`) e la rilevanza al nome del campo. Ad esempio, per aumentare la rilevanza delle corrispondenze dei periodi nel campo `title` rispetto al campo `abstract`, è possibile specificare: `phraseFields:['title^3', 'abstract']` Valori validi: il nome di un campo `text` o `text-array` e un valore numerico facoltativo maggiore di zero. Impostazione predefinita: nessun campo. Se non specifichi un campo con `phraseFields`, l'assegnazione del punteggio di prossimità è disabilitato, anche se `phraseSlop` è specificato. Valida per: `dismax`.
+ `phraseSlop`—Un valore intero che specifica in che misura le corrispondenze possono deviare dalla frase di ricerca e comunque essere aumentate in base ai pesi specificati nell'opzione. `phraseFields` Ad esempio, `phraseSlop: 2`. Inoltre, è necessario specificare `phraseFields` per abilitare l'assegnazione del punteggio di prossimità. Valori validi: numeri interi positivi. Impostazione predefinita: 0. Valida per: `dismax`.
+ `explicitPhraseSlop`—Un valore intero che specifica in che misura una corrispondenza può deviare dalla frase di ricerca quando la frase è racchiusa tra virgolette doppie nella stringa di ricerca. (Le frasi che superano questa distanza di prossimità non sono considerate una corrispondenza.) `explicitPhraseSlop: 5`. Valori validi: numeri interi positivi. Impostazione predefinita: 0. Valida per: `dismax`.
+ `tieBreaker`—Quando un termine nella stringa di ricerca viene trovato nel campo di un documento, viene calcolato un punteggio per quel campo in base alla frequenza della parola in quel campo rispetto ad altri documenti. Se il termine viene utilizzato in più campi all'interno di un documento, per impostazione predefinita al punteggio globale del documento contribuisce solo il campo con punteggio più alto. È possibile specificare un valore `tieBreaker` per consentire che le corrispondenze nei campi con punteggio inferiore contribuiscano al punteggio del documento. In questo modo, se due documenti hanno lo stesso punteggio di campo massimo per un determinato termine, il documento con corrispondenze in più campi avrà un punteggio più alto. La formula per calcolare il punteggio con un tieBreaker è:
```
(max field score) + (tieBreaker) * (sum of the scores for the rest of the matching fields)
```
Ad esempio, la query seguente cerca il termine *dog* nei campi `title`, `description` e `review` e imposta `tieBreaker` su 0.1:
```
q=dog&q.parser=dismax&q.options={fields:['title', 'description', 'review'], tieBreaker: 0.1}
```
Se *dog* è presente in tutti e tre i campi di un documento e i punteggi per ogni campo sono title= 1, description= 3 e review = 1, il punteggio globale per il termine dog è:
```
3 + 0.1 * (1+1) = 3.2
```
Imposta `tieBreaker` su 0 per ignorare tutti i campi, ad eccezione di quello con punteggio più alto (max). Imposta su 1 per sommare i punteggi di tutti i campi (sum). Valori validi: da 0.0 a 1.0. Impostazione predefinita: 0.0. Valida per: `dismax`.
Tipo: oggetto JSON
Impostazione predefinita: vedi le descrizioni delle singole opzioni.
Obbligatorio: no
q.parser
Specifica quali parser di query utilizzare per elaborare la richiesta: `simple`, `structured`, `lucene` e `dismax`. Se non `q.parser` è specificato, Amazon CloudSearch utilizza il parser di `simple` query.
+ `simple`—esegue ricerche semplici su e campi. `text` `text-array` Per impostazione predefinita, il parser di query `simple` esegue la ricerca in tutti i campi `text` e `text-array` configurati staticamente. Puoi specificare i campi in cui desideri eseguire le ricerche con il parametro `q.options`. Se anteponi a un termine di ricerca il prefisso del segno più (\$1), per essere considerata una corrispondenza i documenti devono includere il termine (questa è l'impostazione predefinita, a meno che non si configuri l'operatore predefinito con il parametro `q.options`). È possibile utilizzare gli operatori `-` (NOT), `|` (OR) e `*` (carattere jolly) per escludere particolari termini, trovare i risultati che corrispondono a uno qualsiasi dei termini specificati oppure cercare un prefisso. Per cercare un periodo anziché singoli termini, racchiudi il periodo tra virgolette doppie. Per ulteriori informazioni, consulta [Ricerca nei tuoi dati con Amazon CloudSearch](searching.md).
+ `structured`—esegue ricerche avanzate combinando più espressioni per definire i criteri di ricerca. È inoltre possibile eseguire ricerche all'interno di campi specifici, cercare valori e intervalli di valori e utilizzare opzioni avanzate come l'aumento di rilevanza dei termini, `matchall`, e `near`. Per ulteriori informazioni, consulta [Creazione di query composte](searching-compound-queries.md).
+ `lucene`—ricerca utilizzando la sintassi del parser di query di Apache Lucene. Per ulteriori informazioni, consultare l'argomento relativo alla [sintassi del parser di query Apache Lucene](https://cwiki.apache.org/confluence/display/solr/The+Standard+Query+Parser).
+ `dismax`—ricerca utilizzando il sottoinsieme semplificato della sintassi del parser di query Apache Lucene definita dal parser di query. DisMax [Per ulteriori informazioni, vedere Query Parser Syntax. DisMax ](https://cwiki.apache.org/confluence/display/solr/The+DisMax+Query+Parser)
Tipo: String
Impostazione predefinita: `simple`
Obbligatorio: no
return
I valori dei campi e delle espressioni da includere nella risposta, specificati come elenco separato da virgole. Per impostazione predefinita, una risposta di ricerca comprende tutti i campi inclusi nei risultati (`return=_all_fields`). Per restituire solo il documento IDs per i documenti corrispondenti, specificare. `return=_no_fields` Per recuperare il punteggio di rilevanza calcolato per ogni documento, specifica `return=_score`. È possibile specificare più campi inclusi nei risultati come elenco separato da virgole. Ad esempio, `return=title,_score` restituisce solo il titolo e il punteggio di rilevanza di ogni documento corrispondente.
▬Tipo: stringa
Obbligatorio: no
size
Il numero massimo di occorrenze di ricerca da restituire.
Tipo: numero intero positivo
Impostazione predefinita: 10
Obbligatorio: no
sort
Elenco separato da virgole di campi o espressioni personalizzate da utilizzare per ordinare i risultati della ricerca. È necessario specificare la direzione dell'ordinamento (`asc` o `desc`) per ciascun campo. Ad esempio, `sort=year desc,title asc`. È possibile specificare un massimo di 10 campi ed espressioni. Per usare un campo per ordinare i risultati, è necessario che il campo consenta l'ordinamento nella configurazione del dominio. I campi di tipo array non possono essere utilizzati per l'ordinamento. Se non viene specificato alcun parametro `sort`, i risultati sono elencati in base al punteggio di rilevanza in ordine decrescente: `sort=_score desc`. È possibile ordinarli anche in base all'ID documento (`sort=_id`) e alla versione (`sort=_version`).
▬Tipo: stringa
Obbligatorio: no
start
L'offset della prima occorrenza di ricerca che si desidera restituire. In una richiesta è possibile specificare o il parametro `start` o il parametro `cursor`, in quanto si escludono a vicenda. Per ulteriori informazioni, consulta [Scorrere le pagine dei risultati](paginating-results.md).
Tipo: numero intero positivo
Impostazione predefinita: 0 (la prima occorrenza)
Obbligatorio: no
#### Sintassi di ricerca strutturata
Utilizza la sintassi di ricerca CloudSearch strutturata di Amazon per definire i criteri di ricerca quando usi il parser di `structured` query e per specificare i criteri di filtro con il `fq` parametro.
Quando utilizzi gli operatori delle query strutturate, devi specificare il nome dell'operatore, le relative opzioni e i termini a cui viene applicato l'operatore, `(OPERATOR OPTIONS STRING|EXPRESSION)`. Qualsiasi opzione deve essere specificata prima della stringa o dell'espressione. Ad esempio, `(and (not field=genres 'Sci-Fi')(or (term field=title boost=2 'star')(term field=plot 'star')))`.
**Importante**
I caratteri speciali nella stringa di query devono essere codificati in formato URL. Ad esempio, devi codificare l'`=`operatore in una query strutturata come`%3D`:). `(term+field%3Dtitle+'star'` Amazon CloudSearch restituisce un `InvalidQueryString` errore se i caratteri speciali non sono codificati nell'URL. Per un riferimento completo delle codifiche nel formato URL, consultare il documento [HTML URL Encoding Reference](http://www.w3schools.com/tags/ref_urlencode.asp) di W3C.
Se non si specifica il campo in cui si desidera eseguire la ricerca quando si usa il parser di query strutturate, la ricerca viene eseguita in tutti i campi `text` e `text-array` configurati staticamente. Per impostazione predefinita, i campi dinamici e i campi `literal` *non* sono oggetto di ricerca. Puoi indicare i campi in cui desideri eseguire la ricerca per impostazione predefinita specificando il parametro `q.options`.
Le parentesi controllano l'ordine di valutazione delle espressioni in una query composta. Se è racchiusa tra parentesi, un'espressione viene valutata per prima, quindi il valore risultante viene utilizzato nella valutazione della parte rimanente della query. Le espressioni possono contenere uno qualsiasi degli operatori di query strutturata.
È inoltre possibile utilizzare il parser di query strutturate per cercare una semplice stringa di testo: è sufficiente racchiudere la stringa da cercare tra virgolette singole: `q='black swan'&q.parser="structured"`.
Per ulteriori informazioni sulla creazione di query composte con gli operatori di query strutturata, vedi [Creazione di query composte](searching-compound-queries.md).
FIELD
Sintassi: `FIELD: 'STRING'|value`
Cerca nel campo specificato una stringa, un valore numerico, una data o un intervallo di valori numerici o date.
Le stringhe devono essere racchiuse tra virgolette singole. Ogni singola virgoletta o barra rovesciata nella stringa deve essere sostituita da una barra rovesciata. Per specificare un intervallo di valori, utilizza una virgola (,) per separare i limiti superiore e inferiore e inserisci l'intervallo tra parentesi tonde o parentesi graffe. Una parentesi quadra, [o], indica che il limite è incluso nell'intervallo, una parentesi graffa, \$1o\$1, esclude il limite. Puoi omettere il limite superiore o inferiore per specificare un intervallo aperto. Quando si omette un limite, è necessario utilizzare un tutore riccio.
[Le date e gli orari sono specificati in UTC (Coordinated Universal Time) secondo IETF:. RFC3339](http://tools.ietf.org/html/rfc3339) `yyyy-mm-ddTHH:mm:ss.SSSZ` In UTC, ad esempio, le 17:00 del 23 agosto 1970 sono:. `1970-08-23T17:00:00Z` Tieni presente che puoi anche specificare frazioni di secondo quando specifichi gli orari in UTC. Ad esempio, `1967-01-31T23:20:50.650Z.`
Esempi:
```
title:'star'
year:2000
year:[1998,2000]
year:{,2011]
release_date:['2013-01-01T00:00:00Z',}
```
and
Sintassi: `(and boost=N EXPRESSION EXPRESSION ... EXPRESSIONn)`
Include un documento solo se corrisponde a tutte le espressioni specificate. (Operatore `AND` booleano.) Le espressioni possono contenere uno qualsiasi degli operatori di query strutturata o una stringa di ricerca semplice. Le stringhe di ricerca devono essere racchiuse tra virgolette singole. Per trovare la corrispondenza con i documenti che contengono i termini specificati nei campi in cui viene eseguita la ricerca, è necessario specificare ogni termine come espressione separata: `(and 'star' 'wars')`. Se si specifica `(and 'star wars')`, *star* e *wars* devono essere presenti nello stesso campo per essere considerati una corrispondenza.
Il valore boost è un valore numerico positivo che aumenta l'importanza di questa parte della query di ricerca rispetto alle altre parti.
Esempio:
```
(and title:'star' actors:'Harrison Ford' year:{,2000])
```
matchall
Sintassi: `matchall`
Restituisce ogni documento del dominio. Per impostazione predefinita, restituisce i primi 10. Usa i parametri `size` e `start` per scorrere i risultati.
near
Sintassi: `(near field=FIELD distance=N boost=N 'STRING') `
Esegue la ricerca in un campo `text` o `text-array` della stringa a più termini specificata restituisce i documenti che contengono i termini a una distanza reciproca non superiore a quella specificata (A volte viene chiamata ricerca di frasi *sciatta*.) Se ometti l'`field`opzione, Amazon CloudSearch cerca tutti i `text-array` campi `text` e i campi configurati staticamente per impostazione predefinita. Per impostazione predefinita, i campi dinamici e i campi `literal` non sono oggetto di ricerca. Puoi specificare quali campi desideri cercare per impostazione predefinita specificando l'opzione. `q.options` `fields`
Il valore della distanza deve essere un numero intero positivo. Ad esempio, per trovare tutti i documenti in cui il termine *teenage* è presente a non più di 10 parole di distanza da *vampire* nel campo `plot`, è necessario specificare il valore di distanza 10: `(near field=plot distance=10 'teenage vampire')`.
Il valore boost è un valore numerico positivo che aumenta l'importanza di questa parte della query di ricerca rispetto alle altre parti.
Esempio:
```
(near field=plot distance=10 'teenage vampire')
```
not
Sintassi: `(not boost=N EXPRESSION)`
Esclude un documento se corrisponde all'espressione specificata. (Operatore `NOT` booleano). L'espressione può contenere uno qualsiasi degli operatori di query strutturata o una stringa di ricerca semplice. Le stringhe di ricerca devono essere racchiuse tra virgolette singole.
Il valore boost è un valore numerico positivo che aumenta l'importanza di questa parte della query di ricerca rispetto alle altre parti.
Esempio:
```
(not (or actors:'Harrison Ford' year:{,2010]))
```
or
Sintassi: `(or boost=N EXPRESSION1 EXPRESSION2 ... EXPRESSIONn)`
Include un documento se corrisponde a una delle espressioni specificate. (Operatore `OR` booleano). Le espressioni possono contenere uno qualsiasi degli operatori di query strutturata o una stringa di ricerca semplice. Le stringhe di ricerca devono essere racchiuse tra virgolette singole.
Il valore boost è un valore numerico positivo che aumenta l'importanza di questa parte della query di ricerca rispetto alle altre parti.
Esempio:
```
(or actors:'Alec Guinness' actors:'Harrison Ford' actors:'James Earl Jones')
```
phrase
Sintassi: `(phrase field=FIELD boost=N 'STRING')`
Cerca in un `text-array` campo `text` o la frase specificata. Se ometti l'`field`opzione, Amazon CloudSearch cerca tutti i `text-array` campi `text` e i campi configurati staticamente per impostazione predefinita. Per impostazione predefinita, i campi dinamici e i campi `literal` non sono oggetto di ricerca. Puoi specificare quali campi desideri cercare per impostazione predefinita specificando l'opzione. `q.options` `fields`
Utilizza l'operatore `phrase` per combinare una ricerca di periodo con altri criteri di ricerca in una query strutturata. Ad esempio `q=(and (term field=title 'star') (range field=year {,2000]))` restituisce tutti i documenti che contengono *star* nel campo del titolo e hanno valore minore o uguale a 2000 per l'anno.
Il valore boost è un valore numerico positivo che aumenta l'importanza di questa parte della query di ricerca rispetto alle altre parti.
Esempio:
```
(phrase field=plot 'teenage girl')
```
prefix
Sintassi: `(prefix field=FIELD boost=N 'STRING')`
Cerca un`text`, `text-array``literal`, o `literal-array` campo per il prefisso specificato seguito da zero o più caratteri. Se ometti l'`field`opzione, Amazon CloudSearch cerca tutti i `text-array` campi `text` e i campi configurati staticamente per impostazione predefinita. Per impostazione predefinita, i campi dinamici e i campi `literal` non sono oggetto di ricerca. Puoi specificare quali campi desideri cercare per impostazione predefinita specificando l'opzione. `q.options` `fields`
Utilizza l'operatore `prefix` per combinare una ricerca di prefisso con altri criteri di ricerca in una query strutturata. Ad esempio, `q=(and (prefix field=title 'sta') (range field=year {,2000]))` restituisce tutti i documenti che contengono il prefisso *sta* nel campo del titolo e hanno valore minore o uguale a 2000 per l'anno.
Il valore boost è un valore numerico positivo che aumenta l'importanza di questa parte della query di ricerca rispetto alle altre parti.
Per implementare i suggerimenti di ricerca, è necessario configurare ed eseguire query su un suggeritore anziché eseguire ricerche di prefissi. Per ulteriori informazioni, consulta [Richieste di suggerimento](#suggest-request).
Esempio:
```
(prefix field=title 'star')
```
range
Sintassi: `(range field=FIELD boost=N RANGE)`
Esegue la ricerca di un campo numerico (double, double-array, int, int-array) o di data (date, date-array) per i valori nell'intervallo specificato. Restituisce i documenti che presentano almeno un valore nel campo all'interno dell'intervallo specificato. È necessario specificare l'opzione `field`.
Utilizza l'operatore `range` per combinare una ricerca di intervallo con altri criteri di ricerca in una query strutturata. Ad esempio `q=(and (term field=title 'star') (range field=year {,2000]))` restituisce tutti i documenti che contengono *star* nel campo del titolo e hanno valore minore o uguale a 2000 per l'anno.
Per specificare un intervallo di valori, utilizza una virgola (,) per separare i limiti superiore e inferiore e inserisci l'intervallo tra parentesi tonde o parentesi graffe. Una parentesi quadra, [o], indica che il limite è incluso nell'intervallo, una parentesi graffa, \$1or\$1, esclude il limite. Puoi omettere il limite superiore o inferiore per specificare un intervallo aperto. Quando si omette un limite, è necessario utilizzare un tutore riccio.
[Le date e gli orari sono specificati in UTC (Coordinated Universal Time) secondo IETF:. RFC3339](http://tools.ietf.org/html/rfc3339) `yyyy-mm-ddTHH:mm:ss.SSSZ` In UTC, ad esempio, le 17:00 del 23 agosto 1970 sono:. `1970-08-23T17:00:00Z` Tieni presente che puoi anche specificare frazioni di secondo quando specifichi gli orari in UTC. Ad esempio, `1967-01-31T23:20:50.650Z.`
Il valore boost è un valore numerico positivo che aumenta l'importanza di questa parte della query di ricerca rispetto alle altre parti.
Esempi:
```
(range field=year [1990,2000])
(range field=year {,2000])
(range field=year [1990,})
```
term
Sintassi: `(term field=FIELD boost=N 'STRING'|VALUE) `
Cerca una stringa, un valore numerico o una data nel campo specificato. L'`field`opzione deve essere specificata durante la ricerca di un valore. Se ometti l'`field`opzione, Amazon CloudSearch cerca tutti i `text-array` campi `text` e i campi configurati staticamente per impostazione predefinita. Per impostazione predefinita, i campi dinamici e i campi `literal` non sono oggetto di ricerca. Puoi specificare quali campi desideri cercare per impostazione predefinita specificando l'opzione. `q.options` `fields`
Utilizza l'operatore `term` per combinare una ricerca di termine con altri criteri di ricerca in una query strutturata. Ad esempio, `q=(and (term field=title 'star') (range field=year {,2000]))` restituisce tutti i documenti che contengono *star* nel campo del titolo e hanno valore minore o uguale a 2000 per l'anno.
Le stringhe e le date devono essere racchiuse tra virgolette singole. Le virgolette singole o le barre rovesciate n una stringa devono essere precedute dal carattere di escape barra rovesciata.
Le date e gli orari sono specificati in UTC (Coordinated Universal Time) secondo [ RFC3339IETF](http://tools.ietf.org/html/rfc3339):. `yyyy-mm-ddTHH:mm:ss.SSSZ` In UTC, ad esempio, le 17:00 del 23 agosto 1970 sono:. `1970-08-23T17:00:00Z` Tieni presente che puoi anche specificare frazioni di secondo quando specifichi gli orari in UTC. Ad esempio, `1967-01-31T23:20:50.650Z.`
Il valore boost è un valore numerico positivo che aumenta l'importanza di questa parte della query di ricerca rispetto alle altre parti.
Esempi:
```
(term field=title 'star')
(term field=year 2000)
```
#### Sintassi di ricerca semplice
Utilizza la sintassi di ricerca CloudSearch semplice di Amazon per definire i criteri di ricerca quando usi il parser di `simple` query. Il parser di query semplice viene utilizzato per impostazione predefinita se non si specifica il parametro `q.parser`.
Questo tipo di parser di query consente di cercare singoli termini o periodi. Per impostazione predefinita, la ricerca viene eseguita in tutti i campi `text` e `text-array` configurati staticamente. Per impostazione predefinita, i campi dinamici e i campi `literal` *non* sono oggetto di ricerca. È possibile utilizzare il parametro `q.options` per specificare i campi in cui si desidera eseguire la ricerca, modificare l'operatore predefinito utilizzato per combinare singoli termini nella stringa di ricerca oppure disabilitare uno qualsiasi degli operatori di parser semplici (`and`, `escape`, `fuzzy`, `near`, `not`, `or`, `phrase`, `precedence`, `prefix`, `whitespace`).
Per ulteriori informazioni su come utilizzare i parser di query semplice, vedi [Ricerca di testo in Amazon CloudSearch](searching-text.md).
\$1 (and)
Sintassi: `+TERM`
Richiede il termine specificato. Per corrispondere, i documenti devono contenere il termine specificato.
Esempio: \$1star
\$1 (escape)
Sintassi: `\CHAR`
Aggiunge caratteri di escape ai caratteri speciali che si desidera cercare. Perché facciano parte della query, ai seguenti caratteri è necessario aggiungere caratteri di escape: \$1 - & \$1 \$1 ( ) \$1 \$1 [ ] ^ " \$1 \$1 ? : \$1 /.
Ad esempio: `M\*A\*S\*H`
\$1 (fuzzy)
Sintassi: `TERM~N`
Esegue una ricerca fuzzy. Aggiungere l'operatore \$1 e un valore a un termine per indicare in che misura i termini possono differire ed essere considerati comunque una corrispondenza.
Ad esempio: `stor~1`
\$1 (near)
Sintassi: `"PHRASE"~N`
Esegue una ricerca di frasi simili. Aggiungere l'operatore \$1 e un valore a un periodo per indicare quanto possono essere distanti tra loro i termini ed essere considerati comunque una corrispondenza per il periodo.
Ad esempio: `"star wars"~4`
- (not)
Sintassi: `-TERM`
Vieta il termine specificato. Per corrispondere, i documenti non devono contenere il termine specificato.
Esempio: star -wars
\$1 (or)
Sintassi: `|TERM`
Rende opzionale il termine specificato.
Esempio: star \$1wars
"..." (phrase)
Sintassi: `"PHRASE"`
Esegue la ricerca dell'intero periodo. Può essere combinata con l'operatore `~` per eseguire una ricerca di frasi simili.
Esempio: "star wars"
(...) (precedence)
Sintassi: `(...)`
Controlla l'ordine in cui vengono valutati i vincoli di query. Nella valutazione ha la precedenza il contenuto delle parentesi più interne.
Ad esempio: `+(war|trek)+star`
\$1 (prefix)
Sintassi: `CHARS*`
Restituisce i documenti che contengono i termini che includono il prefisso selezionato.
Ad esempio: `sta*`
### Risposta della ricerca
Quando una richiesta riesce, il corpo della risposta contiene i risultati della ricerca. Per impostazione predefinita, i risultati della ricerca vengono restituiti in formato JSON. Se il parametro `format` è impostato su `xml`, i risultati della ricerca vengono restituiti in formato XML.
A meno che non si specifichi in modo esplicito il parametro `return`, per ogni documento corrispondente (occorrenza) sono inclusi l'ID documento e tutti i campi restituibili. La risposta mostra anche il numero totale di occorrenze trovate (`found`) e l'indice del primo documento elencato (`start`). Per impostazione predefinita, la risposta contiene le prime 10 occorrenze. È possibile specificare il parametro `size` nella richiesta per controllare la quantità di occorrenze incluse in ogni risposta. Per scorrere le occorrenze, è possibile utilizzare il parametro `start` o `cursor`. Per ulteriori informazioni, consulta [Scorrere le pagine dei risultati](paginating-results.md).
Il seguente esempio mostra una tipica risposta in formato JSON:
```
{
"status": {
"rid": "rtKz7rkoeAojlvk=",
"time-ms": 10
},
"hits": {
"found": 3,
"start": 0,
"hit": [
{
"id": "tt1142977",
"fields": {
"rating": "6.9",
"genres": [
"Animation",
"Comedy",
"Family",
"Horror",
"Sci-Fi"
],
"plot": "Young Victor conducts a science experiment to
bring his beloved dog Sparky back to life, only
to face unintended, sometimes monstrous,
consequences.",
"release_date": "2012-09-20T00:00:00Z",
"title": "Frankenweenie",
"rank": "1462",
"running_time_secs": "5220",
"directors": [
"Tim Burton"
],
"image_url": "http://ia.media-imdb.com/images/M/MV5BMjIx
ODY3MjEwNV5BMl5BanBnXkFtZTcwOTMzNjc4Nw@@._
V1_SX400_.jpg",
"year": "2012",
"actors": [
"Winona Ryder",
"Catherine O'Hara",
"Martin Short"
]
}
},
.
.
.
]
}
}
```
L'esempio seguente mostra la risposta XML equivalente.
```
6.9
Animation
Comedy
Family
Horror
Sci-Fi
Young Victor conducts a science experiment to
bring his beloved dog Sparky back to life, only
to face unintended, sometimes monstrous,
consequences.
2012-09-20T00:00:00Z
Frankenweenie
1462
5220
Tim Burton
http://ia.media-imdb.com/images/M/MV5BMjI
xODY3MjEwNV5BMl5BanBnXkFtZTcwOTMzNjc4Nw@@.
_V1_SX400_.jpg
2012
Winona Ryder
Catherine O'Hara
Martin Short
.
.
.
```
L'impostazione del formato della risposta interessa solo le risposte alle richieste riuscite. Il formato di una risposta di errore dipende dall'origine dell'errore. Gli errori restituiti dal servizio di ricerca vengono sempre restituiti in JSON. Gli errori 5xx dovuti a timeout del server e ad altri problemi di routing delle richieste vengono restituiti in XML. Quando una richiesta restituisce un codice di errore, il corpo della risposta contiene informazioni sull'errore che si è verificato. Se si verifica un errore durante l'analisi e la convalida del corpo della richiesta, il codice di errore viene impostato su 400 e il corpo della risposta include un elenco degli errori e del luogo in cui si sono verificati.
#### Intestazioni delle risposte di ricerca
Content-Type
Tipo MIME standard che descrive il formato dei dati oggetto. Per ulteriori informazioni, consultare la [sezione 14 del protocollo RFC 2616 di W3C](http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.17).
Valori validi: o application/json application/xml
Predefinito: application/json
Content-Length
La lunghezza in byte del corpo della risposta.
#### Proprietà della risposta della ricerca (JSON)
status
Contiene l'id di risorsa (rid) e il tempo impiegato per elaborare la richiesta (time-ms).
rid
L'ID di risorsa crittografato.
time-ms
Il tempo impiegato per elaborare la richiesta di ricerca in millisecondi.
hits
Contiene il numero di documenti corrispondenti (`found`), l'indice del primo documento incluso nella risposta (`start`) e un array (`hit`) che elenca il documento IDs e i dati per ogni risultato.
found
Il numero totale di risultati che corrispondono alla richiesta di ricerca dopo che Amazon CloudSearch ha terminato l'elaborazione della richiesta.
start
L'indice della prima occorrenza restituita in questa risposta.
hit
Un array che elenca il documento IDs e i dati per ogni risultato.
id
L'identificatore univoco per un documento.
fields
Elenco di campi restituiti.
facets
Contiene i conteggi dei facet e le relative informazioni.
FACETFIELD
Campo per il quale sono stati calcolati i facet.
buckets
Serie di valori e conteggi di facet.
value
Il valore del facet conteggiato.
count
Il numero di occorrenze che contengono il valore del facet in `FACETFIELD`.
#### Elementi della risposta di ricerca (XML)
results
Contiene i risultati di ricerca. Qualsiasi errore che si verifichi durante l'elaborazione della richiesta viene restituito come messaggio nell'elemento delle informazioni.
status
Contiene l'id di risorsa (`rid`) e il tempo impiegato per elaborare la richiesta (`time-ms`).
hits
Contiene le statistiche delle occorrenze e una raccolta di elementi occorrenza. L'attributo found è il numero totale di risultati che corrispondono alla richiesta di ricerca dopo che Amazon CloudSearch ha terminato l'elaborazione dei risultati. Gli elementi occorrenza vengono ordinati in base al relativo punteggio di rilevanza o all'opzione `sort` specificata nella richiesta di ricerca.
hit
Documento che corrisponde alla richiesta di ricerca. L'attributo id è l'id univoco del documento. Contiene un elemento `d` (dati) per ciascun campo restituito.
field
Un campo restituito da un'occorrenza. Gli elementi occorrenza `d` (dati) per ciascun campo restituito.
facets
Contiene un elemento facet per ogni facet richiesto nella richiesta di ricerca.
facet
Contiene un elemento bucket per ciascun valore di un campo per il quale è stato calcolato un conteggio di facet. È possibile utilizzare l'opzione di dimensione `facet.FIELD` per specificare il numero di vincoli da restituire. Per impostazione predefinita, i conteggi dei facet vengono restituiti per i primi 10 vincoli. L'opzione dei bucket `facet.FIELD` consente di specificare esplicitamente i valori da contare.
bucket
Valore di un campo facet e il numero di occorrenze (conteggio) di tale valore all'interno delle occorrenze di ricerca.
## Invio di richieste di suggerimenti in Amazon CloudSearch
È possibile inviare le richieste tramite HTTP GET all'endpoint di ricerca del tuo dominio in `2013-01-01/suggest`. Per informazioni su come controllare l'accesso al servizio di suggerimenti, vedi [Configurazione di Access per Amazon CloudSearch](configuring-access.md).
In tutte le richieste di suggerimento è necessario specificare la versione API e indicare che deve corrispondere alla versione API specificata al momento della creazione del dominio.
Ad esempio, la seguente richiesta ottiene suggerimenti dal dominio `search-movies-rr2f34ofg56xneuemujamut52i.us-east-1.cloudsearch.amazonaws.com` per la stringa di query `oce` utilizzando il suggeritore denominato `title`.
```
http://search-imdb-hd6ebyouhw2lczkueyuqksnuzu.us-west-2.cloudsearch.amazonaws.com/2013-01-01/suggest -d"q=oce&suggester=suggest_title"
```
Puoi utilizzare qualsiasi metodo desideri per inviare richieste GET all'endpoint di ricerca del tuo dominio: puoi inserire l'URL della richiesta direttamente in un browser Web, utilizzare cURL per inviare la richiesta o generare una chiamata HTTP utilizzando la tua libreria HTTP preferita. Puoi anche utilizzare Search Tester nella CloudSearch console Amazon per ricevere suggerimenti. Per ulteriori informazioni, consulta [Ricerca con il test di ricerca](getting-started-search.md#searching-console).
**Importante**
Gli endpoint di ricerca e il documento di un dominio rimangono invariati per tutta la durata del dominio. Dovresti memorizzare gli endpoint nella cache invece di recuperarli prima di ciascuna richiesta di ricerca o caricamento. È probabile che interrogare il servizio di CloudSearch configurazione Amazon chiamando `aws cloudsearch describe-domains` o `DescribeDomains` prima di ogni richiesta comporti una limitazione delle richieste.
Per impostazione predefinita, Amazon CloudSearch restituisce la risposta in JSON. Puoi ottenere i risultati in formato XML specificando il parametro `format`, `format=xml`. L'impostazione del formato della risposta interessa solo le risposte alle richieste riuscite. Il formato di una risposta di errore dipende dall'origine dell'errore. Gli errori restituiti dal servizio di ricerca vengono sempre restituiti in JSON. Gli errori 5xx dovuti a timeout del server e ad altri problemi di routing delle richieste vengono restituiti in XML.
## Suggerimento
### Richieste di suggerimento
#### Suggerisci la sintassi in Amazon CloudSearch
```
GET /2013-01-01/suggest
```
#### Suggerisci intestazioni di richiesta in Amazon CloudSearch
HOST
L'endpoint delle richieste di ricerca per il dominio sottoposto a query. Puoi utilizzare [DescribeDomains](API_DescribeDomains.md) per recuperare l'endpoint delle richieste di ricerca del dominio.
Obbligatorio: sì
#### Suggerisci parametri di richiesta in Amazon CloudSearch
q
La stringa per la quale ottenere i suggerimenti.
Tipo: stringa
Obbligatorio: sì
suggester
Il nome del suggeritore da utilizzare per trovare le corrispondenze suggerite.
Tipo: stringa
Obbligatorio: sì
size
Il numero massimo di suggerimenti da restituire.
Tipo: numero intero positivo
Impostazione predefinita: 10
Obbligatorio: no
format
Specifica il tipo di contenuti della risposta.
Tipo: String
Valori validi: json\$1xml
Impostazione predefinita: json
Obbligatorio: no
### Risposta del suggerimento
Quando una richiesta riesce, il corpo della risposta contiene i suggerimenti. Per impostazione predefinita, i suggerimenti vengono restituiti in formato JSON. Puoi ottenere i risultati in formato XML impostando il parametro `format` su `xml`.
L'impostazione del formato della risposta interessa solo le risposte alle richieste riuscite. Il formato di una risposta di errore dipende dall'origine dell'errore. Gli errori restituiti dal servizio di ricerca vengono sempre restituiti in JSON. Gli errori 5xx dovuti a timeout del server e ad altri problemi di routing delle richieste vengono restituiti in XML. Quando una richiesta restituisce un codice di errore, il corpo della risposta contiene informazioni sull'errore che si è verificato. Se si verifica un errore durante l'analisi e la convalida del corpo della richiesta, il codice di errore viene impostato su 400 e il corpo della risposta include un elenco degli errori e del luogo in cui si sono verificati.
L'esempio seguente mostra una risposta in formato JSON a una richiesta di suggerimenti.
```
{
"status": {
"rid": "qOSM5s0oCwr8pVk=",
"time-ms": 2
},
"suggest": {
"query": "oce",
"found": 3,
"suggestions": [
{
"suggestion": "Ocean's Eleven",
"score": 0,
"id": "tt0054135"
},
{
"suggestion": "Ocean's Thirteen",
"score": 0,
"id": "tt0496806"
},
{
"suggestion": "Ocean's Twelve",
"score": 0,
"id": "tt0349903"
}
]
}
}
```
L'esempio seguente mostra la risposta XML equivalente:
```