Travaillez avec JSON - AWS SDK for JavaScript
JSONen tant que paramètres d'objet de service

Le guide de API référence AWS SDK for JavaScript V3 décrit en détail toutes les API opérations de la AWS SDK for JavaScript version 3 (V3).

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Travaillez avec JSON

JSONest un format d'échange de données à la fois lisible par l'homme et lisible par machine. Bien que le nom JSON soit un acronyme de JavaScript Object Notation, le format de JSON est indépendant de tout langage de programmation.

AWS SDK for JavaScript Utilisés JSON pour envoyer des données aux objets de service lors de demandes et recevoir des données d'objets de service sous forme deJSON. Pour plus d'informations surJSON, consultez json.org.

Affichage du format général et de certaines parties deJSON.

JSONreprésente les données de deux manières :

  • En tant qu'objet, qui est une collection non ordonnée de paires nom-valeur. Un objet est défini entre des accolades gauche ({) et droite (}). Chaque paire nom-valeur commence par le nom, suivi de deux points, suivi de la valeur. Les paires nom-valeur sont séparées par des virgules.

  • En tant que tableau, qui est une collection ordonnée de valeurs. Une série est définie entre crochets gauche ([) et droit (]). Les éléments de la série sont séparés par des virgules.

Voici un exemple d'JSONobjet contenant un tableau d'objets dans lequel les objets représentent des cartes dans un jeu de cartes. Chaque carte est définie par deux paires nom-valeur, l'une indiquant une valeur unique pour identifier cette carte et l'autre URL indiquant une valeur pointant vers l'image de la carte correspondante.

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

JSONen tant que paramètres d'objet de service

Voici un exemple de simple JSON utilisé pour définir les paramètres d'un appel à un objet AWS Lambda de service.

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

L'objet params est défini par trois paires nom-valeur, séparées par des virgules et entourées d'accolades gauche et droite. Lorsque vous fournissez des paramètres à un appel de méthode d'objet de service, les noms sont déterminés par les noms de paramètres pour la méthode d'objet de service que vous prévoyez d'appeler. Lors de l'appel d'une fonction LambdaFunctionName,,Payload, LogType et sont les paramètres utilisés pour appeler la méthode sur un invoke objet de service Lambda.

Lorsque vous transmettez des paramètres à un appel de méthode d'objet de service, fournissez l'JSONobjet à l'appel de méthode, comme illustré dans l'exemple suivant d'appel d'une fonction 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 };
};