Trabaja con JSON - AWS SDK for JavaScript
JSONcomo parámetro de objeto de servicio

La guía de API referencia de la versión AWS SDK for JavaScript 3 describe en detalle todas las API operaciones de la AWS SDK for JavaScript versión 3 (V3).

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Trabaja con JSON

JSONes un formato para el intercambio de datos que es legible tanto por humanos como por máquinas. Aunque el nombre JSON es un acrónimo de JavaScript Object Notation, el formato de JSON es independiente de cualquier lenguaje de programación.

Se AWS SDK for JavaScript utiliza JSON para enviar datos a objetos de servicio al realizar solicitudes y recibe datos de objetos de servicio comoJSON. Para obtener más información al respectoJSON, consulte json.org.

Muestra el formato general y partes de. JSON

JSONrepresenta los datos de dos maneras:

  • Como un objeto, que es una colección sin ordenar de pares de nombre-valor. Un objeto se define entre las llaves izquierda ({) y derecha (}). Cada par de nombre-valor comienza por el nombre, seguido de dos puntos, seguido del valor. Los pares de nombre-valor están separados por comas.

  • Como una matriz, que es una colección ordenada de valores. Una matriz se define entre los corchetes izquierdo ([) y derecho (]). Los elementos de la matriz están separados por comas.

A continuación se muestra un ejemplo de un JSON objeto que contiene una matriz de objetos en la que los objetos representan las cartas de un juego de cartas. Cada carta se define mediante dos pares nombre-valor, uno que especifica un valor único para identificar esa carta y otro que especifica un URL que apunta a la imagen de la carta correspondiente.

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

JSONcomo parámetro de objeto de servicio

Este es un ejemplo de lo simple que JSON se utiliza para definir los parámetros de una llamada a un objeto AWS Lambda de servicio.

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

El objeto params se define mediante tres pares de nombre-valor, separados por comas e incluidos entre llaves (izquierda y derecha). Cuando se proporcionan parámetros a una llamada de método de objeto de servicio, los nombres se determinan mediante nombres de parámetros para el método de objeto de servicio al que tiene previsto llamar. Al invocar una función de Lambda, FunctionName, Payload y LogType son los parámetros que se utilizan para llamar al método invoke de un objeto de servicio de Lambda.

Al pasar parámetros a una llamada a un método de objeto de servicio, proporcione el JSON objeto a la llamada al método, como se muestra en el siguiente ejemplo de invocación de una función 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 };
};