L’API ClickHouse Cloud est une API REST conçue pour permettre aux développeurs de gérer facilement les organisations et les services sur ClickHouse Cloud. Avec notre Cloud API, vous pouvez créer et gérer des services, provisionner des clés API, ajouter ou supprimer des membres de votre organisation, et bien plus encore.
Découvrez comment créer votre première clé API et commencer à utiliser l’API ClickHouse Cloud.
Point de terminaison Swagger (OpenAPI) et UI
Si votre organisation a été migrée vers l’un des nouveaux plans tarifaires et que vous utilisez OpenAPI, vous devrez supprimer le champ tier de la requête POST de création de service.Le champ tier a été supprimé de l’objet service, car nous n’avons plus de tiers de service.
Cela affectera les objets renvoyés par les requêtes de service POST, GET et PATCH. Par conséquent, tout code qui utilise ces API devra peut-être être adapté pour prendre en compte ces modifications. Si votre organisation a été migrée vers l’un des nouveaux plans tarifaires, vous devrez utiliser la version 2.0.0 ou ultérieure de notre provider Terraform ClickHouse. Cette mise à niveau est nécessaire pour prendre en charge les modifications de l’attribut tier du service, car après la migration tarifaire, le champ tier n’est plus accepté et toutes les références à celui-ci doivent être supprimées.Vous pourrez désormais également spécifier le champ num_replicas comme propriété de la ressource de service.
- Lors de la planification et de l’application, par un avertissement
Beta Resource. Terraform n’échoue jamais en raison d’avertissements ; l’exécution se poursuit donc normalement.
- Dans sa documentation, par un encadré indiquant « Cette ressource est en bêta ».
Bêta signifie que le schéma et le comportement peuvent changer dans une future version du provider. Toute ressource sans ce marqueur est en GA et couverte par les garanties de compatibilité habituelles.
Avant la v3.25.2, le provider marquait ces ressources comme alpha plutôt que bêta, et l’avertissement lors de la planification indiquait Alpha Resource. Seul le libellé a changé — aucun schéma, comportement ou migration d’état n’est concerné — mais les outils qui recherchent Alpha Resource dans la sortie du plan cesseront silencieusement de trouver des correspondances. Les versions antérieures publiaient également une build alpha distincte.
-alphaN (par ex. 3.15.0-alpha3) sont antérieures au modèle de build unique. Elles restent disponibles, mais ne sont plus produites.
Lorsqu’une fonctionnalité atteint la disponibilité générale, la ressource correspondante perd son marqueur bêta dans la version suivante du provider : l’avertissement lors de la planification cesse de s’afficher et l’encadré de la documentation est supprimé. Rien d’autre ne change — aucune modification de configuration, aucune migration d’état et aucun basculement entre les builds.
Le nombre de répliques avec lequel chaque service est créé est de 3 par défaut pour les tiers Scale et Enterprise, contre 1 par défaut pour le tier Basic.
Pour les tiers Scale et Enterprise, il est possible de l’ajuster en transmettant un champ numReplicas dans la requête de création du service.
La valeur du champ numReplicas doit être comprise entre 2 et 20 pour le premier service d’un warehouse. Les services créés dans un warehouse existant peuvent avoir seulement 1 réplique.
Nous vous recommandons de consulter d’abord notre canal Slack pour obtenir rapidement de l’aide. Si
vous souhaitez une assistance supplémentaire ou davantage d’informations sur notre API et ses fonctionnalités,
veuillez contacter ClickHouse Support à l’adresse https://console.clickhouse.cloud/support 
