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 al flusso un numero di versione. Quando modifichi i metadati del flusso, Kinesis Video Streams aggiorna la versione.
CreateStream è un'operazione asincrona.
Per ulteriori informazioni sul funzionamento del servizio, consulta Come funziona.
È necessario avere le autorizzazioni per l'operazione KinesisVideo:CreateStream.
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"
}
}URIParametri della richiesta
La richiesta non utilizza alcun URI parametro.
Corpo della richiesta
La richiesta accetta i seguenti dati nel JSON formato.
- DataRetentionInHours
-
Il numero di ore in cui desideri conservare i dati nello stream. Kinesis Video Streams mantiene i dati in un archivio dati associato al flusso.
Il valore predefinito è 0, che indica che il flusso non conserva i dati. Il minimo è 1 ora.
Quando il
DataRetentionInHoursvalore è 0, i consumatori possono comunque 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 due limiti.Tipo: integer
Intervallo valido: valore minimo di 0.
Campo obbligatorio: no
- DeviceName
-
Il nome del dispositivo che sta scrivendo nello stream.
Nota
Nell'implementazione corrente, Kinesis Video Streams non utilizza questo nome.
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 128 caratteri.
Modello:
[a-zA-Z0-9_.-]+Campo obbligatorio: no
- KmsKeyId
-
L'ID della chiave AWS Key Management Service (AWS KMS) che desideri che Kinesis Video Streams utilizzi per crittografare i dati di streaming.
Se non viene specificato alcun ID di chiave, viene utilizzata la chiave predefinita, gestita da Kinesis Video ()
AWS/kinesisvideo.Per ulteriori informazioni, consulta. DescribeKey
Tipo: stringa
Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 2048 caratteri.
Modello:
.+Campo obbligatorio: no
- MediaType
-
Il tipo di file multimediale dello stream. Gli utenti dello stream possono utilizzare queste informazioni durante l'elaborazione dello stream. Per ulteriori informazioni sui tipi di file multimediali, consulta Tipi di file multimediali
. Se scegli di specificare il MediaType, consulta Requisiti di denominazione per lelinee guida. I valori validi di esempio includono "video/h264" and "video/h264,audio/aac».
Questo parametro è facoltativo; il valore predefinito è
null(o è vuotoJSON).Tipo: stringa
Limitazioni di 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 dello stream è un identificatore dello stream e deve essere univoco per ogni account e regione.
Tipo: stringa
Limitazioni di 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 è opzionale).
Tipo: mappatura stringa a stringa
Voci sulla mappa: numero massimo di 50 elementi.
Limitazioni di lunghezza della chiave: la lunghezza minima è 1. La lunghezza massima è 128 caratteri.
Modello di chiave:
^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$Limiti di lunghezza del valore: lunghezza minima di 0. La lunghezza massima è 256 caratteri.
Modello di 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'azione ha esito positivo, il servizio restituisce una risposta di HTTP 200.
I seguenti dati vengono restituiti in JSON formato dal servizio.
- StreamARN
-
L'Amazon Resource Name (ARN) dello stream.
Tipo: stringa
Limitazioni di 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 stream creati per l'account è troppo alto.
HTTPCodice di stato: 400
- ClientLimitExceededException
-
Kinesis Video Streams ha limitato la richiesta perché è stato superato il limite di chiamate client consentite. Prova a effettuare la chiamata più tardi.
HTTPCodice di stato: 400
- DeviceStreamLimitExceededException
-
Non ancora disponibile.
HTTPCodice di stato: 400
- InvalidArgumentException
-
Il valore di questo parametro di input non è valido.
HTTPCodice di stato: 400
- InvalidDeviceException
-
Non ancora disponibile.
HTTPCodice di stato: 400
- ResourceInUseException
-
Quando l'ingresso
StreamARNoChannelARNl'ingressoCLOUD_STORAGE_MODEsono già mappati su un'altra risorsa Kinesis Video Stream, o se l'StreamARNingresso fornitoChannelARNo non è nello stato Attivo, prova una delle seguenti soluzioni:-
Il
DescribeMediaStorageConfigurationAPI per determinare a cosa è mappato lo stream a cui è mappato un determinato canale. -
Il
DescribeMappedResourceConfigurationAPI per determinare il canale su cui è mappato lo stream specificato. -
L'
DescribeStreamoDescribeSignalingChannelAPI per determinare lo stato della risorsa.
HTTPCodice di stato: 400
-
- TagsPerResourceExceededLimitException
-
Hai superato il limite di tag che puoi associare alla risorsa. Uno stream video Kinesis può supportare fino a 50 tag.
HTTPCodice di stato: 400
Vedi anche
Per ulteriori informazioni sull'utilizzo API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
