La AWS SDK pour JavaScript v2 est arrivée end-of-support. Nous vous recommandons de migrer vers la [AWS SDK pour JavaScript version 3](https://docs.aws.amazon.com//sdk-for-javascript/v3/developer-guide/). Pour plus de détails et d'informations sur la façon de migrer, veuillez consulter cette [annonce](https://aws.amazon.com/blogs//developer/announcing-end-of-support-for-aws-sdk-for-javascript-v2/).

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.

# Gestion des autorisations d’accès aux compartiments Amazon S3
<a name="s3-example-access-permissions"></a>

![\[JavaScript code example that applies to Node.js execution\]](http://docs.aws.amazon.com/fr_fr/sdk-for-javascript/v2/developer-guide/images/nodeicon.png)

**Cet exemple de code Node.js présente :**
+ Comment extraire ou définir la liste de contrôle d'accès pour un compartiment Amazon S3.

## Scénario
<a name="w2aac20c25c27c13b9"></a>

Dans cet exemple, un module Node.js est utilisé pour afficher la liste de contrôle d'accès (ACL) de compartiment d'un compartiment sélectionné et appliquer les modifications à la liste de contrôle d'accès (ACL) pour un compartiment sélectionné. Le module Node.js utilise le SDK pour gérer les autorisations JavaScript d'accès aux compartiments Amazon S3 à l'aide des méthodes suivantes de la classe client Amazon S3 :
+ [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#getBucketAcl-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#getBucketAcl-property)
+ [https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#putBucketAcl-property](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/S3.html#putBucketAcl-property)

Pour plus d'informations sur les listes de contrôle d'accès pour les compartiments Amazon S3, consultez [Managing Access with ACLs](https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3_ACLs_UsingACLs.html) dans le *guide de l'utilisateur d'Amazon Simple Storage Service*.

## Tâches prérequises
<a name="w2aac20c25c27c13c11"></a>

Pour configurer et exécuter cet exemple, vous devez d'abord :
+ Installez Node.js. Pour plus d'informations sur l'installation de Node.js, consultez le [site web de Node.js](https://nodejs.org).
+ Créez un fichier de configurations partagé avec vos informations d'identification utilisateur. Pour plus d'informations sur le fichier d'informations d'identification partagé, consultez [Chargement des informations d'identification dans Node.js à partir du fichier d'informations d'identification partagé](loading-node-credentials-shared.md).

## Configuration du kit SDK
<a name="s3-example-access-permissions-configure-sdk"></a>

Configurez le SDK pour JavaScript en créant un objet de configuration global, puis en définissant la région pour votre code. Dans cet exemple, la région est `us-west-2`.

```
// Load the SDK for JavaScript
var AWS = require('aws-sdk');
// Set the Region 
AWS.config.update({region: 'us-west-2'});
```

## Extraction de la liste de contrôle d'accès du compartiment actuel
<a name="s3-example-access-permissions-get-acl"></a>

Créez un module Node.js nommé `s3_getbucketacl.js`. Le module prend un seul argument de ligne de commande pour spécifier le compartiment de la configuration ACL que vous souhaitez. Veillez à configurer le kit SDK comme indiqué précédemment. 

Créez un objet de service `AWS.S3`. Le seul paramètre à passer est le nom du compartiment sélectionné lorsque vous appelez la méthode `getBucketAcl`. La configuration actuelle de la liste de contrôle d'accès est renvoyée par Amazon S3 dans le `data` paramètre transmis à la fonction de rappel.

```
// Load the AWS SDK for Node.js
var AWS = require("aws-sdk");
// Set the region
AWS.config.update({ region: "REGION" });

// Create S3 service object
s3 = new AWS.S3({ apiVersion: "2006-03-01" });

var bucketParams = { Bucket: process.argv[2] };
// call S3 to retrieve policy for selected bucket
s3.getBucketAcl(bucketParams, function (err, data) {
  if (err) {
    console.log("Error", err);
  } else if (data) {
    console.log("Success", data.Grants);
  }
});
```

Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande.

```
node s3_getbucketacl.js BUCKET_NAME
```

Cet exemple de code se trouve [ici sur GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/blob/master/javascript/example_code/s3/s3_getbucketacl.js).