Skip to main content
Les bases de données sont exposées par le module api.databases. Elles sont disponibles sur les plans Standard, Pro et Enterprise.

Créer une base de données

api.databases.create(options) provisionne une nouvelle base de données. Le password et le certificate ne sont renvoyés qu’à la création — conservez-les dès maintenant.
Versions actuelles par moteur : La réponse de create() renvoie { id, name, memory, cpu, type, password, certificate?, connection_url, cluster }. cpu correspond aux parts CPU allouées ; password et certificate ne sont présents que dans cette réponse de création, pas lors des récupérations ultérieures. Un type non pris en charge échoue avec code: "INVALID_DATABASE_TYPE" ; une memory insuffisante pour le plan échoue avec code: "INSUFFICIENT_MEMORY" ; un échec durant le provisionnement échoue avec code: "DATABASE_CREATION_FAILED".

Lister vos bases de données

api.user.get() remplit user.databases avec une Collection de toutes les bases de données que vous possédez :

Récupérer une seule base de données

Cycle de vie

Statut et métriques

Statut résumé de chaque base de données

Mettre à jour

db.update(options) modifie le nom d’affichage et/ou l’allocation de mémoire. Au moins un champ doit être fourni.

Identifiants

db.credentials.certificate() renvoie le certificat TLS (PEM encodé en base64) :
db.credentials.reset(type) effectue la rotation soit du mot de passe, soit du certificat.
db.credentials.certificate() et db.credentials.reset() nécessitent que la base de données soit en cours d’exécution.

Snapshots

db.snapshots reflète l’API de snapshots des applications.
Contrairement à app.snapshots.restore({ snapshotId, versionId }), db.snapshots.restore(snapshotId, versionId) prend des arguments positionnels.

Supprimer une base de données

La suppression d’une base de données est irréversible. Assurez-vous d’avoir un snapshot récent si vous pourriez avoir besoin de récupérer les données.