feature/rename-serverless: add the docs and content about the AWS support

TOC-tidb-cloud.md

@@ -67,6 +67,7 @@
     - [Sequelize](/develop/dev-guide-sample-application-nodejs-sequelize.md)
     - [TypeORM](/develop/dev-guide-sample-application-nodejs-typeorm.md)
     - [Next.js](/develop/dev-guide-sample-application-nextjs.md)
+    - [AWS Lambda](/develop/dev-guide-sample-application-aws-lambda.md)
   - Ruby
     - [mysql2](/develop/dev-guide-sample-application-ruby-mysql2.md)
     - [Rails](/develop/dev-guide-sample-application-ruby-rails.md)
@@ -137,7 +138,8 @@
     - Connect to Your TiDB Cloud Cluster
       - [Connection Overview](/tidb-cloud/connect-to-tidb-cluster-serverless.md)
       - [Connect via Public Endpoint](/tidb-cloud/connect-via-standard-connection-serverless.md)
-      - [Connect via Private Endpoint](/tidb-cloud/set-up-private-endpoint-connections-serverless.md)
+      - [Connect via Private Endpoint with AWS](/tidb-cloud/set-up-private-endpoint-connections-aws.md)
+      - [Connect via Private Endpoint with Alibaba Cloud](/tidb-cloud/set-up-private-endpoint-connections-serverless.md)
     - Branch ![BETA](/media/tidb-cloud/blank_transparent_placeholder.png)
       - [Overview](/tidb-cloud/branch-overview.md)
       - [Manage Branches](/tidb-cloud/branch-manage.md)
@@ -230,6 +232,7 @@
     - [Naming Conventions for Data Import](/tidb-cloud/naming-conventions-for-data-import.md)
     - [CSV Configurations for Importing Data](/tidb-cloud/csv-config-for-import-data.md)
     - [Troubleshoot Access Denied Errors during Data Import from Amazon S3](/tidb-cloud/troubleshoot-import-access-denied-error.md)
+    - [Connect AWS DMS to TiDB Cloud clusters](/tidb-cloud/tidb-cloud-connect-aws-dms.md)
 - Explore Data
   - [Chat2Query in SQL Editor](/tidb-cloud/explore-data-with-chat2query.md) ![BETA](/media/tidb-cloud/blank_transparent_placeholder.png)
   - [SQL Proxy Account](/tidb-cloud/sql-proxy-account.md)
