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à.
# Trascrizione con AWS CLI
Quando si utilizza AWS CLI per avviare una trascrizione, è possibile eseguire tutti i comandi a livello di CLI. Oppure puoi eseguire il comando che desideri utilizzare, seguito dall’ Regione AWS e dalla posizione di un file JSON che contiene il corpo della richiesta. Gli esempi di questa guida mostrano entrambi i metodi; tuttavia, questa sezione si concentra sul metodo precedente.
Non AWS CLI supporta le trascrizioni in streaming.
Prima di continuare, assicurati che:
+ Hai caricato il tuo file multimediale in un Amazon S3 bucket. Se non sei sicuro di come creare un Amazon S3 bucket o caricare il tuo file, consulta [Creare il tuo primo Amazon S3 bucket e [Caricare un oggetto](https://docs.aws.amazon.com/AmazonS3/latest/userguide/uploading-an-object-bucket.html) nel tuo bucket](https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-bucket.html).
+ [AWS CLI](getting-started.md#getting-started-api) installato.
[Puoi trovare tutti i AWS CLI comandi per Amazon Transcribe nel Command Reference.AWS CLI](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/transcribe/index.html#cli-aws-transcribe)
## Avvio di un nuovo processo di trascrizione
Per iniziare una nuova trascrizione, utilizza il comando `start-transcription-job`.
1. In una finestra del terminale, scrivi quanto riportato qui sotto:
```
aws transcribe start-transcription-job \
```
Nella riga successiva comparirà un “`>`” e ora puoi continuare ad aggiungere i parametri richiesti, come descritto nel passaggio successivo.
Puoi anche omettere “`\`” e aggiungere tutti i parametri, separandoli con uno spazio.
1. Con il comando `start-transcription-job`, è necessario includere`region`, `transcription-job-name` `media`, e `language-code` oppure `identify-language`.
Se desideri specificare una posizione di output, includi `output-bucket-name` nella richiesta; se desideri specificare una sottocartella del bucket di output specificato, includi anche `output-key`.
```
aws transcribe start-transcription-job \
--region us-west-2 \
--transcription-job-name my-first-transcription-job \
--media MediaFileUri=s3://amzn-s3-demo-bucket/my-input-files/my-media-file.flac \
--language-code en-US
```
Se si aggiungono tutti i parametri, questa richiesta ha il seguente aspetto:
```
aws transcribe start-transcription-job --region us-west-2 --transcription-job-name my-first-transcription-job --media MediaFileUri=s3://amzn-s3-demo-bucket/my-input-files/my-media-file.flac --language-code en-US
```
Se scegli di non specificare un bucket di output utilizzando `output-bucket-name`, Amazon Transcribe inserirà l'output della trascrizione in un bucket gestito dal servizio. Le trascrizioni archiviate in un bucket gestito dal servizio scadono dopo 90 giorni.
Amazon Transcribe risponde con:
```
{
"TranscriptionJob": {
"TranscriptionJobName": "my-first-transcription-job",
"TranscriptionJobStatus": "IN_PROGRESS",
"LanguageCode": "en-US",
"Media": {
"MediaFileUri": "s3://amzn-s3-demo-bucket/my-input-files/my-media-file.flac"
},
"StartTime": "2022-03-07T15:03:44.246000-08:00",
"CreationTime": "2022-03-07T15:03:44.229000-08:00"
}
}
```
Il tuo processo di trascrizione ha esito positivo se lo [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_TranscriptionJob.html#transcribe-Type-TranscriptionJob-TranscriptionJobStatus](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_TranscriptionJob.html#transcribe-Type-TranscriptionJob-TranscriptionJobStatus) passa da `IN_PROGRESS` a `COMPLETED`. Per visualizzare lo [https://docs.aws.amazon.com/transcribe/latest/APIReference/API_TranscriptionJob.html#transcribe-Type-TranscriptionJob-TranscriptionJobStatus](https://docs.aws.amazon.com/transcribe/latest/APIReference/API_TranscriptionJob.html#transcribe-Type-TranscriptionJob-TranscriptionJobStatus) aggiornato, utilizza il comando `get-transcription-job` o `list-transcription-job`, come illustrato nella sezione seguente.
## Ottenere lo stato di un processo di trascrizione
Come ottenere informazioni sul processo di trascrizione utilizzando il comando`get-transcription-job`.
Gli unici parametri richiesti per questo comando sono la Regione AWS posizione del processo e il nome del processo.
```
aws transcribe get-transcription-job \
--region us-west-2 \
--transcription-job-name my-first-transcription-job
```
Amazon Transcribe risponde con:
```
{
"TranscriptionJob": {
"TranscriptionJobName": "my-first-transcription-job",
"TranscriptionJobStatus": "COMPLETED",
"LanguageCode": "en-US",
"MediaSampleRateHertz": 48000,
"MediaFormat": "flac",
"Media": {
"MediaFileUri": "s3://amzn-s3-demo-bucket/my-input-files/my-media-file.flac"
},
"Transcript": {
"TranscriptFileUri": "https://s3.the-URI-where-your-job-is-located.json"
},
"StartTime": "2022-03-07T15:03:44.246000-08:00",
"CreationTime": "2022-03-07T15:03:44.229000-08:00",
"CompletionTime": "2022-03-07T15:04:01.158000-08:00",
"Settings": {
"ChannelIdentification": false,
"ShowAlternatives": false
}
}
}
```
Se hai selezionato il tuo Amazon S3 bucket per l'output della trascrizione, questo bucket è elencato con. `TranscriptFileUri` Se hai selezionato un bucket gestito dal servizio, verrà fornito un URI temporaneo; usa questo URI per scaricare la trascrizione.
**Nota**
I Amazon S3 bucket temporanei URIs per la gestione del servizio sono validi solo per 15 minuti. Se ricevi un errore di `AccesDenied` durante l'utilizzo dell'URI, esegui nuovamente la richiesta `get-transcription-job` per ottenere un nuovo URI temporaneo.
## Elenco dei tuoi processi di trascrizione
Per elencare tutti i tuoi lavori di trascrizione in un determinato periodo Regione AWS, usa il comando. `list-transcription-jobs`
L'unico parametro richiesto per questo comando è il luogo Regione AWS in cui si trovano i lavori di trascrizione.
```
aws transcribe list-transcription-jobs \
--region us-west-2
```
Amazon Transcribe risponde con:
```
{
"NextToken": "A-very-long-string",
"TranscriptionJobSummaries": [
{
"TranscriptionJobName": "my-first-transcription-job",
"CreationTime": "2022-03-07T15:03:44.229000-08:00",
"StartTime": "2022-03-07T15:03:44.246000-08:00",
"CompletionTime": "2022-03-07T15:04:01.158000-08:00",
"LanguageCode": "en-US",
"TranscriptionJobStatus": "COMPLETED",
"OutputLocationType": "SERVICE_BUCKET"
}
]
}
```
## Elenco del tuo processo di trascrizione
Per eliminare il processo di trascrizione, utilizzare il comando `delete-transcription-job`.
Gli unici parametri richiesti per questo comando sono la Regione AWS posizione del processo e il nome del lavoro.
```
aws transcribe delete-transcription-job \
--region us-west-2 \
--transcription-job-name my-first-transcription-job
```
Per confermare che la richiesta di eliminazione sia andata a buon fine, puoi eseguire il comando `list-transcription-jobs`. Il processo non dovrebbe più comparire nell'elenco.