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"
}
}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 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.
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" e «video/h264, audio/aac».
Questo parametro è facoltativo; il valore predefinito è (o vuoto in JSON).
null▬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'operazione riesce, il servizio restituisce una risposta HTTP 200.
I dati seguenti vengono restituiti in formato JSON mediante il servizio.
- StreamARN
-
Il nome della risorsa Amazon (ARN) del flusso.
▬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.
Codice di stato HTTP: 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.
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
-
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:-
L'
DescribeMediaStorageConfigurationAPI per determinare a cosa è mappato lo stream di un determinato canale. -
L'
DescribeMappedResourceConfigurationAPI per determinare il canale su cui è mappato lo stream specificato. -
L'
DescribeStreamo l'DescribeSignalingChannelAPI per determinare lo stato della risorsa.
Codice di stato HTTP: 400
-
- TagsPerResourceExceededLimitException
-
Hai superato il limite di tag che puoi associare alla risorsa. Uno stream 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 AWS SDK specifici della lingua, consulta quanto segue:
