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 S3 Storage Lens pour filtrer et agréger des métriques
Un groupe Amazon S3 Storage Lens regroupe les métriques à l’aide de filtres personnalisés basés sur les métadonnées des objets. Les groupes Storage Lens vous permettent d’analyser en détail les caractéristiques de vos données, telles que la répartition des objets par âge, les types de fichiers les plus courants, etc. Par exemple, vous pouvez filtrer les métriques par balise d’objet pour identifier les jeux de données dont la croissance est la plus rapide, ou visualiser votre stockage en fonction de la taille et de l’âge des objets pour définir votre stratégie d’archivage de stockage. Ainsi, les groupes Amazon S3 Storage Lens vous aident à mieux comprendre et à optimiser votre stockage S3.
Lorsque vous utilisez des groupes Storage Lens, vous pouvez analyser et filtrer les métriques S3 Storage Lens à l’aide de métadonnées d’objets, telles que les préfixes, les suffixes, les [balises d’objet](https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-tagging.html), la taille ou l’âge de l’objet. Vous pouvez également appliquer une combinaison de ces filtres. Après avoir attaché votre groupe Storage Lens à votre tableau de bord S3 Storage Lens, vous pouvez consulter les métriques S3 Storage Lens agrégées par les groupes Amazon S3 Storage Lens directement dans votre tableau de bord.
Par exemple, vous pouvez également filtrer vos métriques par taille d’objet ou par tranche d’âge afin de déterminer quelle partie de votre espace de stockage est constituée de petits objets. Vous pouvez ensuite utiliser ces informations avec S3 Intelligent-Tiering ou S3 Lifecycle pour transférer les petits objets vers différentes classes de stockage afin d’optimiser les coûts et le stockage.
**Topics**
+ [
# Fonctionnement des groupes S3 Storage Lens
](storage-lens-groups.md)
+ [
# Utilisation des groupes Storage Lens
](storage-lens-group-tasks.md)
# Fonctionnement des groupes S3 Storage Lens
Vous pouvez utiliser les groupes Storage Lens pour regrouper les métriques à l’aide de filtres personnalisés basés sur les métadonnées des objets. Lorsque vous définissez un filtre personnalisé, vous pouvez utiliser des préfixes, des suffixes, des balises d’objet, des tailles d’objets, leur âge ou une combinaison de ces filtres personnalisés. Lors de la création d’un groupe Storage Lens, vous pouvez également inclure un filtre ou plusieurs conditions de filtre. Pour spécifier plusieurs conditions de filtre, utilisez les opérateurs logiques `And` ou `Or`.
Lorsque vous créez et configurez un groupe Storage Lens, le groupe Storage Lens lui-même agit comme un filtre personnalisé dans le tableau de bord auquel vous attachez le groupe. Dans votre tableau de bord, vous pouvez ensuite utiliser le filtre de groupe Storage Lens pour obtenir des métriques de stockage en fonction du filtre personnalisé que vous avez défini dans le groupe.
Pour consulter les données de votre groupe Storage Lens dans votre tableau de bord S3 Storage Lens, vous devez attacher le groupe au tableau de bord après l’avoir créé. Une fois que votre groupe Storage Lens est attaché à votre tableau de bord Storage Lens, celui-ci collecte les statistiques d’utilisation du stockage pendant 48 heures. Vous pouvez ensuite visualiser ces données dans le tableau de bord Storage Lens ou les exporter via une exportation de métriques. Si vous oubliez d’attacher un groupe Storage Lens à un tableau de bord, les données de votre groupe Storage Lens ne seront pas capturées ou ne s’afficheront nulle part.
**Note**
Lorsque vous créez un groupe S3 Storage Lens, vous créez une AWS ressource. Par conséquent, chaque groupe Storage Lens possède son propre Amazon Resource Name (ARN), que vous pouvez spécifier lorsque vous l’[attachez ou que vous l’excluez d’un tableau de bord S3 Storage Lens](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage-lens-groups-dashboard-console.html).
Si votre groupe Storage Lens n’est pas attaché à un tableau de bord, vous n’aurez pas à payer de frais supplémentaires pour créer un groupe Storage Lens.
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.
Vous pouvez créer un groupe Storage Lens au niveau du compte dans une région d'origine spécifiée (à partir de la liste des groupes pris en charge Régions AWS). Vous pouvez ensuite attacher votre groupe Storage Lens à plusieurs tableaux de bord Storage Lens, à condition que les tableaux de bord se trouvent dans le même Compte AWS et la même région d’origine. Vous pouvez créer jusqu’à 50 groupes Storage Lens par région d’origine dans chaque Compte AWS.
Vous pouvez créer et gérer des groupes S3 Storage Lens à l'aide de la console Amazon S3, AWS Command Line Interface (AWS CLI) AWS SDKs, ou de l'API REST Amazon S3.
**Topics**
+ [
## Affichage des métriques agrégées d’un groupe Storage Lens
](#storage-lens-group-aggregation)
+ [
## Autorisations pour les groupes Storage Lens
](#storage-lens-group-permissions)
+ [
## Configuration des groupes Storage Lens
](#storage-lens-groups-configuration)
+ [
## AWS balises de ressources
](#storage-lens-group-resource-tags)
+ [
## Exportation de métriques des groupes Storage Lens
](#storage-lens-groups-metrics-export)
## Affichage des métriques agrégées d’un groupe Storage Lens
Vous pouvez consulter les métriques agrégées de vos groupes Storage Lens en attachant les groupes à un tableau de bord. Les groupes Storage Lens que vous souhaitez attacher doivent résider dans la région d’origine désignée dans le compte du tableau de bord.
Pour attacher un groupe Storage Lens à un tableau de bord, vous devez le spécifier dans la section **Regroupement des groupes Storage Lens** de la configuration de votre tableau de bord. Si vous avez plusieurs groupes Storage Lens, vous pouvez filtrer les résultats du **Regroupement des groupes Storage Lens** de sorte à inclure ou exclure les groupes de votre choix. Pour plus d’informations sur l’attachement de groupes à vos tableaux de bord, consultez [Attachement ou retrait de groupes S3 Storage Lens à ou de votre tableau de bord](storage-lens-groups-dashboard-console.md).
Après avoir attaché vos groupes, 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.
**Note**
Pour consulter les métriques agrégées de votre groupe Storage Lens, vous devez attacher le groupe à un tableau de bord S3 Storage Lens.
## Autorisations pour les groupes Storage Lens
Les groupes Storage Lens nécessitent certaines autorisations dans Gestion des identités et des accès AWS (IAM) pour autoriser l'accès aux actions du groupe S3 Storage Lens. Pour accorder ces autorisations, vous pouvez utiliser une politique IAM basée sur l’identité. Vous pouvez attacher cette politique aux utilisateurs, groupes ou rôles IAM pour leur accorder des autorisations. Ces autorisations peuvent inclure la possibilité de créer ou de supprimer des groupes Storage Lens, d’afficher leurs configurations ou de gérer leurs balises.
L’utilisateur ou le rôle IAM auquel vous accordez des autorisations doit appartenir au compte qui a créé ou qui possède le groupe Storage Lens.
Pour utiliser les groupes Storage Lens et consulter les métriques de vos groupes Storage Lens, vous devez d’abord disposer des autorisations appropriées pour utiliser S3 Storage Lens. Pour de plus amples informations, veuillez consulter [Définition d’autorisations Amazon S3 Storage Lens](storage_lens_iam_permissions.md).
Pour créer et gérer des groupes S3 Storage Lens, vous devez disposer des autorisations IAM suivantes, en fonction des opérations que vous souhaitez effectuer :
| Action | Autorisations IAM |
| --- | --- |
| Créer un nouveau groupe Storage Lens | `s3:CreateStorageLensGroup` |
| Créer un nouveau groupe Storage Lens avec des balises | `s3:CreateStorageLensGroup`, `s3:TagResource` |
| Mettre à jour un groupe Storage Lens existant | `s3:UpdateStorageLensGroup` |
| Renvoyer les détails de la configuration d’un groupe Storage Lens | `s3:GetStorageLensGroup` |
| Répertorier tous les groupes Storage Lens de votre région d’origine | `s3:ListStorageLensGroups` |
| Supprimer un groupe Storage Lens | `s3:DeleteStorageLensGroup` |
| Répertorier les balises qui ont été ajoutées à votre groupe Storage Lens | `s3:ListTagsForResource` |
| Ajouter ou mettre à jour une balise de groupe Storage Lens pour un groupe Storage Lens existant | `s3:TagResource` |
| Supprimer une balise d’un groupe Storage Lens | `s3:UntagResource` |
Voici un exemple de configuration de votre politique IAM dans le compte qui crée le groupe Storage Lens. Pour utiliser cette politique, remplacez `us-east-1` par la région d’origine dans laquelle se trouve votre groupe Storage Lens. Remplacez `111122223333` par votre ID de Compte AWS , puis remplacez `example-storage-lens-group` par le nom de votre groupe Storage Lens. Pour appliquer ces autorisations à tous les groupes Storage Lens, remplacez `example-storage-lens-group` par `*`.
```
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "EXAMPLE-Statement-ID",
"Effect": "Allow",
"Action": [
"s3:CreateStorageLensGroup",
"s3:UpdateStorageLensGroup",
"s3:GetStorageLensGroup",
"s3:ListStorageLensGroups",
"s3:DeleteStorageLensGroup,
"s3:TagResource",
"s3:UntagResource",
"s3:ListTagsForResource"
],
"Resource": "arn:aws:s3:us-east-1:111122223333:storage-lens-group/example-storage-lens-group"
}
]
}
```
Pour plus d’informations sur les autorisations S3 Storage Lens, consultez [Définition d’autorisations Amazon S3 Storage Lens](storage_lens_iam_permissions.md). Pour plus d’informations sur le langage des politiques IAM, consultez [Politiques, stratégies et autorisations dans Amazon S3](access-policy-language-overview.md).
## Configuration des groupes Storage Lens
### Nom de groupe S3 Storage Lens
Nous vous recommandons de donner à vos groupes Storage Lens des noms indiquant leur objectif afin que vous puissiez facilement déterminer les groupes que vous souhaitez attacher à vos tableaux de bord. Pour [attacher un groupe Storage Lens à un tableau de bord](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage-lens-groups-dashboard-console.html), vous devez spécifier le groupe dans la section **Regroupement des groupes Storage Lens** de la configuration de votre tableau de bord.
Les noms de groupe Storage Lens doivent être uniques au sein du compte. Ils ne doivent pas dépasser 64 caractères et peuvent uniquement contenir des lettres (a à z, A à Z), des chiffres (0 à 9), des traits d’union (`-`) et des traits de soulignement (`_`).
### Région d’accueil
La région d'origine est celle Région AWS où votre groupe Storage Lens est créé et maintenu. Votre groupe Storage Lens est créé dans la même région d’origine que votre tableau de bord Amazon S3 Storage Lens. La configuration et les métriques du groupe Storage Lens sont également stockées dans cette région. Vous pouvez créer jusqu’à 50 groupes Storage Lens dans une région d’origine.
Après avoir créé votre groupe Storage Lens, vous ne pouvez pas modifier la région d’origine.
### Scope
Pour inclure des objets dans votre groupe Storage Lens, ils doivent être dans la portée de votre tableau de bord Amazon S3 Storage Lens. La portée de votre tableau de bord Storage Lens est déterminée par les compartiments que vous avez inclus dans la **Portée du tableau de bord** de la configuration de votre tableau de bord S3 Storage Lens.
Vous pouvez utiliser différents filtres pour vos objets afin de définir la portée de votre groupe Storage Lens. Pour afficher ces métriques de groupe Storage Lens dans votre tableau de bord S3 Storage Lens, les objets doivent correspondre aux filtres que vous incluez dans vos groupes Storage Lens. Supposons, par exemple, que votre groupe Storage Lens inclut des objets dotés du préfixe `marketing` et du suffixe `.png`, mais qu’aucun objet ne correspond à ces critères. Dans ce cas, les métriques de ce groupe Storage Lens ne seront pas générées lors de votre exportation de métriques quotidienne, et aucune métrique de ce groupe ne sera visible dans votre tableau de bord.
### Filtres
Vous pouvez utiliser les filtres suivants dans un groupe S3 Storage Lens :
+ **Préfixes** : indique le [préfixe](https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-prefixes.html) des objets inclus, qui est une chaîne de caractères au début du nom de la clé d’objet. Par exemple, la valeur `images` pour le filtre **Préfixes** inclut les objets dotés de l’un des préfixes suivants : `images/`, `images-marketing` et `images/production`. La longueur maximale d’un préfixe est de 1 024 octets.
+ **Suffixes** : indique le suffixe des objets inclus (par exemple, `.png`, `.jpeg` ou `.csv`). La longueur maximale d’un suffixe est de 1 024 octets.
+ **Balises d’objet** : indique la liste des [balises d’objet](https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-tagging.html) sur lesquelles vous souhaitez appliquer le filtre. Une clé de balise ne peut pas dépasser 128 caractères Unicode et une valeur de balise ne peut pas dépasser 256 caractères Unicode. Notez que si le champ de valeur de balise de l’objet est laissé vide, les groupes S3 Storage Lens ne font correspondre l’objet qu’aux autres objets dont les valeurs de balise sont également vides.
+ **Age** : indique la tranche d’âge des objets inclus en jours. Seuls les entiers sont pris en charge.
+ **Taille** : indique la plage de tailles des objets inclus en octets. Seuls les entiers sont pris en charge. La valeur maximale autorisée est de 50 To.
### Balises d’objet d’un groupe Storage Lens
Vous pouvez [créer un groupe Storage Lens](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage-lens-groups-create.html) comprenant jusqu’à 10 filtres de balises d’objet. L’exemple suivant inclut deux paires clé-valeur de balise d’objet en tant que filtres pour un groupe Storage Lens nommé `Marketing-Department`. Pour utiliser cet exemple, remplacez `Marketing-Department` par le nom de votre groupe, puis remplacez `object-tag-key-1`, `object-tag-value-1`, etc. par les paires clé-valeur de balise d’objet sur lesquelles vous souhaitez appliquer le filtre.
```
{
"Name": "Marketing-Department",
"Filter": {
"MatchAnyTag":[
{
"Key": "object-tag-key-1",
"Value": "object-tag-value-1"
},
{
"Key": "object-tag-key-2",
"Value": "object-tag-value-2"
}
]
}
}
```
### Opérateurs logiques (`And` ou `Or`)
Pour inclure plusieurs conditions de filtre dans votre groupe Storage Lens, vous pouvez utiliser des opérateurs logiques (`And` ou `Or`). Dans l’exemple suivant, le groupe Storage Lens nommé `Marketing-Department` possède un opérateur `And` qui contient les filtres `Prefix`, `ObjectAge` et `ObjectSize`. Étant donné qu’un opérateur `And` est utilisé, seuls les objets répondant à **toutes** ces conditions de filtre seront inclus dans la portée du groupe Storage Lens.
Pour utiliser cet exemple, remplacez les `user input placeholders` par les valeurs sur lesquelles vous souhaitez appliquer le filtre.
```
{
"Name": "Marketing-Department",
"Filter": {
"And": {
"MatchAnyPrefix": [
"prefix-1",
"prefix-2",
"prefix-3/sub-prefix-1"
],
"MatchObjectAge": {
"DaysGreaterThan": 10,
"DaysLessThan": 60
},
"MatchObjectSize": {
"BytesGreaterThan": 10,
"BytesLessThan": 60
}
}
}
}
```
**Note**
Si vous souhaitez inclure des objets répondant à **l’une** des conditions des filtres, remplacez l’opérateur logique `And` par l’opérateur logique `Or` dans cet exemple.
## AWS balises de ressources
Chaque groupe 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 (balises 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.
## Exportation de métriques des groupes Storage Lens
Les métriques de groupe S3 Storage Lens sont incluses dans l’[exportation des métriques Amazon S3 Storage Lens](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage_lens_understanding_metrics_export_schema.html) pour le tableau de bord auquel le groupe Storage Lens est attaché. Pour obtenir des informations générales sur la fonctionnalité d’exportation des métriques Storage Lens, consultez [Afficher les métriques Amazon S3 Storage Lens à l’aide d’une exportation de données](storage_lens_view_metrics_export.md).
Votre exportation de métriques pour les groupes Storage Lens incluent toute métrique S3 Storage Lens dans la portée du tableau de bord auquel le groupe Storage Lens est attaché. L’exportation inclut également des données de métriques supplémentaires pour les groupes Storage Lens.
Une fois que vous avez créé votre groupe Storage Lens, votre exportation de métriques est envoyée quotidiennement au compartiment que vous avez sélectionné lorsque vous avez configuré l’exportation de métriques pour le tableau de bord auquel votre groupe est attaché. La réception de la première exportation de métriques peut prendre jusqu’à 48 heures.
Pour générer des métriques lors de l’exportation quotidienne, les objets doivent correspondre aux filtres que vous incluez dans vos groupes Storage Lens. Si aucun objet ne correspond aux filtres que vous avez inclus dans votre groupe Storage Lens, aucune métrique ne sera générée. Toutefois, si un objet correspond à au moins deux groupes Storage Lens, l’objet est répertorié séparément pour chaque groupe lorsqu’il apparaît dans l’exportation de métriques.
Vous pouvez identifier les métriques pour les groupes Storage Lens en recherchant l’une des valeurs suivantes dans la colonne `record_type` de l’exportation de métriques pour votre tableau de bord :
+ `STORAGE_LENS_GROUP_BUCKET`
+ `STORAGE_LENS_GROUP_ACCOUNT`
La colonne `record_value` affiche l’ARN de ressource du groupe Storage Lens (par exemple, `arn:aws:s3:us-east-1:111122223333:storage-lens-group/Marketing-Department`).
# 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();
}
}
}
```