

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
<a name="API_DeleteStream"></a>

Elimina un flusso video Kinesis e i dati in esso contenuti. 

Questo metodo contrassegna lo stream per l'eliminazione e rende immediatamente inaccessibili i dati in esso contenuti.

 

 Per assicurarti di disporre della versione più recente dello stream prima di eliminarlo, puoi specificare la versione dello stream. Kinesis Video Streams assegna una versione a ogni stream. Quando aggiorni uno stream, Kinesis Video Streams assegna un nuovo numero di versione. Per ottenere la versione di streaming più recente, utilizza l'API. `DescribeStream` 

Questa operazione richiede l’autorizzazione per l'operazione `KinesisVideo:DeleteStream`.

## Sintassi della richiesta
<a name="API_DeleteStream_RequestSyntax"></a>

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

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

## Parametri della richiesta URI:
<a name="API_DeleteStream_RequestParameters"></a>

La richiesta non utilizza parametri URI.

## Corpo della richiesta
<a name="API_DeleteStream_RequestBody"></a>

La richiesta accetta i seguenti dati in formato JSON.

 ** [CurrentVersion](#API_DeleteStream_RequestSyntax) **   <a name="KinesisVideo-DeleteStream-request-CurrentVersion"></a>
Facoltativo: la versione dello stream che desideri eliminare.   
Specificate la versione come protezione per assicurarvi che stiate eliminando lo stream corretto. Per ottenere la versione in streaming, usa l'`DescribeStream`API.  
Se non specificato, `CreationTime` viene controllato solo il prima di eliminare lo stream.  
Tipo: String  
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.  
Modello: `[a-zA-Z0-9]+`   
Obbligatorio: no

 ** [StreamARN](#API_DeleteStream_RequestSyntax) **   <a name="KinesisVideo-DeleteStream-request-StreamARN"></a>
L'Amazon Resource Name (ARN) dello stream che desideri eliminare.   
Tipo: String  
Limitazioni 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]+`   
Obbligatorio: sì

## Sintassi della risposta
<a name="API_DeleteStream_ResponseSyntax"></a>

```
HTTP/1.1 200
```

## Elementi di risposta
<a name="API_DeleteStream_ResponseElements"></a>

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

## Errori
<a name="API_DeleteStream_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Tipi di errore comuni](CommonErrors.md).

 ** ClientLimitExceededException **   
Kinesis Video Streams ha limitato la richiesta perché è stato superato il limite di 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 **   
Quando l'ingresso `StreamARN` o `ChannelARN` l'ingresso `CLOUD_STORAGE_MODE` sono già mappati su un'altra risorsa Kinesis Video Stream, o se l'`StreamARN`ingresso fornito `ChannelARN` o non è nello stato Attivo, prova una delle seguenti soluzioni:   

1. L'`DescribeMediaStorageConfiguration`API per determinare a cosa è mappato lo stream di un determinato canale. 

1. L'`DescribeMappedResourceConfiguration`API per determinare il canale su cui è mappato lo stream specificato. 

1. L'`DescribeStream`o l'`DescribeSignalingChannel`API per determinare lo stato della risorsa. 
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 che hai specificato non è la versione più recente. Per ottenere la versione più recente, usa l'[DescribeStream](https://docs.aws.amazon.com/kinesisvideostreams/latest/dg/API_DescribeStream.html)API.  
Codice di stato HTTP: 400

## Vedi anche
<a name="API_DeleteStream_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/kinesisvideo-2017-09-30/DeleteStream) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisvideo-2017-09-30/DeleteStream) 
+  [AWS SDK per C\+\+](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisvideo-2017-09-30/DeleteStream) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisvideo-2017-09-30/DeleteStream) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisvideo-2017-09-30/DeleteStream) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisvideo-2017-09-30/DeleteStream) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisvideo-2017-09-30/DeleteStream) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisvideo-2017-09-30/DeleteStream) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/kinesisvideo-2017-09-30/DeleteStream) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisvideo-2017-09-30/DeleteStream) 