# REST API 연결
<a name="rest-api-connections"></a>

 AWS Glue 커넥터는 AWS 및 외부 모두에서 다양한 데이터 소스를 다룹니다. 그러나 네이티브 AWS Glue 커넥터가 지원하지 않는 독점 시스템 또는 새로운 플랫폼이 있을 수 있습니다. AWS Glue REST 커넥터는 기본적으로 지원되는 AWS Glue 커넥터와 동일한 방식으로 작동하는 REST 기반 API가 있는 모든 데이터 소스에 대해 사용자 지정 커넥터를 구성하는 메커니즘을 제공합니다. 이 기능을 사용하면 이러한 데이터 소스에 액세스하기 위해 사용자 지정 라이브러리 또는 ETL 스크립트를 빌드할 필요가 최소화됩니다.

 REST API 커넥터를 활성화하기 위해 AWS Glue에 새로운 AWS 리소스 - **연결 유형**이 도입되었습니다. 다음 작업을 사용하여 REST API 기반 데이터 소스에 대한 연결을 관리할 수 있습니다.
+  **RegisterConnectionType** - 제공된 구성을 기반으로 AWS Glue에 연결 유형을 등록합니다. 요청 구조는 [RegisterConnectionType](https://docs.aws.amazon.com/glue/latest/webapi/API_RegisterConnectionType.html)을 참조하세요.
+  **DeleteConnectionType** - AWS Glue에서 연결 유형 구성을 삭제합니다. [DeleteConnectionType](https://docs.aws.amazon.com/glue/latest/webapi/API_DeleteConnectionType.html)을 참조하세요.
+  **DescribeConnectionType** - AWS Glue에 지정된 연결 유형에 대해 지원되는 옵션에 대한 전체 세부 정보가 반환됩니다. [DescribeConnectionType](https://docs.aws.amazon.com/glue/latest/webapi/API_DescribeConnectionType.html)을 참조하세요.
+  **ListConnectionTypes** - 각 AWS Glue 연결 유형에 지원되는 항목에 대한 상위 수준 세부 정보가 포함된 연결 유형 목록이 반환됩니다. [ListConnectionTypes](https://docs.aws.amazon.com/glue/latest/webapi/API_ListConnectionTypes.html)를 참조하세요.

## AWS Glue에서 REST 연결 유형 생성
<a name="creating-a-rest-connection-type"></a>

 REST 연결 유형을 생성하려면 AWS CLI, AWS SDK 또는 AWS API를 사용하여 RegisterConnectionType API를 호출합니다. 구성 세부 정보는 연결 중인 REST API를 기반으로 제공됩니다.

**참고**  
 AWS Glue 콘솔을 사용하여 REST 연결을 생성할 수 없습니다.

### 필수 조건
<a name="creating-a-rest-connection-type-prerequisites"></a>

 AWS Glue REST API 커넥터를 구성하기 전에 REST API의 내부 작업을 숙지해야 합니다. 데이터 소스에 대한 REST API 설명서와 요청/응답 구조를 검사하는 도구가 있는지 확인하는 데 도움이 됩니다.

 REST API의 다음 속성을 식별해야 합니다.
+  REST 엔드포인트에 대한 호출에 사용되는 인증 메커니즘입니다. AWS Glue REST API 커넥터는 **기본 인증, OAuth2 - ClientCredentials, OAuth2 - Authorization Code, OAuth2 - JWT 및 사용자 지정 인증**을 지원합니다.
+  REST 엔드포인트 및 관련 메타데이터(예: 필드 이름 및 데이터 유형)를 통해 전송할 수 있는 엔터티(데이터 객체) 
+  HTTP 요청 및 응답 구조 이 구조에는 HTTP 메서드, 엔드포인트 URL, 헤더, 쿼리 파라미터, 요청 본문 및 응답 페이로드의 형식이 포함됩니다.
+  페이지 매김 체계입니다. AWS Glue REST API 커넥터는 `cursor-based` 및 `offset-based` 페이지 매김이라는 두 가지 페이지 매김 체계를 지원합니다.

### RegisterConnectionType
<a name="registering-a-rest-connection-type"></a>

 제공된 구성을 기반으로 AWS Glue에 ConnectionType을 등록합니다. ConnectionType 리소스는 데이터 소스에서 요청 및 응답을 해석하는 방법에 대한 세부 정보를 저장하는 새로운 AWS Glue 리소스입니다. 현재는 REST 프로토콜만 지원됩니다. 다음과 같은 REST API 소스에 대한 세부 정보를 캡슐화합니다.
+  **연결 속성** - REST API에 연결할 BaseUrl과 AWS Glue CreateConnection 중에 입력을 받는 데 필요한 추가 요청 파라미터를 정의합니다.
+  **인증 구성** - REST API에 대한 요청이 인증되는 방법을 정의합니다. 이 구성은 연결 유형에 대한 AWS Glue 연결을 생성할 때 사용됩니다.
+  **REST 구성** - REST API 소스에서 데이터를 읽기 위한 HTTP 요청 및 응답 구성을 정의합니다. **글로벌** 또는 **엔터티** 수준에서 다음 속성을 구성해야 합니다.
  +  **요청 방법** - REST HTTP 방법을 정의합니다.
  +  **응답 구성** - API 응답을 해석하는 방법을 정의합니다(본문의 레코드 또는 오류 위치 포함).
  +  **페이지 매김 구성** - REST API가 결과 레코드를 페이지 매김하는 데 사용하는 전략과 페이지 매김 속성을 전송/검색하는 방법을 정의합니다.
  +  **검증 엔드포인트 구성** - AWS Glue 연결을 검증하기 위해 호출할 엔드포인트를 정의합니다.
  +  **개체 구성** - 커넥터가 지원하는 REST 엔터티와 해당 스키마를 정의합니다.

### RegisterConnectionType 요청 구문
<a name="register-connection-type-request-syntax"></a>

 [RegisterConnectionType](https://docs.aws.amazon.com/glue/latest/webapi/API_RegisterConnectionType.html) 참조 

 REST API 연결 유형이 등록되면 구성된 데이터 소스에 대한 연결을 생성하는 데 사용할 준비가 된 것입니다. 자세한 지침은 [REST API에 연결](https://docs.aws.amazon.com/glue/latest/dg/connecting-to-data-rest-api.html)을 참조하십시오.