Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés. # CreateStream Crea una nueva transmisión de vídeo de Kinesis. Cuando crea una nueva transmisión, Kinesis Video Streams le asigna un número de versión. Cuando cambia los metadatos de la transmisión, Kinesis Video Streams actualiza la versión. `CreateStream` es una operación asíncrona. Para obtener más información acerca de cómo funciona el servicio, consulte [How it Works](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/how-it-works.html) (Cómo funciona). Debe tener permisos para la acción `KinesisVideo:CreateStream`. ## Sintaxis de la solicitud ``` 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" } } ``` ## Parámetros de solicitud del URI La solicitud no utiliza ningún parámetro de URI. ## Cuerpo de la solicitud La solicitud acepta los siguientes datos en formato JSON. ** [DataRetentionInHours](#API_CreateStream_RequestSyntax) ** El número de horas que desea conservar los datos de la transmisión. Kinesis Video Streams conserva los datos en un almacén de datos que está asociado a la transmisión. El valor predeterminado es 0, lo que indica que el flujo no conserva los datos. El mínimo es de 1 hora. Cuando el `DataRetentionInHours` valor es 0, los consumidores pueden seguir consumiendo los fragmentos que permanecen en el búfer del host del servicio, que tiene un límite de tiempo de retención de 5 minutos y un límite de retención de memoria de 200 MB. Los fragmentos se eliminan del búfer cuando se alcanza cualquiera de los dos límites. Tipo: entero Rango válido: valor mínimo de 0. Obligatorio: no ** [DeviceName](#API_CreateStream_RequestSyntax) ** El nombre del dispositivo que está grabando en la transmisión. En la implementación actual, Kinesis Video Streams no usa este nombre. Tipo: cadena Limitaciones de longitud: longitud mínima de 1. Longitud máxima de 128. Patrón: `[a-zA-Z0-9_.-]+` Obligatorio: no ** [KmsKeyId](#API_CreateStream_RequestSyntax) ** El ID de la clave AWS Key Management Service (AWS KMS) que desea que Kinesis Video Streams utilice para cifrar los datos de la transmisión. Si no se especifica ningún identificador de clave, se utiliza la clave predeterminada gestionada por Kinesis Video ()`aws/kinesisvideo`. Para obtener más información, consulte [DescribeKey](https://docs.aws.amazon.com/kms/latest/APIReference/API_DescribeKey.html#API_DescribeKey_RequestParameters). Tipo: cadena Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 2048 caracteres. Patrón: `.+` Obligatorio: no ** [MediaType](#API_CreateStream_RequestSyntax) ** El tipo de medio de la transmisión. Los consumidores de la transmisión pueden usar esta información al procesar la transmisión. Para obtener más información sobre los tipos de medios, consulte [Tipos de medios](http://www.iana.org/assignments/media-types/media-types.xhtml). Si decide especificarlos`MediaType`, consulte los [requisitos de nomenclatura](https://tools.ietf.org/html/rfc6838#section-4.2) para ver las directrices. Los ejemplos de valores válidos incluyen "video/h264" and "video/h264,audio/aac». Este parámetro es opcional; el valor predeterminado es `null` (o está vacío en JSON). Tipo: cadena Limitaciones de longitud: longitud mínima de 1. Longitud máxima de 128. Patrón: `[\w\-\.\+]+/[\w\-\.\+]+(,[\w\-\.\+]+/[\w\-\.\+]+)*` Obligatorio: no ** [StreamName](#API_CreateStream_RequestSyntax) ** Un nombre para la transmisión que está creando. El nombre de la transmisión es un identificador de la transmisión y debe ser único para cada cuenta y región. Tipo: cadena Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 256 caracteres. Patrón: `[a-zA-Z0-9_.-]+` Obligatorio: sí ** [StreamStorageConfiguration](#API_CreateStream_RequestSyntax) ** La configuración del almacenamiento de la transmisión, incluida la capa de almacenamiento predeterminada para los datos de la transmisión. Esta configuración determina cómo se almacenan los datos de la transmisión y cómo se accede a ellos, con diferentes niveles que ofrecen distintos niveles de rendimiento y optimización de costes. Si no se especifica, la transmisión utilizará la configuración de almacenamiento predeterminada con el nivel HOT para obtener un rendimiento óptimo. Tipo: objeto [StreamStorageConfiguration](API_StreamStorageConfiguration.md) Obligatorio: no ** [Tags](#API_CreateStream_RequestSyntax) ** Una lista de etiquetas para asociar a la transmisión especificada. Cada etiqueta es un par clave-valor (el valor es opcional). Tipo: mapa de cadena a cadena Entradas de mapa: número máximo de 50 elementos. Limitaciones de longitud de la clave: longitud mínima de 1. Longitud máxima de 128. Patrón de clave: `^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$` Limitaciones de longitud de los valores: longitud mínima de 0. La longitud máxima es de 256 caracteres. Patrón de valores: `[\p{L}\p{Z}\p{N}_.:/=+\-@]*` Obligatorio: no ## Sintaxis de la respuesta ``` HTTP/1.1 200 Content-type: application/json { "StreamARN": "string" } ``` ## Elementos de respuesta Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200. El servicio devuelve los datos siguientes en formato JSON. ** [StreamARN](#API_CreateStream_ResponseSyntax) ** El nombre de recurso de Amazon (ARN) del flujo de . Tipo: cadena Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 1024 caracteres. Patrón: `arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+` ## Errores Para obtener información acerca de los errores comunes a todas las acciones, consulte [Tipos de errores comunes](CommonErrors.md). ** AccountStreamLimitExceededException ** El número de transmisiones creadas para la cuenta es demasiado alto. Código de estado HTTP: 400 ** ClientLimitExceededException ** Kinesis Video Streams ha limitado la solicitud porque ha superado el límite de llamadas de clientes permitidas. Intente realizar la llamada más tarde. Código de estado HTTP: 400 ** DeviceStreamLimitExceededException ** No implementado. Código de estado HTTP: 400 ** InvalidArgumentException ** El valor de este parámetro de entrada no es válido. Código de estado HTTP: 400 ** InvalidDeviceException ** No implementado. Código de estado HTTP: 400 ** ResourceInUseException ** Si la entrada `StreamARN` o `ChannelARN` entrada ya `CLOUD_STORAGE_MODE` está mapeada a otro recurso de Kinesis Video Stream, o si la `StreamARN` entrada `ChannelARN` proporcionada no está en estado Activo, pruebe una de las siguientes opciones: 1. La `DescribeMediaStorageConfiguration` API para determinar a qué está asignado el canal de transmisión en cuestión. 1. La `DescribeMappedResourceConfiguration` API para determinar el canal al que está mapeada la transmisión determinada. 1. La `DescribeStream` o la `DescribeSignalingChannel` API para determinar el estado del recurso. Código de estado HTTP: 400 ** TagsPerResourceExceededLimitException ** Ha superado el límite de etiquetas que puede asociar al recurso. Una transmisión de vídeo de Kinesis puede admitir hasta 50 etiquetas. Código de estado HTTP: 400 ## Véase también Para obtener más información sobre el uso de esta API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente: + [AWS Interfaz de línea de comandos V2](https://docs.aws.amazon.com/goto/cli2/kinesisvideo-2017-09-30/CreateStream) + [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisvideo-2017-09-30/CreateStream) + [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisvideo-2017-09-30/CreateStream) + [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisvideo-2017-09-30/CreateStream) + [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisvideo-2017-09-30/CreateStream) + [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisvideo-2017-09-30/CreateStream) + [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisvideo-2017-09-30/CreateStream) + [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisvideo-2017-09-30/CreateStream) + [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/kinesisvideo-2017-09-30/CreateStream) + [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisvideo-2017-09-30/CreateStream)