@@ -298,9 +301,12 @@
   - [Billing Profile](/tidb-cloud/tidb-cloud-billing.md#billing-profile)
   - [Credits](/tidb-cloud/tidb-cloud-billing.md#credits)
   - [Payment Method Setting](/tidb-cloud/tidb-cloud-billing.md#payment-method)
+  - [Billing from AWS Marketplace](/tidb-cloud/tidb-cloud-billing.md#billing-from-aws-marketplace)
   - [Manage Budgets](/tidb-cloud/tidb-cloud-budget.md)
 - Integrations
   - [Airbyte](/tidb-cloud/integrate-tidbcloud-with-airbyte.md)
+  - [Amazon AppFlow](/develop/dev-guide-aws-appflow-integration.md)
+  - [AWS Lambda](/tidb-cloud/integrate-tidbcloud-with-aws-lambda.md)
   - [Cloudflare](/tidb-cloud/integrate-tidbcloud-with-cloudflare.md)
   - [dbt](/tidb-cloud/integrate-tidbcloud-with-dbt.md)
   - [Gitpod](/develop/dev-guide-playground-gitpod.md)

develop/dev-guide-sample-application-aws-lambda.md

@@ -14,10 +14,6 @@ In this tutorial, you can learn how to use TiDB and mysql2 in AWS Lambda Functio
 - Build and run your application. Optionally, you can find [sample code snippets](#sample-code-snippets) for basic CRUD operations.
 - Deploy your AWS Lambda Function.
 
-> **Note**
->
-> This tutorial works with TiDB Cloud Starter.
-
 ## Prerequisites
 
 To complete this tutorial, you need:

tidb-cloud/architecture-concepts.md

@@ -5,7 +5,7 @@
 
 # Architecture
 
-TiDB Cloud is a fully-managed Database-as-a-Service (DBaaS) that brings the flexibility and power of [TiDB](https://docs.pingcap.com/tidb/stable/overview), an open-source HTAP (Hybrid Transactional and Analytical Processing) database, to Amazon Web Services (AWS), Google Cloud, and Alibaba Cloud.
+TiDB Cloud is a fully-managed Database-as-a-Service (DBaaS) that brings the flexibility and power of [TiDB](https://docs.pingcap.com/tidb/stable/overview), an open-source HTAP (Hybrid Transactional and Analytical Processing) database, to Amazon Web Services (AWS), Azure, Google Cloud, and Alibaba Cloud.
 
 TiDB is MySQL-compatible, making it easy to migrate and work with existing applications, while offering seamless scalability to handle everything from small workloads to massive, high-performance clusters. It supports both transactional (OLTP) and analytical (OLAP) workloads in one system, simplifying operations and enabling real-time insights.
 
@@ -39,7 +39,7 @@
 
 ## TiDB Cloud API (Beta)
 
-The TiDB Cloud API is a REST-based interface that provides programmatic access to manage resources across TiDB Cloud Starter clusters. It enables automated and efficient handling of tasks such as managing projects, clusters, backups, restores, data imports, and billing.
+The TiDB Cloud API is a REST-based interface that provides programmatic access to manage resources across TiDB Cloud Starter clusters. It enables automated and efficient handling of tasks such as managing projects, clusters, backups, restores, data imports, billing, and other resources in [TiDB Cloud Data Service](/tidb-cloud/data-service-overview.md).
 
 For more information, see [TiDB Cloud API Overview](/tidb-cloud/api-overview.md).
 

tidb-cloud/create-tidb-cluster-serverless.md

@@ -12,6 +12,8 @@ This document describes how to create a TiDB Cloud cluster in the [TiDB Cloud co
 If you do not have a TiDB Cloud account, click [here](https://console.tidb.io/free-trial?provider_source=alicloud) to sign up for an account.
 
 - You can either sign up with email and password so that you can manage your password using TiDB Cloud, or sign up with your Google, GitHub, or Microsoft account.
+- For AWS Marketplace users, you can also sign up through AWS Marketplace. To do that, search for `TiDB Cloud` in [AWS Marketplace](https://aws.amazon.com/marketplace), subscribe to TiDB Cloud, and then follow the onscreen instructions to set up your TiDB Cloud account.
+- For Alibaba Cloud Marketplace users, you can also sign up through Alibaba Cloud Marketplace. To do that, search for `TiDB Cloud` in [Alibaba Cloud Marketplace](https://marketplace.alibabacloud.com/), subscribe to TiDB Cloud, and then follow the onscreen instructions to set up your TiDB Cloud account.
 
 ## Steps
 
@@ -23,7 +25,7 @@ If you are in the `Organization Owner` or the `Project Owner` role, you can crea
 
 3. Select a cluster plan. TiDB Cloud provides two [cluster plans](/tidb-cloud/select-cluster-tier.md#cluster-plans): **Starter** and **Essential**. You can start with a Starter cluster and later upgrade to an Essential cluster as your needs grow.
 
-4. The cloud provider is Alibaba Cloud. You can select an Alibaba Cloud region where you want to host your cluster.
+4. Choose a cloud provider and a region where you want to host your cluster.
 
 5. Update the default cluster name if necessary.
 

tidb-cloud/integrate-tidbcloud-with-aws-lambda.md

@@ -0,0 +1,202 @@
+---
+title: Integrate TiDB Cloud Starter with Amazon Lambda Using AWS CloudFormation
+summary: Introduce how to integrate TiDB Cloud Starter with Amazon Lambda and CloudFormation step by step.
+---
+
+# Integrate TiDB Cloud Starter with Amazon Lambda Using AWS CloudFormation
+
+This document provides a step-by-step guide on how to use [AWS CloudFormation](https://aws.amazon.com/cloudformation/) to integrate [TiDB Cloud Starter](/tidb-cloud/create-tidb-cluster-serverless.md#tidb-cloud-starter), a cloud-native distributed SQL database, with [AWS Lambda](https://aws.amazon.com/lambda/), a serverless and event-driven compute service. By integrating TiDB Cloud Starter with Amazon Lambda, you can leverage the scalability and cost-efficiency of microservices through TiDB Cloud Starter and AWS Lambda. AWS CloudFormation automates the creation and management of AWS resources, including Lambda functions, API Gateway, and Secrets Manager.
+
+## Solution overview
+
+In this guide, you will create a fully functional online bookshop with the following components:
+
+- AWS Lambda Function: handles requests and queries data from a TiDB Cloud Starter cluster using Sequelize ORM and Fastify API framework.
+- AWS Secrets Manager SDK: retrieves and manages connection configurations for the TiDB Cloud Starter cluster.
+- AWS API Gateway: handles HTTP request routes.
+- TiDB Cloud Starter: a cloud-native distributed SQL database.
+
+AWS CloudFormation is used to create the necessary resources for the project, including the Secrets Manager, API Gateway, and Lambda Functions.
+
+The structure of the bookshop project is as follows:
+
+![AWS Lambda structure overview](/media/develop/aws-lambda-structure-overview.png)
+
+## Prerequisites
+
+Before getting started, ensure that you have the following:
+
+- An AWS account with access to the following AWS services:
+    - [AWS CloudFormation](https://aws.amazon.com/cloudformation/)
+    - [Secrets Manager](https://aws.amazon.com/secrets-manager/)
+    - [API Gateway](https://aws.amazon.com/api-gateway/)
+    - [Lambda services](https://aws.amazon.com/lambda/)
+    - [S3](https://aws.amazon.com/s3/)
+    - [IAM Roles](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html)
+- A [TiDB Cloud](https://console.tidb.io/) account and a TiDB Cloud Starter cluster. Get the connection information for your TiDB Cloud Starter cluster:
+
+    ![TiDB Cloud connection information](/media/develop/aws-lambda-tidbcloud-connection-info.png)
+
+- API test tools such as [Postman](https://www.postman.com/) and [cURL](https://curl.se/). Most examples in this document use cURL. For Windows users, Postman is recommended.
+- Download the [latest release assets](https://github.com/pingcap/TiDB-Lambda-integration/releases/latest) of the project to your local machine, which includes `cloudformation_template.yml` and `cloudformation_template.json` files.
+
+> **Note:**
+>
+> - When you create the AWS resources, it is recommended to use `us-east-1` as your cluster region. This is because the Lambda function code in this demo hardcodes the region as `us-east-1`, and the code bundle is stored in the `us-east-1` region. 
+> - If you use a different region, you need to follow the following instructions to modify the Lambda function code, rebuild it, and upload the code bundle to your own S3 bucket.
+
+<details>
+<summary>Modify and rebuild the Lambda function code if you use a region other than <code>us-east-1</code></summary>
+
+If you use `us-east-1` as your cluster region, skip this section and go to [Step 1: Set up the project using AWS CloudFormation](#step-1-set-up-the-bookshop-project-using-aws-cloudformation).
+
+If you use a different AWS region other than `us-east-1` to create the AWS resources, you need to modify the Lambda function code, rebuild it, and upload the code bundle to your own S3 bucket.
+
+To avoid local development environment issues, it is recommended that you use a cloud-native development environment, such as [Gitpod](https://www.gitpod.io/).
+
+To rebuild and upload the code bundle to your own S3 bucket, do the following:
+
+1. Initialize the development environment.
+
+    - Open the [Gitpod](https://gitpod.io/#/https://github.com/pingcap/TiDB-Lambda-integration) workspace and log in with your GitHub account.
+
+2. Modify the Lambda function code.
+
+    1. Open the `aws-lambda-cloudformation/src/secretManager.ts` file in the left sidebar.
+    2. Locate the line 22 and then modify the `region` variable to match your own region.
+
+3. Rebuild the code bundle.
+
+    1. Install the dependencies.
+
+        1. Open a terminal in Gitpod.
+        2. Enter the working directory:
+
+            ```shell
+            cd aws-lambda-cloudformation
+            ```
+
+        3. Install the dependencies:
+
+            ```shell
+            yarn
+            ```
+
+    2. Rebuild the code bundle.
+
+        1. Build the code bundle.
+
+            ```shell
+            yarn build
+            ```
+
+        2. Check the `aws-lambda-cloudformation/dist/index.zip` file.
+        3. Right-click the `index.zip` file and select **Download**.
+
+4. Upload the rebuilt code bundle to your own S3 bucket.
+
+    1. Visit the [S3 service](https://console.aws.amazon.com/s3) in the AWS Management Console.
+    2. Create a new bucket in your selected region.
+    3. Upload the `index.zip` file to the bucket.
+    4. Note down the S3 bucket name and region for later use.
+
+</details>
+
+## Step 1. Set up the bookshop project using AWS CloudFormation
+
+To set up the bookshop project using AWS CloudFormation, do the following:
+
+1. Navigate to the AWS Management Console and access the [AWS CloudFormation service](https://console.aws.amazon.com/cloudformation).
+2. Click **Create Stack** > **With new resources (standard)**.
+3. On the **Create Stack** page, complete the stack creation process.
+
+    1. In the **Prerequisite** area, select **Choose an existing template**.
+    2. In the **Specify template** area, select **Upload a template file**, click **Choose file** to upload the template file (either YAML or JSON), and click **Next**.
+
+        If you do not have the file yet, download it from [GitHub](https://github.com/pingcap/TiDB-Lambda-integration/releases/latest). The file contains the AWS CloudFormation template that creates the necessary resources for the project.
+
+        ![Create a stack](/media/develop/aws-lambda-cf-create-stack.png)
+
+    3. Specify stack details.
+
+        - If you use `us-east-1` as your cluster region, fill in the fields as in the following screenshot:
+
+            ![Specify AWS Lambda stack details](/media/develop/aws-lambda-cf-stack-config.png)
+
+            - **Stack name**: enter the stack name.
+            - **S3Bucket**: enter the S3 bucket where you store the zip file.
+            - **S3Key**: enter the S3 key.
+            - **TiDBDatabase**: enter the TiDB Cloud cluster name.
+            - **TiDBHost**: enter the host URL for TiDB Cloud database access. Enter `localhost`.
+            - **TiDBPassword**: enter the password for TiDB Cloud database access.
+            - **TiDBPort**: enter the port for TiDB Cloud database access.
+            - **TiDBUser**: enter the user name for TiDB Cloud database access.
+
+        - If you use a different AWS region other than `us-east-1`, follow these steps:
+
+            1. Refer to [Modify and rebuild the Lambda function code if you use a region other than `us-east-1`](#prerequisites) to modify the Lambda function code, rebuild it, and upload the code bundle to your own S3 bucket.
+            2. In the stack details fields, specify the S3 bucket name and region in the `S3Bucket` and `S3Key` parameters according to your own configuration.
+            3. Fill in other fields as in the preceding screenshot.
+
+    4. Configure stack options. You can use the default configurations.
+
+        ![Configure stack options](/media/develop/aws-lambda-cf-stack-config-option.png)
+
+    5. Review and create the stack.
+
+        ![Review and create the stack](/media/develop/aws-lambda-cf-stack-config-review.png)
+
+## Step 2. Use the bookshop project
+
+After the stack has been created, you can use the project as follows:
+
+1. Visit the [API Gateway service](https://console.aws.amazon.com/apigateway) in the AWS Management Console, click the `TiDBCloudApiGatewayV2` API, and then click **API: TiDBCloudApiGatewayV2** in the left pane.
+
+2. Copy the `Invoke URL` from the **Overview** page. This URL serves as the API endpoint.
+
+    ![API Gateway Invoke URL](/media/develop/aws-lambda-get-apigateway-invoke-url.png)
+
+3. Use API test tools such as Postman and cURL to test the API:
+
+    - Init mock books:
+
+        ```shell
+        curl -X POST -H "Content-Type: application/json" -d '{"count":100}' https://<your-api-endpoint>/book/init
+        ```
+
+    - Get all books:
+
+        ```shell
+        curl https://<your-api-endpoint>/book
+        ```
+
+    - Get a book by the book ID:
+
+        ```shell
+        curl https://<your-api-endpoint>/book/<book-id>
+        ```
+
+    - Create a book:
+
+        ```shell
+        curl -X POST -H "Content-Type: application/json" -d '{ "title": "Book Title", "type": "Test", "publishAt": "2022-12-15T21:01:49.000Z", "stock": 123, "price": 12.34, "authors": "Test Test" }' https://  <your-api-endpoint>/book
+        ```
+
+    - Update a book:
+
+        ```shell
+        curl -X PUT -H "Content-Type: application/json" -d '{ "title": "Book Title(updated)" }' https://<your-api-endpoint>/book/<book-id>
+        ```
+
+    - Delete a book:
+
+        ```shell
+        curl -X DELETE https://<your-api-endpoint>/book/<book-id>
+        ```
+
+## Step 3. Clean up resources
+
+To avoid unnecessary charges, clean up all resources that have been created.
+
+1. Access the [AWS Management Console](https://console.aws.amazon.com/cloudformation).
+2. Delete the AWS CloudFormation stack that you created.

tidb-cloud/migrate-from-oracle-using-aws-dms.md

@@ -88,11 +88,9 @@ After you finish executing the SQL script, check the data in Oracle. The followi
 
     ![Create AWS DMS Instance](/media/tidb-cloud/aws-dms-from-oracle-to-tidb-8.png)
 
-<!--
 > **Note:**
 >
 > For detailed steps on creating an AWS DMS replication instance to work with TiDB Cloud Starter, see [Connect AWS DMS to TiDB Cloud clusters](/tidb-cloud/tidb-cloud-connect-aws-dms.md).
--->
 
 ## Step 6. Create DMS endpoints
 
@@ -108,11 +106,9 @@ After you finish executing the SQL script, check the data in Oracle. The followi
 
     ![Create AWS DMS Target endpoint](/media/tidb-cloud/aws-dms-from-oracle-to-tidb-10.png)
 
-<!--
 > **Note:**
 >
 > For detailed steps on creating a TiDB Cloud Starter DMS endpoint, see [Connect AWS DMS to TiDB Cloud clusters](/tidb-cloud/tidb-cloud-connect-aws-dms.md).
--->
 
 ## Step 7. Migrate the schema
 

tidb-cloud/serverless-export.md

@@ -242,7 +242,7 @@ When exporting data to the Parquet format, the data conversion between TiDB Clou
     - **Compression**: choose **Gzip**, **Snappy**, **Zstd**, or **None**.
     - **Folder URI**: enter the URI of the Amazon S3 with the `s3://<bucket-name>/<folder-path>/` format.
     - **Bucket Access**: choose one of the following access credentials and then fill in the credential information:
-        - **AWS Role ARN**: enter the role ARN that has the permission to access the bucket. It is recommended to create the role ARN with AWS CloudFormation. For more information, see [configure external storage access for TiDB Cloud](/tidb-cloud/serverless-external-storage.md#configure-amazon-s3-access).
+        - **AWS Role ARN**: enter the role ARN that has the permission to access the bucket. It is recommended to create the role ARN with AWS CloudFormation. For more information, see [Configure Amazon S3 access](/tidb-cloud/serverless-external-storage.md#configure-amazon-s3-access).
         - **AWS Access Key**: enter the access key ID and access key secret that have the permission to access the bucket.
 
 4. Click **Export**.

tidb-cloud/serverless-faqs.md

@@ -27,9 +27,9 @@ For each organization in TiDB Cloud, you can create a maximum of five [free clus
 
 Some of TiDB Cloud features are partially supported or not supported on TiDB Cloud Starter. For more information, see [TiDB Cloud Starter Limitations and Quotas](/tidb-cloud/serverless-limitations.md).
 
-### When will TiDB Cloud Starter be available on cloud platforms other than Alibaba Cloud, such as Google Cloud or AWS?
+### When will TiDB Cloud Starter be available on cloud platforms other than AWS and Alibaba Cloud, such as Google Cloud?
 
-We are actively working on expanding TiDB Cloud Starter to other cloud platforms, including Google Cloud and AWS. However, we do not have an exact timeline for now as we currently focus on filling gaps and ensuring seamless functionality across all environments. Rest assured, we are working hard to make TiDB Cloud Starter available on more cloud platforms, and we will keep our community updated as we progress.
+We are actively working on expanding TiDB Cloud Starter to other cloud platforms, such as Google Cloud. However, we do not have an exact timeline for now as we currently focus on filling gaps and ensuring seamless functionality across all environments. Rest assured, we are working hard to make TiDB Cloud Starter available on more cloud platforms, and we will keep our community updated as we progress.
 
 ### What is columnar storage in TiDB Cloud Starter?