API Gateway에서 WebSocket API 생성

AWS CLI create-api 명령을 사용하거나 AWS SDK에서 CreateApi 명령을 사용하면 API Gateway 콘솔에서 WebSocket API를 생성할 수 있습니다. 다음 절차는 새 WebSocket API를 생성하는 방법을 보여줍니다.

참고

WebSocket API는 TLS 1.2 및 TLS 1.3만 지원합니다. 이전 버전의 TLS는 지원되지 않습니다.

AWS CLI 명령을 사용하여 WebSocket API 생성

AWS CLI를 사용하여 WebSocket API를 생성하려면 다음 예와 같이 create-api 명령을 직접적으로 호출해야 합니다. 이 명령은 $request.body.action 라우팅 선택 표현식을 사용하여 API를 생성합니다.

aws apigatewayv2 --region us-east-1 create-api --name "myWebSocketApi3" --protocol-type WEBSOCKET --route-selection-expression '$request.body.action'

출력 예제:

{
    "ApiKeySelectionExpression": "$request.header.x-api-key",
    "Name": "myWebSocketApi3",
    "CreatedDate": "2018-11-15T06:23:51Z",
    "ProtocolType": "WEBSOCKET",
    "RouteSelectionExpression": "'$request.body.action'",
    "ApiId": "aabbccddee"
}

API Gateway 콘솔을 사용하여 WebSocket API 생성

콘솔에서 WebSocket 프로토콜을 선택하고 API에 이름을 지정하여 WebSocket API를 만들 수 있습니다.

중요

API를 생성한 후에는 선택한 프로토콜을 변경할 수 없습니다. WebSocket API를 REST API로 또는 그 반대로 변환할 수는 없습니다.

API Gateway 콘솔을 사용하여 WebSocket API를 생성하려면

1. API Gateway 콘솔에 로그인하고 API 생성을 선택합니다.

2. WebSocket API에서 빌드를 선택합니다. 리전 엔드포인트만 지원됩니다.

3. API 이름에 API의 이름을 입력합니다.

4. 라우팅 선택 표현식에 값을 입력합니다. 예: $request.body.action.

   라우팅 선택 표현식에 대한 자세한 내용은 라우팅 선택 표현식 단원을 참조하십시오.

5. 다음 중 하나를 수행하십시오.

   • 라우팅이 없는 API를 생성하려면 빈 API 생성을 선택합니다.

   • 다음을 선택하여 API에 라우팅을 연결합니다.

   API를 생성한 후 라우팅을 연결할 수 있습니다.