API Gateway 콘솔을 사용하여 API 통합 요청 설정

API 메서드 설정은 메서드를 정의하고 그 동작을 설명합니다. 메서드를 설정하려면 해당 메서드를 노출시킬 루트('/') 등의 리소스, HTTP 메서드(GET, POST 등) 및 대상 백엔드와의 통합 방식을 지정해야 합니다. 메서드 요청 및 응답은 호출하는 앱과의 관계를 규정하며, 이를 통해 API는 어떤 파라미터를 받게 되고 응답은 어떤 유형인지 지정합니다.

다음 절차에서는 API Gateway 콘솔을 사용하여 메서드 설정을 지정하는 방법을 설명합니다.

리소스 창에서 메서드 생성을 선택합니다.
메서드 유형에서 HTTP 메서드를 선택합니다.
통합 유형에서 다음 중 하나를 선택합니다.
- API를 Lambda 함수에 통합할 예정이라면 Lambda 함수를 선택합니다. API 수준에서 비프록시 통합을 생성하는 경우 AWS 통합 유형이고, 프록시 통합을 생성하는 경우 AWS_PROXY 통합 유형입니다.
- API가 HTTP 엔드포인트와 통합될 예정이라면 HTTP를 선택합니다. API 수준에서 이는 HTTP 통합 유형입니다.
- API가 AWS 서비스와 직접 통합될 예정이라면 AWS 서비스를 선택합니다. API 수준에서 이는 AWS 통합 유형입니다. Lambda 함수 옵션은 Lambda 함수 호출을 위한 AWS 통합의 특수한 경우입니다.
  
  API Gateway API를 설정하여 다음 중 하나를 수행하려면:
  - 새 Lambda 함수를 생성합니다.
  - Lambda 함수에 리소스 권한을 설정합니다.
  - 기타 Lambda 서비스 작업을 수행합니다.
  AWS 서비스를 선택해야 합니다.
- API Gateway가 정적 응답을 반환하는 백엔드로 작동하기를 원할 경우 Mock을 선택합니다. API 수준에서 이는 MOCK 통합 유형입니다. 일반적으로 API가 최종적인 것은 아니지만 API 응답을 생성하여 테스트를 위해 종속 팀을 차단하고자 하는 경우 MOCK 통합을 사용할 수 있습니다. OPTION 메서드의 경우 API Gateway가 MOCK 통합을 기본값으로 설정하여 적용된 API 리소스에 대한 CORS 사용 헤더를 반환합니다. 이 옵션을 선택하는 경우 이 주제와 관련된 나머지 부분을 건너뛰고 API Gateway에서 모의 통합 설정을 참조하세요.
Lambda 함수를 선택한 경우 다음을 수행합니다.
1. Lambda 프록시 통합을 사용하려면 Lambda 프록시 통합을 활성화합니다. Lambda 프록시 통합에 대한 자세한 내용은 API Gateway Lambda 프록시 통합 이해 섹션을 참조하세요.
2. Lambda 함수에서 Lambda 함수의 이름을 입력합니다. API와 다른 리전에서 Lambda 함수를 사용하는 경우, 드롭다운 메뉴에서 리전을 선택하고 Lambda 함수의 이름을 입력합니다. 교차 계정 Lambda 함수를 사용하는 경우 함수 ARN을 입력합니다.
  
  리전 이름 및 식별자 목록은 Amazon Web Services 일반 참조의 AWS Lambda를 참조하세요.
