Mise à jour d’un groupe Storage Lens - Amazon Simple Storage Service

Mise à jour d’un groupe Storage Lens

Les exemples suivants montrent comment mettre à jour un groupe Amazon S3 Storage Lens. Vous pouvez mettre à jour un groupe Storage Lens à l’aide de la console Amazon S3, AWS Command Line Interface (AWS CLI) et AWS SDK pour Java.

Pour mettre à jour un groupe Storage Lens

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

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

  3. Sous Groupes Storage Lens, choisissez le groupe Storage Lens que vous souhaitez mettre à jour.

  4. Sous Portée, choisissez Modifier.

  5. Sur la page Portée, sélectionnez le filtre que vous souhaitez appliquer à votre groupe Storage Lens. Pour appliquer plusieurs filtres, sélectionnez vos filtres et choisissez l’opérateur logique AND ou OR.

    • Pour le filtre Préfixes, sélectionnez 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, 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, sélectionnez 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. Pour Spécifier l’âge maximum de l’objet, 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. Pour Spécifier la taille maximale d’objet, entrez la taille maximale de l’objet.

  6. Sélectionnez Save Changes. La page de détails du groupe Storage Lens s’affiche.

  7. (Facultatif) Si vous souhaitez ajouter une nouvelle balise de ressource AWS, faites défiler la page jusqu’à la section Balises de ressources AWS, puis choisissez Ajouter des balises. La page Ajouter des balises s’affiche.

    Ajoutez la nouvelle paire clé-valeur, puis choisissez Enregistrer les modifications. La page de détails du groupe Storage Lens s’affiche.

  8. (Facultatif) Si vous souhaitez retirer une balise de ressource AWS existante, faites défiler la page jusqu’à la section Balises de ressources AWS, puis sélectionnez la balise de ressource. Ensuite, choisissez Supprimer. La boîte de dialogue Supprimer les balises AWS s’affiche.

    Choisissez à nouveau Supprimer pour supprimer définitivement la balise de ressource AWS.

    Note

    Une fois que vous avez définitivement supprimé une balise de ressource AWS, elle ne peut pas être restaurée.

L’exemple de commande AWS CLI suivant renvoie les détails de configuration d’un groupe Storage Lens nommé marketing-department. Pour utiliser cet exemple de commande, remplacez user input placeholders par vos propres informations.

aws s3control get-storage-lens-group --account-id 111122223333 \ 
--region us-east-1 --name marketing-department

L’exemple AWS CLI suivant met à jour un groupe Storage Lens. Pour utiliser cet exemple de commande, remplacez user input placeholders par vos propres informations. 

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

Pour obtenir des exemples de configuration JSON, consultez Configuration des groupes Storage Lens.

L’exemple AWS SDK pour Java suivant renvoie les détails de configuration du groupe Storage Lens Marketing-Department dans le compte 111122223333. 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.GetStorageLensGroupRequest;
import software.amazon.awssdk.services.s3control.model.GetStorageLensGroupResponse;

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

        try {
            GetStorageLensGroupRequest getRequest = GetStorageLensGroupRequest.builder()
                    .name(storageLensGroupName)
                    .accountId(accountId).build();
            S3ControlClient s3ControlClient = S3ControlClient.builder()
                    .region(Region.US_WEST_2)
                    .credentialsProvider(ProfileCredentialsProvider.create())
                    .build();
            GetStorageLensGroupResponse response = s3ControlClient.getStorageLensGroup(getRequest);
            System.out.println(response);
        } 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();
        }
    }
}

L’exemple suivant met à jour le groupe Storage Lens nommé Marketing-Department dans le compte 111122223333. Cet exemple met à jour la portée du tableau de bord de sorte à inclure les objets correspondant à l’un des suffixes suivants : .png, .gif, .jpg ou .jpeg. 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.StorageLensGroup;
import software.amazon.awssdk.services.s3control.model.StorageLensGroupFilter;
import software.amazon.awssdk.services.s3control.model.UpdateStorageLensGroupRequest;

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

        try {
            // Create updated filter.
            StorageLensGroupFilter suffixFilter = StorageLensGroupFilter.builder()
                    .matchAnySuffix(".png", ".gif", ".jpg", ".jpeg")
                    .build();

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

            UpdateStorageLensGroupRequest updateStorageLensGroupRequest = UpdateStorageLensGroupRequest.builder()
                    .name(storageLensGroupName)
                    .storageLensGroup(storageLensGroup)
                    .accountId(accountId)
                    .build();

            S3ControlClient s3ControlClient = S3ControlClient.builder()
                    .region(Region.US_WEST_2)
                    .credentialsProvider(ProfileCredentialsProvider.create())
                    .build();
            s3ControlClient.updateStorageLensGroup(updateStorageLensGroupRequest);
        } 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.