# Archivos auxiliares para utilizar Amazon S3 Storage Lens
<a name="S3LensHelperFilesCLI"></a>

Utilice los siguientes archivos JSON y las entradas de claves de sus ejemplos.

## Ejemplo de configuración de S3 Storage Lens en JSON
<a name="S3LensHelperFilesSampleConfigurationCLI"></a>

**Example `config.json`**  
El archivo `config.json` contiene detalles de una configuración de *métricas y recomendaciones avanzadas* de organización de Lente de almacenamiento de S3. Para utilizar el ejemplo siguiente, sustituya `{{user input placeholders}}` con su propia información.  
Se aplican cargos adicionales a las métricas y recomendaciones avanzadas. Para obtener más información, consulte [Métricas y recomendaciones avanzadas](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage_lens_basics_metrics_recommendations.html#storage_lens_basics_metrics_selection).

```
{
  "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:::{{{{amzn-s3-demo-source-bucket}}}}"
    ]
  },
  "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:::{{
{{amzn-s3-demo-destination-bucket}}}}", // 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}}
    }
  }
}
```

## Ejemplo de configuración de S3 Lente de almacenamiento con grupos de Lente de almacenamiento en JSON
<a name="StorageLensGroupsHelperFilesCLI"></a>

**Example `config.json`**  

El archivo `config.json` contiene los detalles que desea aplicar a la configuración de Storage Lens al usar grupos de Storage Lens. Para utilizar el ejemplo, sustituya `{{user input placeholders}}` por su propia información.

Para asociar todos los grupos de Lente de almacenamiento a su panel de control, actualice la configuración de Lente de almacenamiento con la siguiente sintaxis:

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

Para incluir solo dos grupos de Lente de almacenamiento en la configuración del panel de Lente de almacenamiento ({{slg-1}} y {{slg-2}}), utilice la siguiente sintaxis:

```
{
  "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}}
}
```

Para impedir que solo determinados grupos de Lente de almacenamiento se adjunten a la configuración de su panel, utilice la siguiente sintaxis:

```
{
  "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}}
}
```

## Etiquetas de configuración de ejemplo de S3 Storage Lens
<a name="S3LensHelperFilesSampleConfigurationTagsCLI"></a>

**Example `tags.json`**  
El archivo `tags.json` contiene las etiquetas que desea aplicar a la configuración de Lente de almacenamiento de S3. Para utilizar este ejemplo, sustituya `{{user input placeholders}}` por su propia información.  

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

## Permisos de IAM de configuración de ejemplo de S3 Storage Lens
<a name="S3LensHelperFilesSampleConfigurationIAMPermissionsCLI"></a>

**Example `permissions.json`: nombre de panel específico**  
Esta política de ejemplo muestra un archivo de `permissions.json` de IAM de Lente de almacenamiento de S3 con un nombre de panel específico designado. Sustituya {{`value1`}}, `{{us-east-1}}`, `{{your-dashboard-name}}` y `{{example-account-id}}` por sus propios valores.    
****  

```
{
    "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}}:{{111122223333}}:storage-lens/{{your-dashboard-name}}"
        }
    ]
}
```

**Example `permissions.json`: nombre de panel no específico**  
Esta política de ejemplo muestra un archivo de `permissions.json` de IAM de Lente de almacenamiento de S3 sin un nombre de panel específico designado. Sustituya {{`value1`}}, `{{us-east-1}}` y `{{example-account-id}}` por sus propios valores.    
****  

```
{
    "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}}:{{111122223333}}:storage-lens/*"
        }
    ]
}
```