# Amazon RDS Data API 활성화
<a name="data-api.enabling"></a>

Amazon RDS Data API(Data API)를 사용하려면 Aurora DB 클러스터에 대해 해당 API를 활성화하세요. DB 클러스터를 생성하거나 수정할 때 데이터 API를 활성화할 수 있습니다.

**참고**  
 클러스터에 데이터 API를 사용할 수 있는지 여부는 Aurora 버전, 데이터베이스 엔진 및 AWS 리전에 따라 달라집니다. Aurora의 경우 데이터 API는 프로비저닝된 인스턴스와 Aurora Serverless v2 인스턴스를 모두 사용하는 클러스터에서 작동합니다. 클러스터가 데이터 API를 사용할 수 있는지 확인하려면 [RDS Data API를 지원하는 리전 및 Aurora DB 엔진](Concepts.Aurora_Fea_Regions_DB-eng.Feature.Data_API.md) 섹션을 참조하세요.

**Topics**
+ [데이터베이스를 생성할 때 RDS 데이터 API 활성화](#data-api.enabling.creating)
+ [기존 데이터베이스에서 RDS Data API 활성화 또는 비활성화](#data-api.enabling.modifying)

## 데이터베이스를 생성할 때 RDS 데이터 API 활성화
<a name="data-api.enabling.creating"></a>

RDS 데이터 API(데이터 API)를 지원하는 데이터베이스를 생성하는 동안 이 기능을 활성화할 수 있습니다. 다음 절차에서는 AWS Management Console, AWS CLI 또는 RDS API를 사용할 때 해당 작업을 수행하는 방법을 설명합니다.

### 콘솔
<a name="data-api.enabling.creating.console"></a>

DB 클러스터를 생성할 때 데이터 API를 활성화하려면 다음 스크린샷과 같이 **데이터베이스 생성** 페이지의 **연결** 섹션에서 **RDS 데이터 API 활성화** 확인란을 선택합니다.

![데이터베이스 생성 페이지의 연결 섹션에 RDS 데이터 API 활성화 확인란이 선택됨.](http://docs.aws.amazon.com/ko_kr/AmazonRDS/latest/AuroraUserGuide/images/data-api-enable-on-create.png)


RDS 데이터 API를 사용할 수 있는 Aurora DB 클러스터를 생성하는 방법에 대한 지침은 다음을 참조하세요.
+ Aurora Serverless v2 및 프로비저닝된 클러스터의 경우 - [Amazon Aurora DB 클러스터 생성](Aurora.CreateInstance.md)

### AWS CLI
<a name="data-api.enabling.creating.cli"></a>

Aurora DB 클러스터를 생성하는 동안 데이터 API를 활성화하려면 `--enable-http-endpoint` 옵션과 함께 [create-db-cluster](https://docs.aws.amazon.com/cli/latest/reference/rds/create-db-cluster.html) AWS CLI 명령을 실행합니다.

다음 예제에서는 데이터 API가 활성화된 Aurora PostgreSQL DB 클러스터를 생성합니다.

대상 LinuxmacOS, 또는Unix:

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

Windows의 경우:

```
aws rds create-db-cluster ^
	    --db-cluster-identifier {{my_pg_cluster}} ^
	    --engine aurora-postgresql ^
	    --enable-http-endpoint
```

### RDS API
<a name="data-api.enabling.creating.api"></a>

Aurora DB 클러스터를 생성하는 동안 데이터 API를 활성화하려면 `EnableHttpEndpoint` 파라미터 값을 `true`로 설정한 상태에서 [CreateDBCluster](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_CreateDBCluster.html) 작업을 사용하세요.

## 기존 데이터베이스에서 RDS Data API 활성화 또는 비활성화
<a name="data-api.enabling.modifying"></a>

RDS 데이터 API(데이터 API)를 지원하는 DB 클러스터를 수정하여 이 기능을 활성화하거나 비활성화할 수 있습니다.

**Topics**
+ [데이터 API 활성화 또는 비활성화(Aurora Serverless v2 및 프로비저닝)](#data-api.enabling.modifying.all)

### 데이터 API 활성화 또는 비활성화(Aurora Serverless v2 및 프로비저닝)
<a name="data-api.enabling.modifying.all"></a>

다음 절차를 사용하여 Aurora Serverless v2 및 프로비저닝된 데이터베이스에서 데이터 API를 활성화 또는 비활성화합니다.

#### 콘솔
<a name="data-api.enabling.modifying.all.console"></a>

이 기능을 지원하는 DB 클러스터의 RDS 콘솔을 사용하여 데이터 API를 활성화 또는 비활성화할 수 있습니다. 이렇게 하려면 데이터 API를 활성화하거나 비활성화하려는 데이터베이스의 클러스터 세부 정보 페이지를 열고 **작업** 드롭다운 메뉴에서 **RDS 데이터 API 활성화** 또는 **RDS 데이터 API 비활성화**를 선택합니다. 이렇게 하면 클러스터에 대한 RDS 데이터 API를 활성화하거나 비활성화할 수 있습니다.

다음 스크린샷은 활성화되지 않은 **RDS 데이터 API**를 보여줍니다.

![DB 클러스터 세부 정보 페이지의 연결 및 보안 탭에 있는 RDS 데이터 API 섹션. 데이터 API의 상태가 비활성화된 것으로 표시되고 RDS 데이터 API 활성화 버튼이 나타납니다.](http://docs.aws.amazon.com/ko_kr/AmazonRDS/latest/AuroraUserGuide/images/data-api-enable-from-details.png)


#### AWS CLI
<a name="data-api.enabling.modifying.all.cli"></a>

기존 데이터베이스에서 데이터 API를 활성화하거나 비활성화하려면 [enable-http-endpoint](https://docs.aws.amazon.com/cli/latest/reference/rds/enable-http-endpoint.html) 또는 [disable-http-endpoint](https://docs.aws.amazon.com/cli/latest/reference/rds/disable-http-endpoint.html) AWS CLI 명령을 실행하고 DB 클러스터의 ARN을 지정합니다.

다음 예제에서는 데이터 API를 활성화합니다.

대상 LinuxmacOS, 또는Unix:

```
aws rds enable-http-endpoint \
	    --resource-arn {{cluster_arn}}
```

Windows의 경우:

```
aws rds enable-http-endpoint ^
	    --resource-arn {{cluster_arn}}
```

#### RDS API
<a name="data-api.enabling.modifying.all.api"></a>

기존 데이터베이스에서 데이터 API를 활성화하거나 비활성화하려면 [EnableHttpEndpoint](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_EnableHttpEndpoint.html) 및 [DisableHttpEndpoint](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_DisableHttpEndpoint.html) 작업을 사용합니다.