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 tiene la última versión de instalada, puede especificar la versión de instalada. Kinesis Video Streams asigna una versión a cada transmisión. Cuando actualiza una transmisión, Kinesis Video Streams asigna un nuevo número de versión. Para obtener la última versión de transmisión, usa laDescribeStream 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 instalada.
Especifique la versión como medida de seguridad para asegurarse de que está eliminando la transmisión correcta. Para obtener la versión de transmisión, usa la
DescribeStreamAPI.Si no se especifica, solo
CreationTimese marca la casilla antes de eliminar la transmisión.Tipo: cadena
Limitaciones de longitud: longitud mínima de 1. La longitud máxima es 64.
Patrón:
[a-zA-Z0-9]+Obligatorio: no
- StreamARN
-
El nombre de recurso de Amazon (ARN) de la secuencia que desea eliminar.
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: 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 sobre los errores comunes a todas las acciones, consulteErrores comunes.
- 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
- 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 para realizar esta operación.
Código de estado HTTP: 401
- 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
-
- ResourceNotFoundException
-
Amazon Kinesis Video Streams no encuentra la transmisión que especificó.
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 un SDK de AWS de un lenguaje específico, consulte:
