# Referência da API do Amazon RDS
<a name="ProgrammingGuide"></a>

Além do Console de gerenciamento da AWS e do AWS Command Line Interface (AWS CLI), o Amazon RDS também fornece uma API. Você pode usar a API para automatizar tarefas de gerenciamento de suas instâncias de banco de dados e outros objetos no Amazon RDS. 
+ Para obter uma lista alfabética de operações da API, consulte [Ações](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_Operations.html).
+ Para obter uma lista alfabética de tipos de dados, consulte [Tipos de dados](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_Types.html).
+ Para obter uma lista de parâmetros de consulta comuns, consulte [Parâmetros comuns](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/CommonParameters.html).
+ Para obter descrições dos códigos de erro, consulte [Erros comuns](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/CommonErrors.html).

Para obter mais informações sobre a AWS CLI, consulte a [Referência da AWS Command Line Interface para o Amazon RDS](https://docs.aws.amazon.com/cli/latest/reference/rds/index.html). 

**Topics**
+ [Uso da API de consulta](Using_the_Query_API.md)
+ [Solução de problemas de aplicações no Amazon RDS](APITroubleshooting.md)

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

As seções a seguir discutem brevemente os parâmetros e a autenticação de solicitação usados com a API de consulta.

Para obter informações gerais sobre como a API de consulta funciona, consulte [Solicitações de consulta](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Query-Requests.html) no *Amazon EC2 API Reference.*

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

As solicitações baseadas em consulta HTTP são solicitações HTTP que usam o verbo HTTP GET ou POST e um parâmetro de consulta chamado `Action`.

Cada solicitação de consulta deve incluir alguns parâmetros comuns para lidar com a autenticação e a seleção de uma ação. 

Algumas operações levam listas de parâmetros. Essas listas são especificadas usando a notação `param.n`. Os valores de *n* são inteiros a partir de 1. 

Para ter informações sobre as regiões e os endpoints do Amazon RDS, acesse [Amazon Relational Database Service (RDS)](https://docs.aws.amazon.com/general/latest/gr/rande.html#rds_region) na seção Regiões e endpoints da *Referência geral da Amazon Web Services*.

## Autenticação de solicitação de consulta
<a name="query-authentication"></a>

Só é possível enviar solicitações de consulta por meio de HTTPS, e é preciso incluir uma assinatura em todas as solicitações de consulta. Você deve usar a versão de assinatura 4 da AWS ou a versão de assinatura 2. Para obter informações, consulte [Processo de assinatura do Signature versão 4](https://docs.aws.amazon.com/general/latest/gr/signature-version-4.html) e [Processo de assinatura do Signature versão 2](https://docs.aws.amazon.com/general/latest/gr/signature-version-2.html).

# Solução de problemas de aplicações no Amazon RDS
<a name="APITroubleshooting"></a>

O Amazon RDS fornece erros específicos e descritivos para ajudar você a solucionar problemas enquanto interage com a API do Amazon RDS.

**Topics**
+ [Recuperação de erros](#RetrievingErrors)
+ [Dicas de solução de problemas](#TroubleshootingTipss)

 Para obter informações sobre solução de problemas para instâncias de banco de dados do Amazon RDS, consulte [Solução de problemas para o Amazon RDS](CHAP_Troubleshooting.md). 

## Recuperação de erros
<a name="RetrievingErrors"></a>

Normalmente, espera-se que o aplicativo verifique se uma solicitação gerou um erro antes que você precise processar os resultados. A maneira mais fácil de descobrir se ocorreu um erro é procurar por um nó `Error` na resposta da API do Amazon RDS.

A sintaxe XPath apresenta uma maneira simples de procurar pela presença de um nó de `Error`. Ela também fornece uma maneira relativamente fácil de recuperar o código e a mensagem de erro. O snippet de código a seguir usa Perl e o módulo XML::XPath para determinar se ocorreu um erro durante uma solicitação. Caso tenha ocorrido, o código imprimirá o primeiro código de erro e a mensagem na resposta. 

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

## Dicas de solução de problemas
<a name="TroubleshootingTipss"></a>

 Recomendamos os seguintes processos para diagnosticar e resolver problemas com a API do Amazon RDS:
+ Confirme se o Amazon RDS está funcionando normalmente na região da AWS que você está almejando acessando [http://status.aws.amazon.com](https://status.aws.amazon.com/).
+ Verificação da estrutura de sua solicitação.

  Cada operação do Amazon RDS tem uma página de referência na *Amazon RDS Referência da API*. Verifique novamente se você está usando os parâmetros corretamente. Para ter ideias sobre o que pode estar errado, consulte as amostras de solicitações ou cenários de usuários para ver se esses exemplos realizam operações similares.
+ Confira o AWS re:Post

  O Amazon RDS conta com um fórum de comunidade de desenvolvimento onde você pode procurar soluções para os problemas que outros enfrentaram ao longo do caminho. Para visualizar os tópicos, acesse [AWS re:Post](https://repost.aws/).