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.
# Référence d'API Amazon RDS
Outre la AWS Management Console et l'AWS Command Line Interface (AWS CLI), Amazon RDS fournit également une API. Vous pouvez utiliser l'API pour automatiser les tâches de gestion de vos instances de base de données et d'autres objets dans Amazon RDS.
+ Pour obtenir la liste alphabétique des opérations d'API, consultez [Actions](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_Operations.html).
+ Pour obtenir la liste alphabétique des types de données, consultez [Types de données](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_Types.html).
+ Pour consulter la liste des paramètres de requête courants, reportez-vous à la page [Paramètres courants](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/CommonParameters.html).
+ Pour la description des codes d'erreur, veuillez consulter la page [Erreurs courantes](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/CommonErrors.html).
Pour plus d'informations sur l'AWS CLI, consultez [Référence de l'AWS Command Line Interface pour Amazon RDS](https://docs.aws.amazon.com/cli/latest/reference/rds/index.html).
**Topics**
+ [Utilisation de l'API Query](Using_the_Query_API.md)
+ [Applications de dépannage sur Amazon RDS](APITroubleshooting.md)
# Utilisation de l'API Query
Les sections suivantes abordent brièvement l'authentification de la demande et les paramètres utilisés avec l'API Query.
Pour obtenir des informations générales sur le fonctionnement de l'API Query, veuillez consulter [Demandes de requête](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Query-Requests.html) dans le *Amazon EC2 API Reference*.
## Paramètres Query (Requête)
Ces demandes basées sur Query HTTP sont des demandes HTTP qui utilisent le verbe HTTP GET ou POST et un paramètre Query appelé `Action`.
Chaque demande Query doit inclure certains paramètres communs pour gérer l'authentification et la sélection d'une action.
Certaines actions demandent des listes de paramètres. Ces listes sont spécifiées en utilisant la notation `param.n`. Les valeurs de *n* sont des nombres entiers à partir de 1.
Pour plus d'informations sur les régions et les points de terminaison Amazon RDS, consultez [Amazon Relational Database Service (RDS)](https://docs.aws.amazon.com/general/latest/gr/rande.html#rds_region) dans la section Régions et points de terminaison de la *Référence générale d'Amazon Web Services*.
## Authentification de demande Query
Vous pouvez uniquement envoyer des demandes Query via HTTPS, et vous devez inclure une signature dans chaque demande Query. Vous devez utiliser le processus AWS Signature Version 4 ou 2. Pour de plus amples informations, veuillez consulter [Processus de signature Signature Version 4](https://docs.aws.amazon.com/general/latest/gr/signature-version-4.html) et [ Processus de signature Signature Version 2](https://docs.aws.amazon.com/general/latest/gr/signature-version-2.html).
# Applications de dépannage sur Amazon RDS
Amazon RDS fournit des erreurs spécifiques et descriptives pour vous aider à résoudre vos problèmes tout en interagissant avec l'API Amazon RDS.
**Topics**
+ [Récupération d'erreurs](#RetrievingErrors)
+ [Conseils pour le dépannage](#TroubleshootingTipss)
Pour de plus amples informations sur le dépannage des instances de base de données Amazon RDS, veuillez consulter [Dépannage d’Amazon RDS](CHAP_Troubleshooting.md).
## Récupération d'erreurs
Généralement, vous souhaitez que votre application vérifie si une demande a généré une erreur avant de passer du temps à traiter les résultats. Le moyen le plus simple de déterminer si une erreur s'est produite est de rechercher un nœud `Error` dans la réponse de l'API Amazon RDS.
La syntaxe XPath fournit une méthode simple pour rechercher la présence d'un nœud `Error`. Elle fournit également un moyen relativement simple de récupérer le code et le message d'erreur. L'extrait de code suivant utilise Perl et le module XML::XPath pour déterminer si une erreur s'est produite lors d'une demande. Si une erreur s'est produite, le code imprime le premier code et message d'erreur dans la réponse.
```
use XML::XPath;
my $xp = XML::XPath->new(xml =>$response);
if ( $xp->find("//Error") )
{print "There was an error processing your request:\n", " Error code: ",
$xp->findvalue("//Error[1]/Code"), "\n", " ",
$xp->findvalue("//Error[1]/Message"), "\n\n"; }
```
## Conseils pour le dépannage
Nous vous conseillons d'utiliser les processus suivants pour diagnostiquer et résoudre les problèmes avec l'API Amazon RDS :
+ Vérifiez qu'Amazon RDS fonctionne normalement dans la région AWS que vous ciblez en consultant la page [http://status.aws.amazon.com](https://status.aws.amazon.com/).
+ Vérifiez la structure de votre demande.
Chaque opération Amazon RDS possède une page de référence dans la *référence de l'API Amazon RDS*. Revérifiez que vous utilisez les paramètres correctement. Pour des idées sur les éventuels problèmes, observez les exemples de demandes ou de scénarios utilisateur pour voir s'ils effectuent des opérations similaires.
+ Consultez AWS re:Post.
Amazon RDS possède une communauté de développement où vous pouvez chercher des solutions aux problèmes rencontrés par d'autres. Pour consulter les rubriques, accédez à [AWS re:Post](https://repost.aws/).