JSON で操作する - AWS SDK for JavaScript
JSON サービスオブジェクトパラメータとして

AWS SDK for JavaScript V3 APIリファレンスガイドでは、バージョン 3 (V3) のすべてのAPIオペレーション AWS SDK for JavaScript について詳しく説明します。

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

JSON で操作する

JSON は、人間が読み取れる形式と機械が読み取れる形式の両方のデータ交換です。名前JSONは JavaScript Object Notation の頭字語ですが、 の形式JSONはプログラミング言語とは無関係です。

AWS SDK for JavaScript はJSON、 を使用してリクエストを行うときにサービスオブジェクトにデータを送信し、サービスオブジェクトからデータを として受信しますJSON。の詳細についてはJSON、json.org を参照してください。

の一般的な形式と部分を表示しますJSON。

JSON は 2 つの方法でデータを表します。

  • [ object ]としては、名前と値のペアの順不同のコレクションです。オブジェクトは左中括弧 ({) と右中括弧 (}) で囲んで定義します。それぞれの名前と値のペアは名前で始まり、続けてコロン、その後に値が続きます。名前と値のペアはカンマで区切ります。

  • [ array ]としては、値の順序付けられたコレクションです。配列は左角括弧 ([) と右角括弧 (]) で囲んで定義します。配列の項目はカンマで区切ります。

以下は、JSONオブジェクトがカードゲームのカードを表すオブジェクトの配列を含むオブジェクトの例です。各カードは、2 つの名前と値のペアで定義されます。1 つはカードを識別する一意の値を指定し、もう 1 つは対応するカードイメージを指す URL を指定します。

var cards = [
  {"CardID":"defaultname", "Image":"defaulturl"},
  {"CardID":"defaultname", "Image":"defaulturl"},
  {"CardID":"defaultname", "Image":"defaulturl"},
  {"CardID":"defaultname", "Image":"defaulturl"},
  {"CardID":"defaultname", "Image":"defaulturl"}
];

JSON サービスオブジェクトパラメータとして

以下は、 AWS Lambda サービスオブジェクトへの呼び出しのパラメータを定義するJSONために使用されるシンプルな例です。

const params = {
   FunctionName : funcName,
   Payload : JSON.stringify(payload),
   LogType : LogType.Tail,
};

params オブジェクトは、左右の中括弧内にコンマで区切られた、3 つの名前と値のペアによって定義されています。サービスオブジェクトメソッドの呼び出しにパラメータを指定する場合、呼び出す予定のサービスオブジェクトメソッドのパラメータ名によって名前が決まります。Lambda 関数を呼び出すとき、FunctionName、Payload、および LogType は、Lambda サービスオブジェクトの invoke メソッドの呼び出しに使用されるパラメータです。

サービスオブジェクトメソッド呼び出しにパラメータを渡すときは、次の Lambda 関数を呼び出す例に示すように、メソッド呼び出しに JSON オブジェクトを指定します。

const invoke = async (funcName, payload) => {
  const client = new LambdaClient({});
  const command = new InvokeCommand({
    FunctionName: funcName,
    Payload: JSON.stringify(payload),
    LogType: LogType.Tail,
  });

  const { Payload, LogResult } = await client.send(command);
  const result = Buffer.from(Payload).toString();
  const logs = Buffer.from(LogResult, "base64").toString();
  return { logs, result };
};