Activation de l’API de données Amazon RDS - Amazon Aurora
Activation de l’API de données RDS lors de la création d’une base de donnéesActivation de l’API de données RDS sur une base de données existante

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

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 région AWS. 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.

Activation de l’API de données RDS lors de la création d’une base de données

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 la AWS Management Console, l’AWS CLI ou l’API RDS.

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.

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 activer l’API de données lors de la création d’un cluster de bases de données Aurora, exécutez la commande AWS CLI create-db-cluster avec l’option --enable-http-endpoint.

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

Pour activer l’API de données lors de la création d’un cluster de bases de données Aurora, utilisez l’opération CreateDBCluster en définissant le paramètre EnableHttpEndpoint sur true.

Activation de l’API de données RDS sur une base de données existante

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

Activation ou désactivation de l’API de données (Aurora Serverless v2 et base de données provisionnée)

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

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.

Pour activer ou désactiver l’API de données sur une base de données existante, exécutez la commande AWS CLI enable-http-endpoint ou disable-http-endpoint et indiquez 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

Pour activer ou désactiver l’API de données sur une base de données existante, utilisez les opérations EnableHttpEndpoint et DisableHttpEndpoint.

Activation ou désactivation de l’API de données (Aurora Serverless v1 uniquement)

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) pour activer ou désactiver l’API de données sur Aurora Serverless v2 et les bases de données provisionnées.

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.

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.

Pour activer ou désactiver l’API de données, exécutez la commande AWS CLI modify-db-cluster, avec --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

Pour activer l’API de données, utilisez l’opération ModifyDBCluster et définissez la valeur de EnableHttpEndpoint sur true ou false, selon le cas.