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.
Quando
DataRetentionInHoursvalore è 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 il MediaType, 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 un
ACTIVEstato.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 esempio
DescribeStreamper 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:
