Pembantu HTTP di $ util.http

catatan

Kami sekarang terutama mendukung runtime APPSYNC_JS dan dokumentasinya. Harap pertimbangkan untuk menggunakan runtime APPSYNC_JS dan panduannya di sini.

$util.httpUtilitas menyediakan metode pembantu yang dapat Anda gunakan untuk mengelola parameter permintaan HTTP dan untuk menambahkan header respons.

$ util.http daftar utilitas

$util.http.copyHeaders(Map) : Map

Menyalin header dari peta tanpa set header HTTP yang dibatasi. Anda dapat menggunakan ini untuk meneruskan header permintaan ke titik akhir HTTP hilir Anda.

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

$util.http.addResponseHeader(String, Object)

Menambahkan header kustom tunggal dengan nama (String) dan nilai (Object) dari respon. Batasan berikut berlaku:

• Nama header tidak dapat cocok dengan header atau AWS AppSync header yang ada AWS atau dibatasi.

• Nama header tidak dapat dimulai dengan awalan terbatas, seperti x-amzn- atau. x-amz-

• Ukuran header respons kustom tidak boleh melebihi 4 KB. Ini termasuk nama dan nilai header.

• Anda harus menentukan setiap header respons sekali per operasi GraphQL. Namun, jika Anda menentukan header kustom dengan nama yang sama beberapa kali, definisi terbaru akan muncul dalam respons. Semua header dihitung terhadap batas ukuran header terlepas dari penamaan.

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

$util.http.addResponseHeaders(Map)

Menambahkan beberapa header respons ke respons dari peta nama (String) dan nilai (Object) yang ditentukan. Keterbatasan yang sama yang tercantum untuk addResponseHeader(String, Object) metode ini juga berlaku untuk metode ini.

...
#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)
...