Enabling the Amazon RDS Data API
To use the Amazon RDS Data API (Data API), enable it for your Aurora DB cluster. You can enable Data API when you create or modify the DB cluster.
Note
Whether Data API is available for your cluster depends on your Aurora version, database engine, and AWS Region. For older Aurora versions, Data API only works with Aurora Serverless v1 clusters. For newer Aurora versions, Data API works with clusters that use both provisioned and Aurora Serverless v2 instances. To check whether your cluster can use Data API, see Supported Regions and Aurora DB engines for RDS Data API.
Enabling RDS Data API when you create a database
While you are creating a database that supports RDS Data API (Data API), you can enable this feature. The following procedures describe how to do so when you use the AWS Management Console, the AWS CLI, or the RDS API.
To enable Data API when you create a DB cluster, select the Enable the RDS Data API checkbox in the Connectivity section of the Create database page, as in the following screenshot.

For instructions on how to create an Aurora DB cluster that can use the RDS Data API, see the following:
For Aurora Serverless v2 and provisioned clusters – Creating an Amazon Aurora DB cluster
For Aurora Serverless v1 – Creating an Aurora Serverless v1 DB cluster
To enable Data API while you're creating an Aurora DB cluster, run the
create-db-cluster AWS CLI command with the
--enable-http-endpoint
option.
The following example creates an Aurora PostgreSQL DB cluster with Data API enabled.
For Linux, macOS, or Unix:
aws rds create-db-cluster \ --db-cluster-identifier
my_pg_cluster
\ --engine aurora-postgresql \ --enable-http-endpoint
For Windows:
aws rds create-db-cluster ^ --db-cluster-identifier
my_pg_cluster
^ --engine aurora-postgresql ^ --enable-http-endpoint
To enable Data API while you're creating an Aurora DB cluster, use the
CreateDBCluster operation with the
value of the EnableHttpEndpoint
parameter set to true
.
Enabling RDS Data API on an existing database
You can modify a DB cluster that supports RDS Data API (Data API) to enable or disable this feature.
Topics
Enabling or disabling Data API (Aurora Serverless v2 and provisioned)
Use the following procedures to enable or disable Data API on Aurora Serverless v2 and provisioned databases. To enable or disable Data API on Aurora Serverless v1 databases, use the procedures in Enabling or disabling Data API (Aurora Serverless v1 only).
You can enable or disable Data API by using the RDS console for a DB cluster that supports this feature. To do so, open the cluster details page of the database on which you want to enable or disable Data API, and on the Connectivity & security tab, go to the RDS Data API section. This section displays the status of Data API, and allows you to enable or disable it.
The following screenshot shows that the RDS Data API isn't enabled.

To enable or disable Data API on an existing database, run the enable-http-endpoint or disable-http-endpoint AWS CLI command, and specify the ARN of your DB cluster.
The following example enables Data API.
For Linux, macOS, or Unix:
aws rds enable-http-endpoint \ --resource-arn
cluster_arn
For Windows:
aws rds enable-http-endpoint ^ --resource-arn
cluster_arn
To enable or disable Data API on an existing database, use the EnableHttpEndpoint and DisableHttpEndpoint operations.
Enabling or disabling Data API (Aurora Serverless v1 only)
Use the following procedures to enable or disable Data API on existing Aurora Serverless v1 databases. To enable or disable Data API on Aurora Serverless v2 and provisioned databases, use the procedures in Enabling or disabling Data API (Aurora Serverless v2 and provisioned).
When you modify an Aurora Serverless v1 DB cluster, you enable Data API in the RDS console's Connectivity section.
The following screenshot shows the enabled Data API when modifying an Aurora DB cluster.

For instructions on how to modify an Aurora Serverless v1 DB cluster, see Modifying an Aurora Serverless v1 DB cluster.
To enable or disable Data API, run the
modify-db-cluster AWS CLI command, with the
--enable-http-endpoint
or
--no-enable-http-endpoint
, as applicable.
The following example enables Data API on
sample-cluster
.
For Linux, macOS, or Unix:
aws rds modify-db-cluster \ --db-cluster-identifier sample-cluster \ --enable-http-endpoint
For Windows:
aws rds modify-db-cluster ^ --db-cluster-identifier sample-cluster ^ --enable-http-endpoint
To enable Data API, use the ModifyDBCluster
operation, and set the value of EnableHttpEndpoint
to
true
or false
, as applicable.