Fichiers d'aide pour l'utilisation d'Amazon S3 Storage Lens - Amazon Simple Storage Service
Exemple de configuration S3 Storage Lens dans JSONExemple de configuration S3 Storage Lens avec des groupes Storage Lens dans JSONExemple de configuration de balises S3 Storage Lens dans JSONExemple de configuration d'autorisations IAM pour S3 Storage Lens

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.

Fichiers d'aide pour l'utilisation d'Amazon S3 Storage Lens

Utilisez les fichiers JSON suivants et ses entrées de clé pour vos exemples.

Exemple de configuration S3 Storage Lens dans JSON

Exemple config.json

Le fichier config.json contient les détails d'une configuration de métriques et recommandations avancées S3 Storage Lens au niveau de l'organisation. Pour utiliser l'exemple suivant, remplacez user input placeholders par vos propres informations.

Note

Des frais supplémentaires s'appliquent pour les métriques et recommandations avancées. Pour plus d'informations, consultez Métriques et recommandations avancées.

{
  "Id": "SampleS3StorageLensConfiguration", //Use this property to identify your S3 Storage Lens configuration.
  "AwsOrg": { //Use this property when enabling S3 Storage Lens for AWS Organizations.
    "Arn": "arn:aws:organizations::123456789012:organization/o-abcdefgh"
  },
  "AccountLevel": {
    "ActivityMetrics": {
      "IsEnabled":true
    },
    "AdvancedCostOptimizationMetrics": {
      "IsEnabled":true
    },
    "AdvancedDataProtectionMetrics": {
      "IsEnabled":true
    },
    "DetailedStatusCodesMetrics": {
      "IsEnabled":true
    },
    "BucketLevel": {
      "ActivityMetrics": {
        "IsEnabled":true
      },
      "AdvancedDataProtectionMetrics": {
      "IsEnabled":true
      },
      "AdvancedCostOptimizationMetrics": {
        "IsEnabled":true
      },
      "DetailedStatusCodesMetrics": {
        "IsEnabled":true
      },
      "PrefixLevel":{
        "StorageMetrics":{
          "IsEnabled":true,
          "SelectionCriteria":{
            "MaxDepth":5,
            "MinStorageBytesPercentage":1.25,
            "Delimiter":"/"
          }
        }
      }
    }
  },
  "Exclude": { //Replace with "Include" if you prefer to include Regions.
    "Regions": [
      "eu-west-1"
    ],
    "Buckets": [ //This attribute is not supported for AWS Organizations-level configurations.
      "arn:aws:s3:::source_bucket1"
    ]
  },
  "IsEnabled": true, //Whether the configuration is enabled
  "DataExport": { //Details about the metrics export
    "S3BucketDestination": {
      "OutputSchemaVersion": "V_1",
      "Format": "CSV", //You can add "Parquet" if you prefer.
      "AccountId": "111122223333",
      "Arn": "arn:aws:s3:::destination-bucket-name", // The destination bucket for your metrics export must be in the same Region as your S3 Storage Lens configuration. 
      "Prefix": "prefix-for-your-export-destination",
      "Encryption": {
        "SSES3": {}
      }
    },
    "CloudWatchMetrics": {
      "IsEnabled": true
    }
  }
}

Exemple de configuration S3 Storage Lens avec des groupes Storage Lens dans JSON

Exemple config.json

Le fichier config.json contient les détails que vous souhaitez appliquer à votre configuration Storage Lens lorsque vous utilisez des groupes Storage Lens. Pour utiliser l'exemple, remplacez user input placeholders par vos propres informations.

Pour attacher tous les groupes Storage Lens à votre tableau de bord, mettez à jour votre configuration Storage Lens avec la syntaxe suivante :

{
  "Id": "ExampleS3StorageLensConfiguration",
  "AccountLevel": {
    "ActivityMetrics": {
      "IsEnabled":true
    },
    "AdvancedCostOptimizationMetrics": {
      "IsEnabled":true
    },
    "AdvancedDataProtectionMetrics": {
      "IsEnabled":true
    },
    "BucketLevel": {
      "ActivityMetrics": {
      "IsEnabled":true
      },
    "StorageLensGroupLevel": {},
  "IsEnabled": true
}

Pour inclure uniquement deux groupes Storage Lens dans la configuration de votre tableau de bord Storage Lens (slg-1 et slg-2), utilisez la syntaxe suivante :

{
  "Id": "ExampleS3StorageLensConfiguration",
  "AccountLevel": {
    "ActivityMetrics": {
      "IsEnabled":true
    },
    "AdvancedCostOptimizationMetrics": {
      "IsEnabled":true
    },
    "AdvancedDataProtectionMetrics": {
      "IsEnabled":true
    },
    "BucketLevel": {
      "ActivityMetrics": {
      "IsEnabled":true
      },
   "StorageLensGroupLevel": {
        "SelectionCriteria": {
            "Include": [
                "arn:aws:s3:us-east-1:111122223333:storage-lens-group/slg-1",
                "arn:aws:s3:us-east-1:444455556666:storage-lens-group/slg-2"
            ]
    },
  "IsEnabled": true
}

Pour exclure uniquement certains groupes Storage Lens de la configuration de votre tableau de bord, utilisez la syntaxe suivante :

{
  "Id": "ExampleS3StorageLensConfiguration",
  "AccountLevel": {
    "ActivityMetrics": {
      "IsEnabled":true
    },
    "AdvancedCostOptimizationMetrics": {
      "IsEnabled":true
    },
    "AdvancedDataProtectionMetrics": {
      "IsEnabled":true
    },
    "BucketLevel": {
      "ActivityMetrics": {
      "IsEnabled":true
      },
   "StorageLensGroupLevel": {
        "SelectionCriteria": {
            "Exclude": [
                "arn:aws:s3:us-east-1:111122223333:storage-lens-group/slg-1",
                "arn:aws:s3:us-east-1:444455556666:storage-lens-group/slg-2"
            ]
    },
  "IsEnabled": true
}

Exemple de configuration de balises S3 Storage Lens dans JSON

Exemple tags.json

Le fichier tags.json contient les étiquettes que vous souhaitez appliquer à votre configuration S3 Storage Lens. Pour utiliser cet exemple, remplacez user input placeholders par vos propres informations.

[
    {
        "Key": "key1",
        "Value": "value1"
    },
    {
        "Key": "key2",
        "Value": "value2"
    }
]

Exemple de configuration d'autorisations IAM pour S3 Storage Lens

Exemple permissions.json : nom de tableau de bord spécifique

Cet exemple de politique montre un fichier permissions.json IAM de S3 Storage Lens avec un nom de tableau de bord spécifique spécifié. Remplacez value1, us-east-1, your-dashboard-name et example-account-id par vos propres valeurs.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "s3:GetStorageLensConfiguration",
                "s3:DeleteStorageLensConfiguration",
                "s3:PutStorageLensConfiguration"
            ],
            "Condition": {
                "StringEquals": {
                    "aws:ResourceTag/key1": "value1"
                }
            },
            "Resource": "arn:aws:s3:us-east-1:example-account-id:storage-lens/your-dashboard-name"
        }
    ]
}
Exemple permissions.json : aucun nom de tableau de bord spécifique

Cet exemple de politique montre un fichier permissions.json IAM de S3 Storage Lens sans nom de tableau de bord spécifique spécifié. Remplacez value1, us-east-1 et example-account-id par vos propres valeurs.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "s3:GetStorageLensConfiguration",
                "s3:DeleteStorageLensConfiguration",
                "s3:PutStorageLensConfiguration"
            ],
            "Condition": {
                "StringEquals": {
                    "aws:ResourceTag/key1": "value1"
                }
            },
            "Resource": "arn:aws:s3:us-east-1:example-account-id:storage-lens/*"
        }
    ]
}