Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Activation de l’API de données Amazon RDS
<a name="data-api.enabling"></a>

L’API de données Amazon RDS (API de données) doit être activée sur le cluster de bases de données Aurora avant de pouvoir être utilisée. Vous pouvez activer l’API de données lorsque vous créez ou modifiez le cluster de bases de données.

**Note**  
 La disponibilité de l'API de données pour votre cluster dépend de votre version d'Aurora, de votre moteur de base de données et de votre AWS région. Sur les anciennes versions d’Aurora, l’API de données ne peut être utilisée qu’avec des clusters Aurora Serverless v1. Sur les nouvelles versions d’Aurora, l’API de données fonctionne avec des clusters qui utilisent à la fois des instances provisionnées et des instances Aurora Serverless v2. Pour vérifier si votre cluster peut utiliser l’API de données, consultez [Régions et moteurs de base de données Aurora pris en charge pour l’API de données RDS](Concepts.Aurora_Fea_Regions_DB-eng.Feature.Data_API.md). 

**Topics**
+ [Activation de l’API de données RDS lors de la création d’une base de données](#data-api.enabling.creating)
+ [Activation de l’API de données RDS sur une base de données existante](#data-api.enabling.modifying)

## Activation de l’API de données RDS lors de la création d’une base de données
<a name="data-api.enabling.creating"></a>

Lorsque vous créez une base de données compatible avec l’API de données RDS (API de données), vous pouvez activer cette fonctionnalité. Les procédures suivantes décrivent comment procéder lorsque vous utilisez l'API AWS Management Console AWS CLI, la ou l'API RDS.

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

Pour activer l’API de données lors de la création d’un cluster de bases de données, cochez la case **Activer l’API de données RDS** dans la section **Connectivité** de la page **Créer une base de données**, comme illustré dans la capture d’écran suivante.

![\[Section Connectivité de la page Créer une base de données, où la case Activer l’API de données RDS est cochée.\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/AuroraUserGuide/images/data-api-enable-on-create.png)


Pour obtenir des instructions sur la création d’un cluster de bases de données Aurora compatible avec l’API de données RDS, consultez les informations suivantes :
+ Pour Aurora Serverless v2 et les clusters provisionnés : [Création d’un cluster de bases de données Amazon Aurora](Aurora.CreateInstance.md)
+ Pour Aurora Serverless v1 : [Création d’un cluster de bases de données Aurora Serverless v1](aurora-serverless.create.md)

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

Pour activer l'API de données lors de la création d'un cluster de base de données Aurora, exécutez la [create-db-cluster](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-cluster.html) AWS CLI commande avec l'`--enable-http-endpoint`option.

Voici un exemple de création d’un cluster de bases de données Aurora PostgreSQL où l’API de données est activée.

Pour Linux, macOS ou Unix :

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

Pour Windows :

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

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

Pour activer l'API de données pendant que vous créez un cluster de base de données Aurora, utilisez l'DBClusteropération [Create](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBCluster.html) avec la valeur du `EnableHttpEndpoint` paramètre définie sur`true`.

## Activation de l’API de données RDS sur une base de données existante
<a name="data-api.enabling.modifying"></a>

Vous pouvez modifier un cluster de bases de données compatible avec l’API de données RDS (API de données) pour activer ou désactiver cette fonctionnalité.

**Topics**
+ [Activation ou désactivation de l’API de données (Aurora Serverless v2 et base de données provisionnée)](#data-api.enabling.modifying.all)
+ [Activation ou désactivation de l’API de données (Aurora Serverless v1 uniquement)](#data-api.enabling.modifying.sv1)

### Activation ou désactivation de l’API de données (Aurora Serverless v2 et base de données provisionnée)
<a name="data-api.enabling.modifying.all"></a>

Utilisez les procédures suivantes pour activer ou désactiver l’API de données sur Aurora Serverless v2 et les bases de données provisionnées. Pour activer ou désactiver l’API de données sur les bases de données Aurora Serverless v1, utilisez les procédures indiquées dans [Activation ou désactivation de l’API de données (Aurora Serverless v1 uniquement)](#data-api.enabling.modifying.sv1).

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

Si votre cluster de bases de données prend en charge cette fonctionnalité, vous pouvez activer ou désactiver l’API de données directement depuis la console RDS. Pour ce faire, ouvrez la page des détails du cluster de la base de données sur laquelle vous souhaitez activer ou désactiver l’API de données, puis dans l’onglet **Connectivité et sécurité**, accédez à la section **API de données RDS**. Cette section affiche l’état de l’API de données et vous permet de l’activer ou de la désactiver.

Dans la capture d’écran suivante, l’**API de données RDS** est désactivée.

![\[Section API de données RDS sur l’onglet Connectivité et sécurité de la page des détails d’un cluster de bases de données. L’API de données apparaît comme désactivée et le bouton Activer l’API de données RDS est visible.\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/AuroraUserGuide/images/data-api-enable-from-details.png)


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

Pour activer ou désactiver l'API de données sur une base de données existante, exécutez la [disable-http-endpoint](https://docs.aws.amazon.com/cli/latest/reference/rds/disable-http-endpoint.html) AWS CLI commande [enable-http-endpoint](https://docs.aws.amazon.com/cli/latest/reference/rds/enable-http-endpoint.html)or et spécifiez l'ARN de votre cluster de bases de données.

Dans l’exemple suivant, l’API de données est activée.

Pour Linux, macOS ou Unix :

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

Pour Windows :

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

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

Pour activer ou désactiver l'API de données sur une base de données existante, utilisez les [DisableHttpEndpoint](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DisableHttpEndpoint.html)opérations [EnableHttpEndpoint](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_EnableHttpEndpoint.html)et.

### Activation ou désactivation de l’API de données (Aurora Serverless v1 uniquement)
<a name="data-api.enabling.modifying.sv1"></a>

Utilisez les procédures suivantes pour activer ou désactiver l’API de données sur les bases de données Aurora Serverless v1 existantes. Utilisez les procédures indiquées dans [Activation ou désactivation de l’API de données (Aurora Serverless v2 et base de données provisionnée)](#data-api.enabling.modifying.all) pour activer ou désactiver l’API de données sur Aurora Serverless v2 et les bases de données provisionnées.

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

Lorsque vous créez ou modifiez un cluster de bases de données Aurora Serverless v1, vous pouvez activez l’API de données dans la section **Connectivité** de la console RDS.

Dans la capture d’écran ci-dessous, l’**API de données** est activée lors de la modification d’un cluster de bases de données Aurora.

![\[Dans la section Connectivité de la page Modifier le cluster de bases de données, la case API de données est cochée.\]](http://docs.aws.amazon.com/fr_fr/AmazonRDS/latest/AuroraUserGuide/images/data-api-modify-serverlessv1.png)


Pour obtenir des instructions sur la modification d’un cluster de bases de données Aurora Serverless v1, consultez [Modification d’un cluster de bases de données Aurora Serverless v1](aurora-serverless.modifying.md).

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

Pour activer ou désactiver l'API de données, exécutez la [modify-db-cluster](https://docs.aws.amazon.com/cli/latest/reference/rds/modify-db-cluster.html) AWS CLI commande, avec le `--enable-http-endpoint` ou`--no-enable-http-endpoint`, selon le cas.

Dans l’exemple suivant, l’API de données est activée sur `sample-cluster`.

Pour Linux, macOS ou Unix :

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

Pour Windows :

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

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

Pour activer l'API de données, utilisez l'DBClusteropération [Modifier](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_ModifyDBCluster.html) et définissez la valeur de `EnableHttpEndpoint` to `true` ou`false`, le cas échéant.