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物件範例,其中物件代表卡片遊戲中的卡片。每個卡片都由兩個名稱值對定義,一個指定唯一值以識別該卡片,另一個指定指向對應卡片映像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 函數時,FunctionName
、 Payload
和 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 }; };