$util.http의 HTTP 도우미

참고

이제 우리는 주로 APPSYNC_JS 런타임과 해당 문서를 지원합니다. 여기에서 APPSYNC_JS 런타임과 해당 안내서를 사용해 보세요.

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

$util.http 유틸리티 목록

$util.http.copyHeaders(Map) : Map

제한된 HTTP 헤더 세트 없이 맵에서 헤더를 복사합니다. 이를 사용하여 요청 헤더를 다운스트림 HTTP 엔드포인트로 전달할 수 있습니다.

{
    ...
    "params": {
        ...
        "headers": $util.http.copyHeaders($ctx.request.headers),
        ...
    },
    ...
}

$util.http.addResponseHeader(String, Object)

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

• 헤더 이름은 기존 또는 제한된 AWS 또는 AWS AppSync 헤더와 일치할 수 없습니다.

• 헤더 이름은 x-amzn- 또는 x-amz- 같은 제한된 접두사로 시작할 수 없습니다.

• 사용자 지정 응답 헤더의 크기는 4KB를 초과할 수 없습니다. 여기에는 헤더 이름과 값이 포함됩니다.

• GraphQL 작업당 각 응답 헤더를 한 번씩 정의해야 합니다. 하지만 이름이 같은 사용자 지정 헤더를 여러 번 정의하면 응답에 가장 최근의 정의가 나타납니다. 이름 지정과 상관없이 모든 헤더는 헤더 크기 제한에 포함됩니다.

...
$util.http.addResponseHeader("itemsCount", 7)
$util.http.addResponseHeader("render", $ctx.args.render)
...

$util.http.addResponseHeaders(Map)

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

...
#set($headersMap = {})
$util.qr($headersMap.put("headerInt", 12))
$util.qr($headersMap.put("headerString", "stringValue"))
$util.qr($headersMap.put("headerObject", {"field1": 7, "field2": "string"}))
$util.http.addResponseHeaders($headersMap)
...