# Referencia de la API de Amazon RDS
<a name="ProgrammingGuide"></a>

Además de Consola de administración de AWS y la AWS Command Line Interface (AWS CLI), Amazon RDS también proporciona una API. Puede utilizar la API para automatizar las tareas de administración de instancias de base de datos y otros objetos en Amazon RDS. 
+ Para ver una lista de acciones de la API ordenada alfabéticamente, consulte el tema relacionado con las [acciones](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_Operations.html).
+ Para ver una lista de tipos de datos ordenada alfabéticamente, consulte el tema relacionado con los [Tipos de datos](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_Types.html).
+ Para ver una lista de parámetros de consulta comunes, consulte el tema relacionado con los [Parámetros comunes](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/CommonParameters.html).
+ Para ver las descripciones de los códigos de error, consulte el tema relacionado con los [Errores comunes](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/CommonErrors.html).

Para obtener más información acerca de AWS CLI, consulte la [referencia de AWS Command Line Interface para Amazon RDS](https://docs.aws.amazon.com/cli/latest/reference/rds/index.html). 

**Topics**
+ [Uso de la API de consulta](Using_the_Query_API.md)
+ [Solución de problemas de aplicaciones en Amazon RDS](APITroubleshooting.md)

# Uso de la API de consulta
<a name="Using_the_Query_API"></a>

En las siguientes secciones se explican brevemente los parámetros y la autenticación de solicitudes que se utilizan con la API de consulta.

Para obtener información general acerca del funcionamiento de la API de consulta, consulte [Solicitudes de consulta](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Query-Requests.html) en la *Amazon EC2 API Reference*.

## Parámetros de consulta
<a name="query-parameters"></a>

Las solicitudes basadas en consultas HTTP son solicitudes HTTP que utilizan el verbo HTTP GET o POST y un parámetro de consulta denominado `Action`.

Cada solicitud de consulta debe incluir algunos parámetros comunes para realizar la autenticación y la selección de una acción. 

Algunas operaciones toman listas de parámetros. Estas listas se especifican utilizando la notación `param.n`. Los valores de *n* son números enteros a partir de 1. 

Para obtener más información acerca de las regiones y los puntos de conexión de Amazon RDS, vaya a [Amazon Relational Database Service (RDS)](https://docs.aws.amazon.com/general/latest/gr/rande.html#rds_region) en la sección Regiones y puntos de conexiones de la *Referencia general de Amazon Web Services*.

## Autenticación de solicitudes de consulta
<a name="query-authentication"></a>

Solo se pueden enviar solicitudes de consulta a través de HTTPS, y cada una de ellas debe incluir una firma. Debe utilizar Signature Version 4 o Signature Version 2 de AWS. Para obtener más información, consulte [Proceso de firma de Signature Version 4](https://docs.aws.amazon.com/general/latest/gr/signature-version-4.html) y [Proceso de firma de Signature Version 2](https://docs.aws.amazon.com/general/latest/gr/signature-version-2.html).

# Solución de problemas de aplicaciones en Amazon RDS
<a name="APITroubleshooting"></a>

Amazon RDS proporciona errores específicos y descriptivos para ayudarle a solucionar problemas durante la interacción con la API de Amazon RDS.

**Topics**
+ [Recuperación de errores](#RetrievingErrors)
+ [Consejos para la solución de problemas](#TroubleshootingTipss)

 Para obtener más información sobre la solución de problemas para instancias de base de datos de Amazon RDS, consulte [Solución de problemas de Amazon RDS](CHAP_Troubleshooting.md). 

## Recuperación de errores
<a name="RetrievingErrors"></a>

Normalmente, conviene que una aplicación compruebe si una solicitud generó un error antes de emplear tiempo en procesar los resultados. La forma más fácil de averiguar si se ha producido un error, consiste en buscar un nodo `Error` en la respuesta de la API de Amazon RDS.

La sintaxis XPath proprciona una forma simple de buscar la presencia de un nodo `Error`. También proporciona una forma relativamente fácil de recuperar el código y el mensaje de error. La partición de código siguiente utiliza Perl y el módulo XML::XPath para determinar si se ha producido un error durante una solicitud. Si es así, el código imprime el primer mensaje de error y su código en la respuesta. 

```
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"; }
```

## Consejos para la solución de problemas
<a name="TroubleshootingTipss"></a>

 Recomendamos los siguientes procesos para diagnosticar y solucionar problemas con la API de Amazon RDS:
+ Verifique si Amazon RDS funciona normalmente en la región de AWS de destino consultando [http://status.aws.amazon.com](https://status.aws.amazon.com/).
+ Comprobar la estructura de la solicitud.

  Cada operación de Amazon RDS tiene una página de referencia en la *Referencia de la API de Amazon RDS*. Compruebe que está utilizando los parámetros correctamente. Para obtener ideas sobre lo que podría estar mal, mire las solicitudes de ejemplo o los escenarios de usuario para ver si esos ejemplos hacen operaciones similares.
+ Comprobar AWS re:Post

  Existe una comunidad de desarrolladores de Amazon RDS donde puede buscar soluciones a los problemas que otras personas han experimentado al utilizar este servicio. Para ver los temas, vaya a [AWS re:Post](https://repost.aws/).