使用 JSON - AWS SDK for JavaScript

AWS SDK for JavaScript V3 API參考指南詳細描述 AWS SDK for JavaScript 第 3 版 (V3) 的所有API操作。

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

使用 JSON

JSON 是資料交換的格式,可人類讀取且機器可讀取。雖然 名稱JSON是JavaScript 物件記號 的縮寫,但 的格式與任何程式設計語言JSON無關。

AWS SDK for JavaScript 使用 在提出請求時將資料JSON傳送至服務物件,並從服務物件接收資料作為 JSON。如需 的詳細資訊JSON,請參閱 https://json.org

顯示 的一般格式和部分JSON。

JSON 以兩種方式代表資料:

  • 作為物件 ,這是未排序的名稱值對集合。系統會在左 ({) 和右 (}) 括號內定義物件。每個名稱/值對皆以名稱開始,接著是冒號,然後是值。名稱/值對則是以逗號分隔。

  • 作為陣列 ,這是有序的值集合。系統會在左 ([) 和右 (]) 括號內定義陣列。陣列中的項目皆是以逗號分隔。

以下是包含物件陣列的JSON物件範例,其中物件代表卡片遊戲中的卡片。每個卡片都由兩個名稱值對定義,一個指定唯一值以識別該卡片,另一個指定指向對應卡片映像URL的 。

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

JSON 作為服務物件參數

以下是JSON用於定義對 AWS Lambda 服務物件呼叫參數的簡單範例。

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

params 物件是由三個名稱/值對所定義,系統會在左右括號內以逗號分隔該物件。提供參數給服務物件方法呼叫時,名稱會依欲呼叫之服務物件方法的參數名稱而定。叫用 Lambda 函數時,FunctionNamePayload LogType是用來呼叫 Lambda 服務物件上invoke方法的參數。

將參數傳遞至服務物件方法呼叫時,請將JSON物件提供給方法呼叫,如叫用 Lambda 函數的下列範例所示。

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 }; };