DeleteStream - Amazon Kinesis Video Streams

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.

DeleteStream

Elimina una transmisión de vídeo de Kinesis y los datos contenidos en la transmisión.

Este método marca la transmisión para su eliminación y hace que los datos de la transmisión sean inaccesibles inmediatamente.

Para asegurarse de que dispone de la última versión de la transmisión antes de eliminarla, puede especificar la versión de la transmisión. Kinesis Video Streams asigna una versión a cada transmisión. Al actualizar una transmisión, Kinesis Video Streams asigna un nuevo número de versión. Para obtener la versión más reciente de la transmisión, utilice la DescribeStream API.

Esta operación necesita permiso para la acción KinesisVideo:DeleteStream.

Sintaxis de la solicitud

POST /deleteStream HTTP/1.1 Content-type: application/json { "CurrentVersion": "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.

CurrentVersion

Opcional: la versión de la transmisión que quieres eliminar.

Especifique la versión como medida de seguridad para asegurarse de que está eliminando la transmisión correcta. Para obtener la versión de la transmisión, usa la DescribeStream API.

Si no se especifica, solo CreationTime se marca la casilla antes de eliminar la transmisión.

Tipo: string

Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 64.

Patrón: [a-zA-Z0-9]+

Obligatorio: no

StreamARN

El nombre del recurso de Amazon (ARN) de la transmisión que deseas eliminar.

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í

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.

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

NotAuthorizedException

La persona que llama no está autorizada a realizar esta operación.

Código de estado HTTP: 401

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.

  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

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 AWS SDK específicos del idioma, consulta lo siguiente: