필수 조건 단계 변수를 사용하여 API를 통해 HTTP 엔드포인트 액세스 쿼리 파라미터 표현식에서 스테이지 변수를 통해 HTTP 백엔드에 스테이지별 메타데이터 전달 단계 변수를 사용하여 API를 통해 Lambda 함수 호출 단계 변수를 통해 Lambda 함수에 단계별 메타데이터 전달

Amazon API Gateway 단계 변수 사용

API Gateway 단계 변수를 사용하여 다양한 API 배포 단계의 HTTP 및 Lambda 백엔드에 액세스할 수 있습니다. 또한 단계 변수를 사용하여 스테이지별 구성 메타데이터를 HTTP 백엔드에는 쿼리 파라미터로 전달하고 Lambda 함수에는 입력 매핑 템플릿에서 생성되는 페이로드로 전달할 수도 있습니다.

필수 조건

url 스테이지 변수가 두 가지 HTTP 엔드포인트로 설정된 두 스테이지를 생성해야 합니다. 즉, 두 가지 Lambda 함수에 할당된 function 스테이지 변수 및 스테이지별 메타데이터가 포함된 stageName 스테이지 변수를 말합니다.

단계 변수를 사용하여 API를 통해 HTTP 엔드포인트 액세스

단계 탐색 창에서 베타를 선택합니다. 스테이지 세부 정보에서 복사 아이콘을 선택해 API의 호출 URL을 복사하여 웹 브라우저에 입력합니다. 그러면 API의 루트 리소스에 대한 [beta] 단계 GET 요청이 시작됩니다.

