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à. # UpdateDataRetention Aumenta o diminuisce il periodo di conservazione dei dati dello stream in base al valore specificato. Per indicare se desideri aumentare o diminuire il periodo di conservazione dei dati, specifica il `Operation` parametro nel corpo della richiesta. Nella richiesta, è necessario specificare il `StreamName` o il`StreamARN`. Questa operazione richiede l’autorizzazione per l'operazione `KinesisVideo:UpdateDataRetention`. La modifica del periodo di conservazione dei dati influisce sui dati nello stream nel modo seguente: + Se il periodo di conservazione dei dati viene aumentato, i dati esistenti vengono conservati per il nuovo periodo di conservazione. Ad esempio, se il periodo di conservazione dei dati viene aumentato da un'ora a sette ore, tutti i dati esistenti vengono conservati per sette ore. + Se il periodo di conservazione dei dati viene ridotto, i dati esistenti vengono conservati per il nuovo periodo di conservazione. Ad esempio, se il periodo di conservazione dei dati viene ridotto da sette ore a un'ora, tutti i dati esistenti vengono conservati per un'ora e tutti i dati più vecchi di un'ora vengono eliminati immediatamente. ## Sintassi della richiesta ``` POST /updateDataRetention HTTP/1.1 Content-type: application/json { "CurrentVersion": "string", "DataRetentionChangeInHours": number, "Operation": "string", "StreamARN": "string", "StreamName": "string" } ``` ## Parametri della richiesta URI: La richiesta non utilizza parametri URI. ## Corpo della richiesta La richiesta accetta i seguenti dati in formato JSON. ** [CurrentVersion](#API_UpdateDataRetention_RequestSyntax) ** La versione dello stream di cui desideri modificare il periodo di conservazione. Per ottenere la versione, chiama l'API `DescribeStream` o l'`ListStreams`API. Tipo: String Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri. Modello: `[a-zA-Z0-9]+` Obbligatorio: sì ** [DataRetentionChangeInHours](#API_UpdateDataRetention_RequestSyntax) ** Il numero di ore in base al quale regolare la conservazione corrente. Il valore specificato viene aggiunto o sottratto dal valore corrente, a seconda di. `operation` Il valore minimo per la conservazione dei dati è 0 e il valore massimo è 87600 (dieci anni). Tipo: numero intero Intervallo valido: valore minimo di 1. Obbligatorio: sì ** [Operation](#API_UpdateDataRetention_RequestSyntax) ** Indica se si desidera aumentare o diminuire il periodo di conservazione. Tipo: String Valori validi: `INCREASE_DATA_RETENTION | DECREASE_DATA_RETENTION` Obbligatorio: sì ** [StreamARN](#API_UpdateDataRetention_RequestSyntax) ** L'Amazon Resource Name (ARN) dello stream di cui desideri modificare il periodo di conservazione. 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: no ** [StreamName](#API_UpdateDataRetention_RequestSyntax) ** Il nome dello stream di cui desideri modificare il periodo di conservazione. Tipo: String Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 256 caratteri. Modello: `[a-zA-Z0-9_.-]+` Obbligatorio: no ## 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 [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 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/UpdateDataRetention) + [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/kinesisvideo-2017-09-30/UpdateDataRetention) + [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/kinesisvideo-2017-09-30/UpdateDataRetention) + [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/kinesisvideo-2017-09-30/UpdateDataRetention) + [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/kinesisvideo-2017-09-30/UpdateDataRetention) + [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/kinesisvideo-2017-09-30/UpdateDataRetention) + [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/kinesisvideo-2017-09-30/UpdateDataRetention) + [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/kinesisvideo-2017-09-30/UpdateDataRetention) + [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/kinesisvideo-2017-09-30/UpdateDataRetention) + [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/kinesisvideo-2017-09-30/UpdateDataRetention)