$util.http の HTTP ヘルパー - AWS AppSync GraphQL
$util.http utils リスト

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

$util.http の HTTP ヘルパー

注記

現在、主に APPSYNC_JS ランタイムとそのドキュメントをサポートしています。こちらにある APPSYNC_JS ランタイムとそのガイドの使用をご検討ください。

$util.http ユーティリティには、HTTP リクエストパラメータの管理やレスポンスヘッダーの追加に使用できるヘルパーメソッドが用意されています。

$util.http utils リスト

$util.http.copyHeaders(Map) : Map

以下の制限された HTTP ヘッダーを除き、マップからヘッダーをコピーします。

  • transfer-encoding

  • connection

  • host

  • expect

  • keep-alive

  • upgrade

  • proxy-authenticate

  • proxy-authorization

  • te

  • content-length

このユーティリティを使用して、リクエストヘッダーをダウンストリーム HTTP エンドポイントに転送できます。

{
    ...
    "params": {
        ...
        "headers": $util.http.copyHeaders($ctx.request.headers),
        ...
    },
    ...
}
$util.http.addResponseHeader(文字列、オブジェクト）

レスポンスの名前 (String) と値 (Object) を含むカスタムヘッダーを 1 つ追加します。以下の制限が適用されます。

  • の制限付きヘッダーのリストに加えてcopyHeaders(Map)、ヘッダー名は次のいずれかと一致することはできません。

    • 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-。

  • カスタムレスポンスヘッダーのサイズは 4 KB を超えることはできません。これにはヘッダー名と値が含まれます。

  • 各レスポンスヘッダーは、GraphQL 操作ごとに 1 回定義する必要があります。ただし、同じ名前のカスタムヘッダーを複数回定義すると、最新の定義がレスポンスに表示されます。名前に関係なく、すべてのヘッダーがヘッダーサイズの上限に含まれます。

  • 名前が空または制限されているヘッダー(String)や null のヘッダー(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 {}
}