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 ilStreamARN.
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
-
La versione dello stream di cui desideri modificare il periodo di conservazione. Per ottenere la versione, chiama l'API
DescribeStreamo l'ListStreamsAPI.▬Tipo: stringa
Limitazioni di lunghezza: lunghezza minima pari a 1. La lunghezza massima è 64 caratteri.
Modello:
[a-zA-Z0-9]+Campo obbligatorio: sì
- DataRetentionChangeInHours
-
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.
operationIl valore minimo per la conservazione dei dati è 0 e il valore massimo è 87600 (dieci anni).
Tipo: integer
Intervallo valido: valore minimo di 1.
Campo obbligatorio: sì
- Operation
-
Indica se si desidera aumentare o diminuire il periodo di conservazione.
▬Tipo: stringa
Valori validi:
INCREASE_DATA_RETENTION | DECREASE_DATA_RETENTIONCampo obbligatorio: sì
- StreamARN
-
L'Amazon Resource Name (ARN) dello stream di cui desideri modificare il periodo di conservazione.
▬Tipo: stringa
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]+Campo obbligatorio: no
- StreamName
-
Il nome dello stream di cui desideri modificare il periodo di conservazione.
▬Tipo: stringa
Limitazioni 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é è 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
StreamARNoChannelARNl'ingressoCLOUD_STORAGE_MODEsono già mappati su un'altra risorsa Kinesis Video Stream, o se l'StreamARNingresso fornitoChannelARNo non è nello stato Attivo, prova una delle seguenti soluzioni:-
L'
DescribeMediaStorageConfigurationAPI per determinare a cosa è mappato lo stream di un determinato canale. -
L'
DescribeMappedResourceConfigurationAPI per determinare il canale su cui è mappato lo stream specificato. -
L'
DescribeStreamo l'DescribeSignalingChannelAPI 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'DescribeStreamAPI.
Codice di stato HTTP: 400
Vedi anche
Per ulteriori informazioni sull'utilizzo di questa API in uno degli AWS SDK specifici della lingua, consulta quanto segue:
