Nous avons annoncé la sortie end-of-support de la AWS SDK for JavaScript v2. Nous vous recommandons de migrer vers la AWS SDK for JavaScript version 3. Pour les dates, les détails supplémentaires et les informations sur la façon de migrer, reportez-vous à l'annonce associée.

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.

Utilisation du format JSON

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

Le SDK JavaScript utilise le JSON pour envoyer des données aux objets de service lors de demandes et reçoit les données des objets de service au format JSON. Pour plus d'informations sur le format JSON, consultez json.org.

JSON représente les données de deux manières :

Voici un exemple d'un objet JSON contenant une série d'objets dans laquelle les objets représentent des cartes d'un jeu. Chaque carte est définie par deux paires nom-valeur. L'une spécifie une valeur unique qui identifie cette carte et l'une autre spécifie une URL qui pointe 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"}];

JSON en tant que paramètres des objets de service

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

var pullParams = {
   FunctionName : 'slotPull',
   InvocationType : 'RequestResponse',
   LogType : 'None'
};

L'objet pullParams 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,,InvocationType, 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'objet JSON à l'appel de méthode, comme illustré dans l'exemple suivant d'appel d'une fonction Lambda.

lambda = new AWS.Lambda({region: 'us-west-2', apiVersion: '2015-03-31'});
// create JSON object for service call parameters
var pullParams = {
   FunctionName : 'slotPull',
   InvocationType : 'RequestResponse',
   LogType : 'None'
};                
// invoke Lambda function, passing JSON object
lambda.invoke(pullParams, function(err, data) {
   if (err) {
      console.log(err);
   } else {
      console.log(data);
   }
});

Renvoi de données au format JSON

Le format JSON offre un moyen standard de transmettre des données entre les différentes parties d'une application devant envoyer plusieurs valeurs en même temps. Les méthodes de classes de client dans l'API renvoient généralement des éléments JSON dans le paramètre data transmis à leurs fonctions de rappel. Par exemple, voici un appel à la getBucketCors méthode de la classe client Amazon S3.

// call S3 to retrieve CORS configuration for selected bucket
s3.getBucketCors(bucketParams, function(err, data) {
  if (err) {
    console.log(err);
  } else if (data) {
    console.log(JSON.stringify(data));
  }
});

La valeur de data est un objet JSON, dans cet exemple JSON qui décrit la configuration CORS actuelle pour un compartiment Amazon S3 spécifié.

{
   "CORSRules": [
      {
          "AllowedHeaders":["*"],
          "AllowedMethods":["POST","GET","PUT","DELETE","HEAD"],
          "AllowedOrigins":["*"],
          "ExposeHeaders":[],
          "MaxAgeSeconds":3000
      }
   ]
}