put_storage_lens_configuration

put_storage_lens_configuration(**kwargs)

Puts an Amazon S3 Storage Lens configuration. For more information about S3 Storage Lens, see Working with Amazon S3 Storage Lens in the Amazon S3 User Guide . For a complete list of S3 Storage Lens metrics, see S3 Storage Lens metrics glossary in the Amazon S3 User Guide .

Note

To use this action, you must have permission to perform the s3:PutStorageLensConfiguration action. For more information, see Setting permissions to use Amazon S3 Storage Lens in the Amazon S3 User Guide .

See also: AWS API Documentation

Request Syntax

response = client.put_storage_lens_configuration(
    ConfigId='string',
    AccountId='string',
    StorageLensConfiguration={
        'Id': 'string',
        'AccountLevel': {
            'ActivityMetrics': {
                'IsEnabled': True|False
            },
            'BucketLevel': {
                'ActivityMetrics': {
                    'IsEnabled': True|False
                },
                'PrefixLevel': {
                    'StorageMetrics': {
                        'IsEnabled': True|False,
                        'SelectionCriteria': {
                            'Delimiter': 'string',
                            'MaxDepth': 123,
                            'MinStorageBytesPercentage': 123.0
                        }
                    }
                },
                'AdvancedCostOptimizationMetrics': {
                    'IsEnabled': True|False
                },
                'AdvancedDataProtectionMetrics': {
                    'IsEnabled': True|False
                },
                'DetailedStatusCodesMetrics': {
                    'IsEnabled': True|False
                }
            },
            'AdvancedCostOptimizationMetrics': {
                'IsEnabled': True|False
            },
            'AdvancedDataProtectionMetrics': {
                'IsEnabled': True|False
            },
            'DetailedStatusCodesMetrics': {
                'IsEnabled': True|False
            }
        },
        'Include': {
            'Buckets': [
                'string',
            ],
            'Regions': [
                'string',
            ]
        },
        'Exclude': {
            'Buckets': [
                'string',
            ],
            'Regions': [
                'string',
            ]
        },
        'DataExport': {
            'S3BucketDestination': {
                'Format': 'CSV'|'Parquet',
                'OutputSchemaVersion': 'V_1',
                'AccountId': 'string',
                'Arn': 'string',
                'Prefix': 'string',
                'Encryption': {
                    'SSES3': {}
                    ,
                    'SSEKMS': {
                        'KeyId': 'string'
                    }
                }
            },
            'CloudWatchMetrics': {
                'IsEnabled': True|False
            }
        },
        'IsEnabled': True|False,
        'AwsOrg': {
            'Arn': 'string'
        },
        'StorageLensArn': 'string'
    },
    Tags=[
        {
            'Key': 'string',
            'Value': 'string'
        },
    ]
)
Parameters
  • ConfigId (string) --

    [REQUIRED]

    The ID of the S3 Storage Lens configuration.

  • AccountId (string) --

    [REQUIRED]

    The account ID of the requester.

  • StorageLensConfiguration (dict) --

    [REQUIRED]

    The S3 Storage Lens configuration.

    • Id (string) -- [REQUIRED]

      A container for the Amazon S3 Storage Lens configuration ID.

    • AccountLevel (dict) -- [REQUIRED]

      A container for all the account-level configurations of your S3 Storage Lens configuration.

      • ActivityMetrics (dict) --

        A container for S3 Storage Lens activity metrics.

        • IsEnabled (boolean) --

          A container that indicates whether activity metrics are enabled.

      • BucketLevel (dict) -- [REQUIRED]

        A container for the S3 Storage Lens bucket-level configuration.

        • ActivityMetrics (dict) --

          A container for the bucket-level activity metrics for S3 Storage Lens.

          • IsEnabled (boolean) --

            A container that indicates whether activity metrics are enabled.

        • PrefixLevel (dict) --

          A container for the prefix-level metrics for S3 Storage Lens.

          • StorageMetrics (dict) -- [REQUIRED]

            A container for the prefix-level storage metrics for S3 Storage Lens.

            • IsEnabled (boolean) --

              A container for whether prefix-level storage metrics are enabled.

            • SelectionCriteria (dict) --
              • Delimiter (string) --

                A container for the delimiter of the selection criteria being used.

              • MaxDepth (integer) --

                The max depth of the selection criteria

              • MinStorageBytesPercentage (float) --

                The minimum number of storage bytes percentage whose metrics will be selected.

                Note

                You must choose a value greater than or equal to 1.0 .

        • AdvancedCostOptimizationMetrics (dict) --

          A container for bucket-level advanced cost-optimization metrics for S3 Storage Lens.

          • IsEnabled (boolean) --

            A container that indicates whether advanced cost-optimization metrics are enabled.

        • AdvancedDataProtectionMetrics (dict) --

          A container for bucket-level advanced data-protection metrics for S3 Storage Lens.

          • IsEnabled (boolean) --

            A container that indicates whether advanced data-protection metrics are enabled.

        • DetailedStatusCodesMetrics (dict) --

          A container for bucket-level detailed status code metrics for S3 Storage Lens.

          • IsEnabled (boolean) --

            A container that indicates whether detailed status code metrics are enabled.

      • AdvancedCostOptimizationMetrics (dict) --

        A container for S3 Storage Lens advanced cost-optimization metrics.

        • IsEnabled (boolean) --

          A container that indicates whether advanced cost-optimization metrics are enabled.

      • AdvancedDataProtectionMetrics (dict) --

        A container for S3 Storage Lens advanced data-protection metrics.

        • IsEnabled (boolean) --

          A container that indicates whether advanced data-protection metrics are enabled.

      • DetailedStatusCodesMetrics (dict) --

        A container for detailed status code metrics.

        • IsEnabled (boolean) --

          A container that indicates whether detailed status code metrics are enabled.

    • Include (dict) --

      A container for what is included in this configuration. This container can only be valid if there is no Exclude container submitted, and it's not empty.

      • Buckets (list) --

        A container for the S3 Storage Lens bucket includes.

        • (string) --
      • Regions (list) --

        A container for the S3 Storage Lens Region includes.

        • (string) --
    • Exclude (dict) --

      A container for what is excluded in this configuration. This container can only be valid if there is no Include container submitted, and it's not empty.

      • Buckets (list) --

        A container for the S3 Storage Lens bucket excludes.

        • (string) --
      • Regions (list) --

        A container for the S3 Storage Lens Region excludes.

        • (string) --
    • DataExport (dict) --

      A container to specify the properties of your S3 Storage Lens metrics export including, the destination, schema and format.

      • S3BucketDestination (dict) --

        A container for the bucket where the S3 Storage Lens metrics export will be located.

        Note

        This bucket must be located in the same Region as the storage lens configuration.

        • Format (string) -- [REQUIRED]
        • OutputSchemaVersion (string) -- [REQUIRED]

          The schema version of the export file.

        • AccountId (string) -- [REQUIRED]

          The account ID of the owner of the S3 Storage Lens metrics export bucket.

        • Arn (string) -- [REQUIRED]

          The Amazon Resource Name (ARN) of the bucket. This property is read-only and follows the following format: arn:aws:s3:us-east-1:example-account-id:bucket/your-destination-bucket-name

        • Prefix (string) --

          The prefix of the destination bucket where the metrics export will be delivered.

        • Encryption (dict) --

          The container for the type encryption of the metrics exports in this bucket.

          • SSES3 (dict) --
          • SSEKMS (dict) --
            • KeyId (string) -- [REQUIRED]

              A container for the ARN of the SSE-KMS encryption. This property is read-only and follows the following format: arn:aws:kms:us-east-1:example-account-id:key/example-9a73-4afc-8d29-8f5900cef44e

      • CloudWatchMetrics (dict) --

        A container for enabling Amazon CloudWatch publishing for S3 Storage Lens metrics.

        • IsEnabled (boolean) -- [REQUIRED]

          A container that indicates whether CloudWatch publishing for S3 Storage Lens metrics is enabled. A value of true indicates that CloudWatch publishing for S3 Storage Lens metrics is enabled.

    • IsEnabled (boolean) -- [REQUIRED]

      A container for whether the S3 Storage Lens configuration is enabled.

    • AwsOrg (dict) --

      A container for the Amazon Web Services organization for this S3 Storage Lens configuration.

      • Arn (string) -- [REQUIRED]

        A container for the Amazon Resource Name (ARN) of the Amazon Web Services organization. This property is read-only and follows the following format: arn:aws:organizations:us-east-1:example-account-id:organization/o-ex2l495dck

    • StorageLensArn (string) --

      The Amazon Resource Name (ARN) of the S3 Storage Lens configuration. This property is read-only and follows the following format: arn:aws:s3:us-east-1:example-account-id:storage-lens/your-dashboard-name

  • Tags (list) --

    The tag set of the S3 Storage Lens configuration.

    Note

    You can set up to a maximum of 50 tags.

    • (dict) --
      • Key (string) -- [REQUIRED]
      • Value (string) -- [REQUIRED]
Returns

None