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à.

# DescribeVoices
<a name="API_DescribeVoices"></a>

Restituisce l'elenco di voci che sono disponibili per l'uso quando si richiede la sintesi vocale. Ogni voce parla una lingua specificata, è maschile o femminile ed è identificata da un ID, che è la versione ASCII del nome della voce. 

Quando si sintetizza il discorso ( `SynthesizeSpeech` ), si fornisce l'ID vocale per la voce desiderata dall'elenco delle voci restituite da `DescribeVoices`.

Ad esempio, si desidera che l'applicazione per il lettore di notizie legga le notizie in una lingua specifica, ma dando a un utente la possibilità di scegliere la voce. Utilizzando l'operazione `DescribeVoices` è possibile fornire all'utente un elenco di voci disponibili tra cui selezionare.

 È anche possibile specificare un codice della lingua per filtrare le voci disponibili. Se ad esempio si specifica `en-US`, l'operazione restituisce un elenco di tutte le voci disponibili per l'inglese Stati Uniti. 

Questa operazione necessita delle autorizzazioni a eseguire l'operazione `polly:DescribeVoices`.

## Sintassi della richiesta
<a name="API_DescribeVoices_RequestSyntax"></a>

```
GET /v1/voices?Engine=Engine&IncludeAdditionalLanguageCodes=IncludeAdditionalLanguageCodes&LanguageCode=LanguageCode&NextToken=NextToken HTTP/1.1
```

## Parametri della richiesta URI
<a name="API_DescribeVoices_RequestParameters"></a>

La richiesta utilizza i seguenti parametri URI.

 ** [Engine](#API_DescribeVoices_RequestSyntax) **   <a name="polly-DescribeVoices-request-uri-Engine"></a>
Speciifica il motore (`standard`,`neural`, `long-form` or`generative`) utilizzato da Amazon Polly durante l'elaborazione del testo di input per la sintesi vocale.   
Valori validi: `standard | neural | long-form | generative` 

 ** [IncludeAdditionalLanguageCodes](#API_DescribeVoices_RequestSyntax) **   <a name="polly-DescribeVoices-request-uri-IncludeAdditionalLanguageCodes"></a>
Valore booleano che indica se restituire voci bilingue che utilizzano la lingua specificata come lingua aggiuntiva. Ad esempio, se richiedi tutte le lingue che usano l'inglese statunitense (es-US) e c'è una voce italiana che parla sia italiano (it-IT) che inglese americano, tale voce verrà inclusa se specifichi `yes` ma non se si specifica `no`.

 ** [LanguageCode](#API_DescribeVoices_RequestSyntax) **   <a name="polly-DescribeVoices-request-uri-LanguageCode"></a>
 Il tag di identificazione della lingua (codice ISO 639 per il nome della lingua-codice paese ISO 3166) per filtrare l'elenco delle voci restituite. Se non specifichi questo parametro facoltativo, vengono restituite tutte le voci disponibili.   
Valori validi: `arb | cmn-CN | cy-GB | da-DK | de-DE | en-AU | en-GB | en-GB-WLS | en-IN | en-US | es-ES | es-MX | es-US | fr-CA | fr-FR | is-IS | it-IT | ja-JP | hi-IN | ko-KR | nb-NO | nl-NL | pl-PL | pt-BR | pt-PT | ro-RO | ru-RU | sv-SE | tr-TR | en-NZ | en-ZA | ca-ES | de-AT | yue-CN | ar-AE | fi-FI | en-IE | nl-BE | fr-BE | cs-CZ | de-CH | en-SG` 

 ** [NextToken](#API_DescribeVoices_RequestSyntax) **   <a name="polly-DescribeVoices-request-uri-NextToken"></a>
Un token di impaginazione opaco restituito dal precedente operazione `DescribeVoices`. Se presente, indica dove continuare l'inserzione.  
Limitazioni di lunghezza: lunghezza minima di 0. Lunghezza massima di 4096.

## Corpo della richiesta
<a name="API_DescribeVoices_RequestBody"></a>

La richiesta non ha un corpo della richiesta.

## Sintassi della risposta
<a name="API_DescribeVoices_ResponseSyntax"></a>

```
HTTP/1.1 200
Content-type: application/json

{
   "NextToken": "string",
   "Voices": [ 
      { 
         "AdditionalLanguageCodes": [ "string" ],
         "Gender": "string",
         "Id": "string",
         "LanguageCode": "string",
         "LanguageName": "string",
         "Name": "string",
         "SupportedEngines": [ "string" ]
      }
   ]
}
```

## Elementi di risposta
<a name="API_DescribeVoices_ResponseElements"></a>

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

 ** [NextToken](#API_DescribeVoices_ResponseSyntax) **   <a name="polly-DescribeVoices-response-NextToken"></a>
Il token di impaginazione da utilizzare nella richiesta successiva per continuare l'elenco delle voci. `NextToken` viene restituito solo se la risposta viene troncata.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima di 0. Lunghezza massima di 4096.

 ** [Voices](#API_DescribeVoices_ResponseSyntax) **   <a name="polly-DescribeVoices-response-Voices"></a>
Un elenco di voci con le loro proprietà.  
Tipo: matrice di oggetti [Voice](API_Voice.md)

## Errori
<a name="API_DescribeVoices_Errors"></a>

 ** InvalidNextTokenException **   
Non NextToken è valido. Verificare che sia stato digitato correttamente, quindi riprovare.  
Codice di stato HTTP: 400

 ** ServiceFailureException **   
Una condizione sconosciuta ha causato un errore di servizio.  
Codice di stato HTTP: 500

## Vedi anche
<a name="API_DescribeVoices_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/polly-2016-06-10/DescribeVoices) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/polly-2016-06-10/DescribeVoices) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/polly-2016-06-10/DescribeVoices) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/polly-2016-06-10/DescribeVoices) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/polly-2016-06-10/DescribeVoices) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/polly-2016-06-10/DescribeVoices) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/polly-2016-06-10/DescribeVoices) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/polly-2016-06-10/DescribeVoices) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/polly-2016-06-10/DescribeVoices) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/polly-2016-06-10/DescribeVoices)