Para obtener capacidades similares a las de Amazon Timestream, considere Amazon Timestream LiveAnalytics para InfluxDB. Ofrece una ingesta de datos simplificada y tiempos de respuesta a las consultas en milisegundos de un solo dígito para realizar análisis en tiempo real. Obtenga más información aquí.
Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
UpdateTable
Modifica la duración de la retención del almacén de memoria y el almacén magnético para la tabla de Timestream. Tenga en cuenta que el cambio en la duración de la retención entra en vigor de inmediato. Por ejemplo, si el periodo de retención del almacén de memoria se estableció inicialmente en 2 horas y, luego, se cambió a 24 horas, el almacén de memoria podrá almacenar 24 horas de datos, pero se completará con 24 horas de datos, 22 horas después de realizar este cambio. Timestream no recupera datos del almacén magnético para completarlos en el almacén de memoria.
Consulte el ejemplo de código para obtener más detalles.
Sintaxis de la solicitud
{
"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"
}Parámetros de la solicitud
Para obtener información sobre los parámetros comunes a todas las acciones, consulte Parámetros comunes.
La solicitud acepta los siguientes datos en formato JSON.
- DatabaseName
-
Nombre de la base de datos de Timestream.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 3. La longitud máxima es de 256 caracteres.
Obligatorio: sí
- MagneticStoreWriteProperties
-
Contiene las propiedades que se tienen que establecer en la tabla cuando se habilitan las escrituras en el almacén magnético.
Tipo: objeto MagneticStoreWriteProperties
Obligatorio: no
- RetentionProperties
-
La duración de la retención del almacén de memoria y el almacén magnético.
Tipo: objeto RetentionProperties
Obligatorio: no
- Schema
-
El esquema de la tabla.
Tipo: objeto Schema
Obligatorio: no
- TableName
-
Nombre de la tabla de Timestream.
Tipo: cadena
Limitaciones de longitud: longitud mínima de 3. La longitud máxima es de 256 caracteres.
Obligatorio: sí
Sintaxis de la respuesta
{
"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"
}
}Elementos de respuesta
Si la acción se realiza correctamente, el servicio devuelve una respuesta HTTP 200.
El servicio devuelve los datos siguientes en formato JSON.
Errores
Para obtener información acerca de los errores comunes a todas las acciones, consulte Errores comunes.
- AccessDeniedException
-
No tiene autorización para realizar esta acción.
Código de estado HTTP: 400
- InternalServerException
-
Timestream no pudo procesar por completo esta solicitud debido a un error interno del servidor.
Código de estado HTTP: 500
- InvalidEndpointException
-
El punto de conexión solicitado no era válido.
Código de estado HTTP: 400
- ResourceNotFoundException
-
La operación intentó acceder a un recurso que no existe. Es posible que el recurso no esté especificado de manera correcta o que el estado no sea ACTIVO.
Código de estado HTTP: 400
- ThrottlingException
-
Un usuario realizó demasiadas solicitudes y estas superaron las cuotas de servicio. La solicitud se ha limitado.
Código de estado HTTP: 400
- ValidationException
-
Solicitud no válida o con formato incorrecto.
Código de estado HTTP: 400
Véase también
Para obtener más información sobre el uso de esta API en un SDK de AWS de un idioma específico, consulte:
