# Habilitación de la API de datos de Amazon RDS
<a name="data-api.enabling"></a>

Para utilizar la API de datos de Amazon RDS (API de datos), habilítela para el clúster de base de datos de Aurora. Puede habilitar la API de datos cuando cree o modifique el clúster de base de datos.

**nota**  
 La disponibilidad de la API de datos para el clúster depende de la versión de Aurora, del motor de base de datos y de la región de AWS. En Aurora, la API de datos funciona con clústeres que utilizan tanto instancias de Aurora Serverless v2 como aprovisionadas. Para comprobar si el clúster puede utilizar la API de datos, consulte [Regiones y motores de base de datos Aurora admitidos para API de datos de RDS](Concepts.Aurora_Fea_Regions_DB-eng.Feature.Data_API.md). 

**Topics**
+ [Habilitación de la API de datos de RDS al crear una base de datos](#data-api.enabling.creating)
+ [Habilitación o desactivación de la API de datos de RDS en una DB existente](#data-api.enabling.modifying)

## Habilitación de la API de datos de RDS al crear una base de datos
<a name="data-api.enabling.creating"></a>

Al crear una base de datos compatible con la API de datos de RDS (API de datos), puede habilitar esta característica. Los siguientes procedimientos describen el proceso al utilizar la Consola de administración de AWS, la AWS CLI o la API de RDS.

### Consola
<a name="data-api.enabling.creating.console"></a>

Para habilitar la API de datos al crear un clúster de base de datos, seleccione la casilla **Habilitar la API de datos de RDS** en la sección **Conectividad** de la página **Crear base de datos**, como se muestra en la siguiente captura de pantalla.

![La sección Conectividad de la página Crear base de datos, con la casilla Habilitar la API de datos de RDS seleccionada.](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/AuroraUserGuide/images/data-api-enable-on-create.png)


Para obtener instrucciones sobre cómo crear un clúster de base de datos de Aurora que pueda usar la API de datos de RDS, consulte lo siguiente:
+ En clústeres de Aurora Serverless v2 y aprovisionados: [Creación de un clúster de base de datos de Amazon Aurora](Aurora.CreateInstance.md)

### AWS CLI
<a name="data-api.enabling.creating.cli"></a>

Para habilitar la API de datos mientras crea un clúster de base de datos de Aurora, ejecute el comando de la AWS CLI [create-db-clúster](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-cluster.html) con la opción `--enable-http-endpoint`.

En el ejemplo siguiente se crea un clúster de base de datos de Aurora PostgreSQL con la API de datos habilitada.

Para Linux, macOS o Unix:

```
aws rds create-db-cluster \
	    --db-cluster-identifier {{my_pg_cluster}} \
	    --engine aurora-postgresql \
	    --enable-http-endpoint
```

Para Windows:

```
aws rds create-db-cluster ^
	    --db-cluster-identifier {{my_pg_cluster}} ^
	    --engine aurora-postgresql ^
	    --enable-http-endpoint
```

### API de RDS
<a name="data-api.enabling.creating.api"></a>

Para habilitar la API de datos al crear un clúster de base de datos de Aurora, utilice la operación [CreateDBclúster](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBCluster.html) con el valor del parámetro `EnableHttpEndpoint` establecido en `true`.

## Habilitación o desactivación de la API de datos de RDS en una DB existente
<a name="data-api.enabling.modifying"></a>

Puede modificar un clúster de base de datos que admita la API de datos de RDS (API de datos) para activar o desactivar esta característica.

**Topics**
+ [Habilitación o deshabilitación de la API de datos (Aurora Serverless v2 y aprovisionada)](#data-api.enabling.modifying.all)

### Habilitación o deshabilitación de la API de datos (Aurora Serverless v2 y aprovisionada)
<a name="data-api.enabling.modifying.all"></a>

Utilice los siguientes procedimientos para habilitar o deshabilitar la API de datos en las bases de datos de Aurora Serverless v2 y aprovisionadas. 

#### Consola
<a name="data-api.enabling.modifying.all.console"></a>

Puede habilitar o deshabilitar la API de datos con la consola de RDS para un clúster de base de datos que sea compatible con esta característica. Para ello, abra la página de detalles del clúster de la DB en la que desee activar o desactivar la API de datos y seleccione **Activar API de datos de RDS** o **Desactivar API de datos de RDS** en el menú desplegable **Acciones**. Esto le permitirá activar o desactivar la API de datos de RDS para su clúster.

La siguiente captura de pantalla muestra que la **API de datos de RDS** no está habilitada.

![La sección API de datos de RDS en la pestaña Conectividad y seguridad de la página de detalles de un clúster de base de datos. El estado de la API de datos aparece como deshabilitado y aparece el botón Habilitar la API de datos de RDS.](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/AuroraUserGuide/images/data-api-enable-from-details.png)


#### AWS CLI
<a name="data-api.enabling.modifying.all.cli"></a>

Para habilitar o deshabilitar la API de datos en una base de datos existente, ejecute el comando de la AWS CLI [enable-http-endpoint](https://docs.aws.amazon.com/cli/latest/reference/rds/enable-http-endpoint.html) o [disable-http-endpoint](https://docs.aws.amazon.com/cli/latest/reference/rds/disable-http-endpoint.html) y especifique el ARN de su clúster de base de datos.

En el ejemplo siguiente se habilita la API de datos.

Para Linux, macOS o Unix:

```
aws rds enable-http-endpoint \
	    --resource-arn {{cluster_arn}}
```

Para Windows:

```
aws rds enable-http-endpoint ^
	    --resource-arn {{cluster_arn}}
```

#### API de RDS
<a name="data-api.enabling.modifying.all.api"></a>

Para habilitar o deshabilitar la API de datos en una base de datos existente, utilice las operaciones [EnableHttpEndpoint](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_EnableHttpEndpoint.html) y [DisableHttpEndpoint](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DisableHttpEndpoint.html).