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 video 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 (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",
"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
-
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.
Cuando el
DataRetentionInHoursvalor es 0, los consumidores pueden seguir consumiendo los fragmentos que permanecen en el búfer del servidor del servicio, que tiene un límite de tiempo de retención de 5 minutos y un límite de memoria de retención de 200 MB. Los fragmentos se eliminan del búfer cuando se alcanza cualquiera de los límites.Tipo: entero
Rango válido: valor mínimo de 0.
Obligatorio: no
- DeviceName
-
El nombre del dispositivo que se utiliza para escribir en la transmisión.
nota
En la implementación actual, Kinesis Video Streams no usa este nombre.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 128 caracteres.
Patrón:
[a-zA-Z0-9_.-]+Obligatorio: no
- KmsKeyId
-
El ID de la claveAWS 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 ID de clave, la clave predeterminada de Kinesis Video se utiliza.
AWS/kinesisvideoPara obtener más información, consulte DescribeKey.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 2048 caracteres.
Patrón:
.+Obligatorio: no
- MediaType
-
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
. Si decide especificar el MediaType, consulte Requisitos de nomenclaturapara obtener instrucciones. Los valores válidos de ejemplo incluyen «video/h264" y «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. La longitud máxima es de 128 caracteres.
Patrón:
[\w\-\.\+]+/[\w\-\.\+]+(,[\w\-\.\+]+/[\w\-\.\+]+)*Obligatorio: no
- StreamName
-
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í
- Tags
-
Una lista de etiquetas para asociar con 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. La longitud máxima es de 128 caracteres.
Patrón de clave:
^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$Limitaciones de longitud de valor: 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
-
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 sobre los errores comunes a todas las acciones, consulteErrores comunes.
- AccountStreamLimitExceededException
-
El número de elementos creados para la cuenta de se utiliza demasiado.
Código de estado HTTP: 400
- ClientLimitExceededException
-
Kinesis Video Streams ha limitado la solicitud porque ha superado el límite de llamadas de cliente permitidas. Intenta hacer 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
-
Cuando la entrada
StreamARNoChannelARNentrada yaCLOUD_STORAGE_MODEesté asignada a otro recurso de Kinesis Video Stream, o si la entradaStreamARNproporcionada noChannelARNestá en estado activo, pruebe una de las siguientes opciones:-
La
DescribeMediaStorageConfigurationAPI para determinar a qué se asigna el canal determinado de la transmisión. -
La
DescribeMappedResourceConfigurationAPI para determinar el canal al que se asigna la transmisión dada. -
La
DescribeSignalingChannelAPIDescribeStreamo 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 un SDK de AWS de un lenguaje específico, consulte:
