CreateStream - Amazon Kinesis Video Streams

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

CreateStream

Crea un nuovo flusso video Kinesis.

Quando crei un nuovo flusso, Kinesis Video Streams assegna un numero di versione. Quando modificate i metadati del flusso, Kinesis Video Streams aggiorna la versione.

CreateStreamè un'operazione asincrona.

Per ulteriori informazioni sul funzionamento del servizio, consultaCome funziona.

È necessario avere le autorizzazioni perKinesisVideo:CreateStreamOperazione .

Sintassi della richiesta

POST /createStream HTTP/1.1 Content-type: application/json { "DataRetentionInHours": number, "DeviceName": "string", "KmsKeyId": "string", "MediaType": "string", "StreamName": "string", "Tags": { "string" : "string" } }

Parametri della richiesta URI:

La richiesta non utilizza parametri URI.

Corpo della richiesta

La richiesta accetta i seguenti dati in formato JSON.

DataRetentionInHours

Il numero di ore in cui si desidera conservare i dati nel flusso. Kinesis Video Streams conserva i dati in un archivio dati associato allo stream.

Il valore predefinito è 0, a indicare che il flusso non persiste i dati.

QuandoDataRetentionInHoursvalore è 0, i consumatori possono ancora consumare i frammenti che rimangono nel buffer dell'host del servizio, che ha un limite di tempo di conservazione di 5 minuti e un limite di memoria di conservazione di 200 MB. I frammenti vengono rimossi dal buffer quando viene raggiunto uno dei limiti.

Type: Numero intero

Intervallo valido: Il valore minimo pari a 0.

: campo obbligatorio No

DeviceName

Il nome del dispositivo che sta scrivendo nel flusso.

Nota

Nell'attuale implementazione, Kinesis Video Streams non usa questo nome.

Type: Stringa

Vincoli della lunghezza: Lunghezza minima pari a 1. La lunghezza massima è 128 caratteri.

Modello: [a-zA-Z0-9_.-]+

: campo obbligatorio No

KmsKeyId

L'ID delAWS Key Management Service(AWS KMS) chiave che si desidera che Kinesis Video Streams utilizzi per crittografare i dati di flusso.

Se non viene specificato alcun ID della chiave, la chiave predefinita gestita da Kinesis Video (aws/kinesisvideo) viene utilizzato.

Per ulteriori informazioni, consultaDescribeKey.

Type: Stringa

Vincoli della lunghezza: Lunghezza minima pari a 1. La lunghezza massima è 2048 caratteri.

Modello: .+

: campo obbligatorio No

MediaType

Il tipo di supporto dello stream. I consumatori dello stream possono utilizzare queste informazioni durante l'elaborazione del flusso. Per ulteriori informazioni sui tipi di supporti, consultaTipi di supporti. Se si sceglie di specificare ilMediaType, consultaRequisiti di denominazioneper linee guida.

Esempi di valori validi includono «video/h264" e «video/h264, audio/aac».

Questo parametro è facoltativo; il valore predefinito ènull(o vuoto in JSON).

Type: Stringa

Vincoli della lunghezza: Lunghezza minima pari a 1. La lunghezza massima è 128 caratteri.

Modello: [\w\-\.\+]+/[\w\-\.\+]+(,[\w\-\.\+]+/[\w\-\.\+]+)*

: campo obbligatorio No

StreamName

Un nome per lo stream che stai creando.

Il nome del flusso è un identificatore del flusso e deve essere univoco per ogni account e regione.

Type: Stringa

Vincoli della lunghezza: Lunghezza minima pari a 1. La lunghezza massima è 256 caratteri.

Modello: [a-zA-Z0-9_.-]+

: campo obbligatorio Sì

Tags

Un elenco di tag da associare allo stream specificato. Ogni tag è una coppia chiave-valore (il valore è facoltativo).

Type: mappatura stringa a stringa

Voci mappa: Numero massimo di 50 item.

Vincoli della lunghezza della chiave: Lunghezza minima pari a 1. La lunghezza massima è 128 caratteri.

Modello di chiave:^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$

Vincoli della lunghezza valore: Lunghezza minima 0. La lunghezza massima è 256 caratteri.

Pattern valore:[\p{L}\p{Z}\p{N}_.:/=+\-@]*

: campo obbligatorio No

Sintassi della risposta

HTTP/1.1 200 Content-type: application/json { "StreamARN": "string" }

Elementi di risposta

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

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

StreamARN

L'Amazon Resource Name (ARN) del flusso.

Type: Stringa

Vincoli della lunghezza: Lunghezza minima pari a 1. La lunghezza massima è 1024 caratteri.

Modello: arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+

Errori

Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.

AccountStreamLimitExceededException

Il numero di flussi creati per l'account è troppo alto.

Codice di stato HTTP: 400

ClientLimitExceededException

Kinesis Video Streams ha limitato la richiesta perché hai superato il limite delle chiamate client consentite. Prova a effettuare la chiamata più tardi.

Codice di stato HTTP: 400

DeviceStreamLimitExceededException

Non ancora disponibile.

Codice di stato HTTP: 400

InvalidArgumentException

Il valore di questo parametro di input non è valido.

Codice di stato HTTP: 400

InvalidDeviceException

Non ancora disponibile.

Codice di stato HTTP: 400

ResourceInUseException

La risorsa non è attualmente disponibile per questa operazione. Non è possibile creare nuove risorse con lo stesso nome delle risorse esistenti. Inoltre, le risorse non possono essere aggiornate o eliminate a meno che non si trovino in unACTIVEstato.

Se viene restituita questa eccezione, non utilizzarla per determinare se la risorsa richiesta esiste già. Invece, si consiglia di utilizzare l'API di descrizione specifica delle risorse, ad esempioDescribeStreamper flussi video.

Codice di stato HTTP: 400

TagsPerResourceExceededLimitException

Hai superato il limite di tag che è possibile associare alla risorsa. Un flusso video Kinesis può supportare fino a 50 tag.

Codice di stato HTTP: 400

Vedi anche

Per ulteriori informazioni sull'utilizzo di questa API in uno degli SDK AWS specifici della lingua, consulta quanto segue: