Amazon RDS Data API 활성화 - Amazon Aurora
데이터베이스를 생성할 때 RDS 데이터 API 활성화기존 데이터베이스에서 RDS 데이터 API 활성화

Amazon RDS Data API 활성화

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

참고

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

데이터베이스를 생성할 때 RDS 데이터 API 활성화

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

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

데이터베이스 생성 페이지의 연결 섹션에 RDS 데이터 API 활성화 확인란이 선택됨.

RDS 데이터 API를 사용할 수 있는 Aurora DB 클러스터를 생성하는 방법에 대한 지침은 다음을 참조하세요.

Aurora DB 클러스터를 생성하는 동안 데이터 API를 활성화하려면 --enable-http-endpoint 옵션과 함께 create-db-cluster 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

Aurora DB 클러스터를 생성하는 동안 데이터 API를 활성화하려면 EnableHttpEndpoint 파라미터 값을 true로 설정한 상태에서 CreateDBCluster 작업을 사용하세요.

기존 데이터베이스에서 RDS 데이터 API 활성화

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

데이터 API 활성화 또는 비활성화(Aurora Serverless v2 및 프로비저닝)

다음 절차를 사용하여 Aurora Serverless v2 및 프로비저닝된 데이터베이스에서 데이터 API를 활성화 또는 비활성화합니다. Aurora Serverless v1 데이터베이스에서 데이터 API를 활성화하거나 비활성화하려면 데이터 API 활성화 또는 비활성화(Aurora Serverless v1 전용)의 절차를 사용하세요.

이 기능을 지원하는 DB 클러스터의 RDS 콘솔을 사용하여 데이터 API를 활성화 또는 비활성화할 수 있습니다. 이렇게 하려면 데이터 API를 활성화하거나 비활성화하려는 데이터베이스의 클러스터 세부 정보 페이지를 열고 연결 및 보안 탭에서 RDS 데이터 API 섹션으로 이동합니다. 이 섹션에는 데이터 API의 상태가 표시되며 이를 활성화하거나 비활성화할 수 있습니다.

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

DB 클러스터 세부 정보 페이지의 연결 및 보안 탭에 있는 RDS 데이터 API 섹션. 데이터 API의 상태가 비활성화된 것으로 표시되고 RDS 데이터 API 활성화 버튼이 나타납니다.

기존 데이터베이스에서 데이터 API를 활성화하거나 비활성화하려면 enable-http-endpoint 또는 disable-http-endpoint 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

기존 데이터베이스에서 데이터 API를 활성화하거나 비활성화하려면 EnableHttpEndpoint 및 DisableHttpEndpoint 작업을 사용합니다.

데이터 API 활성화 또는 비활성화(Aurora Serverless v1 전용)

다음 절차를 사용하여 기존 Aurora Serverless v1 데이터베이스에서 데이터 API를 활성화 또는 비활성화합니다. Aurora Serverless v2 및 프로비저닝된 데이터베이스에서 데이터 API를 활성화하거나 비활성화하려면 데이터 API 활성화 또는 비활성화(Aurora Serverless v2 및 프로비저닝)의 절차를 사용하세요.

Aurora Serverless v1 DB 클러스터를 수정할 때 RDS 콘솔의 연결 섹션에서 데이터 API를 활성화합니다.

다음 스크린샷은 Aurora DB 클러스터를 수정할 때 활성화된 데이터 API를 보여줍니다.

DB 클러스터 수정 페이지의 연결 섹션에서 데이터 API 확인란이 선택됨.

Aurora Serverless v1 DB 클러스터를 수정하는 방법에 대한 지침은 Aurora Serverless v1 DB 클러스터 수정 섹션을 참조하세요.

데이터 API를 활성화하거나 비활성화하려면 해당하는 경우 --enable-http-endpoint 또는 --no-enable-http-endpoint와 함께 modify-db-cluster AWS CLI 명령을 실행합니다.

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

대상 LinuxmacOS, 또는Unix:

aws rds modify-db-cluster \
    --db-cluster-identifier sample-cluster \
    --enable-http-endpoint

Windows의 경우:

aws rds modify-db-cluster ^
    --db-cluster-identifier sample-cluster ^
    --enable-http-endpoint

데이터 API를 활성화하려면 ModifyDBCluster 작업을 사용하고 해당하는 경우 EnableHttpEndpoint 의 값을 true 또는 false로 설정합니다.