DeleteStream - Amazon Kinesis Video Streams
Sintaxe da SolicitaçãoParâmetros da solicitação de URICorpo da SolicitaçãoSintaxe da RespostaElementos de RespostaErrosConsulte também

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

DeleteStream

Exclui um stream de vídeo do Kinesis e os dados contidos no stream.

Esse método marca o fluxo para exclusão e torna os dados no fluxo inacessíveis imediatamente.

Para garantir que você tenha a versão mais recente do stream antes de excluí-lo, você pode especificar a versão do stream. O Kinesis Video Streams atribui uma versão a cada stream. Quando você atualiza um stream, o Kinesis Video Streams atribui um novo número de versão. Para obter a versão mais recente do stream, use a DescribeStream API.

Essa operação exige permissão para a ação KinesisVideo:DeleteStream.

Sintaxe da Solicitação

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

{
   "CurrentVersion": "string",
   "StreamARN": "string"
}

Parâmetros da solicitação de URI

A solicitação não usa nenhum parâmetro de URI.

Corpo da Solicitação

A solicitação aceita os dados a seguir no formato JSON.

CurrentVersion

Opcional: a versão do stream que você deseja excluir.

Especifique a versão como uma proteção para garantir que você esteja excluindo o stream correto. Para obter a versão do stream, use a DescribeStream API.

Se não for especificado, somente o CreationTime é verificado antes de excluir o fluxo.

Tipo: string

Restrições de tamanho: tamanho mínimo 1. Comprimento máximo de 64.

Padrão: [a-zA-Z0-9]+

Obrigatório: não

StreamARN

O Amazon Resource Name (ARN) do stream que você deseja excluir.

Tipo: string

Restrições de tamanho: tamanho mínimo 1. Tamanho máximo de 1.024.

Padrão: arn:[a-z\d-]+:kinesisvideo:[a-z0-9-]+:[0-9]+:[a-z]+/[a-zA-Z0-9_.-]+/[0-9]+

Exigido: Sim

Sintaxe da Resposta

HTTP/1.1 200

Elementos de Resposta

Se a ação tiver êxito, o serviço enviará de volta uma resposta HTTP 200 com um corpo HTTP vazio.

Erros

Para obter informações sobre os erros comuns a todas as ações, consulte Erros comuns.

ClientLimitExceededException

O Kinesis Video Streams limitou a solicitação porque você excedeu o limite permitido de chamadas de clientes. Tente fazer a ligação mais tarde.

Código de Status HTTP: 400

InvalidArgumentException

O valor desse parâmetro de entrada é inválido.

Código de Status HTTP: 400

NotAuthorizedException

O chamador não está autorizado a realizar essa operação.

Código de status HTTP: 401

ResourceInUseException

Quando a entrada StreamARN ou ChannelARN a entrada já estiverem mapeadas para um recurso diferente do Kinesis Video Stream, ou se a StreamARN entrada ChannelARN fornecida não estiver no status Ativo, tente uma das seguintes opções: CLOUD_STORAGE_MODE

  1. A DescribeMediaStorageConfiguration API para determinar para onde o stream determinado canal é mapeado.

  2. A DescribeMappedResourceConfiguration API para determinar o canal para o qual o determinado fluxo é mapeado.

  3. A DescribeSignalingChannel API DescribeStream ou para determinar o status do recurso.

Código de Status HTTP: 400

ResourceNotFoundException

O Amazon Kinesis Video Streams não consegue encontrar o stream que você especificou.

Código de Status HTTP: 404

VersionMismatchException

A versão do stream que você especificou não é a versão mais recente. Para obter a versão mais recente, use a DescribeStreamAPI.

Código de Status HTTP: 400

Consulte também

Para obter mais informações sobre como usar essa API em um dos AWS SDKs específicos da linguagem, consulte o seguinte: