util.http의 HTTP 도우미

PDF

포커스 모드

util.http의 HTTP 도우미 - AWS AppSync GraphQL

util.http 유틸리티 목록

이 util.http 유틸리티는 HTTP 요청 파라미터를 관리하고 응답 헤더를 추가하는 데 사용할 수 있는 도우미 메서드를 제공합니다.

util.http 유틸리티 목록

util.http.copyHeaders(headers)

다음과 같은 제한된 HTTP 헤더를 제외하고 맵에서 헤더를 복사합니다.

transfer-encoding
connection
host
expect
keep-alive
upgrade
proxy-authenticate
proxy-authorization
te
content-length

util.http.addResponseHeader(String, Object)

응답의 이름(String) 및 값(Object)이 포함된 단일 사용자 지정 헤더를 추가합니다. 다음과 같은 제한이 적용됩니다.

의 제한된 헤더 목록 외에도 copyHeaders(headers)헤더 이름은 다음 중 하나와 일치할 수 없습니다.
- Access-Control-Allow-Credentials
- Access-Control-Allow-Origin
- Access-Control-Expose-Headers
- Access-Control-Max-Age
- Access-Control-Allow-Methods
- Access-Control-Allow-Headers
- Vary
- Content-Type
헤더 이름은 제한된 접두사 x-amzn- 또는 로 시작할 수 없습니다x-amz-.
사용자 지정 응답 헤더의 크기는 4KB를 초과할 수 없습니다. 여기에는 헤더 이름과 값이 포함됩니다.
GraphQL 작업당 각 응답 헤더를 한 번씩 정의해야 합니다. 하지만 이름이 같은 사용자 지정 헤더를 여러 번 정의하면 응답에 가장 최근의 정의가 나타납니다. 이름 지정과 상관없이 모든 헤더는 헤더 크기 제한에 포함됩니다.
이름 또는 null 값이 비어 (String) 있거나 제한된 헤더(Object)는 무시되고 작업 errors 출력에 추가되는 ResponseHeaderError 오류가 발생합니다.


export function request(ctx) {
  util.http.addResponseHeader('itemsCount', 7)
  util.http.addResponseHeader('render', ctx.args.render)
  return {}
}

util.http.addResponseHeaders(Map)

지정된 이름 (String) 및 값 맵의 응답에 여러 응답 헤더를 추가합니다(Object). addResponseHeader(String, Object) 메서드에 나열된 것과 동일한 제한 사항이 이 메서드에도 적용됩니다.


export function request(ctx) {
  const headers = {
    headerInt: 12,
    headerString: 'stringValue',
    headerObject: {
      field1: 7,
      field2: 'string'
    }
  }
  util.http.addResponseHeaders(headers)
  return {}
}