Activation de l'API de données Amazon RDS - Amazon Aurora
Activation de l'API RDS Data 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

Pour utiliser l'API de données Amazon RDS (API de données), activez-la pour votre cluster de base de données Aurora. Vous pouvez activer l'API de données lorsque vous créez ou modifiez le cluster de base 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. Pour les anciennes versions d'Aurora, l'API de données ne fonctionne qu'avec les Aurora Serverless v1 clusters. Pour les nouvelles versions d'Aurora, l'API de données fonctionne avec des clusters qui utilisent à la fois des Aurora Serverless v2 instances et des instances provisionnées. Pour vérifier si votre cluster peut utiliser l'API de données, consultezRégions et moteurs de base de données Aurora pris en charge pour l'API de données RDS.

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

Lorsque vous créez une base de données qui prend en charge 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.

Pour activer l'API de données lorsque vous créez un cluster de base 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 dans la capture d'écran suivante.

La section Connectivité de la page Créer une base de données, avec la case Activer l'API de données RDS sélectionnée.

Pour obtenir des instructions sur la création d'un cluster de base de données Aurora pouvant utiliser l'API de données RDS, consultez ce qui suit :

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 AWS CLI commande avec l'--enable-http-endpointoption.

L'exemple suivant crée un cluster de base de données Aurora PostgreSQL avec l'API de données activée.

Pour LinuxmacOS, ou Unix :

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

Dans 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 pendant que vous créez un cluster de base de données Aurora, utilisez l'DBClusteropération Create avec la valeur du EnableHttpEndpoint paramètre définie surtrue.

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

Vous pouvez modifier un cluster de base de données qui prend en charge 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 v2et provisionnée)

Utilisez les procédures suivantes pour activer ou désactiver l'API de données sur les bases de données provisionnées Aurora Serverless v2 et les bases de données mises en service. Pour activer ou désactiver l'API de données sur les Aurora Serverless v1 bases de données, utilisez les procédures décrites dansActivation ou désactivation de l'API de données (Aurora Serverless v1uniquement).

Vous pouvez activer ou désactiver l'API de données à l'aide de la console RDS d'un cluster de base de données prenant en charge cette fonctionnalité. 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.

La capture d'écran suivante montre que l'API de données RDS n'est pas activée.

La section API de données RDS sur l'onglet Connectivité et sécurité de la page de détails d'un cluster de base de données. L'état de l'API de données s'affiche comme étant désactivé et le bouton Activer l'API de données RDS est présent.

Pour activer ou désactiver l'API de données sur une base de données existante, exécutez la disable-http-endpoint AWS CLI commande enable-http-endpointor et spécifiez l'ARN de votre cluster de bases de données.

L'exemple suivant active l'API Data.

Pour LinuxmacOS, ou Unix :

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

Dans 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 DisableHttpEndpointopérations EnableHttpEndpointet.

Activation ou désactivation de l'API de données (Aurora Serverless v1uniquement)

Utilisez les procédures suivantes pour activer ou désactiver l'API de données sur les Aurora Serverless v1 bases de données existantes. Pour activer ou désactiver l'API de données sur les bases de données Aurora Serverless v2 et les bases de données provisionnées, utilisez les procédures décrites dansActivation ou désactivation de l'API de données (Aurora Serverless v2et provisionnée).

Lorsque vous modifiez un Aurora Serverless v1 cluster de base de données, vous activez l'API de données dans la section Connectivité de la console RDS.

La capture d'écran suivante montre l'API de données activée lors de la modification d'un cluster de base de données Aurora.

Dans la section Connectivité de la page Modifier le cluster de base de données, la case API de données est cochée.

Pour obtenir des instructions sur la façon de modifier un Aurora Serverless v1 cluster de base de données, consultezModification d'un Aurora Serverless v1 Cluster DB.

Pour activer ou désactiver l'API de données, exécutez la modify-db-cluster AWS CLI commande, avec le --enable-http-endpoint ou--no-enable-http-endpoint, selon le cas.

L'exemple suivant active l'API Data sursample-cluster.

Pour LinuxmacOS, ou Unix :

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

Dans Windows :

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

Pour activer l'API de données, utilisez l'DBClusteropération Modifier et définissez la valeur de EnableHttpEndpoint to true oufalse, le cas échéant.