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 des groupes Storage Lens
Les groupes Amazon S3 Storage Lens regroupent les métriques à l’aide de filtres personnalisés basés sur les métadonnées des objets. Vous pouvez analyser et filtrer les métriques S3 Storage Lens à l’aide de préfixes, suffixes, balises d’objet, taille ou âge d’objet. Les groupes Amazon S3 Storage Lens vous permettent également de classer votre utilisation au sein des compartiments Amazon S3 et entre eux. Ainsi, vous serez en mesure de mieux comprendre et d’optimiser votre stockage S3.
Pour commencer à visualiser les données d’un groupe Storage Lens, vous devez d’abord [attacher votre groupe Storage Lens à un tableau de bord S3 Storage Lens](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage-lens-groups-dashboard-console.html#storage-lens-groups-attach-dashboard-console). Si vous devez gérer des groupes Storage Lens dans le tableau de bord, vous pouvez modifier la configuration du tableau de bord. Pour vérifier quels groupes Storage Lens sont associés à votre compte, vous pouvez les répertorier. Pour vérifier quels groupes Storage Lens sont attachés à votre tableau de bord, vous pouvez toujours consulter l’onglet **Groupes Storage Lens** du tableau de bord. Pour consulter ou mettre à jour la portée d’un groupe Storage Lens existant, vous pouvez consulter ses détails. Vous pouvez également supprimer définitivement un groupe Storage Lens.
Pour gérer les autorisations, vous pouvez créer et ajouter des balises de AWS ressources définies par l'utilisateur à vos groupes Storage Lens. Vous pouvez utiliser AWS des balises de ressources pour classer les ressources par département, secteur d'activité ou projet. Cela est utile lorsque vous avez de nombreuses ressources du même type. En appliquant des balises, vous pouvez rapidement identifier un groupe Storage Lens spécifique en fonction des balises que vous lui avez affectées.
En outre, lorsque vous ajoutez une balise de AWS ressource à votre groupe Storage Lens, vous activez le [contrôle d'accès basé sur les attributs (ABAC)](https://docs.aws.amazon.com/IAM/latest/UserGuide/introduction_attribute-based-access-control.html). L’ABAC est une stratégie d’autorisation qui définit les autorisations en fonction des attributs, dans ce cas, des balises. Vous pouvez également utiliser des conditions qui spécifient des balises de ressources dans vos politiques IAM pour [contrôler l'accès aux AWS ressources](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html#access_tags_control-resources).
**Topics**
+ [Création d’un groupe Storage Lens](storage-lens-groups-create.md)
+ [Attachement ou retrait de groupes S3 Storage Lens à ou de votre tableau de bord](storage-lens-groups-dashboard-console.md)
+ [Visualisation des données de vos groupes Storage Lens](storage-lens-groups-visualize.md)
+ [Mise à jour d’un groupe Storage Lens](storage-lens-groups-update.md)
+ [Gestion des balises de AWS ressources avec les groupes Storage Lens](storage-lens-groups-manage-tags.md)
+ [Liste de tous les groupes Storage Lens](storage-lens-groups-list.md)
+ [Affichage des détails d’un groupe Storage Lens](storage-lens-groups-view.md)
+ [Suppression d’un groupe Storage Lens](storage-lens-groups-delete.md)
# 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 pour Java.
## Utilisation de la console S3
**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
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
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).
# Attachement ou retrait de groupes S3 Storage Lens à ou de votre tableau de bord
Une fois que vous êtes passé au niveau avancé dans Amazon S3 Storage Lens, vous pouvez attacher un [groupe Storage Lens](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage-lens-groups-overview.html) à votre tableau de bord. Si vous avez plusieurs groupes Storage Lens, vous pouvez inclure ou exclure les groupes de votre choix.
Vos groupes Storage Lens doivent résider dans la région d’origine désignée dans le compte du tableau de bord. Une fois que vous avez attaché un groupe Storage Lens à votre tableau de bord, vous recevrez les données d’agrégation supplémentaires du groupe Storage Lens dans votre exportation de métriques dans un délai de 48 heures.
**Note**
Si vous souhaitez consulter les métriques agrégées de votre groupe Storage Lens, vous devez les attacher à votre tableau de bord Storage Lens. Pour obtenir des exemples de fichiers de configuration JSON pour le groupe Storage Lens, consultez [Exemple de configuration S3 Storage Lens avec des groupes Storage Lens dans JSON](S3LensHelperFilesCLI.md#StorageLensGroupsHelperFilesCLI).
## Utilisation de la console S3
**Pour attacher un groupe Storage Lens à un tableau de bord 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 le volet de navigation de gauche, sous **Storage Lens**, choisissez **Tableaux de bord**.
1. Choisissez le bouton d’option du tableau de bord Storage Lens auquel vous souhaitez attacher un groupe Storage Lens.
1. Choisissez **Modifier**.
1. Sous **Metrics selection** (Sélection des métriques), choisissez **Advanced metrics and recommendations** (Métriques et recommandations avancées).
1. Sélectionnez **Regroupement des groupes Storage Lens**.
**Note**
Par défaut, **Métriques avancées** est également sélectionné. Toutefois, vous pouvez également désélectionner ce paramètre, car il n’est pas obligatoire pour agréger les données des groupes Storage Lens.
1. Faites défiler la page jusqu’à **Regroupement des groupes Storage Lens** et spécifiez le ou les groupes Storage Lens que vous souhaitez inclure ou exclure dans l’agrégation de données. Vous pouvez utiliser les options de filtrage suivantes :
+ Si vous souhaitez inclure certains groupes Storage Lens, choisissez **Inclure les groupes Storage Lens**. Sous **Groupes Storage Lens à inclure**, sélectionnez vos groupes Storage Lens.
+ Si vous souhaitez inclure tous les groupes Storage Lens, sélectionnez **Inclure tous les groupes Storage Lens de la région d’origine de ce compte**.
+ Si vous souhaitez exclure certains groupes Storage Lens, choisissez **Exclure les groupes Storage Lens**. Sous **Groupes Storage Lens à exclure**, sélectionnez les groupes Storage Lens que vous souhaitez exclure.
1. Sélectionnez **Enregistrer les modifications**. Si vous avez configuré vos groupes Storage Lens correctement, vous verrez les données d’agrégation supplémentaires du groupe Storage Lens dans votre tableau de bord dans un délai de 48 heures.
**Pour retirer un groupe Storage Lens d’un tableau de bord S3 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 le panneau de navigation de gauche, sous **Storage Lens**, choisissez **Tableaux de bord**.
1. Choisissez le bouton d’option du tableau de bord Storage Lens duquel vous souhaitez retirer un groupe Storage Lens.
1. Choisissez **Afficher la configuration du tableau de bord**.
1. Choisissez **Modifier**.
1. Faites défiler la page jusqu’à la section **Sélection des métriques**.
1. Sous **Regroupement des groupes Storage Lens**, cliquez sur le **X** en regard du groupe Storage Lens que vous souhaitez retirer. Votre groupe Storage Lens est retiré.
Si vous avez inclus tous vos groupes Storage Lens dans votre tableau de bord, décochez la case en regard de **Inclure tous les groupes Storage Lens de la région d’origine de ce compte**.
1. Sélectionnez **Enregistrer les modifications**.
**Note**
La répercussion des mises à jour de configuration dans votre tableau de bord prend jusqu’à 48 heures.
## Utilisation du AWS SDK pour Java
**Example – Attacher tous les groupes Storage Lens à un tableau de bord**
L'exemple de SDK pour Java suivant associe tous les groupes Storage Lens du *111122223333* compte au tableau *DashBoardConfigurationId* de bord :
```
package aws.example.s3control;
import com.amazonaws.AmazonServiceException;
import com.amazonaws.SdkClientException;
import com.amazonaws.services.s3control.AWSS3Control;
import com.amazonaws.services.s3control.AWSS3ControlClient;
import com.amazonaws.services.s3control.model.BucketLevel;
import com.amazonaws.services.s3control.model.PutStorageLensConfigurationRequest;
import com.amazonaws.auth.profile.ProfileCredentialsProvider;
import com.amazonaws.services.s3control.model.AccountLevel;
import com.amazonaws.services.s3control.model.StorageLensConfiguration;
import com.amazonaws.services.s3control.model.StorageLensGroupLevel;
import static com.amazonaws.regions.Regions.US_WEST_2;
public class CreateDashboardWithStorageLensGroups {
public static void main(String[] args) {
String configurationId = "ExampleDashboardConfigurationId";
String sourceAccountId = "111122223333";
try {
StorageLensGroupLevel storageLensGroupLevel = new StorageLensGroupLevel();
AccountLevel accountLevel = new AccountLevel()
.withBucketLevel(new BucketLevel())
.withStorageLensGroupLevel(storageLensGroupLevel);
StorageLensConfiguration configuration = new StorageLensConfiguration()
.withId(configurationId)
.withAccountLevel(accountLevel)
.withIsEnabled(true);
AWSS3Control s3ControlClient = AWSS3ControlClient.builder()
.withCredentials(new ProfileCredentialsProvider())
.withRegion(US_WEST_2)
.build();
s3ControlClient.putStorageLensConfiguration(new PutStorageLensConfigurationRequest()
.withAccountId(sourceAccountId)
.withConfigId(configurationId)
.withStorageLensConfiguration(configuration)
);
} 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 – Attacher deux groupes Storage Lens à un tableau de bord**
L' AWS SDK pour Java exemple suivant associe deux groupes Storage Lens (*StorageLensGroupName1*et*StorageLensGroupName2*) au *ExampleDashboardConfigurationId* tableau de bord.
```
package aws.example.s3control;
import com.amazonaws.AmazonServiceException;
import com.amazonaws.SdkClientException;
import com.amazonaws.auth.profile.ProfileCredentialsProvider;
import com.amazonaws.services.s3control.AWSS3Control;
import com.amazonaws.services.s3control.AWSS3ControlClient;
import com.amazonaws.services.s3control.model.AccountLevel;
import com.amazonaws.services.s3control.model.BucketLevel;
import com.amazonaws.services.s3control.model.PutStorageLensConfigurationRequest;
import com.amazonaws.services.s3control.model.StorageLensConfiguration;
import com.amazonaws.services.s3control.model.StorageLensGroupLevel;
import com.amazonaws.services.s3control.model.StorageLensGroupLevelSelectionCriteria;
import static com.amazonaws.regions.Regions.US_WEST_2;
public class CreateDashboardWith2StorageLensGroups {
public static void main(String[] args) {
String configurationId = "ExampleDashboardConfigurationId";
String storageLensGroupName1 = "StorageLensGroupName1";
String storageLensGroupName2 = "StorageLensGroupName2";
String sourceAccountId = "111122223333";
try {
StorageLensGroupLevelSelectionCriteria selectionCriteria = new StorageLensGroupLevelSelectionCriteria()
.withInclude(
"arn:aws:s3:" + US_WEST_2.getName() + ":" + sourceAccountId + ":storage-lens-group/" + storageLensGroupName1,
"arn:aws:s3:" + US_WEST_2.getName() + ":" + sourceAccountId + ":storage-lens-group/" + storageLensGroupName2);
System.out.println(selectionCriteria);
StorageLensGroupLevel storageLensGroupLevel = new StorageLensGroupLevel()
.withSelectionCriteria(selectionCriteria);
AccountLevel accountLevel = new AccountLevel()
.withBucketLevel(new BucketLevel())
.withStorageLensGroupLevel(storageLensGroupLevel);
StorageLensConfiguration configuration = new StorageLensConfiguration()
.withId(configurationId)
.withAccountLevel(accountLevel)
.withIsEnabled(true);
AWSS3Control s3ControlClient = AWSS3ControlClient.builder()
.withCredentials(new ProfileCredentialsProvider())
.withRegion(US_WEST_2)
.build();
s3ControlClient.putStorageLensConfiguration(new PutStorageLensConfigurationRequest()
.withAccountId(sourceAccountId)
.withConfigId(configurationId)
.withStorageLensConfiguration(configuration)
);
} 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 – Attacher tous les groupes Storage Lens avec des exclusions**
L'exemple de SDK pour Java suivant associe tous les groupes Storage Lens au tableau de bord, à *ExampleDashboardConfigurationId* l'exception des deux spécifiés *StorageLensGroupName1* (*StorageLensGroupName2*et) :
```
package aws.example.s3control;
import com.amazonaws.AmazonServiceException;
import com.amazonaws.SdkClientException;
import com.amazonaws.auth.profile.ProfileCredentialsProvider;
import com.amazonaws.services.s3control.AWSS3Control;
import com.amazonaws.services.s3control.AWSS3ControlClient;
import com.amazonaws.services.s3control.model.AccountLevel;
import com.amazonaws.services.s3control.model.BucketLevel;
import com.amazonaws.services.s3control.model.PutStorageLensConfigurationRequest;
import com.amazonaws.services.s3control.model.StorageLensConfiguration;
import com.amazonaws.services.s3control.model.StorageLensGroupLevel;
import com.amazonaws.services.s3control.model.StorageLensGroupLevelSelectionCriteria;
import static com.amazonaws.regions.Regions.US_WEST_2;
public class CreateDashboardWith2StorageLensGroupsExcluded {
public static void main(String[] args) {
String configurationId = "ExampleDashboardConfigurationId";
String storageLensGroupName1 = "StorageLensGroupName1";
String storageLensGroupName2 = "StorageLensGroupName2";
String sourceAccountId = "111122223333";
try {
StorageLensGroupLevelSelectionCriteria selectionCriteria = new StorageLensGroupLevelSelectionCriteria()
.withInclude(
"arn:aws:s3:" + US_WEST_2.getName() + ":" + sourceAccountId + ":storage-lens-group/" + storageLensGroupName1,
"arn:aws:s3:" + US_WEST_2.getName() + ":" + sourceAccountId + ":storage-lens-group/" + storageLensGroupName2);
System.out.println(selectionCriteria);
StorageLensGroupLevel storageLensGroupLevel = new StorageLensGroupLevel()
.withSelectionCriteria(selectionCriteria);
AccountLevel accountLevel = new AccountLevel()
.withBucketLevel(new BucketLevel())
.withStorageLensGroupLevel(storageLensGroupLevel);
StorageLensConfiguration configuration = new StorageLensConfiguration()
.withId(configurationId)
.withAccountLevel(accountLevel)
.withIsEnabled(true);
AWSS3Control s3ControlClient = AWSS3ControlClient.builder()
.withCredentials(new ProfileCredentialsProvider())
.withRegion(US_WEST_2)
.build();
s3ControlClient.putStorageLensConfiguration(new PutStorageLensConfigurationRequest()
.withAccountId(sourceAccountId)
.withConfigId(configurationId)
.withStorageLensConfiguration(configuration)
);
} 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();
}
}
}
```
# Visualisation des données de vos groupes Storage Lens
Vous pouvez visualiser les données de vos groupes Storage Lens en [attachant le groupe à votre tableau de bord Amazon S3 Storage Lens](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage-lens-groups-dashboard-console.html#storage-lens-groups-attach-dashboard-console). Une fois que vous avez inclus le groupe Storage Lens dans l’agrégation de groupes Storage Lens de la configuration de votre tableau de bord, l’affichage des données du groupe Storage Lens dans votre tableau de bord peut prendre jusqu’à 48 heures.
Une fois la configuration du tableau de bord mise à jour, tous les groupes Storage Lens récemment attachés apparaissent dans la liste des ressources disponibles sous l’onglet **Groupes Storage Lens**. Vous pouvez également analyser en détail l’utilisation du stockage dans votre onglet **Aperçu** en découpant les données selon une autre dimension. Par exemple, vous pouvez choisir l’un des éléments répertoriés dans les **3 principales** catégories et choisir **Analyser par** pour découper les données selon une autre dimension. Vous ne pouvez pas appliquer la même dimension que le filtre lui-même.
**Note**
Vous ne pouvez pas appliquer un filtre de groupe Storage Lens en même temps qu’un filtre de préfixe, ou inversement. Vous ne pouvez pas non plus approfondir l’analyse d’un groupe Storage Lens à l’aide d’un filtre de préfixe.
Vous pouvez utiliser l’onglet **Groupes Storage Lens** du tableau de bord Amazon S3 Storage Lens pour personnaliser la visualisation des données pour les groupes Storage Lens attachés à votre tableau de bord. Vous pouvez visualiser les données de certains groupes Storage Lens attachés à votre tableau de bord ou de tous les groupes.
Lorsque vous visualisez les données d’un groupe Storage Lens dans votre tableau de bord S3 Storage Lens, tenez compte des points suivants :
+ S3 Storage Lens regroupe les métriques d'utilisation d'un objet dans tous les groupes Storage Lens correspondants. Par conséquent, si un objet correspond aux conditions de filtre pour au moins deux groupes Storage Lens, vous constaterez des décomptes répétés pour le même objet dans l'ensemble de votre utilisation du stockage.
+ Les objets doivent correspondre aux filtres que vous incluez dans vos groupes Storage Lens. Si aucun objet ne correspond aux filtres que vous incluez dans votre groupe Storage Lens, aucune métrique n’est générée. Pour déterminer s’il existe des objets non affectés, vérifiez le nombre total d’objets dans le tableau de bord au niveau du compte et au niveau du compartiment.
# 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.
## Utilisation de la console S3
**Pour mettre à jour 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 le panneau de navigation de gauche, choisissez **Groupes Storage Lens**.
1. Sous **Groupes Storage Lens**, choisissez le groupe Storage Lens que vous souhaitez mettre à jour.
1. Sous **Portée**, choisissez **Modifier**.
1. 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.
1. Sélectionnez **Enregistrer les modifications**. La page de détails du groupe Storage Lens s’affiche.
1. (Facultatif) Si vous souhaitez ajouter une nouvelle balise de AWS ressource, accédez à la section **AWS des balises de ressource**, 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.
1. (Facultatif) Si vous souhaitez supprimer une balise de AWS ressource existante, accédez à la section **AWS des balises de ressource**, 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 AWS ressource, elle ne peut pas être restaurée.
## À l'aide du AWS CLI
L' AWS CLI exemple de commande 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' AWS CLI exemple 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](storage-lens-groups.md#storage-lens-groups-configuration).
## Utilisation du AWS SDK pour Java
L' AWS SDK pour Java exemple suivant renvoie les détails de configuration du groupe `Marketing-Department` Storage Lens dans le compte`111122223333`. 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.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 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.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](storage-lens-groups.md#storage-lens-groups-configuration).
# Gestion des balises de AWS ressources avec les groupes Storage Lens
Chaque groupe Amazon S3 Storage Lens est considéré comme une AWS ressource dotée de son propre Amazon Resource Name (ARN). Par conséquent, lorsque vous configurez votre groupe Storage Lens, vous pouvez éventuellement ajouter des balises de ressource AWS au groupe. Vous pouvez ajouter jusqu’à 50 balises par groupe Storage Lens. Pour créer un groupe Storage Lens avec des balises, vous devez disposer des autorisations `s3:CreateStorageLensGroup` et `s3:TagResource`.
Vous pouvez utiliser AWS des balises de ressources pour classer les ressources par département, secteur d'activité ou projet. Cela est utile lorsque vous avez de nombreuses ressources du même type. En appliquant des balises, vous pouvez rapidement identifier un groupe Storage Lens spécifique en fonction des balises que vous lui avez affectées. Vous pouvez également utiliser des balises pour suivre et répartir les coûts.
En outre, lorsque vous ajoutez une balise de AWS ressource à votre groupe Storage Lens, vous activez le [contrôle d'accès basé sur les attributs (ABAC)](https://docs.aws.amazon.com/IAM/latest/UserGuide/introduction_attribute-based-access-control.html). L’ABAC est une stratégie d’autorisation qui définit les autorisations en fonction des attributs, dans ce cas, des balises. Vous pouvez également utiliser des conditions qui spécifient des balises de ressources dans vos politiques IAM pour [contrôler l'accès aux AWS ressources](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html#access_tags_control-resources).
Vous pouvez modifier les clés et valeurs de balise, et vous pouvez retirer des balises d’une ressource à tout moment. En outre, tenez compte des limitations suivantes :
+ Les clés de balise et valeurs de balise sont sensibles à la casse.
+ Si vous ajoutez une balise ayant la même clé qu’une balise existante sur cette ressource, la nouvelle valeur remplace l’ancienne valeur.
+ Si vous supprimez une ressource, ses balises sont également supprimées.
+ N'incluez pas de données privées ou sensibles dans vos balises de AWS ressources.
+ Les balises système (dont les clés de balise commencent par `aws:`) ne sont pas prises en charge.
+ La longueur de chaque clé de balise ne peut pas dépasser 128 caractères. La longueur de chaque valeur de balise ne peut pas dépasser 256 caractères.
Les exemples suivants montrent comment utiliser les balises de AWS ressources avec les groupes Storage Lens.
**Topics**
+ [Ajouter une balise AWS de ressource à un groupe Storage Lens](storage-lens-groups-add-tags.md)
+ [Mise à jour des valeurs de balise d’un groupe Storage Lens](storage-lens-groups-update-tags.md)
+ [Supprimer une balise de AWS ressource d'un groupe Storage Lens](storage-lens-groups-delete-tags.md)
+ [Liste des balises du groupe Storage Lens](storage-lens-groups-list-tags.md)
# Ajouter une balise AWS de ressource à un groupe Storage Lens
Les exemples suivants montrent comment ajouter AWS des balises de ressources à un groupe Amazon S3 Storage Lens. Vous pouvez ajouter des balises de ressources à l'aide de la console Amazon S3, AWS Command Line Interface (AWS CLI) et AWS SDK pour Java.
## Utilisation de la console S3
**Pour ajouter une balise de AWS ressource à 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 le panneau de navigation de gauche, choisissez **Groupes Storage Lens**.
1. Sous **Groupes Storage Lens**, choisissez le groupe Storage Lens que vous souhaitez mettre à jour.
1. Sous **Balises de ressources AWS **, choisissez **Ajouter des balises**.
1. Sur la page **Ajouter des balises**, ajoutez la nouvelle paire clé-valeur.
**Note**
L'ajout d'une nouvelle balise ayant la même clé qu'une balise existante remplace la valeur de balise précédente.
1. (Facultatif) Pour ajouter plusieurs nouvelles balises, choisissez à nouveau **Ajouter une balise** pour continuer à ajouter de nouvelles entrées. Vous pouvez ajouter jusqu'à 50 balises de AWS ressources à votre groupe Storage Lens.
1. (Facultatif) Si vous souhaitez retirer une entrée récemment ajoutée, choisissez **Retirer** en regard de la balise que vous souhaitez retirer.
1. Sélectionnez **Enregistrer les modifications**.
## À l'aide du AWS CLI
L'exemple de AWS CLI commande suivant ajoute deux balises de ressources à un groupe Storage Lens existant nommé`marketing-department`. Pour utiliser cet exemple de commande, remplacez `user input placeholders` par vos propres informations.
```
aws s3control tag-resource --account-id 111122223333 \
--resource-arn arn:aws:s3:us-east-1:111122223333:storage-lens-group/marketing-department \
--region us-east-1 --tags Key=k1,Value=v1 Key=k2,Value=v2
```
## Utilisation du AWS SDK pour Java
L' AWS SDK pour Java exemple suivant ajoute deux balises de AWS ressources à un groupe Storage Lens existant. 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.Tag;
import software.amazon.awssdk.services.s3control.model.TagResourceRequest;
public class TagResource {
public static void main(String[] args) {
String resourceARN = "Resource_ARN";
String accountId = "111122223333";
try {
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();
TagResourceRequest tagResourceRequest = TagResourceRequest.builder()
.resourceArn(resourceARN)
.tags(resourceTag1, resourceTag2)
.accountId(accountId)
.build();
S3ControlClient s3ControlClient = S3ControlClient.builder()
.region(Region.US_WEST_2)
.credentialsProvider(ProfileCredentialsProvider.create())
.build();
s3ControlClient.tagResource(tagResourceRequest);
} 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();
}
}
}
```
# Mise à jour des valeurs de balise d’un groupe Storage Lens
Les exemples suivants montrent comment mettre à jour les valeurs des balises de groupe 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
**Pour mettre à jour une balise de AWS ressource pour 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 le panneau de navigation de gauche, choisissez **Groupes Storage Lens**.
1. Sous **Groupes Storage Lens**, choisissez le groupe Storage Lens que vous souhaitez mettre à jour.
1. Sous **Balises de ressources AWS **, sélectionnez la balise que vous souhaitez mettre à jour.
1. Ajoutez la nouvelle valeur de balise en utilisant la même clé que la paire clé-valeur que vous souhaitez mettre à jour. Cliquez sur l’icône représentant une coche pour mettre à jour la valeur de balise.
**Note**
L'ajout d'une nouvelle balise ayant la même clé qu'une balise existante remplace la valeur de balise précédente.
1. (Facultatif) Si vous souhaitez ajouter de nouvelles balises, choisissez **Ajouter une balise** pour ajouter de nouvelles entrées. La page **Ajouter des balises** s’affiche.
Vous pouvez ajouter jusqu'à 50 balises de AWS ressources pour votre groupe Storage Lens. Lorsque vous avez terminé d’ajouter des nouvelles balises, choisissez **Enregistrer les modifications**.
1. (Facultatif) Si vous souhaitez retirer une entrée récemment ajoutée, choisissez **Retirer** en regard de la balise que vous souhaitez retirer. Lorsque vous avez terminé de retirer des balises, choisissez **Enregistrer les modifications**.
## À l'aide du AWS CLI
L'exemple de AWS CLI commande suivant met à jour deux valeurs de balise pour le groupe Storage Lens nommé`marketing-department`. Pour utiliser cet exemple de commande, remplacez `user input placeholders` par vos propres informations.
```
aws s3control tag-resource --account-id 111122223333 \
--resource-arn arn:aws:s3:us-east-1:111122223333:storage-lens-group/marketing-department \
--region us-east-1 --tags Key=k1,Value=v3 Key=k2,Value=v4
```
## Utilisation du AWS SDK pour Java
L' AWS SDK pour Java exemple suivant met à jour les valeurs de deux balises de 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.Tag;
import software.amazon.awssdk.services.s3control.model.TagResourceRequest;
public class UpdateTagsForResource {
public static void main(String[] args) {
String resourceARN = "Resource_ARN";
String accountId = "111122223333";
try {
Tag updatedResourceTag1 = Tag.builder()
.key("resource-tag-key-1")
.value("resource-tag-updated-value-1")
.build();
Tag updatedResourceTag2 = Tag.builder()
.key("resource-tag-key-2")
.value("resource-tag-updated-value-2")
.build();
TagResourceRequest tagResourceRequest = TagResourceRequest.builder()
.resourceArn(resourceARN)
.tags(updatedResourceTag1, updatedResourceTag2)
.accountId(accountId)
.build();
S3ControlClient s3ControlClient = S3ControlClient.builder()
.region(Region.US_WEST_2)
.credentialsProvider(ProfileCredentialsProvider.create())
.build();
s3ControlClient.tagResource(tagResourceRequest);
} 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();
}
}
}
```
# Supprimer une balise de AWS ressource d'un groupe Storage Lens
Les exemples suivants montrent comment supprimer une balise de AWS ressource d'un groupe Storage Lens. Vous pouvez supprimer des balises à l'aide de la console Amazon S3, AWS Command Line Interface (AWS CLI) et AWS SDK pour Java.
## Utilisation de la console S3
**Pour supprimer une balise de AWS ressource d'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 le panneau de navigation de gauche, choisissez **Groupes Storage Lens**.
1. Sous **Groupes Storage Lens**, choisissez le groupe Storage Lens que vous souhaitez mettre à jour.
1. Sous **Balises de ressources AWS **, sélectionnez la paire clé-valeur que vous souhaitez supprimer.
1. Sélectionnez **Delete (Supprimer)**. La boîte de dialogue **Supprimer les balises de ressources AWS ** s’affiche.
**Note**
Si des balises sont utilisées pour contrôler l’accès, cette action peut affecter les ressources associées. Une fois que vous avez définitivement supprimé une balise, elle ne peut pas être restaurée.
1. Choisissez **Supprimer** pour supprimer définitivement la paire clé-valeur.
## À l'aide du AWS CLI
La AWS CLI commande suivante supprime deux balises de AWS ressources d'un groupe Storage Lens existant : Pour utiliser cet exemple de commande, remplacez-les `user input placeholders` par vos propres informations.
```
aws s3control untag-resource --account-id 111122223333 \
--resource-arn arn:aws:s3:us-east-1:111122223333:storage-lens-group/Marketing-Department \
--region us-east-1 --tag-keys k1 k2
```
## Utilisation du AWS SDK pour Java
L' AWS SDK pour Java exemple suivant supprime deux balises de AWS ressources du groupe Storage Lens Amazon Resource Name (ARN) que vous spécifiez dans le compte`111122223333`. 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.UntagResourceRequest;
public class UntagResource {
public static void main(String[] args) {
String resourceARN = "Resource_ARN";
String accountId = "111122223333";
try {
String tagKey1 = "resource-tag-key-1";
String tagKey2 = "resource-tag-key-2";
UntagResourceRequest untagResourceRequest = UntagResourceRequest.builder()
.resourceArn(resourceARN)
.tagKeys(tagKey1, tagKey2)
.accountId(accountId)
.build();
S3ControlClient s3ControlClient = S3ControlClient.builder()
.region(Region.US_WEST_2)
.credentialsProvider(ProfileCredentialsProvider.create())
.build();
s3ControlClient.untagResource(untagResourceRequest);
} 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();
}
}
}
```
# Liste des balises du groupe Storage Lens
Les exemples suivants montrent comment répertorier les balises de AWS ressources associées à un groupe Storage Lens. Vous pouvez répertorier les balises à l'aide de la console Amazon S3, AWS Command Line Interface (AWS CLI) et AWS SDK pour Java.
## Utilisation de la console S3
**Pour consulter la liste des balises et des valeurs des balises d’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 le panneau de navigation de gauche, choisissez **Groupes Storage Lens**.
1. Sous **Groupes Storage Lens**, choisissez le groupe Storage Lens qui vous intéresse.
1. Faites défiler la page jusqu’à la section **Balises de ressources AWS **. Toutes les balises de AWS ressources définies par l'utilisateur qui sont ajoutées à votre groupe Storage Lens sont répertoriées avec leurs valeurs de balise.
## À l'aide du AWS CLI
L' AWS CLI exemple de commande suivant répertorie toutes les valeurs des balises du groupe Storage Lens pour le groupe Storage Lens nommé`marketing-department`. Pour utiliser cet exemple de commande, remplacez `user input placeholders` par vos propres informations.
```
aws s3control list-tags-for-resource --account-id 111122223333 \
--resource-arn arn:aws:s3:us-east-1:111122223333:storage-lens-group/marketing-department \
--region us-east-1
```
## Utilisation du AWS SDK pour Java
L' AWS SDK pour Java exemple suivant répertorie les valeurs des balises de groupe Storage Lens pour le groupe Storage Lens Amazon Resource Name (ARN) que vous spécifiez. 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.ListTagsForResourceRequest;
import software.amazon.awssdk.services.s3control.model.ListTagsForResourceResponse;
public class ListTagsForResource {
public static void main(String[] args) {
String resourceARN = "Resource_ARN";
String accountId = "111122223333";
try {
ListTagsForResourceRequest listTagsForResourceRequest = ListTagsForResourceRequest.builder()
.resourceArn(resourceARN)
.accountId(accountId)
.build();
S3ControlClient s3ControlClient = S3ControlClient.builder()
.region(Region.US_WEST_2)
.credentialsProvider(ProfileCredentialsProvider.create())
.build();
ListTagsForResourceResponse response = s3ControlClient.listTagsForResource(listTagsForResourceRequest);
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();
}
}
}
```
# Liste de tous les groupes Storage Lens
Les exemples suivants montrent comment répertorier tous les groupes Amazon S3 Storage Lens d’un Compte AWS et d’une région d’origine. Ces exemples montrent comment répertorier tous les groupes 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
**Pour répertorier tous les groupes Storage Lens d’un compte et d’une région d’origine**
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 le volet de navigation de gauche, choisissez **Groupes Storage Lens**.
1. Sous **Groupes Storage Lens**, la liste des groupes Storage Lens de votre compte s’affiche.
## À l'aide du AWS CLI
L' AWS CLI exemple suivant répertorie tous les groupes Storage Lens de votre compte. Pour utiliser cet exemple de commande, remplacez `user input placeholders` par vos propres informations.
```
aws s3control list-storage-lens-groups --account-id 111122223333 \
--region us-east-1
```
## Utilisation du AWS SDK pour Java
L' AWS SDK pour Java exemple suivant répertorie les groupes Storage Lens pour le compte`111122223333`. 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.ListStorageLensGroupsRequest;
import software.amazon.awssdk.services.s3control.model.ListStorageLensGroupsResponse;
public class ListStorageLensGroups {
public static void main(String[] args) {
String accountId = "111122223333";
try {
ListStorageLensGroupsRequest listStorageLensGroupsRequest = ListStorageLensGroupsRequest.builder()
.accountId(accountId)
.build();
S3ControlClient s3ControlClient = S3ControlClient.builder()
.region(Region.US_WEST_2)
.credentialsProvider(ProfileCredentialsProvider.create())
.build();
ListStorageLensGroupsResponse response = s3ControlClient.listStorageLensGroups(listStorageLensGroupsRequest);
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();
}
}
}
```
# Affichage des détails d’un groupe Storage Lens
Les exemples suivants montrent comment afficher les détails de configuration d’un groupe Amazon S3 Storage Lens. Vous pouvez consulter ces informations à l'aide de la console Amazon S3, AWS Command Line Interface (AWS CLI) et AWS SDK pour Java.
## Utilisation de la console S3
**Pour consulter les détails de configuration d’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 le panneau de navigation de gauche, choisissez **Groupes Storage Lens**.
1. Sous **Groupes Storage Lens**, choisissez le bouton d’option en regard du groupe Storage Lens qui vous intéresse.
1. Sélectionnez **Afficher les détails**. Vous pouvez désormais passer en revue les détails de votre groupe Storage Lens.
## À l'aide du AWS CLI
L' AWS CLI exemple suivant renvoie les détails de configuration d'un groupe Storage Lens. 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
```
## Utilisation du AWS SDK pour Java
L' AWS SDK pour Java exemple suivant renvoie les détails de configuration du groupe Storage Lens nommé `Marketing-Department` dans le compte`111122223333`. 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.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();
}
}
}
```
# Suppression d’un groupe Storage Lens
Les exemples suivants montrent comment supprimer 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
**Pour supprimer 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 le volet de navigation de gauche, choisissez **Groupes Storage Lens**.
1. Sous **Groupes Storage Lens**, cliquez sur le bouton d’option en regard du groupe Storage Lens que vous souhaitez supprimer.
1. Sélectionnez **Delete (Supprimer)**. La boîte de dialogue **Supprimer le groupe Storage Lens** s’affiche.
1. Choisissez à nouveau **Supprimer** pour supprimer définitivement votre groupe Storage Lens.
**Note**
Une fois que vous avez supprimé un groupe Storage Lens, il ne peut pas être restauré.
## À l'aide du AWS CLI
L' AWS CLI exemple suivant supprime le groupe Storage Lens nommé`marketing-department`. Pour utiliser cet exemple de commande, remplacez `user input placeholders` par vos propres informations.
```
aws s3control delete-storage-lens-group --account-id 111122223333 \
--region us-east-1 --name marketing-department
```
## Utilisation du AWS SDK pour Java
L' AWS SDK pour Java exemple suivant supprime le groupe Storage Lens nommé `Marketing-Department` dans le compte`111122223333`. 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.DeleteStorageLensGroupRequest;
public class DeleteStorageLensGroup {
public static void main(String[] args) {
String storageLensGroupName = "Marketing-Department";
String accountId = "111122223333";
try {
DeleteStorageLensGroupRequest deleteStorageLensGroupRequest = DeleteStorageLensGroupRequest.builder()
.name(storageLensGroupName)
.accountId(accountId).build();
S3ControlClient s3ControlClient = S3ControlClient.builder()
.region(Region.US_WEST_2)
.credentialsProvider(ProfileCredentialsProvider.create())
.build();
s3ControlClient.deleteStorageLensGroup(deleteStorageLensGroupRequest);
} 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();
}
}
}
```