# 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 las versiones anteriores de Aurora, la API de datos solo funciona con los clústeres de Aurora Serverless v1. En las versiones más recientes de 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 de la API de datos de RDS en una base de datos 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)
+ Para:Aurora Serverless v1 [Creación de un clúster de bases de datos de Aurora Serverless v1](aurora-serverless.create.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 de la API de datos de RDS en una base de datos 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 (solo Aurora Serverless v1)](#data-api.enabling.modifying.sv1)

### 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. Para activar o desactivar la API de datos en las bases de datos de Aurora Serverless v1, utilice los procedimientos descritos en [Habilitación o deshabilitación de la API de datos (solo Aurora Serverless v1)](#data-api.enabling.modifying.sv1).

#### 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 base de datos en la que desee habilitar o deshabilitar la API de datos y, en la pestaña **Conectividad y seguridad**, vaya a la sección **API de datos de RDS**. Esta sección muestra el estado de la API de datos y le permite habilitarla o deshabilitarla.

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).

### Habilitación o deshabilitación de la API de datos (solo Aurora Serverless v1)
<a name="data-api.enabling.modifying.sv1"></a>

Para habilitar o deshabilitar la API de datos en las bases de datos de Aurora Serverless v1 existentes. Para habilitar o deshabilitar la API de datos en las bases de datos de Aurora Serverless v2 y aprovisionadas, utilice los procedimientos indicados en [Habilitación o deshabilitación de la API de datos (Aurora Serverless v2 y aprovisionada)](#data-api.enabling.modifying.all).

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

Cuando cree o modifique un clúster de base de datos de Aurora Serverless v1, debe habilitar la API de datos en la sección **Conectividad** de la consola de RDS.

En la siguiente captura de pantalla se muestra la **API de datos** cuando se modifica un clúster de base de datos de Aurora.

![\[En la sección Conectividad de la página Modificar el clúster de base de datos, está seleccionada la casilla de verificación API de datos.\]](http://docs.aws.amazon.com/es_es/AmazonRDS/latest/AuroraUserGuide/images/data-api-modify-serverlessv1.png)


Para obtener instrucciones sobre cómo modificar un clúster de base de datos de Aurora Serverless v1, consulte [Modificación de un clúster de bases de datos de Aurora Serverless v1](aurora-serverless.modifying.md).

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

Para habilitar o deshabilitar la API de datos, ejecute el comando de la AWS CLI [modify-db-clúster](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-cluster.html) con `--enable-http-endpoint` o `--no-enable-http-endpoint`, según corresponda.

En el ejemplo siguiente se habilita la API de datos en `sample-cluster`.

Para Linux, macOS o Unix:

```
aws rds modify-db-cluster \
    --db-cluster-identifier sample-cluster \
    --enable-http-endpoint
```

Para Windows:

```
aws rds modify-db-cluster ^
    --db-cluster-identifier sample-cluster ^
    --enable-http-endpoint
```

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

Para habilitar la API de datos, utilice la operación [ModifyDBclúster](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBCluster.html) y establezca el valor de `EnableHttpEndpoint` en `true` o `false`, según corresponda.