UpdateDataRetention - Amazon Kinesis Video Streams

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 del flusso in base al valore specificato. Per indicare se si desidera aumentare o ridurre il periodo di conservazione dei dati, specificareOperationparametro nel corpo della richiesta. Nella richiesta, è necessario specificare ilStreamNameo ilStreamARN.

Nota

Il periodo di conservazione specificato sostituisce il valore corrente.

Questa operazione richiede l'autorizzazione perKinesisVideo:UpdateDataRetentionOperazione .

La modifica del periodo di conservazione dei dati influisce sui dati nel flusso come segue:

  • 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 è diminuito, 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

La versione dello stream di cui si desidera modificare il periodo di conservazione. Per ottenere la versione, chiama ilDescribeStreamo ilListStreamsAPI.

Type: Stringa

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

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

Campo obbligatorio: Sì

DataRetentionChangeInHours

Il periodo di conservazione, in ore. Il valore specificato sostituisce il valore corrente. Il valore massimo per questo parametro è 87600 (dieci anni).

Type: Numero intero

Intervallo valido: Valore minimo di 1.

Campo obbligatorio: Sì

Operation

Indica se si desidera aumentare o ridurre il periodo di conservazione.

Type: Stringa

Valori validi: INCREASE_DATA_RETENTION | DECREASE_DATA_RETENTION

Campo obbligatorio: Sì

StreamARN

L'Amazon Resource Name (ARN) del flusso di cui desideri modificare il periodo di conservazione.

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: No

StreamName

Il nome dello stream di cui si desidera modificare il periodo di conservazione.

Type: Stringa

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

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

Campo 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 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 per questo parametro di input non è valido.

Codice di stato HTTP: 400

NotAuthorizedException

L'intermediario 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, usa 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: