Sélectionner vos préférences de cookies

Nous utilisons des cookies essentiels et des outils similaires qui sont nécessaires au fonctionnement de notre site et à la fourniture de nos services. Nous utilisons des cookies de performance pour collecter des statistiques anonymes afin de comprendre comment les clients utilisent notre site et d’apporter des améliorations. Les cookies essentiels ne peuvent pas être désactivés, mais vous pouvez cliquer sur « Personnaliser » ou « Refuser » pour refuser les cookies de performance.

Si vous êtes d’accord, AWS et les tiers approuvés utiliseront également des cookies pour fournir des fonctionnalités utiles au site, mémoriser vos préférences et afficher du contenu pertinent, y compris des publicités pertinentes. Pour accepter ou refuser tous les cookies non essentiels, cliquez sur « Accepter » ou « Refuser ». Pour effectuer des choix plus détaillés, cliquez sur « Personnaliser ».

Création d’un tableau de bord Amazon S3 Storage Lens

Mode de mise au point
Création d’un tableau de bord Amazon S3 Storage Lens - Amazon Simple Storage Service

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.

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.

Vous pouvez créer des tableaux de bord personnalisés S3 Storage Lens supplémentaires qui peuvent être adaptés à votre organisation AWS Organizations ou à des compartiments spécifiques Régions AWS au sein d'un compte.

Note

L’affichage ou la visualisation des mises à jour apportées à la configuration de votre tableau de bord peut prendre jusqu’à 48 heures.

Procédure pour créer un tableau de bord Amazon S3 Storage Lens sur la console Amazon S3.

Étape 1 : définir la portée du tableau de bord
  1. Connectez-vous à la console Amazon S3 AWS Management Console et ouvrez-la à l'adresse https://console.aws.amazon.com/s3/.

  2. 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.

  3. Dans le volet de navigation de gauche, sous S3 Storage Lens, choisissez Tableaux de bord.

  4. Choisissez Create dashboard (Créer un tableau de bord).

  5. Sur la page Tableau de bord, dans la section General (Général), procédez comme suit :

    1. Sélectionnez la région d’origine de votre tableau de bord. La région d'origine est l' Région AWS endroit où sont stockées la configuration et les mesures de ce tableau de bord Storage Lens.

    2. Saisissez un nom de tableau de bord.

      Les noms de tableau de bord doivent contenir moins de 65 caractères et ne doivent pas contenir de caractères spéciaux ou d’espaces.

      Note

      Vous ne pouvez pas modifier ce nom de tableau de bord une fois le tableau de bord créé.

    3. Vous pouvez éventuellement choisir d’ajouter des balises à votre tableau de bord. Vous pouvez utiliser des balises pour gérer les autorisations de votre tableau de bord et suivre les coûts relatifs à S3 Storage Lens.

      Pour plus d’informations, consultez Contrôle de l’accès à l’aide d’étiquettes de ressources dans le Guide de l’utilisateur IAM et Étiquettes de répartition des coûts générées par AWS dans le Guide de l’utilisateur AWS Billing .

      Note

      Vous pouvez ajouter jusqu’à 50 balises à votre configuration de tableau de bord.

  6. Dans la section Dashboard scope (Portée du tableau de bord), procédez comme suit :

    1. Sélectionnez les Régions et les compartiments que vous souhaitez que S3 Storage Lens inclue ou exclue du tableau de bord.

    2. Sélectionnez les compartiments dans les Régions sélectionnées que vous souhaitez que S3 Storage Lens inclue ou exclue. Vous pouvez inclure ou exclure des compartiments, mais pas les deux. Cette option n’est pas disponible lorsque vous créez des tableaux de bord au niveau de l’organisation.

    Note
    • Vous pouvez inclure ou exclure des Régions et des compartiments. Cette option est limitée aux Régions uniquement lors de la création de tableaux de bord au niveau de l’organisation sur les comptes membres de votre organisation.

    • Vous pouvez choisir jusqu’à 50 compartiments à inclure ou exclure.

Étape 2 : configurer la sélection des métriques
  1. Dans la section Metrics selection (Sélection de métriques), sélectionnez le type de métriques que vous souhaitez agréger pour ce tableau de bord.

    • Pour inclure des métriques gratuites agrégées au niveau du compartiment et disponibles pour les requêtes pendant 14 jours, choisissez Free Metrics (Métriques gratuites).

    • Pour activer les métriques avancées et d’autres options avancées, choisissez Advanced metrics and recommendations (Métriques et recommandations avancées). Ces options incluent l'agrégation avancée des préfixes, la CloudWatch publication sur Amazon et les recommandations contextuelles. Les données sont disponibles pour les requêtes pendant 15 mois. Les métriques et recommandations avancées entraînent un coût supplémentaire. Pour plus d’informations, consultez Tarification Amazon S3.

      Pour plus d’informations sur les métriques gratuites et avancées, consultez Sélection des métriques.

  2. Sous Advanced metrics and recommendations features (Fonctionnalités de métriques et recommandations avancées), sélectionnez les options que vous voulez activer :

    • Advanced metrics (Métriques avancées)

    • CloudWatch publiant

    • Prefix aggregation (Agrégation de préfixes)

    Important

    Si vous activez l'agrégation de préfixes pour votre configuration S3 Storage Lens, les métriques au niveau du préfixe ne seront pas publiées sur. CloudWatch Seules les métriques S3 Storage Lens au niveau du bucket, du compte et de l'organisation sont publiées sur. CloudWatch

  3. Si vous avez activé Advanced metrics (Métriques avancées), sélectionnez les Advanced metrics categories (Catégories de métriques avancées) que vous souhaitez afficher dans votre tableau de bord S3 Storage Lens :

    • Métriques d’activité

    • Detailed status code metrics (Métriques détaillées sur le code de statut)

    • Advanced cost optimization metrics (Métriques avancées sur l’optimisation des coûts)

    • Advanced data protection metrics (Métriques avancées sur la protection des données)

    Pour plus d’informations sur les catégories de métriques, consultez Catégories de métriques. Pour obtenir une liste complète des métriques, consultez Glossaire des métriques Amazon S3 Storage Lens.

  4. Si vous avez choisi d’activer l’agrégation des préfixes, configurez les éléments suivants :

    1. Choisissez la taille minimale du seuil de préfixe pour ce tableau de bord.

      Par exemple, un seuil de préfixe de 5 % indique que les préfixes représentant 5 % ou plus de la taille totale de stockage du compartiment seront agrégés.

    2. Sélectionnez la profondeur de préfixe.

      Ce paramètre indique le nombre maximal de niveaux jusqu’auquel les préfixes sont évalués. La profondeur de préfixe doit être inférieure à 10.

    3. Saisissez un caractère de délimiteur de préfixe.

      Cette valeur est utilisée pour identifier chaque niveau de préfixe. La valeur par défaut dans Amazon S3 est le caractère /, mais votre structure de stockage peut utiliser d’autres délimiteurs.

(Facultatif) Étape 3 : exporter des métriques pour le tableau de bord
  1. Dans la section Metrics export (Exportation de métriques), choisissez Enable (Activer) pour créer une exportation de métriques qui sera placée quotidiennement dans un compartiment de destination de votre choix.

    L'exportation des métriques est au format CSV ou Apache Parquet . La portée des données est la même que celle des données de votre tableau de bord S3 Storage Lens sans les recommandations.

  2. Si vous avez activé l'exportation des mesures, choisissez le format de sortie de votre exportation quotidienne des mesures : CSV ou Apache Parquet.

    Parquet est un format de fichier open source pour Hadoop qui stocke les données imbriquées dans un format à colonnes plates.

  3. Sélectionnez le compartiment S3 de destination pour l’exportation de vos métriques.

    Vous pouvez choisir un compartiment dans le compte actuel du tableau de bord S3 Storage Lens. Vous pouvez également en choisir un autre Compte AWS si vous disposez des autorisations du compartiment de destination et de l'ID de compte du propriétaire du compartiment de destination.

  4. Choisissez le compartiment S3 de destination (format : s3://bucket-name/prefix).

    Le compartiment doit être dans la région d’origine de votre tableau de bord S3 Storage Lens. La console S3 vous montre le paramètre Destination bucket permission (Autorisation de compartiment de destination) qui sera ajouté par Amazon S3 à la politique de compartiment de destination. Amazon S3 met à jour la politique de compartiment sur le compartiment de destination pour permettre à S3 de placer des données dans ce compartiment.

  5. (Facultatif) Pour activer le chiffrement côté serveur pour l’exportation de vos métriques, choisissez Specify an encryption key (Spécifier une clé de chiffrement). Ensuite, choisissez le Type de chiffrement : Clés gérées par Amazon S3 (SSE-S3) ou Clé AWS Key Management Service  (SSE-KMS).

    Vous pouvez choisir entre une clé gérée par Amazon S3 (SSE-S3) et une clé AWS Key Management Service (AWS KMS) (SSE-KMS).

  6. (Facultatif) Pour spécifier une AWS KMS clé, vous devez choisir une clé KMS ou saisir une clé Amazon Resource Name (ARN).

    Si vous choisissez une clé gérée par le client, vous devez accorder à S3 Storage Lens l’autorisation de chiffrer dans la politique de clé AWS KMS . Pour de plus amples informations, veuillez consulter Utiliser un AWS KMS key pour chiffrer vos exportations de métriques.

  7. Choisissez Create dashboard (Créer un tableau de bord).

Procédure pour créer un tableau de bord Amazon S3 Storage Lens sur la console Amazon S3.

Étape 1 : définir la portée du tableau de bord
  1. Connectez-vous à la console Amazon S3 AWS Management Console et ouvrez-la à l'adresse https://console.aws.amazon.com/s3/.

  2. 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.

  3. Dans le volet de navigation de gauche, sous S3 Storage Lens, choisissez Tableaux de bord.

  4. Choisissez Create dashboard (Créer un tableau de bord).

  5. Sur la page Tableau de bord, dans la section General (Général), procédez comme suit :

    1. Sélectionnez la région d’origine de votre tableau de bord. La région d'origine est l' Région AWS endroit où sont stockées la configuration et les mesures de ce tableau de bord Storage Lens.

    2. Saisissez un nom de tableau de bord.

      Les noms de tableau de bord doivent contenir moins de 65 caractères et ne doivent pas contenir de caractères spéciaux ou d’espaces.

      Note

      Vous ne pouvez pas modifier ce nom de tableau de bord une fois le tableau de bord créé.

    3. Vous pouvez éventuellement choisir d’ajouter des balises à votre tableau de bord. Vous pouvez utiliser des balises pour gérer les autorisations de votre tableau de bord et suivre les coûts relatifs à S3 Storage Lens.

      Pour plus d’informations, consultez Contrôle de l’accès à l’aide d’étiquettes de ressources dans le Guide de l’utilisateur IAM et Étiquettes de répartition des coûts générées par AWS dans le Guide de l’utilisateur AWS Billing .

      Note

      Vous pouvez ajouter jusqu’à 50 balises à votre configuration de tableau de bord.

  6. Dans la section Dashboard scope (Portée du tableau de bord), procédez comme suit :

    1. Sélectionnez les Régions et les compartiments que vous souhaitez que S3 Storage Lens inclue ou exclue du tableau de bord.

    2. Sélectionnez les compartiments dans les Régions sélectionnées que vous souhaitez que S3 Storage Lens inclue ou exclue. Vous pouvez inclure ou exclure des compartiments, mais pas les deux. Cette option n’est pas disponible lorsque vous créez des tableaux de bord au niveau de l’organisation.

    Note
    • Vous pouvez inclure ou exclure des Régions et des compartiments. Cette option est limitée aux Régions uniquement lors de la création de tableaux de bord au niveau de l’organisation sur les comptes membres de votre organisation.

    • Vous pouvez choisir jusqu’à 50 compartiments à inclure ou exclure.

Étape 2 : configurer la sélection des métriques
  1. Dans la section Metrics selection (Sélection de métriques), sélectionnez le type de métriques que vous souhaitez agréger pour ce tableau de bord.

    • Pour inclure des métriques gratuites agrégées au niveau du compartiment et disponibles pour les requêtes pendant 14 jours, choisissez Free Metrics (Métriques gratuites).

    • Pour activer les métriques avancées et d’autres options avancées, choisissez Advanced metrics and recommendations (Métriques et recommandations avancées). Ces options incluent l'agrégation avancée des préfixes, la CloudWatch publication sur Amazon et les recommandations contextuelles. Les données sont disponibles pour les requêtes pendant 15 mois. Les métriques et recommandations avancées entraînent un coût supplémentaire. Pour plus d’informations, consultez Tarification Amazon S3.

      Pour plus d’informations sur les métriques gratuites et avancées, consultez Sélection des métriques.

  2. Sous Advanced metrics and recommendations features (Fonctionnalités de métriques et recommandations avancées), sélectionnez les options que vous voulez activer :

    • Advanced metrics (Métriques avancées)

    • CloudWatch publiant

    • Prefix aggregation (Agrégation de préfixes)

    Important

    Si vous activez l'agrégation de préfixes pour votre configuration S3 Storage Lens, les métriques au niveau du préfixe ne seront pas publiées sur. CloudWatch Seules les métriques S3 Storage Lens au niveau du bucket, du compte et de l'organisation sont publiées sur. CloudWatch

  3. Si vous avez activé Advanced metrics (Métriques avancées), sélectionnez les Advanced metrics categories (Catégories de métriques avancées) que vous souhaitez afficher dans votre tableau de bord S3 Storage Lens :

    • Métriques d’activité

    • Detailed status code metrics (Métriques détaillées sur le code de statut)

    • Advanced cost optimization metrics (Métriques avancées sur l’optimisation des coûts)

    • Advanced data protection metrics (Métriques avancées sur la protection des données)

    Pour plus d’informations sur les catégories de métriques, consultez Catégories de métriques. Pour obtenir une liste complète des métriques, consultez Glossaire des métriques Amazon S3 Storage Lens.

  4. Si vous avez choisi d’activer l’agrégation des préfixes, configurez les éléments suivants :

    1. Choisissez la taille minimale du seuil de préfixe pour ce tableau de bord.

      Par exemple, un seuil de préfixe de 5 % indique que les préfixes représentant 5 % ou plus de la taille totale de stockage du compartiment seront agrégés.

    2. Sélectionnez la profondeur de préfixe.

      Ce paramètre indique le nombre maximal de niveaux jusqu’auquel les préfixes sont évalués. La profondeur de préfixe doit être inférieure à 10.

    3. Saisissez un caractère de délimiteur de préfixe.

      Cette valeur est utilisée pour identifier chaque niveau de préfixe. La valeur par défaut dans Amazon S3 est le caractère /, mais votre structure de stockage peut utiliser d’autres délimiteurs.

(Facultatif) Étape 3 : exporter des métriques pour le tableau de bord
  1. Dans la section Metrics export (Exportation de métriques), choisissez Enable (Activer) pour créer une exportation de métriques qui sera placée quotidiennement dans un compartiment de destination de votre choix.

    L'exportation des métriques est au format CSV ou Apache Parquet . La portée des données est la même que celle des données de votre tableau de bord S3 Storage Lens sans les recommandations.

  2. Si vous avez activé l'exportation des mesures, choisissez le format de sortie de votre exportation quotidienne des mesures : CSV ou Apache Parquet.

    Parquet est un format de fichier open source pour Hadoop qui stocke les données imbriquées dans un format à colonnes plates.

  3. Sélectionnez le compartiment S3 de destination pour l’exportation de vos métriques.

    Vous pouvez choisir un compartiment dans le compte actuel du tableau de bord S3 Storage Lens. Vous pouvez également en choisir un autre Compte AWS si vous disposez des autorisations du compartiment de destination et de l'ID de compte du propriétaire du compartiment de destination.

  4. Choisissez le compartiment S3 de destination (format : s3://bucket-name/prefix).

    Le compartiment doit être dans la région d’origine de votre tableau de bord S3 Storage Lens. La console S3 vous montre le paramètre Destination bucket permission (Autorisation de compartiment de destination) qui sera ajouté par Amazon S3 à la politique de compartiment de destination. Amazon S3 met à jour la politique de compartiment sur le compartiment de destination pour permettre à S3 de placer des données dans ce compartiment.

  5. (Facultatif) Pour activer le chiffrement côté serveur pour l’exportation de vos métriques, choisissez Specify an encryption key (Spécifier une clé de chiffrement). Ensuite, choisissez le Type de chiffrement : Clés gérées par Amazon S3 (SSE-S3) ou Clé AWS Key Management Service  (SSE-KMS).

    Vous pouvez choisir entre une clé gérée par Amazon S3 (SSE-S3) et une clé AWS Key Management Service (AWS KMS) (SSE-KMS).

  6. (Facultatif) Pour spécifier une AWS KMS clé, vous devez choisir une clé KMS ou saisir une clé Amazon Resource Name (ARN).

    Si vous choisissez une clé gérée par le client, vous devez accorder à S3 Storage Lens l’autorisation de chiffrer dans la politique de clé AWS KMS . Pour de plus amples informations, veuillez consulter Utiliser un AWS KMS key pour chiffrer vos exportations de métriques.

  7. Choisissez Create dashboard (Créer un tableau de bord).

L’exemple de commande suivant crée une configuration Amazon S3 Storage Lens avec des balises. Pour utiliser ces exemples, remplacez user input placeholders par vos propres informations.

aws s3control put-storage-lens-configuration --account-id=111122223333 --config-id=example-dashboard-configuration-id --region=us-east-1 --storage-lens-configuration=file://./config.json --tags=file://./tags.json

L’exemple de commande suivant crée une configuration Amazon S3 Storage Lens sans balises. Pour utiliser ces exemples, remplacez user input placeholders par vos propres informations.

aws s3control put-storage-lens-configuration --account-id=222222222222 --config-id=your-configuration-id --region=us-east-1 --storage-lens-configuration=file://./config.json

L’exemple de commande suivant crée une configuration Amazon S3 Storage Lens avec des balises. Pour utiliser ces exemples, remplacez user input placeholders par vos propres informations.

aws s3control put-storage-lens-configuration --account-id=111122223333 --config-id=example-dashboard-configuration-id --region=us-east-1 --storage-lens-configuration=file://./config.json --tags=file://./tags.json

L’exemple de commande suivant crée une configuration Amazon S3 Storage Lens sans balises. Pour utiliser ces exemples, remplacez user input placeholders par vos propres informations.

aws s3control put-storage-lens-configuration --account-id=222222222222 --config-id=your-configuration-id --region=us-east-1 --storage-lens-configuration=file://./config.json
Exemple – Créer et mettre à jour une configuration Amazon S3 Storage Lens

L’exemple suivant crée et met à jour une configuration Amazon S3 Storage Lens dans le kit SDK pour Java :

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.ActivityMetrics; import com.amazonaws.services.s3control.model.BucketLevel; import com.amazonaws.services.s3control.model.CloudWatchMetrics; import com.amazonaws.services.s3control.model.Format; import com.amazonaws.services.s3control.model.Include; import com.amazonaws.services.s3control.model.OutputSchemaVersion; import com.amazonaws.services.s3control.model.PrefixLevel; import com.amazonaws.services.s3control.model.PrefixLevelStorageMetrics; import com.amazonaws.services.s3control.model.PutStorageLensConfigurationRequest; import com.amazonaws.services.s3control.model.S3BucketDestination; import com.amazonaws.services.s3control.model.SSES3; import com.amazonaws.services.s3control.model.SelectionCriteria; import com.amazonaws.services.s3control.model.StorageLensAwsOrg; import com.amazonaws.services.s3control.model.StorageLensConfiguration; import com.amazonaws.services.s3control.model.StorageLensDataExport; import com.amazonaws.services.s3control.model.StorageLensDataExportEncryption; import com.amazonaws.services.s3control.model.StorageLensTag; import java.util.Arrays; import java.util.List; import static com.amazonaws.regions.Regions.US_WEST_2; public class CreateAndUpdateDashboard { public static void main(String[] args) { String configurationId = "ConfigurationId"; String sourceAccountId = "111122223333"; String exportAccountId = "Destination Account ID"; String exportBucketArn = "arn:aws:s3:::destBucketName"; // The destination bucket for your metrics export must be in the same Region as your S3 Storage Lens configuration. String awsOrgARN = "arn:aws:organizations::123456789012:organization/o-abcdefgh"; Format exportFormat = Format.CSV; try { SelectionCriteria selectionCriteria = new SelectionCriteria() .withDelimiter("/") .withMaxDepth(5) .withMinStorageBytesPercentage(10.0); PrefixLevelStorageMetrics prefixStorageMetrics = new PrefixLevelStorageMetrics() .withIsEnabled(true) .withSelectionCriteria(selectionCriteria); BucketLevel bucketLevel = new BucketLevel() .withActivityMetrics(new ActivityMetrics().withIsEnabled(true)) .withAdvancedCostOptimizationMetrics(new AdvancedCostOptimizationMetrics().withIsEnabled(true)) .withAdvancedDataProtectionMetrics(new AdvancedDataProtectionMetrics().withIsEnabled(true)) .withDetailedStatusCodesMetrics(new DetailedStatusCodesMetrics().withIsEnabled(true)) .withPrefixLevel(new PrefixLevel().withStorageMetrics(prefixStorageMetrics)); AccountLevel accountLevel = new AccountLevel() .withActivityMetrics(new ActivityMetrics().withIsEnabled(true)) .withAdvancedCostOptimizationMetrics(new AdvancedCostOptimizationMetrics().withIsEnabled(true)) .withAdvancedDataProtectionMetrics(new AdvancedDataProtectionMetrics().withIsEnabled(true)) .withDetailedStatusCodesMetrics(new DetailedStatusCodesMetrics().withIsEnabled(true)) .withBucketLevel(bucketLevel); Include include = new Include() .withBuckets(Arrays.asList("arn:aws:s3:::bucketName")) .withRegions(Arrays.asList("us-west-2")); StorageLensDataExportEncryption exportEncryption = new StorageLensDataExportEncryption() .withSSES3(new SSES3()); S3BucketDestination s3BucketDestination = new S3BucketDestination() .withAccountId(exportAccountId) .withArn(exportBucketArn) .withEncryption(exportEncryption) .withFormat(exportFormat) .withOutputSchemaVersion(OutputSchemaVersion.V_1) .withPrefix("Prefix"); CloudWatchMetrics cloudWatchMetrics = new CloudWatchMetrics() .withIsEnabled(true); StorageLensDataExport dataExport = new StorageLensDataExport() .withCloudWatchMetrics(cloudWatchMetrics) .withS3BucketDestination(s3BucketDestination); StorageLensAwsOrg awsOrg = new StorageLensAwsOrg() .withArn(awsOrgARN); StorageLensConfiguration configuration = new StorageLensConfiguration() .withId(configurationId) .withAccountLevel(accountLevel) .withInclude(include) .withDataExport(dataExport) .withAwsOrg(awsOrg) .withIsEnabled(true); List<StorageLensTag> tags = Arrays.asList( new StorageLensTag().withKey("key-1").withValue("value-1"), new StorageLensTag().withKey("key-2").withValue("value-2") ); AWSS3Control s3ControlClient = AWSS3ControlClient.builder() .withCredentials(new ProfileCredentialsProvider()) .withRegion(US_WEST_2) .build(); s3ControlClient.putStorageLensConfiguration(new PutStorageLensConfigurationRequest() .withAccountId(sourceAccountId) .withConfigId(configurationId) .withStorageLensConfiguration(configuration) .withTags(tags) ); } catch (AmazonServiceException e) { // The call was transmitted successfully, but Amazon S3 couldn't process // it and returned an error response. e.printStackTrace(); } catch (SdkClientException e) { // Amazon S3 couldn't be contacted for a response, or the client // couldn't parse the response from Amazon S3. e.printStackTrace(); } } }

Exemple – Créer et mettre à jour une configuration Amazon S3 Storage Lens

L’exemple suivant crée et met à jour une configuration Amazon S3 Storage Lens dans le kit SDK pour Java :

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.ActivityMetrics; import com.amazonaws.services.s3control.model.BucketLevel; import com.amazonaws.services.s3control.model.CloudWatchMetrics; import com.amazonaws.services.s3control.model.Format; import com.amazonaws.services.s3control.model.Include; import com.amazonaws.services.s3control.model.OutputSchemaVersion; import com.amazonaws.services.s3control.model.PrefixLevel; import com.amazonaws.services.s3control.model.PrefixLevelStorageMetrics; import com.amazonaws.services.s3control.model.PutStorageLensConfigurationRequest; import com.amazonaws.services.s3control.model.S3BucketDestination; import com.amazonaws.services.s3control.model.SSES3; import com.amazonaws.services.s3control.model.SelectionCriteria; import com.amazonaws.services.s3control.model.StorageLensAwsOrg; import com.amazonaws.services.s3control.model.StorageLensConfiguration; import com.amazonaws.services.s3control.model.StorageLensDataExport; import com.amazonaws.services.s3control.model.StorageLensDataExportEncryption; import com.amazonaws.services.s3control.model.StorageLensTag; import java.util.Arrays; import java.util.List; import static com.amazonaws.regions.Regions.US_WEST_2; public class CreateAndUpdateDashboard { public static void main(String[] args) { String configurationId = "ConfigurationId"; String sourceAccountId = "111122223333"; String exportAccountId = "Destination Account ID"; String exportBucketArn = "arn:aws:s3:::destBucketName"; // The destination bucket for your metrics export must be in the same Region as your S3 Storage Lens configuration. String awsOrgARN = "arn:aws:organizations::123456789012:organization/o-abcdefgh"; Format exportFormat = Format.CSV; try { SelectionCriteria selectionCriteria = new SelectionCriteria() .withDelimiter("/") .withMaxDepth(5) .withMinStorageBytesPercentage(10.0); PrefixLevelStorageMetrics prefixStorageMetrics = new PrefixLevelStorageMetrics() .withIsEnabled(true) .withSelectionCriteria(selectionCriteria); BucketLevel bucketLevel = new BucketLevel() .withActivityMetrics(new ActivityMetrics().withIsEnabled(true)) .withAdvancedCostOptimizationMetrics(new AdvancedCostOptimizationMetrics().withIsEnabled(true)) .withAdvancedDataProtectionMetrics(new AdvancedDataProtectionMetrics().withIsEnabled(true)) .withDetailedStatusCodesMetrics(new DetailedStatusCodesMetrics().withIsEnabled(true)) .withPrefixLevel(new PrefixLevel().withStorageMetrics(prefixStorageMetrics)); AccountLevel accountLevel = new AccountLevel() .withActivityMetrics(new ActivityMetrics().withIsEnabled(true)) .withAdvancedCostOptimizationMetrics(new AdvancedCostOptimizationMetrics().withIsEnabled(true)) .withAdvancedDataProtectionMetrics(new AdvancedDataProtectionMetrics().withIsEnabled(true)) .withDetailedStatusCodesMetrics(new DetailedStatusCodesMetrics().withIsEnabled(true)) .withBucketLevel(bucketLevel); Include include = new Include() .withBuckets(Arrays.asList("arn:aws:s3:::bucketName")) .withRegions(Arrays.asList("us-west-2")); StorageLensDataExportEncryption exportEncryption = new StorageLensDataExportEncryption() .withSSES3(new SSES3()); S3BucketDestination s3BucketDestination = new S3BucketDestination() .withAccountId(exportAccountId) .withArn(exportBucketArn) .withEncryption(exportEncryption) .withFormat(exportFormat) .withOutputSchemaVersion(OutputSchemaVersion.V_1) .withPrefix("Prefix"); CloudWatchMetrics cloudWatchMetrics = new CloudWatchMetrics() .withIsEnabled(true); StorageLensDataExport dataExport = new StorageLensDataExport() .withCloudWatchMetrics(cloudWatchMetrics) .withS3BucketDestination(s3BucketDestination); StorageLensAwsOrg awsOrg = new StorageLensAwsOrg() .withArn(awsOrgARN); StorageLensConfiguration configuration = new StorageLensConfiguration() .withId(configurationId) .withAccountLevel(accountLevel) .withInclude(include) .withDataExport(dataExport) .withAwsOrg(awsOrg) .withIsEnabled(true); List<StorageLensTag> tags = Arrays.asList( new StorageLensTag().withKey("key-1").withValue("value-1"), new StorageLensTag().withKey("key-2").withValue("value-2") ); AWSS3Control s3ControlClient = AWSS3ControlClient.builder() .withCredentials(new ProfileCredentialsProvider()) .withRegion(US_WEST_2) .build(); s3ControlClient.putStorageLensConfiguration(new PutStorageLensConfigurationRequest() .withAccountId(sourceAccountId) .withConfigId(configurationId) .withStorageLensConfiguration(configuration) .withTags(tags) ); } 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 améliorer la visibilité de votre stockage, vous pouvez créer un ou plusieurs groupes S3 Storage Lens et les attacher à votre tableau de bord. Un groupe S3 Storage Lens est un filtre défini personnalisé pour les objets basé sur les préfixes, les suffixes, les balises d’objet, la taille d’objet, l’âge d’objet ou une combinaison de ces filtres.

Vous pouvez utiliser les groupes S3 Storage Lens pour obtenir une visibilité précise sur les compartiments partagés de grande taille, tels que les lacs de données, afin de prendre des décisions commerciales plus éclairées. Par exemple, vous pouvez rationaliser l’allocation du stockage et optimiser les rapports sur les coûts en répartissant l’utilisation du stockage en groupes d’objets spécifiques pour des projets individuels et des centres de coûts au sein d’un compartiment ou de plusieurs compartiments.

Pour utiliser les groupes S3 Storage Lens, vous devez mettre à niveau votre tableau de bord afin d’utiliser des métriques et des recommandations avancées. Pour plus d’informations sur les groupes S3 Storage Lens, consultez Utilisation des groupes S3 Storage Lens pour filtrer et agréger des métriques.

ConfidentialitéConditions d'utilisation du sitePréférences de cookies
© 2025, Amazon Web Services, Inc. ou ses affiliés. Tous droits réservés.