3. 기본 제한 시간 값인 29초를 사용하려면 기본 제한 시간을 활성화된 상태로 유지합니다. 사용자 지정 제한 시간을 설정하려면 기본 제한 시간을 선택하고 50 ~ 29000밀리초 사이의 제한 시간 값을 입력합니다.
4. 메서드 생성을 선택합니다.
HTTP 를 선택한 경우 다음을 수행합니다.
1. HTTP 프록시 통합을 사용하려면 HTTP 프록시 통합을 활성화합니다. HTTP 프록시 통합에 대한 자세한 내용은 API Gateway에서 HTTP 프록시 통합 설정 섹션을 참조하세요.
2. HTTP 메서드(HTTP method)에서 HTTP 백엔드의 메서드와 가장 가까운 HTTP 메서드 유형을 선택합니다.
3. 엔드포인트 URL에서 이 메서드를 사용하고자 하는 HTTP 백엔드의 URL을 입력합니다.
4. 콘텐츠 처리에서 콘텐츠 처리 동작을 선택합니다.
5. 기본 제한 시간 값인 29초를 사용하려면 기본 제한 시간을 활성화된 상태로 유지합니다. 사용자 지정 제한 시간을 설정하려면 기본 제한 시간을 선택하고 50 ~ 29000밀리초 사이의 제한 시간 값을 입력합니다.
6. 메서드 생성을 선택합니다.
모의(Mock)를 선택한 경우 다음을 수행합니다.
1. 메서드 생성을 선택합니다.
AWS 서비스를 선택한 경우 다음을 수행합니다.
1. AWS 리전에서 이 메서드를 사용하여 작업을 호출하고자 하는 AWS 리전을 선택합니다.
2. AWS 서비스에서 이 메서드로 호출하려는 AWS 서비스를 선택합니다.
3. AWS 하위 도메인에 AWS 서비스가 사용하는 하위 도메인을 입력합니다. 일반적으로 이 필드는 비워 둡니다. 일부 AWS 서비스는 호스트의 일부로 하위 도메인을 지원할 수 있습니다. 사용 가능 여부, 그리고 사용 가능할 경우 세부 정보는 서비스 설명서를 참조하세요.
4. HTTP 메서드(HTTP method)에서 작업에 해당하는 HTTP 메서드 유형을 선택합니다. HTTP 메서드 유형에 대해서는 AWS 서비스에서 선택한 AWS 서비스에 관한 API 참조 문서를 참조하세요.
5. 작업 유형에서 API 작업을 사용하려면 작업 이름 사용을 선택하고 사용자 지정 리소스 경로를 사용하려면 경로 재정의 사용을 선택합니다. 사용 가능한 작업 및 사용자 지정 리소스 경로에 대해서는 AWS 서비스에서 선택한 AWS 서비스에 관한 API 참조 문서를 참조하세요.
6. 작업 이름 또는 경로 재정의를 입력합니다.
7. 실행 역할에 메서드가 작업을 호출할 때 사용할 IAM 역할의 ARN을 입력합니다.
  
  IAM 역할을 생성하려는 경우 1단계: AWS 서비스 프록시 실행 역할 생성의 지침을 조정할 수 있습니다. 원하는 작업 개수 및 리소스 설명으로 다음 형식의 액세스 정책을 지정합니다.
```
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "action-statement"
      ],
      "Resource": [
        "resource-statement"
      ]
    },
    ...
  ]
}  
```
  작업 및 리소스 설명문 구문은 AWS 서비스에서 선택한 AWS서비스에 관한 문서를 참조하세요.
  
  IAM 역할의 신뢰 관계에 대해 다음과 같이 지정합니다. 이렇게 하면 API Gateway가 AWS 계정을 대신해 작업을 수행할 수 있습니다.
```
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "",
      "Effect": "Allow",
      "Principal": {
        "Service": "apigateway.amazonaws.com"
      },
      "Action": "sts:AssumeRole"
    }
  ]
}
```
8. 기본 제한 시간 값인 29초를 사용하려면 기본 제한 시간을 활성화된 상태로 유지합니다. 사용자 지정 제한 시간을 설정하려면 기본 제한 시간을 선택하고 50 ~ 29000밀리초 사이의 제한 시간 값을 입력합니다.
9. 메서드 생성을 선택합니다.

javascript가 브라우저에서 비활성화되거나 사용이 불가합니다.

AWS 설명서를 사용하려면 Javascript가 활성화되어야 합니다. 지침을 보려면 브라우저의 도움말 페이지를 참조하십시오.

문서 규칙

프록시 리소스를 사용하여 프록시 통합 설정

통합 응답