UpdateDatabase - Amazon Timestream
Sintaxis de la solicitudParámetros de la solicitudSintaxis de la respuestaElementos de respuestaErroresVéase también

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.

UpdateDatabase

Modifica la clave de AWS KMS de una base de datos existente. Al actualizar la base de datos, debe especificar el nombre de la base de datos y el identificador de la clave nueva de AWS KMS que se va a utilizar (KmsKeyId). Si hay solicitudes UpdateDatabase simultáneas, gana el primer escritor.

Consulte el ejemplo de código para obtener más detalles.

Sintaxis de la solicitud

{
   "DatabaseName": "string",
   "KmsKeyId": "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

El nombre de la base de datos.

Tipo: cadena

Limitaciones de longitud: longitud mínima de 3. La longitud máxima es de 256 caracteres.

Obligatorio: sí

KmsKeyId

El identificador de la clave nueva de AWS KMS (KmsKeyId) que se utilizó para cifrar los datos almacenados en la base de datos. Si el registro KmsKeyId actual en la base de datos es el mismo que el KmsKeyId de la solicitud, no habrá ninguna actualización.

Puede especificar la KmsKeyId mediante alguno de los métodos siguientes:

  • ID de clave: 1234abcd-12ab-34cd-56ef-1234567890ab

  • ARN de clave: arn:aws:kms:us-east-1:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab

  • Nombre del alias: alias/ExampleAlias

  • ARN de alias: arn:aws:kms:us-east-1:111122223333:alias/ExampleAlias

Tipo: cadena

Limitaciones de longitud: longitud mínima de 1. La longitud máxima es de 2048 caracteres.

Obligatorio: sí

Sintaxis de la respuesta

{
   "Database": { 
      "Arn": "string",
      "CreationTime": number,
      "DatabaseName": "string",
      "KmsKeyId": "string",
      "LastUpdatedTime": number,
      "TableCount": number
   }
}

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.

Database

Un contenedor de nivel superior para una tabla. Las bases de datos y las tablas son los conceptos de administración fundamentales de Amazon Timestream. Todas las tablas de una base de datos se cifran con la misma clave de AWS KMS.

Tipo: objeto Database

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

ServiceQuotaExceededException

Se superó la cuota de recursos de la instancia para esta cuenta.

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: