Création d'un groupe Storage Lens

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 for Java.

Pour créer un groupe Storage Lens

Connectez-vous à la console Amazon S3 AWS Management Console et ouvrez-la à l'adresse https://console.aws.amazon.com/s3/.
Dans la barre de navigation en haut de la page, choisissez le nom de la AWS région actuellement affichée. Ensuite, choisissez la région vers laquelle vous souhaitez passer.
Dans le panneau de navigation de gauche, choisissez Groupes Storage Lens.
Choisissez Créer un groupe Storage Lens.
Sous Général, consultez votre région d'origine et entrez le nom de votre groupe Storage Lens.
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.
(Facultatif) Pour les balises de AWS ressources, ajoutez la paire clé-valeur, puis choisissez Ajouter une balise.
Choisissez Créer un groupe Storage Lens.

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.

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

Exemple – 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 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();
        }
    }
}

Exemple – 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 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();
        }
    }
}

Exemple – 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 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();
        }
    }
}

Exemple — 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 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.

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

Utilisation des groupes Storage Lens

Attachement ou retrait d'un groupe Storage Lens