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](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/how-it-works.html). È 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", "StreamStorageConfiguration": { "DefaultStorageTier": "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](#API_CreateStream_RequestSyntax) ** 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 `DataRetentionInHours` valore è 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: numero intero Intervallo valido: valore minimo di 0. Obbligatorio: no ** [DeviceName](#API_CreateStream_RequestSyntax) ** Il nome del dispositivo che sta scrivendo nello stream. Nell'implementazione corrente, Kinesis Video Streams non utilizza questo nome. Tipo: String Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 128 caratteri. Modello: `[a-zA-Z0-9_.-]+` Obbligatorio: no ** [KmsKeyId](#API_CreateStream_RequestSyntax) ** 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](https://docs.aws.amazon.com/kms/latest/APIReference/API_DescribeKey.html#API_DescribeKey_RequestParameters). Tipo: String Limitazioni di lunghezza: lunghezza minima di 1. La lunghezza massima è 2048 caratteri. Modello: `.+` Obbligatorio: no ** [MediaType](#API_CreateStream_RequestSyntax) ** 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](http://www.iana.org/assignments/media-types/media-types.xhtml). Se scegli di specificare il`MediaType`, consulta [Requisiti di denominazione per le](https://tools.ietf.org/html/rfc6838#section-4.2) linee guida. I valori validi di esempio includono "video/h264" and "video/h264,audio/aac». Questo parametro è facoltativo; il valore predefinito è `null` (o vuoto in JSON). Tipo: String Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 128 caratteri. Modello: `[\w\-\.\+]+/[\w\-\.\+]+(,[\w\-\.\+]+/[\w\-\.\+]+)*` Obbligatorio: no ** [StreamName](#API_CreateStream_RequestSyntax) ** 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: String Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 256 caratteri. Modello: `[a-zA-Z0-9_.-]+` Obbligatorio: sì ** [StreamStorageConfiguration](#API_CreateStream_RequestSyntax) ** La configurazione per l'archiviazione dello stream, incluso il livello di archiviazione predefinito per i dati dello stream. Questa configurazione determina il modo in cui i dati di flusso vengono archiviati e accessibili, con diversi livelli che offrono diversi livelli di ottimizzazione delle prestazioni e dei costi. Se non specificato, lo stream utilizzerà la configurazione di archiviazione predefinita con HOT tier per prestazioni ottimali. Tipo: oggetto [StreamStorageConfiguration](API_StreamStorageConfiguration.md) Obbligatorio: no ** [Tags](#API_CreateStream_RequestSyntax) ** 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}_.:/=+\-@]*` 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](#API_CreateStream_ResponseSyntax) ** Il nome della risorsa Amazon (ARN) del flusso. Tipo: String 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 [Tipi di errore comuni](CommonErrors.md). ** 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 `StreamARN` o `ChannelARN` l'ingresso `CLOUD_STORAGE_MODE` sono già mappati su un'altra risorsa Kinesis Video Stream, o se l'`StreamARN`ingresso fornito `ChannelARN` o non è nello stato Attivo, prova una delle seguenti soluzioni: 1. L'`DescribeMediaStorageConfiguration`API per determinare a cosa è mappato lo stream di un determinato canale. 1. L'`DescribeMappedResourceConfiguration`API per determinare il canale su cui è mappato lo stream specificato. 1. L'`DescribeStream`o l'`DescribeSignalingChannel`API 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 una delle lingue specifiche AWS SDKs, consulta quanto segue: + [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/kinesisvideo-2017-09-30/CreateStream) + [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisvideo-2017-09-30/CreateStream) + [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisvideo-2017-09-30/CreateStream) + [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisvideo-2017-09-30/CreateStream) + [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisvideo-2017-09-30/CreateStream) + [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisvideo-2017-09-30/CreateStream) + [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisvideo-2017-09-30/CreateStream) + [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisvideo-2017-09-30/CreateStream) + [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/kinesisvideo-2017-09-30/CreateStream) + [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisvideo-2017-09-30/CreateStream)