HTTP용 AWS AppSync JavaScript 해석기 함수 참조 - AWS AppSync
요청메서드ResourcePath파라미터 필드응답

HTTP용 AWS AppSync JavaScript 해석기 함수 참조

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"

응답

여기에서 예시를 확인하세요.