UpdateMediaStorageConfiguration - Amazon Kinesis Video Streams
Sintaxis de la solicitudParámetros de solicitud del URICuerpo de la solicitudSintaxis de la respuestaElementos de respuestaErroresVéase también

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.

UpdateMediaStorageConfiguration

SignalingChannelAsocia a una transmisión para almacenar el contenido multimedia. Hay dos modos de señalización que puede especificar:

  • Si StorageStatus está activado, los datos se almacenarán en el lugar StreamARN indicado. Para que la ingestión de WebRTC funcione, la transmisión debe tener habilitada la retención de datos.

  • Si StorageStatus está deshabilitado, no se almacenará ningún dato y el StreamARN parámetro no será necesario.

importante

Si StorageStatus está activado, ya no se producen conexiones directas peer-to-peer (maestro-espectador). Los pares se conectan directamente a la sesión de almacenamiento. Debe llamar a la JoinStorageSession API para activar el envío de una oferta de SDP y establecer una conexión entre un par y la sesión de almacenamiento.

Sintaxis de la solicitud

POST /updateMediaStorageConfiguration HTTP/1.1
Content-type: application/json

{
   "ChannelARN": "string",
   "MediaStorageConfiguration": { 
      "Status": "string",
      "StreamARN": "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.

ChannelARN

El nombre de recurso de Amazon (ARN) del canal.

Tipo: string

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: sí

MediaStorageConfiguration

Estructura que encapsula o contiene las propiedades de configuración del almacenamiento multimedia.

Tipo: objeto MediaStorageConfiguration

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

NoDataRetentionException

La retención de datos de Stream en horas es igual a cero.

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é se ha asignado el canal de transmisión en cuestión.

  2. La DescribeMappedResourceConfiguration API para determinar el canal al que está mapeada la transmisión determinada.

  3. La DescribeStream o la DescribeSignalingChannel API 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

Véase también

Para obtener más información sobre el uso de esta API en uno de los AWS SDK específicos del idioma, consulte lo siguiente: