# Amazon RDS API 참조
<a name="ProgrammingGuide"></a>

Amazon RDS는 AWS Management Console 및 AWS Command Line Interface(AWS CLI) 외에 API도 제공합니다. API를 사용하여 Amazon RDS의 DB 인스턴스 및 기타 객체 관리 작업을 자동화할 수 있습니다.
+ API 작업의 알파벳순 목록은 [작업](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_Operations.html)을 참조하십시오.
+ 데이터 형식에 대한 알파벳순 목록은 [데이터 형식](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_Types.html)을 참조하십시오.
+ 공통 쿼리 파라미터 목록은 [공통 파라미터](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/CommonParameters.html)를 참조하십시오.
+ 오류 코드에 대한 설명은 [공통 오류](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/CommonErrors.html)를 참조하십시오.

AWS CLI에 대한 자세한 내용은 [Amazon RDS용 AWS Command Line Interface 참조](https://docs.aws.amazon.com/cli/latest/reference/rds/index.html)를 참조하세요.

**Topics**
+ [

# 쿼리 API 사용
](Using_the_Query_API.md)
+ [

# Amazon RDS에서 애플리케이션 문제 해결
](APITroubleshooting.md)

# 쿼리 API 사용
<a name="Using_the_Query_API"></a>

다음 단원에서는 쿼리 API와 함께 사용되는 파라미터 및 요청 인증에 대해 간락하게 설명합니다.

쿼리 API의 작동 방식에 대한 일반적인 내용은 *Amazon EC2 API Reference*의 [쿼리 요청](https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Query-Requests.html)을 참조하십시오.

## 쿼리 파라미터
<a name="query-parameters"></a>

HTTP 쿼리 기반 요청은 GET 또는 POST와 같은 HTTP 동사와 `Action` 쿼리 매개 변수를 사용하는 HTTP 요청입니다.

각 쿼리 요청은 인증 및 작업을 처리할 수 있도록 일부 공통 파라미터를 포함해야 합니다.

일부 작업은 파라미터의 목록을 허용합니다. 이러한 목록은 `param.n` 표기법을 사용하여 지정됩니다. *n*의 값은 1부터 시작하는 정수입니다.

Amazon RDS 리전과 엔드포인트에 대한 자세한 내용은 *Amazon Web Services 일반 참조*의 리전 및 엔드포인트 섹션에서 [Amazon Relational Database Service(RDS)](https://docs.aws.amazon.com/general/latest/gr/rande.html#rds_region)를 참조하세요.

## 쿼리 요청 인증
<a name="query-authentication"></a>

HTTPS를 통해서만 쿼리 요청을 보낼 수 있으며 모든 쿼리 요청에는 서명이 포함되어야 합니다. AWS 서명 버전 4 또는 서명 버전 2를 사용해야 합니다. 자세한 정보는 [서명 버전 4 서명 프로세스](https://docs.aws.amazon.com/general/latest/gr/signature-version-4.html) 및 [서명 버전 2 서명 프로세스](https://docs.aws.amazon.com/general/latest/gr/signature-version-2.html)를 참조하십시오.

# Amazon RDS에서 애플리케이션 문제 해결
<a name="APITroubleshooting"></a>

Amazon RDS는 Amazon RDS API와 상호 작용하는 동안 발생하는 문제를 해결할 때 도움이 되도록 구체적이고 서술적인 오류를 제공합니다.

**Topics**
+ [

## 오류 검색
](#RetrievingErrors)
+ [

## 문제 해결 팁
](#TroubleshootingTipss)

 Amazon RDS DB 인스턴스 문제 해결에 대한 자세한 내용은 [Amazon RDS 문제 해결](CHAP_Troubleshooting.md) 단원을 참조하십시오.

## 오류 검색
<a name="RetrievingErrors"></a>

일반적으로 사용자는 시간을 소비하여 결과를 처리하기 전에 애플리케이션이 먼저 해당 요청으로 오류가 발생되는지 여부를 확인하려고 합니다. 오류 발생 여부를 확인하는 가장 쉬운 방법은 Amazon RDS API의 응답에서 `Error` 노드를 찾는 것입니다.

XPath 구문은 `Error` 노드의 존재 여부를 검색하는 간단한 방법을 제공합니다. 또한 오류 코드와 메시지를 비교적 쉽게 검색할 수 있는 방법을 제공합니다. 다음 코드 조각에서는 요청 중에 오류가 발생했는지 여부를 파악하기 위해 Perl 및 XML::Xpath 모듈을 사용합니다. 오류가 발생되면 코드는 응답에 첫 번째 오류 코드와 메시지를 인쇄합니다.

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

## 문제 해결 팁
<a name="TroubleshootingTipss"></a>

 다음 절차를 통해 Amazon RDS API의 문제를 진단하고 해결하는 것이 좋습니다.
+ 타겟팅하는 AWS 리전에서 Amazon RDS가 정상적으로 작동하는지 [http://status.aws.amazon.com](https://status.aws.amazon.com/)에서 확인합니다.
+ 요청 구조 확인.

  각 Amazon RDS 작업에 대한 참조 페이지는 *Amazon RDS API 참조*에 있습니다. 파라미터를 올바르게 사용하고 있는지 여부를 다시 확인합니다. 어떤 문제가 발생할 수 있을지 알아보려면 샘플 요청이나 사용자 시나리오를 살펴보고 이러한 예시가 유사한 작업을 하는지 확인하세요.
+ AWS re:Post 확인

  Amazon RDS와 관련하여 다른 사람들이 경험한 문제에 대한 해결책을 검색할 수 있는 개발 커뮤니티가 있습니다. 주제를 보려면 [AWS re:Post](https://repost.aws/)로 이동하세요.