From f81980e23b315defb0b4ce894b39202cf04b9379 Mon Sep 17 00:00:00 2001 From: lilin90 Date: Tue, 12 May 2026 18:00:49 +0800 Subject: [PATCH 1/7] tidb-cloud: add a note for Starter agent plan --- tidb-cloud/architecture-concepts.md | 2 +- tidb-cloud/select-cluster-tier.md | 7 ++++++- 2 files changed, 7 insertions(+), 2 deletions(-) diff --git a/tidb-cloud/architecture-concepts.md b/tidb-cloud/architecture-concepts.md index 51379522a2425..fd21c6ceccd33 100644 --- a/tidb-cloud/architecture-concepts.md +++ b/tidb-cloud/architecture-concepts.md @@ -42,7 +42,7 @@ TiDB Cloud makes it easy to scale your database, handle complex management tasks The Starter plan is ideal for those who are getting started with TiDB Cloud. It provides developers and small teams with the following features: -- **No cost**: This plan is completely free, with no credit card required to get started. +- **No cost**: This plan is completely free within the [free quota](https://www.pingcap.com/tidb-cloud-starter-pricing-details/). No credit card is required to get started. - **Storage**: Provides an initial 5 GiB of row-based storage and 5 GiB of columnar storage. - **Request Units**: Includes 50 million [Request Units (RUs)](/tidb-cloud/tidb-cloud-glossary.md#request-unit-ru) for database operations. diff --git a/tidb-cloud/select-cluster-tier.md b/tidb-cloud/select-cluster-tier.md index ef02871fa6118..8df7e68b71294 100644 --- a/tidb-cloud/select-cluster-tier.md +++ b/tidb-cloud/select-cluster-tier.md @@ -25,10 +25,15 @@ TiDB Cloud Starter is a fully managed, multi-tenant TiDB offering. It delivers a The free plan is ideal for those who are getting started with {{{ .starter }}}. It provides developers and small teams with the following essential features: -- **No cost**: This plan is completely free, with no credit card required to get started. +- **No cost**: This plan is completely free within the [free quota](https://www.pingcap.com/tidb-cloud-starter-pricing-details/). No credit card is required to get started. - **Storage**: Provides an initial 5 GiB of row-based storage and 5 GiB of columnar storage. - **Request Units**: Includes 50 million [Request Units (RUs)](/tidb-cloud/tidb-cloud-glossary.md#request-unit-ru) for database operations. +> **Note:** +> +> - To better support agent platform builders who need to create a large number of lightweight instances for their end users, TiDB Cloud offers the **Agent Plan**. With this plan, each TiDB Cloud organization can create up to 100 free {{{ .starter }}} instances. To learn more and apply for the Agent Plan, fill out the [application form](https://www.pingcap.com/agent-plan/). +> - You will receive an email notification once your application for the Agent Plan is approved. You will also be notified via email and the TiDB Cloud console when you are approaching the limit of 100 free {{{ .starter }}} instances in your organization. + ### Usage quota For each organization in TiDB Cloud, you can create a maximum of five free {{{ .starter }}} instances by default. To create more {{{ .starter }}} instances, you need to add a credit card and specify a spending limit. From 64deae173314c796afd4373b68605a8b82ffb37a Mon Sep 17 00:00:00 2001 From: lilin90 Date: Tue, 12 May 2026 18:10:25 +0800 Subject: [PATCH 2/7] Update notification condition --- tidb-cloud/select-cluster-tier.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/tidb-cloud/select-cluster-tier.md b/tidb-cloud/select-cluster-tier.md index 8df7e68b71294..540c24299e4ed 100644 --- a/tidb-cloud/select-cluster-tier.md +++ b/tidb-cloud/select-cluster-tier.md @@ -32,7 +32,7 @@ The free plan is ideal for those who are getting started with {{{ .starter }}}. > **Note:** > > - To better support agent platform builders who need to create a large number of lightweight instances for their end users, TiDB Cloud offers the **Agent Plan**. With this plan, each TiDB Cloud organization can create up to 100 free {{{ .starter }}} instances. To learn more and apply for the Agent Plan, fill out the [application form](https://www.pingcap.com/agent-plan/). -> - You will receive an email notification once your application for the Agent Plan is approved. You will also be notified via email and the TiDB Cloud console when you are approaching the limit of 100 free {{{ .starter }}} instances in your organization. +> - You will receive an email notification once your application for the Agent Plan is approved. You will also be notified via email and the TiDB Cloud console when the number of free {{{ .starter }}} instances in your organization reaches 80 and 100. ### Usage quota From beaceeaca9162a6767be850386e12a475590bddc Mon Sep 17 00:00:00 2001 From: Lilian Lee Date: Wed, 13 May 2026 10:15:14 +0800 Subject: [PATCH 3/7] Apply suggestions from code review Co-authored-by: Grace Cai --- tidb-cloud/architecture-concepts.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/tidb-cloud/architecture-concepts.md b/tidb-cloud/architecture-concepts.md index fd21c6ceccd33..1c91037ef8d45 100644 --- a/tidb-cloud/architecture-concepts.md +++ b/tidb-cloud/architecture-concepts.md @@ -42,7 +42,8 @@ TiDB Cloud makes it easy to scale your database, handle complex management tasks The Starter plan is ideal for those who are getting started with TiDB Cloud. It provides developers and small teams with the following features: -- **No cost**: This plan is completely free within the [free quota](https://www.pingcap.com/tidb-cloud-starter-pricing-details/). No credit card is required to get started. +- **No cost**: This plan is free when usage is within the [free quota](https://www.pingcap.com/tidb-cloud-starter-pricing-details/). No credit card is required to get started. + - **Storage**: Provides an initial 5 GiB of row-based storage and 5 GiB of columnar storage. - **Request Units**: Includes 50 million [Request Units (RUs)](/tidb-cloud/tidb-cloud-glossary.md#request-unit-ru) for database operations. From 08efd3febfbb23f5cb1cdc6d8589196f11fc61e4 Mon Sep 17 00:00:00 2001 From: Lilian Lee Date: Wed, 13 May 2026 10:15:27 +0800 Subject: [PATCH 4/7] Apply suggestions from code review Co-authored-by: Grace Cai --- tidb-cloud/select-cluster-tier.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/tidb-cloud/select-cluster-tier.md b/tidb-cloud/select-cluster-tier.md index 540c24299e4ed..d77ca110c10cd 100644 --- a/tidb-cloud/select-cluster-tier.md +++ b/tidb-cloud/select-cluster-tier.md @@ -25,7 +25,8 @@ TiDB Cloud Starter is a fully managed, multi-tenant TiDB offering. It delivers a The free plan is ideal for those who are getting started with {{{ .starter }}}. It provides developers and small teams with the following essential features: -- **No cost**: This plan is completely free within the [free quota](https://www.pingcap.com/tidb-cloud-starter-pricing-details/). No credit card is required to get started. +- **No cost**: This plan is free when usage is within the [free quota](https://www.pingcap.com/tidb-cloud-starter-pricing-details/). No credit card is required to get started. + - **Storage**: Provides an initial 5 GiB of row-based storage and 5 GiB of columnar storage. - **Request Units**: Includes 50 million [Request Units (RUs)](/tidb-cloud/tidb-cloud-glossary.md#request-unit-ru) for database operations. From bbb6d3f3ee8faaa1072efc86270368f65d4cb419 Mon Sep 17 00:00:00 2001 From: lilin90 Date: Wed, 13 May 2026 11:00:52 +0800 Subject: [PATCH 5/7] Add branch count --- tidb-cloud/select-cluster-tier.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/tidb-cloud/select-cluster-tier.md b/tidb-cloud/select-cluster-tier.md index d77ca110c10cd..7c1dc0ea532c3 100644 --- a/tidb-cloud/select-cluster-tier.md +++ b/tidb-cloud/select-cluster-tier.md @@ -32,8 +32,10 @@ The free plan is ideal for those who are getting started with {{{ .starter }}}. > **Note:** > -> - To better support agent platform builders who need to create a large number of lightweight instances for their end users, TiDB Cloud offers the **Agent Plan**. With this plan, each TiDB Cloud organization can create up to 100 free {{{ .starter }}} instances. To learn more and apply for the Agent Plan, fill out the [application form](https://www.pingcap.com/agent-plan/). -> - You will receive an email notification once your application for the Agent Plan is approved. You will also be notified via email and the TiDB Cloud console when the number of free {{{ .starter }}} instances in your organization reaches 80 and 100. +> - To better support agent platform builders who need to create a large number of lightweight instances for their end users, TiDB Cloud offers the **Agent Plan**. With this plan, each TiDB Cloud organization can create up to 100 free {{{ .starter }}} instances in total, with each [branch](/tidb-cloud/branch-overview.md) counted as a separate instance. To learn more and apply for the Agent Plan, fill out the [application form](https://www.pingcap.com/agent-plan/). +> - You will receive an email notification once your application for the Agent Plan is approved. You will also be notified via email and the TiDB Cloud console when the total number of free {{{ .starter }}} instances (including branches) in your organization reaches 80 and 100. + +With this plan, each TiDB Cloud organization can create up to 100 free {{{ .starter }}} resources in total, including {{{ .starter }}} instances and [branches](/tidb-cloud/branch-overview.md) of these instances. ### Usage quota From b7323fc1d397c3df0d72572a686a617f0ebab2cf Mon Sep 17 00:00:00 2001 From: lilin90 Date: Wed, 13 May 2026 11:04:14 +0800 Subject: [PATCH 6/7] Update select-cluster-tier.md --- tidb-cloud/select-cluster-tier.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/tidb-cloud/select-cluster-tier.md b/tidb-cloud/select-cluster-tier.md index 7c1dc0ea532c3..d587e9729d81a 100644 --- a/tidb-cloud/select-cluster-tier.md +++ b/tidb-cloud/select-cluster-tier.md @@ -35,8 +35,6 @@ The free plan is ideal for those who are getting started with {{{ .starter }}}. > - To better support agent platform builders who need to create a large number of lightweight instances for their end users, TiDB Cloud offers the **Agent Plan**. With this plan, each TiDB Cloud organization can create up to 100 free {{{ .starter }}} instances in total, with each [branch](/tidb-cloud/branch-overview.md) counted as a separate instance. To learn more and apply for the Agent Plan, fill out the [application form](https://www.pingcap.com/agent-plan/). > - You will receive an email notification once your application for the Agent Plan is approved. You will also be notified via email and the TiDB Cloud console when the total number of free {{{ .starter }}} instances (including branches) in your organization reaches 80 and 100. -With this plan, each TiDB Cloud organization can create up to 100 free {{{ .starter }}} resources in total, including {{{ .starter }}} instances and [branches](/tidb-cloud/branch-overview.md) of these instances. - ### Usage quota For each organization in TiDB Cloud, you can create a maximum of five free {{{ .starter }}} instances by default. To create more {{{ .starter }}} instances, you need to add a credit card and specify a spending limit. From ab7ee26e3e41d2bd3c000c0d6b660cdc1b19c0f2 Mon Sep 17 00:00:00 2001 From: lilin90 Date: Wed, 13 May 2026 11:27:46 +0800 Subject: [PATCH 7/7] Reorganize content and update branch page --- tidb-cloud/branch-overview.md | 4 ++++ tidb-cloud/select-cluster-tier.md | 11 ++++++----- 2 files changed, 10 insertions(+), 5 deletions(-) diff --git a/tidb-cloud/branch-overview.md b/tidb-cloud/branch-overview.md index f136517546f3b..423698f277fab 100644 --- a/tidb-cloud/branch-overview.md +++ b/tidb-cloud/branch-overview.md @@ -41,6 +41,10 @@ Currently, TiDB Cloud branches are in beta and free of charge. - For each organization in TiDB Cloud, you can create a maximum of five branches by default across all {{{ .starter }}} and Essential instances. The branches of a {{{ .starter }}} or Essential instance will be created in the same region as the instance, and you cannot create branches for a {{{ .starter }}} or Essential instance that is throttled or larger than 100 GiB. + > **Note:** + > + > To better support agent platform builders who need to create a large number of lightweight instances for their end users, TiDB Cloud offers the **Agent Plan**. With this plan, each TiDB Cloud organization can create up to 100 free {{{ .starter }}} instances in total, with each branch counted as a separate instance. To learn more, see the [Agent Plan](/tidb-cloud/select-cluster-tier.md#agent-plan). + - For each branch of a free {{{ .starter }}} instance, 10 GiB storage is allowed. For each branch of a {{{ .starter }}} instance with spending limit > 0, 100 GiB storage is allowed. Once the storage is reached, the read and write operations on this branch will be throttled until you reduce the storage. - Branches are intended for short-term feature development and functional testing. Because branches lack auto-scaling capability, they are not suitable for performance testing. diff --git a/tidb-cloud/select-cluster-tier.md b/tidb-cloud/select-cluster-tier.md index d587e9729d81a..54fb25588989c 100644 --- a/tidb-cloud/select-cluster-tier.md +++ b/tidb-cloud/select-cluster-tier.md @@ -30,11 +30,6 @@ The free plan is ideal for those who are getting started with {{{ .starter }}}. - **Storage**: Provides an initial 5 GiB of row-based storage and 5 GiB of columnar storage. - **Request Units**: Includes 50 million [Request Units (RUs)](/tidb-cloud/tidb-cloud-glossary.md#request-unit-ru) for database operations. -> **Note:** -> -> - To better support agent platform builders who need to create a large number of lightweight instances for their end users, TiDB Cloud offers the **Agent Plan**. With this plan, each TiDB Cloud organization can create up to 100 free {{{ .starter }}} instances in total, with each [branch](/tidb-cloud/branch-overview.md) counted as a separate instance. To learn more and apply for the Agent Plan, fill out the [application form](https://www.pingcap.com/agent-plan/). -> - You will receive an email notification once your application for the Agent Plan is approved. You will also be notified via email and the TiDB Cloud console when the total number of free {{{ .starter }}} instances (including branches) in your organization reaches 80 and 100. - ### Usage quota For each organization in TiDB Cloud, you can create a maximum of five free {{{ .starter }}} instances by default. To create more {{{ .starter }}} instances, you need to add a credit card and specify a spending limit. @@ -51,6 +46,12 @@ Once a {{{ .starter }}} instance reaches its usage quota, it immediately denies To learn more about the RU consumption of different resources (including read, write, SQL CPU, and network egress), the pricing details, and the throttled information, see [{{{ .starter }}} Pricing Details](https://www.pingcap.com/tidb-cloud-starter-pricing-details/). +### Agent Plan + +To better support agent platform builders who need to create a large number of lightweight instances for their end users, TiDB Cloud offers the **Agent Plan**. With this plan, each TiDB Cloud organization can create up to 100 free {{{ .starter }}} instances in total, with each [branch](/tidb-cloud/branch-overview.md) counted as a separate instance. To learn more and apply for the Agent Plan, fill out the [application form](https://www.pingcap.com/agent-plan/). + +You will receive an email notification once your application for the Agent Plan is approved. You will also be notified via email and the TiDB Cloud console when the total number of free {{{ .starter }}} instances (including branches) in your organization reaches 80 and 100. + ## {{{ .essential }}} {#essential} For applications experiencing growing workloads and needing scalability in real time, the Essential plan provides the flexibility and performance to keep pace with your business growth with the following features: