기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
AWS AppSync HTTP 해석기 함수를 사용하면 AWS AppSync에서 모든 HTTP 엔드포인트로 요청을 보내고 HTTP 엔드포인트의 응답을 다시 AWS AppSync로 보낼 수 있습니다. 요청 핸들러를 사용하여 AWS AppSync에 호출할 작업의 특성에 대한 힌트를 제공할 수 있습니다. 이 단원에서는 지원되는 HTTP 해석기에 대한 다양한 구성에 대해 설명합니다.
요청
type HTTPRequest = {
method: 'PUT' | 'POST' | 'GET' | 'DELETE' | 'PATCH';
params?: {
query?: { [key: string]: any };
headers?: { [key: string]: string };
body?: any;
};
resourcePath: string;
};다음 코드 조각은 text/plain 본문을 포함한 HTTP POST 요청의 예입니다.
export function request(ctx) {
return {
method: 'POST',
params: {
headers: { 'Content-Type': 'text/plain' },
body: 'this is an example of text body',
},
resourcePath: '/',
};
}메서드
참고
이는 요청 핸들러에만 적용됩니다.
AWS AppSync가 HTTP 엔드포인트로 보내는 HTTP 메서드 또는 동사(GET, POST, PUT, PATCH 또는 DELETE)입니다.
"method": "PUT"ResourcePath
참고
이는 요청 핸들러에만 적용됩니다.
액세스하고자 하는 리소스 경로입니다. 리소스 경로는 HTTP 데이터 소스의 엔드포인트와 함께 AWS AppSync 서비스가 요청하는 URL을 형성합니다.
"resourcePath": "/v1/users"요청이 평가되면 이 경로는 HTTP 엔드포인트를 포함해 HTTP 요청의 일부로 전송됩니다. 예를 들어, 이전 예제는 다음과 같이 변환될 수 있습니다.
PUT <endpoint>/v1/users
파라미터 필드
참고
이는 요청 핸들러에만 적용됩니다.
검색에서 수행할 작업을 지정하는 데 사용되며, 가장 일반적으로 본문 내에 쿼리 값을 설정하여 지정합니다. 그러나 응답 형식 지정 등과 같이 구성할 수 있는 기타 여러 가지 기능이 있습니다.
- headers
-
키-값 페어로 표시되는 헤더 정보. 키와 값은 둘 다 문자열이어야 합니다.
예시:
"headers" : { "Content-Type" : "application/json" }현재 지원되는
Content-Type헤더는 다음과 같습니다.text/* application/xml application/json application/soap+xml application/x-amz-json-1.0 application/x-amz-json-1.1 application/vnd.api+json application/x-ndjson다음 HTTP 헤더를 설정할 수 없습니다.
HOST CONNECTION USER-AGENT EXPECTATION TRANSFER_ENCODING CONTENT_LENGTH - query
-
JSON 응답에 대한 코드 형식 지정 등과 같이 공통 옵션을 지정하는 키-값 페어. 키와 값은 둘 다 문자열이어야 합니다. 다음 예제는 쿼리 문자열을
?type=json으로 보낼 방법을 보여줍니다."query" : { "type" : "json" } - body
-
본문에는 설정을 선택하는 HTTP 요청 본문이 포함됩니다. 콘텐츠 유형이 charset을 지정하지 않는 한 요청 본문은 항상 UTF-8 인코딩된 문자열입니다.
"body":"body string"
응답
여기에서 예시를 확인하세요.
