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.

# Création d’un groupe Storage Lens
<a name="storage-lens-groups-create"></a>

Les exemples suivants montrent comment créer un groupe Amazon S3 Storage Lens à l'aide de la console Amazon S3, AWS Command Line Interface (AWS CLI) et AWS SDK pour Java.

## Utilisation de la console S3
<a name="create-storage-lens-group-console"></a>

**Pour créer un groupe Storage Lens**

1. Connectez-vous à la console Amazon S3 AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

1. Dans la barre de navigation en haut de la page, sélectionnez le nom de la région AWS actuellement affichée. Choisissez ensuite la région à laquelle vous souhaitez passer. 

1. Dans le volet de navigation de gauche, choisissez **Groupes Storage Lens**.

1. Choisissez **Créer un groupe Storage Lens**.

1. Sous **Général**, affichez votre **région d’origine** et entrez le **nom de votre groupe Storage Lens**.

1. Sous **Portée**, choisissez le filtre que vous souhaitez appliquer à votre groupe Storage Lens. Pour appliquer plusieurs filtres, choisissez vos filtres, puis l’opérateur logique **AND** ou **OR**.
   + Pour le filtre **Préfixes**, choisissez **Préfixes** et entrez une chaîne de préfixe. Pour ajouter plusieurs préfixes, choisissez **Ajouter un préfixe**. Pour supprimer un préfixe, choisissez **Supprimer** en regard du préfixe que vous souhaitez supprimer.
   + Pour le filtre **Balises d’objet**, choisissez **Balises d’objet** et entrez la paire clé-valeur de votre objet. Choisissez ensuite **Ajouter une balise**. Pour supprimer une balise, choisissez **Supprimer** en regard de la balise que vous souhaitez supprimer.
   + Pour le filtre **Suffixes**, choisissez **Suffixes** et entrez une chaîne de suffixe. Pour ajouter plusieurs suffixes, choisissez **Ajouter un suffixe**. Pour supprimer un suffixe, choisissez **Supprimer** en regard du suffixe que vous souhaitez supprimer.
   + Pour le filtre **Age**, spécifiez la tranche d’âge de l’objet en jours. Choisissez **Spécifier l’âge minimum de l’objet**, puis entrez l’âge minimal de l’objet. Choisissez ensuite **Spécifier l’âge maximum de l’objet**, puis entrez l’âge maximal de l’objet.
   + Pour le filtre **Taille**, spécifiez la plage de tailles de l’objet et l’unité de mesure. Choisissez **Spécifier la taille minimale d’objet**, puis entrez la taille minimale de l’objet. Choisissez **Spécifier la taille maximale d’objet**, puis entrez la taille maximale de l’objet.

1. (Facultatif) Pour les balises de AWS ressources, ajoutez la paire clé-valeur, puis choisissez **Ajouter** une balise.

1. Choisissez **Créer un groupe Storage Lens**.

## À l'aide du AWS CLI
<a name="create-storage-lens-group-cli"></a>

L'exemple de AWS CLI commande suivant crée un groupe Storage Lens. Pour utiliser cet exemple de commande, remplacez `user input placeholders` par vos propres informations.

```
aws s3control create-storage-lens-group --account-id 111122223333 \ 
--region us-east-1 --storage-lens-group=file://./marketing-department.json
```

L'exemple de AWS CLI commande suivant crée un groupe Storage Lens avec deux balises de AWS ressources. Pour utiliser cet exemple de commande, remplacez `user input placeholders` par vos propres informations.

```
aws s3control create-storage-lens-group --account-id 111122223333 \ 
--region us-east-1 --storage-lens-group=file://./marketing-department.json \
--tags Key=k1,Value=v1 Key=k2,Value=v2
```

Pour obtenir des exemples de configuration JSON, consultez [Configuration des groupes Storage Lens](storage-lens-groups.md#storage-lens-groups-configuration).

## Utilisation du AWS SDK pour Java
<a name="create-storage-lens-group-sdk-java"></a>

L' AWS SDK pour Java exemple suivant crée un groupe Storage Lens. Pour utiliser cet exemple, remplacez les `user input placeholders` par vos propres informations.

**Example – Création d’un groupe Storage Lens avec un seul filtre**  
L’exemple suivant crée un groupe Storage Lens nommé `Marketing-Department`. Ce groupe possède un filtre d’âge d’objet qui spécifie la tranche d’âge sur `30` à `90` jours. Pour utiliser cet exemple, remplacez les `user input placeholders` par vos propres informations.  

```
package aws.example.s3control;
 
import com.amazonaws.AmazonServiceException;
import com.amazonaws.SdkClientException;
import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider;
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.s3control.S3ControlClient;
import software.amazon.awssdk.services.s3control.model.CreateStorageLensGroupRequest;
import software.amazon.awssdk.services.s3control.model.MatchObjectAge;
import software.amazon.awssdk.services.s3control.model.StorageLensGroup;
import software.amazon.awssdk.services.s3control.model.StorageLensGroupFilter;
 
public class CreateStorageLensGroupWithObjectAge {
    public static void main(String[] args) {
        String storageLensGroupName = "Marketing-Department";
        String accountId = "111122223333";
        
        try {
            StorageLensGroupFilter objectAgeFilter = StorageLensGroupFilter.builder()
                    .matchObjectAge(MatchObjectAge.builder()
                            .daysGreaterThan(30)
                            .daysLessThan(90)
                            .build())
                    .build();

            StorageLensGroup storageLensGroup = StorageLensGroup.builder()
                    .name(storageLensGroupName)
                    .filter(objectAgeFilter)
                    .build();

            CreateStorageLensGroupRequest createStorageLensGroupRequest = CreateStorageLensGroupRequest.builder()
                    .storageLensGroup(storageLensGroup)
                    .accountId(accountId).build();

            S3ControlClient s3ControlClient = S3ControlClient.builder()
                    .region(Region.US_WEST_2)
                    .credentialsProvider(ProfileCredentialsProvider.create())
                    .build();
            s3ControlClient.createStorageLensGroup(createStorageLensGroupRequest);
        } catch (AmazonServiceException e) {
            // The call was transmitted successfully, but Amazon S3 couldn't process
            // it and returned an error response.
            e.printStackTrace();
        } catch (SdkClientException e) {
            // Amazon S3 couldn't be contacted for a response, or the client
            // couldn't parse the response from Amazon S3.
            e.printStackTrace();
        }
    }
}
```

**Example – Création d’un groupe Storage Lens avec un opérateur `AND` incluant plusieurs filtres**  
L'exemple suivant crée un groupe Storage Lens nommé `Marketing-Department`. Ce groupe utilise l’opérateur `AND` pour indiquer que les objets doivent correspondre à **toutes** les conditions de filtre. Pour utiliser cet exemple, remplacez les `user input placeholders` par vos propres informations.   

```
package aws.example.s3control;

import com.amazonaws.AmazonServiceException;
import com.amazonaws.SdkClientException;
import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider;
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.s3control.S3ControlClient;
import software.amazon.awssdk.services.s3control.model.CreateStorageLensGroupRequest;
import software.amazon.awssdk.services.s3control.model.MatchObjectAge;
import software.amazon.awssdk.services.s3control.model.MatchObjectSize;
import software.amazon.awssdk.services.s3control.model.S3Tag;
import software.amazon.awssdk.services.s3control.model.StorageLensGroup;
import software.amazon.awssdk.services.s3control.model.StorageLensGroupAndOperator;
import software.amazon.awssdk.services.s3control.model.StorageLensGroupFilter;


public class CreateStorageLensGroupWithAndFilter {
    public static void main(String[] args) {
        String storageLensGroupName = "Marketing-Department";
        String accountId = "111122223333";

        try {
            // Create object tags.
            S3Tag tag1 = S3Tag.builder()
                    .key("object-tag-key-1")
                    .value("object-tag-value-1")
                    .build();
            S3Tag tag2 = S3Tag.builder()
                    .key("object-tag-key-2")
                    .value("object-tag-value-2")
                    .build();

            StorageLensGroupAndOperator andOperator = StorageLensGroupAndOperator.builder()
                    .matchAnyPrefix("prefix-1", "prefix-2", "prefix-3/sub-prefix-1")
                    .matchAnySuffix(".png", ".gif", ".jpg")
                    .matchAnyTag(tag1, tag2)
                    .matchObjectAge(MatchObjectAge.builder()
                            .daysGreaterThan(30)
                            .daysLessThan(90).build())
                    .matchObjectSize(MatchObjectSize.builder()
                            .bytesGreaterThan(1000L)
                            .bytesLessThan(6000L).build())
                    .build();

            StorageLensGroupFilter andFilter = StorageLensGroupFilter.builder()
                    .and(andOperator)
                    .build();

            StorageLensGroup storageLensGroup = StorageLensGroup.builder()
                    .name(storageLensGroupName)
                    .filter(andFilter)
                    .build();

            CreateStorageLensGroupRequest createStorageLensGroupRequest = CreateStorageLensGroupRequest.builder()
                    .storageLensGroup(storageLensGroup)
                    .accountId(accountId).build();

            S3ControlClient s3ControlClient = S3ControlClient.builder()
                    .region(Region.US_WEST_2)
                    .credentialsProvider(ProfileCredentialsProvider.create())
                    .build();
            s3ControlClient.createStorageLensGroup(createStorageLensGroupRequest);
        } catch (AmazonServiceException e) {
            // The call was transmitted successfully, but Amazon S3 couldn't process
            // it and returned an error response.
            e.printStackTrace();
        } catch (SdkClientException e) {
            // Amazon S3 couldn't be contacted for a response, or the client
            // couldn't parse the response from Amazon S3.
            e.printStackTrace();
        }
    }
}
```

**Example – Création d’un groupe Storage Lens avec un opérateur `OR` incluant plusieurs filtres**  
L'exemple suivant crée un groupe Storage Lens nommé `Marketing-Department`. Ce groupe utilise un opérateur `OR` pour appliquer un filtre de préfixe (`prefix-1`, `prefix-2`, `prefix3/sub-prefix-1`) ou un filtre de taille d’objet avec une plage de tailles comprise entre `1000` octets et `6000` octets. Pour utiliser cet exemple, remplacez les `user input placeholders` par vos propres informations.  

```
package aws.example.s3control;

import com.amazonaws.AmazonServiceException;
import com.amazonaws.SdkClientException;
import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider;
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.s3control.S3ControlClient;
import software.amazon.awssdk.services.s3control.model.CreateStorageLensGroupRequest;
import software.amazon.awssdk.services.s3control.model.MatchObjectSize;
import software.amazon.awssdk.services.s3control.model.StorageLensGroup;
import software.amazon.awssdk.services.s3control.model.StorageLensGroupFilter;
import software.amazon.awssdk.services.s3control.model.StorageLensGroupOrOperator;

public class CreateStorageLensGroupWithOrFilter {
    public static void main(String[] args) {
        String storageLensGroupName = "Marketing-Department";
        String accountId = "111122223333";

        try {
            StorageLensGroupOrOperator orOperator = StorageLensGroupOrOperator.builder()
                    .matchAnyPrefix("prefix-1", "prefix-2", "prefix-3/sub-prefix-1")
                    .matchObjectSize(MatchObjectSize.builder()
                            .bytesGreaterThan(1000L)
                            .bytesLessThan(6000L)
                            .build())
                    .build();

            StorageLensGroupFilter orFilter = StorageLensGroupFilter.builder()
                    .or(orOperator)
                    .build();

            StorageLensGroup storageLensGroup = StorageLensGroup.builder()
                    .name(storageLensGroupName)
                    .filter(orFilter)
                    .build();

            CreateStorageLensGroupRequest createStorageLensGroupRequest = CreateStorageLensGroupRequest.builder()
                    .storageLensGroup(storageLensGroup)
                    .accountId(accountId).build();

            S3ControlClient s3ControlClient = S3ControlClient.builder()
                    .region(Region.US_WEST_2)
                    .credentialsProvider(ProfileCredentialsProvider.create())
                    .build();
            s3ControlClient.createStorageLensGroup(createStorageLensGroupRequest);
        } catch (AmazonServiceException e) {
            // The call was transmitted successfully, but Amazon S3 couldn't process
            // it and returned an error response.
            e.printStackTrace();
        } catch (SdkClientException e) {
            // Amazon S3 couldn't be contacted for a response, or the client
            // couldn't parse the response from Amazon S3.
            e.printStackTrace();
        }
    }
}
```

**Example — Créez un groupe Storage Lens avec un seul filtre et deux balises de AWS ressources**  
L’exemple suivant crée un groupe Storage Lens nommé `Marketing-Department` qui possède un filtre de suffixe. Cet exemple ajoute également deux balises de AWS ressources au groupe Storage Lens. Pour utiliser cet exemple, remplacez les `user input placeholders` par vos propres informations.  

```
package aws.example.s3control;

import com.amazonaws.AmazonServiceException;
import com.amazonaws.SdkClientException;
import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider;
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.s3control.S3ControlClient;
import software.amazon.awssdk.services.s3control.model.CreateStorageLensGroupRequest;
import software.amazon.awssdk.services.s3control.model.StorageLensGroup;
import software.amazon.awssdk.services.s3control.model.StorageLensGroupFilter;
import software.amazon.awssdk.services.s3control.model.Tag;

public class CreateStorageLensGroupWithResourceTags {
    public static void main(String[] args) {
        String storageLensGroupName = "Marketing-Department";
        String accountId = "111122223333";

        try {
            // Create AWS resource tags.
            Tag resourceTag1 = Tag.builder()
                    .key("resource-tag-key-1")
                    .value("resource-tag-value-1")
                    .build();
            Tag resourceTag2 = Tag.builder()
                    .key("resource-tag-key-2")
                    .value("resource-tag-value-2")
                    .build();

            StorageLensGroupFilter suffixFilter = StorageLensGroupFilter.builder()
                    .matchAnySuffix(".png", ".gif", ".jpg")
                    .build();

            StorageLensGroup storageLensGroup = StorageLensGroup.builder()
                    .name(storageLensGroupName)
                    .filter(suffixFilter)
                    .build();

            CreateStorageLensGroupRequest createStorageLensGroupRequest = CreateStorageLensGroupRequest.builder()
                    .storageLensGroup(storageLensGroup)
                    .tags(resourceTag1, resourceTag2)
                    .accountId(accountId).build();

            S3ControlClient s3ControlClient = S3ControlClient.builder()
                    .region(Region.US_WEST_2)
                    .credentialsProvider(ProfileCredentialsProvider.create())
                    .build();
            s3ControlClient.createStorageLensGroup(createStorageLensGroupRequest);
        } catch (AmazonServiceException e) {
            // The call was transmitted successfully, but Amazon S3 couldn't process
            // it and returned an error response.
            e.printStackTrace();
        } catch (SdkClientException e) {
            // Amazon S3 couldn't be contacted for a response, or the client
            // couldn't parse the response from Amazon S3.
            e.printStackTrace();
        }
    }
}
```

Pour obtenir des exemples de configuration JSON, consultez [Configuration des groupes Storage Lens](storage-lens-groups.md#storage-lens-groups-configuration).