DeleteStream - Amazon Kinesis Video Streams
Sintassi della richiestaParametri della richiesta URI:Corpo della richiestaSintassi della rispostaElementi di rispostaErroriVedi anche

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

DeleteStream

Elimina un flusso video Kinesis e i dati contenuti nel flusso.

Questo metodo segna il flusso per l'eliminazione e rende immediatamente inaccessibili i dati nel flusso.

Per verificare di disporre della versione più recente del flusso prima di eliminarlo, puoi specificare la versione dello stream. Kinesis Video Streams assegna una versione a ciascun flusso. Quando si aggiorna uno stream, Kinesis Video Streams assegna un nuovo numero di versione. Per ottenere la versione più recente dello streaming, utilizzare ilDescribeStreamAPI.

Questa operazione richiede l'autorizzazione per ilKinesisVideo:DeleteStreamOperazione .

Sintassi della richiesta

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

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

Parametri della richiesta URI:

La richiesta non utilizza parametri URI.

Corpo della richiesta

La richiesta accetta i seguenti dati in formato JSON.

CurrentVersion

Opzionale: La versione dello stream che desideri eliminare.

Specificare la versione come salvaguardia per assicurarsi di eliminare il flusso corretto. Per ottenere la versione dello stream, usa ilDescribeStreamAPI.

Se non specificato, soloCreationTimeviene controllato prima di eliminare lo stream.

Type: Stringa

Vincoli di lunghezza: Lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.

Modello: [a-zA-Z0-9]+

campo obbligatorio: No

StreamARN

L'Amazon Resource Name (ARN) del flusso che desideri eliminare.

Type: Stringa

Vincoli di lunghezza: Lunghezza minima pari a 1. La lunghezza massima è 1024 caratteri.

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

campo obbligatorio: Sì

Sintassi della risposta

HTTP/1.1 200

Elementi di risposta

Se l'operazione riesce, il servizio invia una risposta HTTP 200 con un corpo HTTP vuoto.

Errori

Per informazioni sugli errori comuni a tutte le operazioni, consultare Errori comuni.

ClientLimitExceededException

Kinesis Video Streams ha limitato la richiesta perché hai superato il limite delle chiamate client consentite. Prova a effettuare la chiamata più tardi.

Codice di stato HTTP: 400

InvalidArgumentException

Il valore di questo parametro di input non è valido.

Codice di stato HTTP: 400

NotAuthorizedException

Il chiamante non è autorizzato a eseguire questa operazione.

Codice di stato HTTP: 401

ResourceInUseException

La risorsa non è attualmente disponibile per questa operazione. Non è possibile creare nuove risorse con lo stesso nome delle risorse esistenti. Inoltre, le risorse non possono essere aggiornate o eliminate a meno che non si trovino in unACTIVEstato.

Se viene restituita questa eccezione, non utilizzarla per determinare se la risorsa richiesta esiste già. Invece, si consiglia di utilizzare l'API di descrizione specifica delle risorse, ad esempioDescribeStreamper flussi video.

Codice di stato HTTP: 400

ResourceNotFoundException

Amazon Kinesis Video Streams non riesce a trovare lo stream specificato.

Codice di stato HTTP: 404

VersionMismatchException

La versione dello stream specificata non è la versione più recente. Per ottenere la versione più recente, utilizza ilDescribeStreamAPI.

Codice di stato HTTP: 400

Vedi anche

Per ulteriori informazioni sull'utilizzo di questa API in uno degli SDK AWS specifici della lingua, consulta quanto segue: