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.
UpdateStreamStorageConfiguration
Actualiza la configuración de almacenamiento de una transmisión de vídeo de Kinesis existente.
Esta operación le permite modificar la configuración del nivel de almacenamiento de una transmisión, lo que le permite optimizar los costes de almacenamiento y el rendimiento en función de sus patrones de acceso.
UpdateStreamStorageConfiguration es una operación asíncrona.
Debe tener permisos para la acción KinesisVideo:UpdateStreamStorageConfiguration.
Sintaxis de la solicitud
POST /updateStreamStorageConfiguration HTTP/1.1
Content-type: application/json
{
"CurrentVersion": "string",
"StreamARN": "string",
"StreamName": "string",
"StreamStorageConfiguration": {
"DefaultStorageTier": "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.
- CurrentVersion
-
La versión de la transmisión cuya configuración de almacenamiento desea cambiar. Para obtener la versión, llama a la API
DescribeStreamo a laListStreamsAPI.Tipo: cadena
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 64.
Patrón:
[a-zA-Z0-9]+Obligatorio: sí
- StreamARN
-
El nombre de recurso de Amazon (ARN) de la transmisión para la que desea actualizar la configuración de almacenamiento.
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]+Obligatorio: no
- StreamName
-
El nombre de la transmisión para la que desea actualizar la configuración de almacenamiento.
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: no
- StreamStorageConfiguration
-
La nueva configuración de almacenamiento de la transmisión. Esto incluye el nivel de almacenamiento predeterminado que determina cómo se almacenan los datos de la transmisión y cómo se accede a ellos.
Los distintos niveles de almacenamiento ofrecen distintos niveles de rendimiento y optimización de costes para adaptarse a los requisitos específicos de cada caso de uso.
Tipo: objeto StreamStorageConfiguration
Obligatorio: sí
Sintaxis de la respuesta
HTTP/1.1 200
Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200 con un cuerpo HTTP vacío.
Errores
Para obtener información acerca de los errores comunes a todas las acciones, consulte Errores comunes.
- AccessDeniedException
-
No tiene los permisos necesarios para realizar esta operación.
Código de estado HTTP: 401
- 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
- InvalidArgumentException
-
El valor de este parámetro de entrada no es válido.
Código de estado HTTP: 400
- ResourceInUseException
-
Si la entrada
StreamARNoChannelARNentrada yaCLOUD_STORAGE_MODEestá mapeada a otro recurso de Kinesis Video Stream, o si laStreamARNentradaChannelARNproporcionada no está en estado Activo, pruebe una de las siguientes opciones:-
La
DescribeMediaStorageConfigurationAPI para determinar a qué está asignado el canal de transmisión en cuestión. -
La
DescribeMappedResourceConfigurationAPI para determinar el canal al que está mapeada la transmisión determinada. -
La
DescribeStreamoDescribeSignalingChannelAPI para determinar el estado del recurso.
Código de estado HTTP: 400
-
- ResourceNotFoundException
-
Amazon Kinesis Video Streams no encuentra la transmisión que ha especificado.
Código de estado HTTP: 404
- VersionMismatchException
-
La versión de transmisión que especificó no es la versión más reciente. Para obtener la versión más reciente, usa la DescribeStreamAPI.
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, consulta lo siguiente:
