쿠키 기본 설정 선택

당사는 사이트와 서비스를 제공하는 데 필요한 필수 쿠키 및 유사한 도구를 사용합니다. 고객이 사이트를 어떻게 사용하는지 파악하고 개선할 수 있도록 성능 쿠키를 사용해 익명의 통계를 수집합니다. 필수 쿠키는 비활성화할 수 없지만 '사용자 지정' 또는 ‘거부’를 클릭하여 성능 쿠키를 거부할 수 있습니다.

사용자가 동의하는 경우 AWS와 승인된 제3자도 쿠키를 사용하여 유용한 사이트 기능을 제공하고, 사용자의 기본 설정을 기억하고, 관련 광고를 비롯한 관련 콘텐츠를 표시합니다. 필수가 아닌 모든 쿠키를 수락하거나 거부하려면 ‘수락’ 또는 ‘거부’를 클릭하세요. 더 자세한 내용을 선택하려면 ‘사용자 정의’를 클릭하세요.

API 스테이지를 WebSocket API에 대한 사용자 지정 도메인 이름에 매핑

포커스 모드
API 스테이지를 WebSocket API에 대한 사용자 지정 도메인 이름에 매핑 - Amazon API Gateway

API 매핑을 사용하여 API 스테이지를 사용자 지정 도메인 이름에 연결합니다. 도메인 이름을 생성하고 DNS 레코드를 구성한 후에는 API 매핑을 사용하여 사용자 지정 도메인 이름을 통해 API로 트래픽을 보냅니다.

API 매핑은 API, 스테이지 및 매핑에 사용할 경로(선택 사항)를 지정합니다. 예를 들어 API의 production 스테이지를 wss://api.example.com/orders에 매핑할 수 있습니다.

API 매핑을 생성하기 전에 API, 스테이지 및 사용자 지정 도메인 이름이 있어야 합니다. 사용자 지정 도메인 이름 생성에 대한 자세한 내용은 ‭API Gateway에서 리전 사용자 지정 도메인 이름 설정‬ 단원을 참조하세요.

제한 사항

  • API 매핑에서 사용자 지정 도메인 이름과 매핑된 API는 동일한 AWS 계정에 있어야 합니다.

  • API 매핑에는 문자, 숫자 및 문자 $-_.+!*'()만 포함해야 합니다.

  • API 매핑에서 경로의 최대 길이는 300자입니다.

  • WebSocket API를 HTTP API 또는 REST API와 동일한 사용자 지정 도메인 이름에 매핑할 수 없습니다.

  • 여러 레벨로 API 매핑을 생성하는 경우 API Gateway는 모든 헤더 이름을 소문자로 변환합니다.

API 매핑 생성

API 매핑을 생성하려면 먼저 사용자 지정 도메인 이름, API 및 스테이지를 생성해야 합니다. 사용자 지정 도메인 이름 생성에 대한 자세한 내용은 API Gateway에서 리전 사용자 지정 도메인 이름 설정 단원을 참조하세요.

AWS Management Console
API 매핑 생성
  1. https://console.aws.amazon.com/apigateway에서 API Gateway 콘솔에 로그인합니다.

  2. 사용자 지정 도메인 이름을 선택합니다.

  3. 이미 생성한 사용자 지정 도메인 이름을 선택합니다.

  4. API 매핑을 선택합니다.

  5. API 매핑 구성을 선택합니다.

  6. 새 매핑 추가를 선택합니다.

  7. API, 스테이지경로(선택 사항)를 입력합니다.

  8. 저장을 선택합니다.

AWS CLI

다음 create-api-mapping 명령은 API 매핑을 생성합니다. 이 예에서 API Gateway는 지정된 API 및 스테이지로 api.example.com/v1 요청을 보냅니다.

aws apigatewayv2 create-api-mapping \ --domain-name api.example.com \ --api-mapping-key v1 \ --api-id a1b2c3d4 \ --stage test
AWS CloudFormation

다음 AWS CloudFormation 예에서는 API 매핑을 생성합니다.

MyApiMapping: Type: 'AWS::ApiGatewayV2::ApiMapping' Properties: DomainName: api.example.com ApiMappingKey: 'v1' ApiId: !Ref MyApi Stage: !Ref MyStage
API 매핑 생성
  1. https://console.aws.amazon.com/apigateway에서 API Gateway 콘솔에 로그인합니다.

  2. 사용자 지정 도메인 이름을 선택합니다.

  3. 이미 생성한 사용자 지정 도메인 이름을 선택합니다.

  4. API 매핑을 선택합니다.

  5. API 매핑 구성을 선택합니다.

  6. 새 매핑 추가를 선택합니다.

  7. API, 스테이지경로(선택 사항)를 입력합니다.

  8. 저장을 선택합니다.

이 페이지에서

프라이버시사이트 이용 약관쿠키 기본 설정
© 2025, Amazon Web Services, Inc. 또는 계열사. All rights reserved.