StartCallAnalyticsJob

Un nome univoco, scelto da te, per il tuo lavoro di analisi delle chiamate.

Questo nome fa distinzione tra maiuscole e minuscole, non può contenere spazi e deve essere univoco all'interno di unAccount AWS. Se si tenta di creare un nuovo lavoro con lo stesso nome di un lavoro esistente, viene visualizzato unConflictException errore.

Tipo: String

Limitazioni di lunghezza: lunghezza minima di 1. Lunghezza massima di 200.

Pattern: ^[0-9a-zA-Z._-]+

Campo obbligatorio: sì

Consente di specificare quale altoparlante si trova su quale canale. Ad esempio, se il tuo agente è il primo partecipante a parlare, dovresti impostare su0 (ChannelIdper indicare il primo canale) eParticipantRole suAGENT (per indicare che è l'agente che parla).

Tipo: matrice di oggetti ChannelDefinition

Membri dell'array: numero minimo di 2 elementi.

Required: No

Il nome della risorsa Amazon Resource Name (ARN) di un ruolo IAM con le autorizzazioni per accedere al bucket Amazon S3 che contiene i file di input. Se il ruolo specificato non dispone delle autorizzazioni appropriate per accedere alla posizione Amazon S3 specificata, la richiesta ha esito negativo.

Gli ARN del ruolo IAM hanno il formatoarn:partition:iam::account:role/role-name-with-path. Ad esempio: arn:aws:iam::111122223333:role/Admin.

Per ulteriori informazioni, consulta ARN IAM.

Tipo: String

Limitazioni di lunghezza: lunghezza minima di 20. La lunghezza massima è 2048 caratteri.

Modello: ^arn:(aws|aws-cn|aws-us-gov|aws-iso-{0,1}[a-z]{0,1}):iam::[0-9]{0,63}:role/[A-Za-z0-9:_/+=,@.-]{0,1024}$

Required: No

Descrive la posizione Amazon S3 del file multimediale che desideri utilizzare nella tua richiesta di analisi delle chiamate.

Tipo: Media oggetto

Campo obbligatorio: sì

La chiave KMS che desideri utilizzare per crittografare l'output di Call Analytics.

Se usi una chiave che si trova nella correnteAccount AWS, puoi specificare la tua chiave KMS in quattro modi:

Se usi una chiave che si trova in una posizione Account AWSdiversa da quella attualeAccount AWS, puoi specificare la tua chiave KMS in due modi:

Se non si specifica una chiave di crittografia, l'output viene crittografato con la chiave Amazon S3 (SSE-S3).

Se si specifica una chiave KMS per crittografare l'output, è necessario specificare anche una posizione di output utilizzando ilOutputLocation parametro.

Si noti che il ruolo che effettua laStartCallAnalyticsJob richiesta deve disporre dell'autorizzazione per utilizzare la chiave KMS specificata.

Tipo: String

Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 2048 caratteri.

Modello: ^[A-Za-z0-9][A-Za-z0-9:_/+=,@.-]{0,2048}$

Required: No

La posizione di Amazon S3 in cui si desidera memorizzare l'output della trascrizione di Call Analytics. È possibile utilizzare uno dei seguenti formati per specificare la posizione di output:

A meno che non si specifichi un nome di file (opzione 3), il nome del file di output ha un valore predefinito che corrisponde al nome specificato per il processo di trascrizione utilizzando ilCallAnalyticsJobName parametro.

È possibile specificare una chiave KMS per crittografare l'output utilizzando ilOutputEncryptionKMSKeyId parametro. Se non si specifica una chiave KMS, Amazon Transcribe utilizza la chiave Amazon S3 per la crittografia lato server.

Se non lo specifichiOutputLocation, la trascrizione viene inserita in un bucket Amazon S3 gestito dal servizio e ti viene fornito un URI per accedere alla trascrizione.

Tipo: String

Limitazioni di lunghezza: lunghezza minima di 1. Lunghezza massima di 2000.

Modello: (s3://|http(s*)://).+

Required: No

Specifica impostazioni opzionali aggiuntive nella tuaStartCallAnalyticsJob richiesta, inclusa la redazione dei contenuti; ti consente di applicare modelli linguistici personalizzati, filtri di vocabolario e vocabolari personalizzati al tuo lavoro di analisi delle chiamate.

Tipo: CallAnalyticsJobSettings oggetto

Required: No

Fornisce informazioni dettagliate sull'attuale job di Call Analytics, incluso lo stato del processo e, se applicabile, il motivo dell'errore.

Tipo: CallAnalyticsJob oggetto

La tua richiesta non ha superato uno o più test di convalida. Ciò può verificarsi quando l'entità che stai cercando di eliminare non esiste o se si trova in uno stato non terminale (ad esempioIN PROGRESS). Per ulteriori informazioni, consulta il campo del messaggio di eccezione.

Codice di stato HTTP: 400

Esiste già una risorsa con questo nome. I nomi delle risorse devono essere univoci all'interno diAccount AWS.

Codice di stato HTTP: 400

Si è verificato un errore. Controlla il messaggio di errore, correggi il problema e riprova con la richiesta.

Codice di stato HTTP: 500

Hai inviato troppe richieste o il file di input è troppo lungo. Attendi prima di riprovare la richiesta oppure utilizza un file più piccolo e riprova la richiesta.

Codice di stato HTTP: 400