

Pour des fonctionnalités similaires à celles d'Amazon Timestream pour, pensez à Amazon Timestream LiveAnalytics pour InfluxDB. Il permet une ingestion simplifiée des données et des temps de réponse aux requêtes à un chiffre en millisecondes pour des analyses en temps réel. Pour en savoir plus, [cliquez ici](https://docs.aws.amazon.com//timestream/latest/developerguide/timestream-for-influxdb.html).

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# UpdateDatabase
<a name="API_UpdateDatabase"></a>

 Modifie la AWS KMS clé d'une base de données existante. Lors de la mise à jour de la base de données, vous devez spécifier le nom de la base de données et l'identifiant de la nouvelle AWS KMS clé à utiliser (`KmsKeyId`). S'il y a des `UpdateDatabase` demandes simultanées, le premier rédacteur gagne. 

Voir l'[exemple de code](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.update-db.html) pour plus de détails.

## Syntaxe de la requête
<a name="API_UpdateDatabase_RequestSyntax"></a>

```
{
   "DatabaseName": "string",
   "KmsKeyId": "string"
}
```

## Paramètres de demande
<a name="API_UpdateDatabase_RequestParameters"></a>

Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md).

Cette demande accepte les données suivantes au format JSON.

 ** [DatabaseName](#API_UpdateDatabase_RequestSyntax) **   <a name="timestream-UpdateDatabase-request-DatabaseName"></a>
 Nom de la base de données.   
Type : Chaîne  
Contraintes de longueur : Longueur minimum de 3. Longueur maximale de 256.  
Obligatoire : oui

 ** [KmsKeyId](#API_UpdateDatabase_RequestSyntax) **   <a name="timestream-UpdateDatabase-request-KmsKeyId"></a>
 Identifiant de la nouvelle AWS KMS clé (`KmsKeyId`) à utiliser pour chiffrer les données stockées dans la base de données. Si le contenu `KmsKeyId` actuellement enregistré dans la base de données est le même que celui `KmsKeyId` indiqué dans la demande, aucune mise à jour ne sera effectuée.   
Vous pouvez le spécifier à l'`KmsKeyId`aide de l'une des options suivantes :  
+ ID de clé : `1234abcd-12ab-34cd-56ef-1234567890ab` 
+ ARN de clé : `arn:aws:kms:us-east-1:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab` 
+ Nom d'alias : `alias/ExampleAlias` 
+ ARN d'alias : `arn:aws:kms:us-east-1:111122223333:alias/ExampleAlias` 
Type : Chaîne  
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 2048.  
Obligatoire : oui

## Syntaxe de la réponse
<a name="API_UpdateDatabase_ResponseSyntax"></a>

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

## Eléments de réponse
<a name="API_UpdateDatabase_ResponseElements"></a>

Si l’action aboutit, le service renvoie une réponse HTTP 200.

Les données suivantes sont renvoyées au format JSON par le service.

 ** [Database](#API_UpdateDatabase_ResponseSyntax) **   <a name="timestream-UpdateDatabase-response-Database"></a>
Un conteneur de haut niveau pour une table. Les bases de données et les tables sont les concepts de gestion fondamentaux d'Amazon Timestream. Toutes les tables d'une base de données sont chiffrées avec la même AWS KMS clé.  
Type : objet [Database](API_Database.md)

## Erreurs
<a name="API_UpdateDatabase_Errors"></a>

Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md).

 ** AccessDeniedException **   
Vous n'êtes pas autorisé à effectuer cette action.  
Code d’état HTTP : 400

 ** InternalServerException **   
 Timestream n'a pas pu traiter complètement cette demande en raison d'une erreur interne du serveur.  
Code d’état HTTP : 500

 ** InvalidEndpointException **   
Le point de terminaison demandé n'était pas valide.  
Code d’état HTTP : 400

 ** ResourceNotFoundException **   
L'opération a tenté d'accéder à une ressource inexistante. La ressource n'est peut-être pas spécifiée correctement ou son statut n'est peut-être pas ACTIF.  
Code d’état HTTP : 400

 ** ServiceQuotaExceededException **   
 Le quota de ressources d'instance a été dépassé pour ce compte.  
Code d’état HTTP : 400

 ** ThrottlingException **   
 Trop de demandes ont été effectuées par un utilisateur et elles ont dépassé les quotas de service. La demande a été limitée.  
Code d’état HTTP : 400

 ** ValidationException **   
 Une demande non valide ou mal formée.  
Code d’état HTTP : 400

## Voir aussi
<a name="API_UpdateDatabase_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+  [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/UpdateDatabase) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/UpdateDatabase) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/UpdateDatabase) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/UpdateDatabase) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/UpdateDatabase) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/UpdateDatabase) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/UpdateDatabase) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/UpdateDatabase) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/UpdateDatabase) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/UpdateDatabase) 