이 페이지에서는 App Engine 애플리케이션이 URL Fetch 서비스를 사용하여 HTTP 및 HTTPS 요청을 수행하고 응답을 수신하는 방법을 설명합니다. App Engine 애플리케이션에서 HTTP 및 HTTPS 요청을 수행하는 방법을 보여주는 코드 샘플은 HTTP(S) 요청 실행을 참조하세요.
서버리스 VPC 액세스를 설정했거나 Sockets API를 사용하는 경우 URL Fetch 요청 처리를 중지해야 합니다.
URL Fetch를 사용하면 VPC 네트워크 또는 소켓 API에 대한 요청이 실패합니다. URL Fetch를 사용 중지하면 표준 Python 라이브러리가 HTTP 요청을 처리합니다. 특정 요청에 대해 URL Fetch에서 제공하는 기능이 필요한 경우 해당 요청에 urlfetch 라이브러리를 직접 사용할 수 있습니다.
요청
App Engine은 URL Fetch 서비스를 사용하여 아웃바운드 요청을 수행합니다. Python으로httplib, urllib, urllib2 라이브러리를 사용하여 HTTP 요청을 수행할 수 있습니다. App Engine 애플리케이션에서 각 라이브러리는 URL Fetch 서비스를 사용하여 이러한 요청을 수행합니다. 또한 urlfetch 라이브러리를 직접 사용할 수 있습니다.
요청 프로토콜
애플리케이션은 HTTP 또는 HTTPS를 사용하여 URL을 가져올 수 있습니다. 사용되는 프로토콜은 대상 URL의 프로토콜에 따라 유추됩니다.
가져올 URL은 다음 범위의 포트 번호를 사용할 수 있습니다.
80~90440~4501024-65535
포트가 URL에 명시되지 않은 경우 프로토콜의 기본 포트가 사용됩니다. HTTP 요청은 포트 80에서, HTTPS 요청은 포트 443에서 수행됩니다.
요청 메서드
URL Fetch 서비스를 통해 요청을 수행하는 경우 다음과 같은 HTTP 메서드를 사용할 수 있습니다.
GETPOSTPUTHEADDELETEPATCH
요청은 HTTP 헤더를 포함할 수 있으며 POST, PUT, PATCH 요청의 경우에는 페이로드를 포함할 수 있습니다.
요청에 프록시 사용
URL Fetch 서비스는 HTTP/1.1 호환 프록시를 사용하여 결과를 가져옵니다.
애플리케이션에서 요청 무한 재귀가 발생할 우려가 있으므로 요청 핸들러가 자신의 URL을 가져오는 것은 금지되어 있습니다. 그러나 다른 방법으로도 무한 반복이 발생할 수 있으므로, 애플리케이션이 사용자가 제공한 URL에 대한 요청을 가져올 수 있는 경우에는 특히 주의가 필요합니다.
요청 헤더
애플리케이션은 발신 요청에 HTTP 헤더를 설정할 수 있습니다.
HTTP POST 요청을 보낼 때 Content-Type 헤더가 명시적으로 설정되어 있지 않으면 헤더는 x-www-form-urlencoded로 설정됩니다.
이 콘텐츠 유형은 웹 양식에 사용됩니다.
보안상의 이유로 다음 헤더는 애플리케이션에서 수정할 수 없습니다.
Content-LengthHostVaryViaX-Appengine-Inbound-AppidX-Forwarded-ForX-ProxyUser-IP
이러한 헤더는 App Engine에서 정확한 값으로 적절히 설정됩니다. 예를 들어 App Engine은 요청 데이터에서 Content-Length 헤더를 계산하여 요청에 추가한 후 전송합니다.
다음 헤더는 요청하는 앱의 애플리케이션 ID를 나타냅니다.
User-Agent. 이 헤더는 수정할 수 있지만 서버가 App Engine 요청을 식별할 수 있도록 App Engine이 식별자 문자열을 추가합니다. 추가되는 문자열은"AppEngine-Google; (+http://code.google.com/appengine; appid: APPID)"형식이며, 여기서APPID는 앱의 식별자입니다.X-Appengine-Inbound-Appid. 이 헤더를 수정할 수 없으며 이후 리디렉션 매개변수가False로 설정된 경우 URL Fetch 서비스를 통해 요청이 전송되면 자동으로 헤더가 추가됩니다.
요청 제한시간
요청의 기한 또는 제한 시간을 설정할 수 있습니다. 기본적으로 요청 제한 시간은 10초입니다.
동기 요청과 비동기 요청을 전송할 수 있습니다. 다음 동작은 URL Fetch API에 적용됩니다.
- 동기 요청: 원격 호스트가 결과를 반환할 때까지 가져오기 호출이 대기한 후 애플리케이션에 컨트롤을 반환합니다. 가져오기 호출의 최장 대기 시간이 초과되면 호출이 예외를 발생시킵니다.
- 비동기 요청: URL Fetch 서비스가 요청을 시작한 후 즉시 객체를 반환합니다. URL을 가져오는 동안 애플리케이션이 다른 태스크를 수행할 수 있습니다. 애플리케이션은 결과가 필요하면 객체에서 메서드를 호출하고, 객체는 필요에 따라 요청이 완료되기를 기다린 후 결과를 반환합니다. 요청 핸들러가 종료될 때 보류 중인 URL Fetch 요청이 있으면 애플리케이션 서버는 사용자에게 응답을 반환하기 전에 남은 모든 요청이 결과를 반환하거나 기한에 도달할 때까지 기다립니다.
보안 연결 및 HTTPS
애플리케이션은 HTTPS로 보안 서버에 연결하여 안전하게 URL을 가져올 수 있습니다. 이렇게 하면 요청 및 응답 데이터가 암호화된 형식으로 네트워크를 통해 전송됩니다.
Python API에서 URL Fetch 프록시는 기본적으로 연결 중인 호스트를 검증하지 않습니다. 선택사항인 validate_certificate 인수를 fetch() 메서드에 추가하여 호스트 검증을 사용 설정할 수 있습니다.
응답
URL Fetch API를 사용하는 경우 URL Fetch 서비스는 응답, 코드, 헤더, 본문을 포함하여 모든 응답 데이터를 반환한다는 점에 주의하세요.
기본적으로 URL Fetch 서비스는 리디렉션 코드가 포함된 응답을 수신하면 해당 리디렉션을 따릅니다. 서비스는 최대 5개까지 리디렉션 응답을 따른 후 최종 리소스를 반환합니다. 사용자는 URL Fetch 서비스가 리디렉션을 따르지 않도록 지정하고 그 대신 리디렉션 응답을 애플리케이션에 반환하도록 지정할 수 있습니다.
개발 서버에서 URL Fetch 사용
사용자 컴퓨터의 App Engine 개발 서버에서 애플리케이션이 실행되는 경우 URL Fetch 서비스에 대한 호출이 로컬로 처리됩니다. 개발 서버는 컴퓨터에서 인터넷 액세스에 사용 중인 모든 네트워크 구성을 통해 사용자 컴퓨터에서 직접 원격 호스트에 연결하여 URL을 가져옵니다.
URL을 가져오는 애플리케이션의 기능을 테스트할 때는 컴퓨터가 원격 호스트에 액세스할 수 있는지 확인해야 합니다.
URL Fetch의 할당량 및 한도
URL Fetch 서비스의 할당량에 대한 자세한 내용은 할당량을 참조하세요. 애플리케이션이 현재 사용 중인 할당량을 보려면 Google Cloud 콘솔의 할당량 세부정보 페이지로 이동합니다.
또한 URL Fetch 서비스를 사용할 때 다음과 같은 한도가 적용됩니다.
| 한도 | 용량 |
|---|---|
| 요청 크기 | 10MB |
| 요청 헤더 크기 | 16KB(이 값은 헤더에 지정할 수 있는 URL의 최대 길이를 제한함) |
| 응답 크기 | 32MB |
다음 단계
HTTP(S) 요청 실행에서 코드 샘플을 실행하고 애플리케이션에서 요청을 수행하는 방법을 알아봅니다.