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.
CreateTable
Agrega una tabla nueva a una base de datos existente en tu cuenta. En una Cuenta de AWS, los nombres de las tablas deben ser al menos únicos en cada región si están en la misma base de datos. Es posible que tenga nombres de tabla idénticos en la misma región si las tablas están en bases de datos independientes. Cuando cree la tabla, debe especificar su nombre, el nombre de la base de datos y las propiedades de retención. Se aplican cuotas de servicio. 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",
"Tags": [
{
"Key": "string",
"Value": "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 JSON formato.
- 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.
Patrón:
[a-zA-Z0-9_.-]+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
-
El tiempo durante el que deben almacenarse los datos de series temporales en el almacén de memoria y en 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.
Patrón:
[a-zA-Z0-9_.-]+Obligatorio: sí
- Tags
-
Una lista de pares clave-valor para etiquetar la tabla.
Tipo: matriz de objetos Tag
Miembros de la matriz: número mínimo de 0 artículos. La cantidad máxima es de 200 artículos.
Obligatorio: no
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 de HTTP 200.
El servicio devuelve los siguientes datos en JSON formato.
Errores
Para obtener información acerca de los errores comunes a todas las acciones, consulte Errores comunes.
- AccessDeniedException
-
No está autorizado a realizar esta acción.
HTTPCódigo de estado: 400
- ConflictException
-
Timestream no pudo procesar esta solicitud porque contiene un recurso que ya existe.
HTTPCódigo de estado: 400
- InternalServerException
-
Timestream no pudo procesar completamente esta solicitud debido a un error interno del servidor.
HTTPCódigo de estado: 500
- InvalidEndpointException
-
El punto final solicitado no era válido.
HTTPCódigo de estado: 400
- InvalidEndpointException
-
El punto final solicitado no era válido.
HTTPCódigo de estado: 400
- ResourceNotFoundException
-
La operación intentó acceder a un recurso inexistente. Es posible que el recurso no esté especificado correctamente o que su estado no lo estéACTIVE.
HTTPCódigo de estado: 400
- ServiceQuotaExceededException
-
Se ha superado la cuota de recursos de la instancia para esta cuenta.
HTTPCódigo de estado: 400
- ThrottlingException
-
Un usuario realizó demasiadas solicitudes y estas superaron las cuotas de servicio. La solicitud se ha limitado.
HTTPCódigo de estado: 400
- ValidationException
-
Solicitud no válida o mal formada.
HTTPCódigo de estado: 400
Véase también
Para obtener más información sobre cómo usarlo API en uno de los idiomas específicos AWS SDKs, consulte lo siguiente:
