UpdateTable - Amazon Timestream

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à.

UpdateTable

Modifica la durata di conservazione dell'archivio di memoria e dell'archivio magnetico per la tabella Timestream. Si noti che la modifica della durata di conservazione ha effetto immediato. Ad esempio, se il periodo di conservazione dell'archivio di memoria è stato inizialmente impostato su 2 ore e poi modificato su 24 ore, l'archivio di memoria sarà in grado di contenere 24 ore di dati, ma verrà popolato con 24 ore di dati 22 ore dopo la modifica. Timestream non recupera i dati dall'archivio magnetico per popolare l'archivio di memoria.

Consulta l'esempio di codice per i dettagli.

Sintassi della richiesta

{ "DatabaseName": "string", "MagneticStoreWriteProperties": { "EnableMagneticStoreWrites": boolean, "MagneticStoreRejectedDataLocation": { "S3Configuration": { "BucketName": "string", "EncryptionOption": "string", "KmsKeyId": "string", "ObjectKeyPrefix": "string" } } }, "RetentionProperties": { "MagneticStoreRetentionPeriodInDays": number, "MemoryStoreRetentionPeriodInHours": number }, "Schema": { "CompositePartitionKey": [ { "EnforcementInRecord": "string", "Name": "string", "Type": "string" } ] }, "TableName": "string" }

Parametri della richiesta

Per informazioni sui parametri comuni per tutte le azioni, consulta Parametri comuni.

La richiesta accetta i seguenti dati in formato JSON.

DatabaseName

Nome del database Timestream.

Tipo: stringa

Limitazioni di lunghezza: lunghezza minima di 3. La lunghezza massima è 256 caratteri.

Campo obbligatorio: sì

MagneticStoreWriteProperties

Contiene le proprietà da impostare nella tabella quando si abilitano le scritture dello store magnetico.

Tipo: oggetto MagneticStoreWriteProperties

Campo obbligatorio: no

RetentionProperties

La durata di conservazione dell'archivio di memoria e dell'archivio magnetico.

Tipo: oggetto RetentionProperties

Campo obbligatorio: no

Schema

Lo schema della tabella.

Tipo: oggetto Schema

Campo obbligatorio: no

TableName

Nome della tabella Timestream.

Tipo: stringa

Limitazioni di lunghezza: lunghezza minima di 3. La lunghezza massima è 256 caratteri.

Campo obbligatorio: sì

Sintassi della risposta

{ "Table": { "Arn": "string", "CreationTime": number, "DatabaseName": "string", "LastUpdatedTime": number, "MagneticStoreWriteProperties": { "EnableMagneticStoreWrites": boolean, "MagneticStoreRejectedDataLocation": { "S3Configuration": { "BucketName": "string", "EncryptionOption": "string", "KmsKeyId": "string", "ObjectKeyPrefix": "string" } } }, "RetentionProperties": { "MagneticStoreRetentionPeriodInDays": number, "MemoryStoreRetentionPeriodInHours": number }, "Schema": { "CompositePartitionKey": [ { "EnforcementInRecord": "string", "Name": "string", "Type": "string" } ] }, "TableName": "string", "TableStatus": "string" } }

Elementi di risposta

Se l'operazione riesce, il servizio restituisce una risposta HTTP 200.

I dati seguenti vengono restituiti in formato JSON mediante il servizio.

Table

La tabella Timestream aggiornata.

Tipo: oggetto Table

Errori

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

AccessDeniedException

Non sei autorizzato a eseguire questa azione.

Codice di stato HTTP: 400

InternalServerException

Timestream non è stato in grado di elaborare completamente questa richiesta a causa di un errore interno del server.

Codice di stato HTTP: 500

InvalidEndpointException

L'endpoint richiesto non era valido.

Codice di stato HTTP: 400

ResourceNotFoundException

L'operazione ha tentato di accedere a una risorsa inesistente. La risorsa potrebbe non essere specificata correttamente o il suo stato potrebbe non essere ATTIVO.

Codice di stato HTTP: 400

ThrottlingException

Troppe richieste sono state fatte da un utente e hanno superato le quote di servizio. La richiesta è stata sottoposta a throttling.

Codice di stato HTTP: 400

ValidationException

Richiesta non valida o con formato errato.

Codice di stato HTTP: 400

Vedi anche

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche, consulta quanto segue AWS SDKs: