You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/cloud/features/05_admin_features/api/openapi.md
+4Lines changed: 4 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -34,6 +34,10 @@ This document covers the ClickHouse Cloud API. For database API endpoints, pleas
34
34
<br/>
35
35
:::note
36
36
Permissions align with ClickHouse Cloud [predefined roles](/cloud/security/console-roles). The developer role has read-only permissions for assigned services and the admin role has full read and write permissions.
37
+
:::
38
+
39
+
:::tip Query API Endpoints
40
+
To use API keys with [Query API Endpoints](/cloud/get-started/query-endpoints), set Organization Role to `Member` (minimum) and grant Service Role access to `Query Endpoints`.
37
41
:::
38
42
39
43
<Imageimg={image_03}size="md"alt="Create API key form"border/>
Copy file name to clipboardExpand all lines: docs/cloud/guides/SQL_console/query-endpoints.md
+6-2Lines changed: 6 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -24,11 +24,15 @@ The **Query API Endpoints** feature allows you to create an API endpoint directl
24
24
## Pre-requisites {#quick-start-guide}
25
25
26
26
Before proceeding, ensure you have:
27
-
-an API key
28
-
-an Admin Console Role.
27
+
-An API key with appropriate permissions
28
+
-An Admin Console Role
29
29
30
30
You can follow this guide to [create an API key](/cloud/manage/openapi) if you don't yet have one.
31
31
32
+
:::note Minimum permissions
33
+
To query an API endpoint, the API key needs `Member` organization role with `Query Endpoints` service access. The database role is configured when you create the endpoint.
34
+
:::
35
+
32
36
<VerticalStepperheaderLevel="h3">
33
37
34
38
### Create a saved query {#creating-a-saved-query}
Copy file name to clipboardExpand all lines: docs/cloud/reference/01_changelog/01_changelog.md
+16Lines changed: 16 additions & 0 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -33,6 +33,22 @@ import dashboards from '@site/static/images/cloud/reference/may-30-dashboards.pn
33
33
34
34
In addition to this ClickHouse Cloud changelog, please see the [Cloud Compatibility](/whats-new/cloud-compatibility) page.
35
35
36
+
:::tip[Automatically keep up to date!]
37
+
<ahref="/docs/cloud/changelog-rss.xml">
38
+
Subscribe to Cloud Changelog via RSS
39
+
</a>
40
+
:::
41
+
42
+
## November 7, 2025 {#november-7-2025}
43
+
44
+
- ClickHouse Cloud console now supports configuring replica sizes in increments of 1 vCPU, 4 GiB from the cloud console.
45
+
These options are available both when setting up a new service as well as when setting minimum and maximum replica sizes on the settings page.
46
+
- Custom hardware profiles (available on the Enterprise tier) now support idling.
47
+
- ClickHouse Cloud now offers a simplified purchasing experience through AWS Marketplace, with separate options for [pay-as-you-go](https://aws.amazon.com/marketplace/pp/prodview-p4gwofrqpkltu?sr=0-2&ref_=beagle&applicationId=AWSMPContessa) and [committed spend contracts](https://aws.amazon.com/marketplace/pp/prodview-4qyeihstyym2s?sr=0-3&ref_=beagle&applicationId=AWSMPContessa).
48
+
- Alerting is now available for ClickStack users in ClickHouse Cloud.
49
+
Users can now create and manage alerts directly in the HyperDX UI, across logs, metrics, and traces with no extra setup, no extra infra or service, and no config. Alerts integrate with Slack, PagerDuty, and more.
50
+
For more information see the [alerting documentation](/use-cases/observability/clickstack/alerts).
Copy file name to clipboardExpand all lines: docs/cloud/reference/03_billing/02_marketplace/aws-marketplace-payg.md
+43-75Lines changed: 43 additions & 75 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -15,9 +15,6 @@ import aws_marketplace_payg_6 from '@site/static/images/cloud/manage/billing/mar
15
15
import aws_marketplace_payg_7 from '@site/static/images/cloud/manage/billing/marketplace/aws-marketplace-payg-7.png';
16
16
import aws_marketplace_payg_8 from '@site/static/images/cloud/manage/billing/marketplace/aws-marketplace-payg-8.png';
17
17
import aws_marketplace_payg_9 from '@site/static/images/cloud/manage/billing/marketplace/aws-marketplace-payg-9.png';
18
-
import aws_marketplace_payg_10 from '@site/static/images/cloud/manage/billing/marketplace/aws-marketplace-payg-10.png';
19
-
import aws_marketplace_payg_11 from '@site/static/images/cloud/manage/billing/marketplace/aws-marketplace-payg-11.png';
20
-
import aws_marketplace_payg_12 from '@site/static/images/cloud/manage/billing/marketplace/aws-marketplace-payg-12.png';
21
18
import Image from '@theme/IdealImage';
22
19
23
20
Get started with ClickHouse Cloud on the [AWS Marketplace](https://aws.amazon.com/marketplace) via a PAYG (Pay-as-you-go) Public Offer.
@@ -26,112 +23,83 @@ Get started with ClickHouse Cloud on the [AWS Marketplace](https://aws.amazon.co
26
23
27
24
- An AWS account that is enabled with purchasing rights by your billing administrator.
28
25
- To purchase, you must be logged into the AWS marketplace with this account.
26
+
- To connect a ClickHouse organization to your subscription, you must be an admin of that organization.
29
27
30
-
## Steps to sign up {#steps-to-sign-up}
31
-
32
-
1. Go to the [AWS Marketplace](https://aws.amazon.com/marketplace) and search for ClickHouse Cloud.
33
-
34
-
<br />
35
-
36
-
<Imageimg={aws_marketplace_payg_1}size="md"alt="AWS Marketplace home page"border/>
37
-
38
-
<br />
39
-
40
-
2. Click on the [listing](https://aws.amazon.com/marketplace/pp/prodview-jettukeanwrfc) and then on **View purchase options**.
41
-
42
-
<br />
43
-
44
-
<Imageimg={aws_marketplace_payg_2}size="md"alt="AWS Marketplace search for ClickHouse"border/>
45
-
46
-
<br />
47
-
48
-
3. On the next screen, configure the contract:
49
-
-**Length of contract** - PAYG contracts run month to month.
50
-
-**Renewal settings** - You can set the contract to auto-renew or not.
51
-
Note that we strongly recommend keeping your subscription set to auto-renew every month. However, if you don't enable auto renewal, your organization is automatically put into a grace period at the end of the billing cycle and then decommissioned.
28
+
:::note
29
+
One AWS account can only subscribe to one “ClickHouse Cloud - Pay As You Go” subscription which can only be linked to one ClickHouse organization.
30
+
:::
52
31
53
-
-**Contract options** - You can input any number (or just 1) into this text box. This will not affect the price you pay as the price for these units for the public offer is $0. These units are usually used when accepting a private offer from ClickHouse Cloud.
54
-
55
-
-**Purchase order** - This is optional and you can ignore this.
After filling out the above information, click on **Create Contract**. You can confirm that the contract price displayed is zero dollars which essentially means that you have no payment due and will incur charges based on usage.
6. Note that at this point, the setup is not complete yet. You will need to redirect to ClickHouse Cloud by clicking on **Set up your account** and signing up on ClickHouse Cloud.
48
+
### Subscribe {#subscribe}
82
49
83
-
7. Once you redirect to ClickHouse Cloud, you can either login with an existing account, or register with a new account. This step is very important so we can bind your ClickHouse Cloud organization to the AWS Marketplace billing.
50
+
On the next screen, click subscribe.
84
51
85
-
<br />
52
+
:::note
53
+
**Purchase order (PO) number** is optional and can be ignored.
54
+
:::
86
55
87
-
<Imageimg={aws_marketplace_payg_6}size="md"alt="ClickHouse Cloud sign in page"border/>
If you are a new ClickHouse Cloud user, click **Register** at the bottom of the page. You will be prompted to create a new user and verify the email. After verifying your email, you can leave the ClickHouse Cloud login page and login using the new username at the [https://console.clickhouse.cloud](https://console.clickhouse.cloud).
60
+
Note that at this point, the setup is not complete and your ClickHouse Cloud organization is not being billed through the marketplace yet. You will now need to click on Set up your account on your marketplace subscription to redirect to ClickHouse Cloud to finish setup.
92
61
93
-
<br/>
62
+
<Imageimg={aws_marketplace_payg_4}alt="Set up your account"border/>
94
63
95
-
<Imageimg={aws_marketplace_payg_7}size="md"alt="ClickHouse Cloud sign up page"border/>
64
+
Once you redirect to ClickHouse Cloud, you can either login with an existing account, or register with a new account. This step is very important so we can bind your ClickHouse Cloud organization to your AWS Marketplace billing.
96
65
97
-
<br />
66
+
:::note[New Clickhouse Cloud Users]
67
+
If you are a new ClickHouse Cloud user, follow the steps below.
68
+
:::
98
69
99
-
Note that if you are a new user, you will also need to provide some basic information about your business. See the screenshots below.
70
+
<details>
71
+
<summary><strong>Steps for new users</strong></summary>
100
72
101
-
<br />
73
+
If you are a new ClickHouse Cloud user, click Register at the bottom of the page. You will be prompted to create a new user and verify the email. After verifying your email, you can leave the ClickHouse Cloud login page and login using the new username at the https://console.clickhouse.cloud.
102
74
103
-
<Imageimg={aws_marketplace_payg_8}size="md"alt="ClickHouse Cloud sign up info form"border/>
You will also need to provide some basic information about your business. See the screenshots below.
79
+
:::
106
80
107
-
<br/>
81
+
<Imageimg={aws_marketplace_payg_6}size="md"alt="Before you start"/>
108
82
109
-
<Imageimg={aws_marketplace_payg_9}size="md"alt="ClickHouse Cloud sign up info form 2"border/>
83
+
<Imageimg={aws_marketplace_payg_7}size="md"alt="Before you star continued"/>
110
84
111
-
<br />
85
+
</details>
112
86
113
87
If you are an existing ClickHouse Cloud user, simply log in using your credentials.
114
88
115
-
8. After successfully logging in, a new ClickHouse Cloud organization will be created. This organization will be connected to your AWS billing account and all usage will be billed via your AWS account.
116
-
117
-
9. Once you login, you can confirm that your billing is in fact tied to the AWS Marketplace and start setting up your ClickHouse Cloud resources.
### Add the Marketplace Subscription to an Organization {#add-marketplace-subscription}
122
90
123
-
<br />
91
+
After successfully logging in, you can decide whether to create a new organization to bill to this marketplace subscription or choose an existing organization to bill to this subscription.
124
92
125
-
<Imageimg={aws_marketplace_payg_11}size="md"alt="ClickHouse Cloud new services page"border/>
Customers must sign a Business Associate Agreement (BAA) and request onboarding through Sales or Support to set up services in HIPAA compliant regions. The following regions support HIPAA compliance:
85
+
- AWS af-south-1 (South Africa) **Private Region**
86
+
- AWS ca-central-1 (Canada) **Private Region**
85
87
- AWS eu-central-1 (Frankfurt)
88
+
- AWS eu-north-1 (Stockholm) **Private Region**
89
+
- AWS eu-west-1 (Ireland)
86
90
- AWS eu-west-2 (London)
91
+
- AWS sa-east-1 (South America) **Private Region**
87
92
- AWS us-east-1 (N. Virginia)
88
93
- AWS us-east-2 (Ohio)
89
94
- AWS us-west-2 (Oregon)
@@ -96,8 +101,13 @@ Customers must sign a Business Associate Agreement (BAA) and request onboarding
0 commit comments