참고
[Invoke URL] 링크는 [beta] 단계에서 API의 루트 리소스를 가리킵니다. 웹 브라우저에 URL을 입력하면 루트 리소스에서 링크 베타 스테이지 GET 메서드를 호출합니다. 루트 리소스 자체가 아닌 하위 리소스에 메서드가 정의된 경우, 웹 브라우저에 URL을 입력하면 {"message":"Missing Authentication Token"} 오류 응답이 반환됩니다. 이 경우 특정 하위 리소스의 이름을 URL 호출(Invoke URL) 링크에 추가해야 합니다.
[beta] 단계 GET 요청에서 받은 응답은 다음에 표시됩니다. 브라우저로 [http://httpbin.org/get] 페이지를 탐색해 결과를 확인할 수도 있습니다. 이 값은 [beta] 단계의 url 변수에 할당되었습니다. 이 두 응답은 동일합니다.
단계(Stages) 탐색 창에서 prod 단계를 선택합니다. 스테이지 세부 정보에서 복사 아이콘을 선택해 API의 호출 URL을 복사하여 웹 브라우저에 입력합니다. 그러면 API의 루트 리소스에 대한 prod 단계 GET 요청이 시작됩니다.
[prod] 단계 GET 요청에서 받은 응답은 다음에 표시됩니다. 브라우저를 사용하여 petstore-demo-endpointhttp://.execute-api.com/petstore/pets로 이동하여 결과를 확인할 수 있습니다. 이 값은 [prod] 단계의 url 변수에 할당되었습니다. 이 두 응답은 동일합니다.

쿼리 파라미터 표현식에서 스테이지 변수를 통해 HTTP 백엔드에 스테이지별 메타데이터 전달

이 절차에서는 쿼리 파라미터 표현식에서 스테이지 변수 값을 사용하여 스테이지별 메타데이터를 HTTP 백엔드로 전달하는 방법에 대해 설명합니다. stageName에 설명된 Amazon API Gateway 콘솔을 사용하여 단계 변수 설정 단계 변수를 사용하겠습니다.

리소스 탐색 창에서 GET 메서드를 선택합니다.

쿼리 문자열 파라미터를 메서드의 URL에 추가하려면 메서드 요청 탭을 선택한 다음 메서드 요청 설정 섹션에서 편집을 선택합니다.
URL 쿼리 문자열 파라미터를 선택하고 다음을 수행합니다.
1. 쿼리 문자열 추가(Add query string)를 선택합니다.
2. 이름에 stageName를 입력합니다.
3. 필수 상태로 유지하고 캐싱을 해제합니다.
저장을 선택합니다.
통합 요청 탭을 선택한 다음 통합 요청 설정 섹션에서 편집을 선택합니다.
엔드포인트 URL의 경우 이전에 정의한 URL 값에 ?stageName=${stageVariables.stageName}을 추가하여 전체 엔드포인트 URL이 http://${stageVariables.url}?stageName=${stageVariables.stageName}이 되도록 합니다.
배포 API를 선택하고 베타 스테이지를 선택합니다.
기본 탐색 창에서 스테이지를 선택합니다. 단계 탐색 창에서 베타를 선택합니다. 스테이지 세부 정보에서 복사 아이콘을 선택해 API의 호출 URL을 복사하여 웹 브라우저에 입력합니다.

참고
url 변수 "http://httpbin.org/get"에서 지정한 바와 같이 HTTP 엔드포인트가 쿼리 파라미터 표현식을 수락하고 응답으로 args 객체로 반환하기 때문에 베타 스테이지를 사용합니다.
응답은 다음과 같습니다. beta 단계 변수에 할당된 stageName는 백엔드에 stageName 인수로 전달됩니다.

단계 변수를 사용하여 API를 통해 Lambda 함수 호출

이 절차에서는 스테이지 변수를 사용하여 Lambda 함수를 API 백엔드로 호출하는 방법을 설명합니다. 앞서 설명한 function 단계 변수를 사용하겠습니다. 자세한 설명은 Amazon API Gateway 콘솔을 사용하여 단계 변수 설정 섹션을 참조하세요.

기본 Node.js 런타임을 사용하여 HelloWorld라는 Lambda 함수를 생성합니다. 코드에는 다음이 포함되어 있습니다.


export const handler = function(event, context, callback) {
    if (event.stageName)
        callback(null, 'Hello, World! I\'m calling from the ' + event.stageName + ' stage.');
    else
        callback(null, 'Hello, World! I\'m not sure where I\'m calling from...');
};

Lambda 함수를 생성하는 방법에 대한 자세한 내용은 REST API 콘솔 시작하기를 참조하세요.

리소스 창에서 리소스 생성을 선택하고 다음을 수행합니다.
1. 리소스 경로에서 /를 선택합니다.
2. 리소스 이름에 lambdav1을 입력합니다.
3. 리소스 생성을 선택합니다.
/lambdav1 리소스를 선택한 다음 메서드 생성을 선택합니다.

이어서 다음을 수행합니다.
1. 메서드 유형에서 GET을 선택합니다.
2. 통합 유형에서 Lambda 함수를 선택합니다.
3. Lambda 프록시 통합을 비활성화된 상태로 유지합니다.
4. Lambda 함수에서 ${stageVariables.function}을(를) 입력합니다.
  작은 정보
  권한 명령 추가라는 메시지가 표시되면 AWS CLI 명령을 복사합니다. function 스테이지 변수에 할당될 각 Lambda 함수에서 명령을 실행합니다. 예를 들어, $stageVariables.function 값이 이면 HelloWorld 다음 명령을 실행합니다. AWS CLI
```
aws lambda add-permission --function-name arn:aws:lambda:us-east-1:account-id:function:HelloWorld --source-arn arn:aws:execute-api:us-east-1:account-id:api-id/*/GET/lambdav1 --principal apigateway.amazonaws.com --statement-id statement-id-guid --action lambda:InvokeFunction
```
  그렇지 않으면 메서드 호출 시 500 Internal Server Error 응답이 반환됩니다. ${stageVariables.function}을 스테이지 변수에 할당된 Lambda 함수 이름으로 바꾸어야 합니다.
5. 메서드 생성을 선택합니다.
prod 및 beta 스테이지 모두에 API를 배포합니다.
기본 탐색 창에서 스테이지를 선택합니다. 단계 탐색 창에서 베타를 선택합니다. 스테이지 세부 정보에서 복사 아이콘을 선택해 API의 호출 URL을 복사하여 웹 브라우저에 입력합니다. URL에 /lambdav1을 추가한 다음 Enter 키를 누릅니다.

응답은 다음과 같습니다.
```
"Hello, World! I'm not sure where I'm calling from..."
```

단계 변수를 통해 Lambda 함수에 단계별 메타데이터 전달

이 절차에서는 단계 변수를 사용하여 Lambda 함수로 단계별 구성 메타데이터를 전달하는 방법을 설명합니다. POST 메서드 및 입력 매핑 템플릿을 만들어 앞서 설명한 stageName 스테이지 변수를 사용해 페이로드를 생성합니다.

/lambdav1 리소스를 선택한 다음 Create 메서드를 선택합니다.

이어서 다음을 수행합니다.
1. 메서드 유형에서 POST를 선택합니다.
2. 통합 유형에서 Lambda 함수를 선택합니다.
3. Lambda 프록시 통합을 비활성화된 상태로 유지합니다.
4. Lambda 함수에서 ${stageVariables.function}을(를) 입력합니다.
5. 권한 명령 추가라는 메시지가 표시되면 AWS CLI 명령을 복사합니다. function 스테이지 변수에 할당될 각 Lambda 함수에서 명령을 실행합니다.
6. 메서드 생성을 선택합니다.
통합 요청 탭을 선택한 다음 통합 요청 설정 섹션에서 편집을 선택합니다.
매핑 템플릿을 선택한 다음 매핑 템플릿 추가를 선택합니다.
콘텐츠 유형에 application/json을 입력합니다.
템플릿 본문에 다음 템플릿을 입력합니다.
```
#set($inputRoot = $input.path('$'))
{
    "stageName" : "$stageVariables.stageName"
}
```
참고
매핑 템플릿에서 스테이지 변수는 따옴표 안에 참조되어야 합니다("$stageVariables.stageName" 또는 "${stageVariables.stageName}"에서와 같이). 다른 곳에서는 따옴표 없이 참조해야 합니다(${stageVariables.function}에서와 같이).
저장을 선택합니다.
beta 및 prod 스테이지 모두에 API를 배포합니다.
REST API 클라이언트를 사용하여 스테이지별 메타데이터를 전달하려면 다음을 수행합니다.
1. 단계 탐색 창에서 베타를 선택합니다. 스테이지 세부 정보에서 복사 아이콘을 선택해 API의 호출 URL을 복사하여 REST API 클라이언트의 입력 필드에 입력합니다. /lambdav1을 추가한 후 요청을 제출합니다.
  
  응답은 다음과 같습니다.
```
"Hello, World! I'm calling from the beta stage."
```
2. 스테이지 탐색 창에서 프로덕션을 선택합니다. 스테이지 세부 정보에서 복사 아이콘을 선택해 API의 호출 URL을 복사하여 REST API 클라이언트의 입력 필드에 입력합니다. /lambdav1을 추가한 후 요청을 제출합니다.
  
  응답은 다음과 같습니다.
```
"Hello, World! I'm calling from the prod stage."
```
테스트 기능을 사용하여 스테이지별 메타데이터를 전달하려면 다음을 수행합니다.
1. 리소스 탐색 창에서 테스트 탭을 선택합니다. 탭을 표시하려면 오른쪽 화살표 버튼을 선택해야 할 수도 있습니다.
2. function에 HelloWorld를 입력합니다.
3. stageName에 beta를 입력합니다.
4. 테스트를 선택합니다. POST 요청에 본문을 추가할 필요는 없습니다.
  
  응답은 다음과 같습니다.
```
"Hello, World! I'm calling from the beta stage."
```
5. 이전 단계를 반복하여 프로덕션 스테이지를 테스트할 수 있습니다. stageName에 Prod를 입력합니다.
  
  응답은 다음과 같습니다.
```
"Hello, World! I'm calling from the prod stage."
```

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

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

문서 규칙

스테이지 변수 설정

스테이지 변수 참조