

# Trabajo con Amazon S3 Storage Lens mediante la consola y la API
<a name="S3LensExamples"></a>

La Lente de almacenamiento de Amazon S3 es una función de análisis de almacenamiento en la nube que puede utilizar para obtener visibilidad en toda la organización sobre el uso y la actividad del almacenamiento de objetos. Puede utilizar las métricas de S3 Storage Lens para generar información resumida, como averiguar cuánto almacenamiento tiene en toda la organización o cuáles son los buckets y los prefijos de crecimiento más rápido. También puede utilizar las métricas de Amazon S3 Storage Lens para identificar oportunidades de optimización de costos, implementar las prácticas recomendadas de protección y seguridad de los datos y mejorar el rendimiento de las cargas de trabajo de las aplicaciones. Por ejemplo, puede identificar los buckets que no tienen reglas del ciclo de vida de S3 para que hagan vencer las cargas multipartes incompletas que tengan más de 7 días de antigüedad. También puede identificar los buckets que no siguen las prácticas recomendadas de protección de datos, como el uso de la Replicación de S3 o el control de versiones de S3. S3 Storage Lens analiza también las métricas para ofrecer recomendaciones contextuales que puede usar para optimizar los costos de almacenamiento y aplicar las prácticas recomendadas para proteger los datos. 

S3 Storage Lens agrega las métricas y muestra la información en la sección **Instantánea de la cuenta** en la página **Buckets** de la consola de Amazon S3. La Lente de almacenamiento de S3 también proporciona un panel interactivo que puede utilizar para visualizar información y tendencias, marcar valores atípicos y recibir recomendaciones para optimizar los costos de almacenamiento y aplicar las prácticas recomendadas de protección de datos. El panel tiene opciones de desglose para generar y visualizar información en el nivel de la organización, la cuenta, la Región de AWS, la clase de almacenamiento, el bucket, el prefijo o el grupo de Lente de almacenamiento. También puede enviar un informe de métricas diario en CSV o formato Parquet a un bucket de S3 de uso general o exportar las métricas directamente a un bucket de tablas de S3 administrado de AWS. 

**nota**  
Lente de almacenamiento solo agrega métricas para los [buckets de uso general de S3](UsingBucket.md).

Las siguientes secciones contienen ejemplos de la creación, la actualización y la visualización de las configuraciones de S3 Storage Lens y de la realización de operaciones relacionadas con la característica. Si utiliza S3 Storage Lens con AWS Organizations, en estos ejemplos también se abarcan esos casos de uso. En los ejemplos, sustituya cualquier valor de marcador de posición.

**Topics**
+ [

# Creación de un panel de Lente de almacenamiento de Amazon S3
](storage_lens_creating_dashboard.md)
+ [

# Actualización de un panel de Lente de almacenamiento de Amazon S3
](storage_lens_editing.md)
+ [

# Deshabilitación de un panel de Lente de almacenamiento de Amazon S3
](storage_lens_disabling.md)
+ [

# Eliminación de un panel de Lente de almacenamiento de Amazon S3
](storage_lens_deleting.md)
+ [

# Obtención de lista de paneles de Lente de almacenamiento de Amazon S3
](storage_lens_list_dashboard.md)
+ [

# Visualización de los detalles de configuración de paneles de Lente de almacenamiento de Amazon S3
](storage_lens_viewing.md)
+ [

# Administración de etiquetas de recursos de AWS con Lente de almacenamiento de S3
](storage-lens-groups-manage-tags-dashboard.md)
+ [

# Archivos auxiliares para utilizar Amazon S3 Storage Lens
](S3LensHelperFilesCLI.md)

# Creación de un panel de Lente de almacenamiento de Amazon S3
<a name="storage_lens_creating_dashboard"></a>

Puede crear paneles personalizados de Lente de almacenamiento de S3 adicionales que pueden abarcar a la organización en AWS Organizations o a Regiones de AWS específicas o buckets dentro de una cuenta. 

**nota**  
Las actualizaciones en la configuración del panel pueden tardar hasta 48 horas en mostrarse o visualizarse con precisión.

## Uso de la consola de S3
<a name="storage_lens_console_creating"></a>

Siga los pasos que figuran a continuación para crear un panel de Amazon S3 Storage Lens en la consola de Amazon S3.

**Paso 1: configuración de los ajustes generales**

1. Inicie sesión en la Consola de administración de AWS y abra la consola de Amazon S3 en [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

1. En la barra de navegación de la parte superior de la página, elija el nombre de la Región de AWS que aparece. A continuación, elija la región a la que desea cambiar. 

1. En el panel de navegación, en **Lente de almacenamiento de S3**, elija **Paneles**.

1. Elija **Create dashboard (Crear un panel)**.

1. En la página **Dashboard** (Panel), en la sección **General**, haga lo siguiente:

   1. Vea la **región de origen** del panel. La región de origen es la Región de AWS donde se almacenan la configuración y las métricas de este Almacenamiento de lente.

   1. Escriba un nombre de panel. 

      Los nombres de los paneles deben tener menos de 65 caracteres y no deben contener caracteres ni espacios especiales. 
**nota**  
No puede cambiar el nombre de este panel una vez que se creado.

   1. Elija **Habilitado** para mostrar las métricas diarias actualizadas en el panel de control.

   1. (Opcional) Si lo desea, puede agregar **Etiquetas** al panel. Puede usar etiquetas para administrar los permisos de su panel y realizar un seguimiento de los costos de S3 Storage Lens. Para obtener más información, consulte [Control del acceso a recursos de AWS mediante etiquetas](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html) en la *Guía del usuario de IAM* y [Uso de etiquetas generadas por AWS](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/aws-tags.html) en la *Guía del usuario de AWS Billing*.
**nota**  
Puede agregar hasta 50 etiquetas a la configuración del panel.

1. Elija **Siguiente** para guardar los cambios y continuar.

**Paso 2: definir el alcance del panel**

1. En la sección **Alcance del panel**, elija las regiones y los buckets que desea que Lente de almacenamiento de S3 incluya o excluya en el panel.

1. Elija los buckets en las regiones seleccionadas que desea que S3 Storage Lens incluya o excluya. Puede incluir o excluir buckets, pero no ambos. Esta opción no está disponible cuando se crean paneles por organización.
**nota**  
Puede incluir o excluir regiones y buckets. Esta opción está limitada a las regiones solo cuando se crean paneles de nivel de organización en las cuentas de miembros de su organización. 
Puede elegir hasta 50 buckets para incluir o excluir.

1. Elija **Siguiente** para guardar los cambios y continuar.

**Paso 3: elección del nivel de Lente de almacenamiento**

1. En la sección **Niveles de Lente de almacenamiento**, elija el nivel de características que desea agregar a este panel.

   1. Para incluir métricas gratuitas agregadas por bucket y disponibles para consultas durante 14 días, elija **Nivel gratuito**.

   1. Para habilitar las métricas avanzadas, elija el **nivel avanzado**. Estas opciones incluyen la agregación de grupos de prefijos o lentes de almacenamiento, la publicación en Amazon CloudWatch, el informe de prefijos ampliado y las recomendaciones contextuales. Los datos están disponibles para consultas durante 15 meses. Las métricas y recomendaciones avanzadas tienen un costo adicional. Para obtener más información, consulte [Precios de Amazon S3](https://aws.amazon.com/s3/pricing/).

      Para obtener más información sobre las métricas avanzadas y gratuitas, consulte [Selección de métricas](storage_lens_basics_metrics_recommendations.md#storage_lens_basics_metrics_selection).

1. En **Categorías de métricas avanzadas**, seleccione la categoría de métricas que desea habilitar:
   + **Métricas de actividad**
   + **Detailed status code metrics (Métricas de código de estado detalladas**
   + **Métricas de optimización de costos**
   + **Métricas de protección de datos**
   + **Métricas de desempeño**

   Para obtener una vista previa de las métricas que se incluyen en cada categoría, use el botón de flecha desplegable situado debajo de la lista de casillas de verificación de las categorías de métricas. Para obtener más información sobre categorías de métricas, consulte [Categorías de métricas](storage_lens_basics_metrics_recommendations.md#storage_lens_basics_metrics_types). Para obtener una lista completa de métricas, consulte [Glosario de métricas de Amazon S3 Storage Lens](storage_lens_metrics_glossary.md).

1. Elija o especifique un **Delimitador de prefijo** para distinguir los niveles dentro de cada prefijo. Este valor se utiliza para identificar cada nivel de prefijo. El valor predeterminado de Amazon S3 es el carácter “`/`“, pero la estructura de almacenamiento podría utilizar otros caracteres delimitadores.

1. Elija **Siguiente** para guardar los cambios y continuar.

**Paso 4: (opcional) elección de la agregación de las métricas**

1. En **Agregación de métricas adicionales**, elija qué métricas quiere agregar:
   + Agregación de prefijos
   + Agregación de grupos de Lente de almacenamiento

1. Si ha habilitado la **Agregación de prefijos**, especifique el **umbral mínimo de prefijos** para el panel de control y la **profundidad de prefijos**. A continuación, elija **Siguiente** para guardar y continuar.
**nota**  
La configuración de **Profundidad de prefijo** determina con cuántos niveles jerárquicos de profundidad Lente de almacenamiento de S3 analizará los prefijos de los objetos, con un límite máximo de 10 niveles. El **Umbral de prefijo** especifica el porcentaje mínimo del almacenamiento total que debe representar un prefijo antes de que se incluya en las métricas de Lente de almacenamiento.

1. Si ha habilitado la **Agregación de grupos de Storage Lens**, elija una de las siguientes opciones:
   + **Incluir grupos de Storage Lens**
   + **Excluya grupos de lentes de almacenamiento**

1. Al incluir grupos de lentes de almacenamiento en la agregación, puede **Incluir todos los grupos de lentes de almacenamiento de la región de origen** o especificar los grupos de lentes de almacenamiento que desee incluir.

1. Elija **Siguiente** para guardar los cambios y continuar.

**Paso 5: (opcional) elección de la configuración de exportación y publicación de métricas**

1. En **Publicación de métricas**, elija **Publicación de CloudWatch** si quiere acceder a las métricas de Lente de almacenamiento en el panel de control de CloudWatch.
**nota**  
Las métricas por prefijo no están disponibles en CloudWatch.

1. En **Exportación de métricas**, elija qué datos del panel de Lente de almacenamiento quiere que se exporten a diario:
   + **Informe de métricas predeterminado**
   + **Informe de métricas de prefijos ampliados**

1. (Opcional) Si eligió el **Informe de métricas predeterminado**, en la configuración del **Informe de métricas predeterminado**, elija el tipo de bucket. Puede exportar el informe a un bucket de Amazon S3 de uso general o a un bucket de tabla de S3 administrado de AWS. Según el tipo de bucket seleccionado, actualice las opciones de **Configuración de destino de bucket de uso general** o **Configuración de destino de bucket de tabla**.
**nota**  
El **informe de métricas predeterminado** solo incluye prefijos dentro del umbral y la profundidad establecidos en la configuración de agregación de prefijos.  
Si elige especificar una clave de cifrado, debe elegir una clave de AWS KMS (SSE-KMS) o una clave administrada por Amazon S3 (SSE-S3). Si la política de bucket de destino requiere el cifrado, debe proporcionar una clave de cifrado para la exportación de las métricas. Sin la clave de cifrado, se produce un error en la exportación a S3. Para obtener más información, consulte [Uso de una AWS KMS key para cifrar las exportaciones de métricas](storage_lens_encrypt_permissions.md).

1. (Opcional) Si eligió el **Informe de métricas de prefijos ampliados**, en la configuración del **Informe de métricas de prefijos ampliados**, elija el tipo de bucket. Puede exportar el informe a un bucket de Amazon S3 de uso general o a un bucket de tabla de S3 de solo lectura. Según el tipo de bucket seleccionado, actualice la **Configuración de destino de bucket de uso general** o **Configuración de destino de bucket de tabla**.
**nota**  
El **Informe de métricas de prefijos ampliados** incluye todos los prefijos hasta la profundidad del prefijo 50 en todos los buckets seleccionados que se especifican en el alcance del panel.  
Si elige especificar una clave de cifrado, debe elegir una clave de AWS KMS (SSE-KMS) o una clave administrada por Amazon S3 (SSE-S3). Si la política de bucket de destino requiere el cifrado, debe proporcionar una clave de cifrado para la exportación de las métricas. Sin la clave de cifrado, se produce un error en la exportación a S3. Para obtener más información, consulte [Uso de una AWS KMS key para cifrar las exportaciones de métricas](storage_lens_encrypt_permissions.md).

1. Elija **Siguiente** para guardar los cambios y continuar.

1. Revise todo lo que aparece en la página **Revisar y crear**. Si no hay cambios adicionales, elija **Siguiente** para guardar los cambios y crear el panel de control.

**Paso 6: revisión de la configuración del panel y creación del panel**

1. En la sección **General**, revise la configuración. Para realizar cualquier cambio, elija **Editar**.

1. En la sección **Alcance del panel**, revise la configuración. Para realizar cualquier cambio, elija **Editar**.

1. En la sección **Nivel de Lente de almacenamiento**, revise la configuración. Para realizar cualquier cambio, elija **Editar**.

1. En la sección **Agregación de métricas**, revise la configuración. Para realizar cualquier cambio, elija **Editar**.

1. En la sección **Exportación de métricas**, revise la configuración. Para realizar cualquier cambio, elija **Editar**.

1. Tras revisar y confirmar todos los ajustes de configuración del panel, elija **Enviar** para crear el panel.

Una vez que haya creado correctamente el nuevo panel de Lente de almacenamiento, podrá verlo en la página del **panel** de Lente de almacenamiento.

## Uso de AWS CLI
<a name="S3PutStorageLensConfigurationTagsCLI"></a>

**Example**  
En el siguiente comando de ejemplo, se crea una configuración de Lente de almacenamiento de Amazon S3 con etiquetas. Para utilizar estos ejemplos, sustituya `user input placeholders` por su propia información.  

```
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
```

**Example**  
En el siguiente comando de ejemplo, se crea una configuración de Lente de almacenamiento de Amazon S3 sin etiquetas. Para utilizar estos ejemplos, sustituya `user input placeholders` por su propia información.  

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

## Uso de AWS SDK para Java
<a name="S3CreateandUpdateStorageLensConfigurationJava"></a>

**Example – Creación y actualización de una configuración de Lente de almacenamiento de Amazon S3**  
El siguiente ejemplo crea y actualiza una configuración de Lente de almacenamiento de Amazon S3 en SDK para Java:  

```
package aws.example.s3control;

import software.amazon.awssdk.awscore.exception.AwsServiceException;
import software.amazon.awssdk.core.exception.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.AccountLevel;
import software.amazon.awssdk.services.s3control.model.ActivityMetrics;
import software.amazon.awssdk.services.s3control.model.AdvancedCostOptimizationMetrics;
import software.amazon.awssdk.services.s3control.model.AdvancedDataProtectionMetrics;
import software.amazon.awssdk.services.s3control.model.AdvancedPerformanceMetrics;
import software.amazon.awssdk.services.s3control.model.BucketLevel;
import software.amazon.awssdk.services.s3control.model.CloudWatchMetrics;
import software.amazon.awssdk.services.s3control.model.DetailedStatusCodesMetrics;
import software.amazon.awssdk.services.s3control.model.Format;
import software.amazon.awssdk.services.s3control.model.Include;
import software.amazon.awssdk.services.s3control.model.OutputSchemaVersion;
import software.amazon.awssdk.services.s3control.model.PrefixLevel;
import software.amazon.awssdk.services.s3control.model.PrefixLevelStorageMetrics;
import software.amazon.awssdk.services.s3control.model.PutStorageLensConfigurationRequest;
import software.amazon.awssdk.services.s3control.model.S3BucketDestination;
import software.amazon.awssdk.services.s3control.model.SSES3;
import software.amazon.awssdk.services.s3control.model.SelectionCriteria;
import software.amazon.awssdk.services.s3control.model.StorageLensAwsOrg;
import software.amazon.awssdk.services.s3control.model.StorageLensConfiguration;
import software.amazon.awssdk.services.s3control.model.StorageLensDataExport;
import software.amazon.awssdk.services.s3control.model.StorageLensDataExportEncryption;
import software.amazon.awssdk.services.s3control.model.StorageLensExpandedPrefixesDataExport;
import software.amazon.awssdk.services.s3control.model.StorageLensTableDestination;
import software.amazon.awssdk.services.s3control.model.StorageLensTag;

import java.util.Arrays;
import java.util.List;

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 = SelectionCriteria.builder()
                    .delimiter("/")
                    .maxDepth(5)
                    .minStorageBytesPercentage(10.0)
                    .build();

            PrefixLevelStorageMetrics prefixStorageMetrics = PrefixLevelStorageMetrics.builder()
                    .isEnabled(true)
                    .selectionCriteria(selectionCriteria)
                    .build();

            BucketLevel bucketLevel = BucketLevel.builder()
                    .activityMetrics(ActivityMetrics.builder().isEnabled(true).build())
                    .advancedCostOptimizationMetrics(AdvancedCostOptimizationMetrics.builder().isEnabled(true).build())
                    .advancedDataProtectionMetrics(AdvancedDataProtectionMetrics.builder().isEnabled(true).build())
                    .advancedPerformanceMetrics(AdvancedPerformanceMetrics.builder().isEnabled(true).build())
                    .detailedStatusCodesMetrics(DetailedStatusCodesMetrics.builder().isEnabled(true).build())
                    .prefixLevel(PrefixLevel.builder().storageMetrics(prefixStorageMetrics).build())
                    .build();

            AccountLevel accountLevel = AccountLevel.builder()
                    .activityMetrics(ActivityMetrics.builder().isEnabled(true).build())
                    .advancedCostOptimizationMetrics(AdvancedCostOptimizationMetrics.builder().isEnabled(true).build())
                    .advancedPerformanceMetrics(AdvancedPerformanceMetrics.builder().isEnabled(true).build())
                    .advancedDataProtectionMetrics(AdvancedDataProtectionMetrics.builder().isEnabled(true).build())
                    .detailedStatusCodesMetrics(DetailedStatusCodesMetrics.builder().isEnabled(true).build())
                    .bucketLevel(bucketLevel)
                    .build();

            Include include = Include.builder()
                    .buckets(Arrays.asList("arn:aws:s3:::bucketName"))
                    .regions(Arrays.asList("us-west-2"))
                    .build();

            StorageLensDataExportEncryption exportEncryption = StorageLensDataExportEncryption.builder()
                    .sses3(SSES3.builder().build())
                    .build();

            S3BucketDestination s3BucketDestination = S3BucketDestination.builder()
                    .accountId(exportAccountId)
                    .arn(exportBucketArn)
                    .encryption(exportEncryption)
                    .format(exportFormat)
                    .outputSchemaVersion(OutputSchemaVersion.V_1)
                    .prefix("Prefix")
                    .build();

            StorageLensTableDestination s3TablesDestination = StorageLensTableDestination.builder()
                    .encryption(exportEncryption)
                    .isEnabled(true)
                    .build();

            CloudWatchMetrics cloudWatchMetrics = CloudWatchMetrics.builder()
                    .isEnabled(true)
                    .build();

            StorageLensDataExport dataExport = StorageLensDataExport.builder()
                    .cloudWatchMetrics(cloudWatchMetrics)
                    .s3BucketDestination(s3BucketDestination)
                    .storageLensTableDestination(s3TablesDestination)
                    .build();

            StorageLensAwsOrg awsOrg = StorageLensAwsOrg.builder()
                    .arn(awsOrgARN)
                    .build();

            StorageLensExpandedPrefixesDataExport expandedPrefixesDataExport = StorageLensExpandedPrefixesDataExport.builder()
                    .s3BucketDestination(s3BucketDestination)
                    .storageLensTableDestination(s3TablesDestination)
                    .build();

            StorageLensConfiguration configuration = StorageLensConfiguration.builder()
                    .id(configurationId)
                    .accountLevel(accountLevel)
                    .include(include)
                    .dataExport(dataExport)
                    .awsOrg(awsOrg)
                    .expandedPrefixesDataExport(expandedPrefixesDataExport)
                    .prefixDelimiter("/")
                    .isEnabled(true)
                    .build();

            List<StorageLensTag> tags = Arrays.asList(
                    StorageLensTag.builder().key("key-1").value("value-1").build(),
                    StorageLensTag.builder().key("key-2").value("value-2").build()
            );

            S3ControlClient s3ControlClient = S3ControlClient.builder()
                    .region(Region.US_WEST_2)
                    .credentialsProvider(ProfileCredentialsProvider.create())
                    .build();

            s3ControlClient.putStorageLensConfiguration(PutStorageLensConfigurationRequest.builder()
                    .accountId(sourceAccountId)
                    .configId(configurationId)
                    .storageLensConfiguration(configuration)
                    .tags(tags)
                    .build()
            );

        } catch (AwsServiceException 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();
        }
    }
}
```

Para acceder a grupos de lentes de almacenamiento de S3 o prefijos expandidos, debe actualizar el panel para usar el nivel avanzado. Se aplican cargos adicionales. Para obtener más información sobre los niveles gratuitos y avanzados, consulte [Selección de métricas](storage_lens_basics_metrics_recommendations.md#storage_lens_basics_metrics_selection). Para obtener más información acerca de los grupos de S3 Storage Lens, consulte [Trabajo con grupos de Lente de almacenamiento de S3 para filtrar y agregar métricas](storage-lens-groups-overview.md). 

# Actualización de un panel de Lente de almacenamiento de Amazon S3
<a name="storage_lens_editing"></a>

 El panel predeterminado de Lente de almacenamiento de Amazon S3 es `default-account-dashboard`. Amazon S3 preconfigura este panel para ayudarle a visualizar información resumida y tendencias para las métricas avanzadas y gratuitas agregadas de toda la cuenta en la consola. No puede modificar el alcance de configuración del panel, pero puede actualizar la selección de métricas de métricas gratuitas a métricas y recomendaciones avanzadas pagadas, configurar la exportación de métricas opcionales o incluso desactivar el panel predeterminado. El panel predeterminado no se puede eliminar y solo se puede deshabilitar. Para obtener más información, consulte [Uso de la consola de S3](storage_lens_console_deleting.md).

## Uso de la consola de S3
<a name="storage_lens_console_editing"></a>

Siga los pasos que figuran a continuación para actualizar un panel de Amazon S3 Storage Lens en la consola de Amazon S3.

**Paso 1: actualización del panel y configuración de los ajustes generales**

1. Inicie sesión en la Consola de administración de AWS y abra la consola de Amazon S3 en [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

1. En el panel de navegación izquierdo, elija **Storage Lens, paneles**.

1. Elija el panel que desea editar.

1. Elija **Ver la configuración del panel**.

1. Elija **Edit (Edición de)**. Ahora puede revisar la configuración del panel de control paso a paso. Para realizar cambios en cualquiera de los pasos, puede hacer clic directamente en el paso mediante el menú de navegación de la izquierda. Para obtener instrucciones sobre cómo actualizar esos pasos,
**nota**  
No puede cambiar lo siguiente:  
El nombre del panel
La región de origen

1. En la página **Panel**, en la sección **General**, puede hacer cambios de la siguiente manera:
   + Elija **Habilitado** o **Desactivado** para actualizar si recibe métricas diarias en el panel de control.
   + (Opcional) Si lo desea, puede agregar **Etiquetas** al panel. Puede usar etiquetas para administrar los permisos de su panel y realizar un seguimiento de los costos de S3 Storage Lens. Para obtener más información, consulte [Control del acceso a recursos de AWS mediante etiquetas](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html) en la *Guía del usuario de IAM* y [Uso de etiquetas generadas por AWS](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/aws-tags.html) en la *Guía del usuario de AWS Billing*.
**nota**  
Puede agregar hasta 50 etiquetas a la configuración del panel.

1. Elija **Siguiente** para guardar los cambios y continuar.

**Paso 2: actualizar el alcance del panel**

1. En la sección **Alcance del panel**, actualice las regiones y los buckets que desea que Lente de almacenamiento de S3 incluya o excluya en el panel.
**nota**  
Puede incluir o excluir regiones y buckets. Esta opción está limitada a las regiones solo cuando se crean paneles de nivel de organización en las cuentas de miembros de su organización. 
Puede elegir hasta 50 buckets para incluir o excluir.

1. Elija los buckets en las regiones seleccionadas que desea que S3 Storage Lens incluya o excluya. Puede incluir o excluir buckets, pero no ambos. Esta opción no está disponible cuando se crean paneles por organización.
**nota**  
Puede incluir o excluir regiones y buckets. Esta opción está limitada a las regiones solo cuando se crean paneles de nivel de organización en las cuentas de miembros de su organización.
Puede elegir hasta 50 buckets para incluir o excluir.

1. Elija **Siguiente** para guardar los cambios y continuar.

**Paso 3: actualización del nivel de Lente de almacenamiento, configuración de la selección de métricas**

1. En la sección **Nivel de Lente de almacenamiento** **Selección de métricas**, actualice el nivel de métricas que desea agregar a este panel.
**nota**  
Si va a actualizar el **Nivel gratuito** al **Nivel avanzado**, tendrá que actualizar la configuración de **Agregación de métricas**. Para actualizar la **Configuración de agregación de métricas**, consulte el **Paso 4: actualización de la agregación de métricas**.
Si va a actualizar el nivel de Lente de almacenamiento de **Nivel avanzado** a **Nivel gratuito**, tendrá que actualizar la configuración de **Agregación de métricas**. La característica **Agregación de métricas** solo se aplica a las categorías de métricas del **Nivel avanzado**.

1. Para incluir métricas gratuitas agregadas por bucket y disponibles para consultas durante 14 días, elija **Nivel gratuito**.

1. Para habilitar las métricas avanzadas, elija el **nivel avanzado**. Estas opciones incluyen la agregación de prefijos, la publicación de Amazon CloudWatch y las recomendaciones contextuales. Los datos están disponibles para consultas durante 15 meses. Las métricas y recomendaciones avanzadas tienen un costo adicional. Para obtener más información, consulte [Precios de Amazon S3](https://aws.amazon.com/s3/pricing/).

   Para obtener más información sobre las métricas avanzadas y gratuitas, consulte [Selección de métricas](storage_lens_basics_metrics_recommendations.md#storage_lens_basics_metrics_selection).

1. En **Categorías de métricas avanzadas**, elija la categoría de las métricas que desea habilitar:
   + **Métricas de actividad**
   + **Detailed status code metrics (Métricas de código de estado detalladas**
   + **Métricas de optimización de costos**
   + **Métricas de protección de datos**
   + **Métricas de desempeño**

   Para obtener una vista previa de las métricas que se incluyen en cada categoría, use el botón de flecha desplegable situado debajo de la lista de casillas de verificación de las categorías de métricas. Para obtener más información sobre categorías de métricas, consulte [Categorías de métricas](storage_lens_basics_metrics_recommendations.md#storage_lens_basics_metrics_types). Para obtener una lista completa de métricas, consulte [Glosario de métricas de Amazon S3 Storage Lens](storage_lens_metrics_glossary.md).

1. Elija o especifique un **Delimitador de prefijo** para distinguir los niveles dentro de cada prefijo. Este valor se utiliza para identificar cada nivel de prefijo. El valor predeterminado de Amazon S3 es el carácter “`/`“, pero la estructura de almacenamiento podría utilizar otros caracteres delimitadores.

1. Elija **Siguiente** para guardar los cambios y continuar.

**Paso 4: (opcional) actualización de la agregación de métricas**

1. En **Agregación de métricas adicionales**, elija qué métricas quiere agregar mediante la elección de una de las siguientes opciones:
   + Agregación de prefijos
   + Agregación de grupos de Lente de almacenamiento

1. Si ha habilitado la **Agregación de prefijos**, especifique el **umbral mínimo de prefijos** para el panel de control y la **profundidad de prefijos**. A continuación, elija **Siguiente** para guardar y continuar.

1. Si ha habilitado la **Agregación de grupos de Storage Lens**, elija una de las siguientes opciones:
   + **Incluir grupos de Storage Lens**
   + **Excluya grupos de lentes de almacenamiento**

1. Al incluir grupos de lentes de almacenamiento en la agregación, puede **Incluir todos los grupos de lentes de almacenamiento de la región de origen** o especificar los grupos de lentes de almacenamiento que desee incluir.

1. Elija **Siguiente** para guardar los cambios y continuar.

**Paso 5: (opcional) actualización de la configuración de exportación y publicación de métricas**

1. En **Publicación de métricas**, elija **Publicación de CloudWatch** si quiere acceder a las métricas de Lente de almacenamiento en el panel de control de CloudWatch.
**nota**  
Las métricas por prefijo no están disponibles en CloudWatch.

1. En **Exportación de métricas**, elija qué datos del panel de Lente de almacenamiento quiere que se exporten a diario:
   + **Informe de métricas predeterminado**
   + **Informe de métricas de prefijos ampliados**

1. (Opcional) Si eligió el **Informe de métricas predeterminado**, en la configuración del **Informe de métricas predeterminado**, elija el tipo de bucket. Puede exportar el informe a un bucket de S3 de uso general o a un bucket de tabla de S3 de solo lectura. Según el tipo de bucket seleccionado, actualice las opciones de **Configuración de destino de bucket de uso general** o **Configuración de destino de bucket de tabla**.
**nota**  
El **informe de métricas predeterminado** solo incluye prefijos dentro del umbral y la profundidad establecidos en la configuración de agregación de prefijos. Si la agregación de prefijos aún no está configurada, el umbral incluye hasta los 100 prefijos más grandes por tamaño.
Si elige especificar una clave de cifrado, debe elegir una clave de AWS KMS (SSE-KMS) o una clave administrada por Amazon S3 (SSE-S3). Si la política de bucket de destino requiere el cifrado, debe proporcionar una clave de cifrado para la exportación de las métricas. Sin la clave de cifrado, se produce un error en la exportación a S3. Para obtener más información, consulte [Uso de una AWS KMS key para cifrar las exportaciones de métricas](storage_lens_encrypt_permissions.md).

1. Elija **Siguiente** para guardar los cambios y continuar.

1. (Opcional) Si eligió el **Informe de métricas de prefijos ampliados**, en la configuración del **Informe de métricas de prefijos ampliados**, elija el tipo de bucket. Puede exportar el informe a un bucket de S3 de uso general o a un bucket de tabla de S3 de solo lectura. Según el tipo de bucket seleccionado, actualice la **Configuración de destino de bucket de uso general** o **Configuración de destino de bucket de tabla**.
**nota**  
El **Informe de métricas de prefijos ampliados** incluye prefijos en todos los buckets especificados en el alcance del panel.
Si elige especificar una clave de cifrado, debe elegir una clave de AWS KMS (SSE-KMS) o una clave administrada por Amazon S3 (SSE-S3). Si la política de bucket de destino requiere el cifrado, debe proporcionar una clave de cifrado para la exportación de las métricas. Sin la clave de cifrado, se produce un error en la exportación a S3. Para obtener más información, consulte [Uso de una AWS KMS key para cifrar las exportaciones de métricas](storage_lens_encrypt_permissions.md).

1. Elija **Siguiente** para guardar los cambios y continuar.

**Paso 6: revisión y actualización de la configuración del panel**

1. En la sección **General**, revise la configuración. Para realizar cualquier cambio, elija **Editar**.

1. En la sección **Alcance del panel**, revise la configuración. Para realizar cualquier cambio, elija **Editar**.

1. En la sección **Nivel de Lente de almacenamiento**, revise la configuración. Para realizar cualquier cambio, elija **Editar**.

1. En la sección **Agregación de métricas**, revise la configuración. Para realizar cualquier cambio, elija **Editar**.

1. En la sección **Exportación de métricas**, revise la configuración. Para realizar cualquier cambio, elija **Editar**.

1. Tras revisar y confirmar todos los ajustes de configuración del panel, elija **Enviar** para actualizar el panel.

Una vez que haya actualizado correctamente el nuevo panel de Lente de almacenamiento, podrá ver la configuración del panel actualizada en la página del **Panel** de Lente de almacenamiento.

## Uso de AWS CLI
<a name="S3PutStorageLensConfigurationTagsCLI"></a>

**Example**  
En el siguiente comando de ejemplo, se actualiza una configuración de panel de Lente de almacenamiento de Amazon S3. Para utilizar estos ejemplos, sustituya `user input placeholders` por su propia información.  

```
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
```

## Uso de AWS SDK para Java
<a name="S3UpdateStorageLensConfigurationAdvancedJava"></a>

**Example – Actualización de una configuración de Lente de almacenamiento de Amazon S3 con métricas y recomendaciones avanzadas**  
Los siguientes ejemplos le muestran cómo actualizar la configuración predeterminada de Lente de almacenamiento de S3 con métricas y recomendaciones avanzadas en SDK para 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.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 UpdateDefaultConfigWithPaidFeatures {

    public static void main(String[] args) {
        String configurationId = "default-account-dashboard"; // This configuration ID cannot be modified.
        String sourceAccountId = "111122223333";

        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))
                    .withPrefixLevel(new PrefixLevel().withStorageMetrics(prefixStorageMetrics));
            AccountLevel accountLevel = new AccountLevel()
                    .withActivityMetrics(new ActivityMetrics().withIsEnabled(true))
                    .withBucketLevel(bucketLevel);

            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();
        }
    }
}
```

Para acceder a grupos de lentes de almacenamiento de S3 o prefijos expandidos, debe actualizar el panel para usar el nivel avanzado. Se aplican cargos adicionales. Para obtener más información sobre los niveles gratuitos y avanzados, consulte [Selección de métricas](storage_lens_basics_metrics_recommendations.md#storage_lens_basics_metrics_selection). Para obtener más información acerca de los grupos de S3 Storage Lens, consulte [Trabajo con grupos de Lente de almacenamiento de S3 para filtrar y agregar métricas](storage-lens-groups-overview.md). 

# Deshabilitación de un panel de Lente de almacenamiento de Amazon S3
<a name="storage_lens_disabling"></a>

Puede deshabilitar un panel de Lente de almacenamiento de Amazon S3 desde la consola de Amazon S3. Al deshabilitar un panel, se impide que este genere métricas en el futuro. Aunque el panel esté deshabilitado, retiene su información de configuración, por lo que se puede reanudar fácilmente cuando se vuelve a habilitar. Un panel desactivado retiene sus datos históricos hasta que ya no esté disponible para consultas.

# Uso de la consola de S3
<a name="storage_lens_console_disabling"></a>

Siga los pasos que figuran a continuación para deshabilitar un panel de Lente de almacenamiento de Amazon S3 en la consola de Amazon S3.

**Deshabilitación de un panel de Lente de almacenamiento de Amazon S3**

1. Inicie sesión en la Consola de administración de AWS y abra la consola de Amazon S3 en [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

1. En el panel de navegación izquierdo, elija **Storage Lens**, **Paneles**.

1. En la lista **Paneles**, elija el panel que desea deshabilitar y, a continuación, elija **Deshabilitar** en la parte superior de la lista.

1. En la página de confirmación, confirme que desea deshabilitar el panel escribiendo el nombre del panel en el campo de texto y, a continuación, elija **Confirmar**.

# Eliminación de un panel de Lente de almacenamiento de Amazon S3
<a name="storage_lens_deleting"></a>

No puede eliminar el panel predeterminado. No obstante, sí puede deshabilitarlo. Antes de eliminar un panel que ha creado, tenga en cuenta lo siguiente:
+ Como alternativa a eliminar un panel, puede *deshabilitar* el panel para que esté disponible y pueda volver a habilitarse en el futuro. Para obtener más información, consulte [Uso de la consola de S3](storage_lens_console_disabling.md).
+ Al eliminar el panel, se eliminan todas las opciones de configuración asociadas a él.
+ Cuando elimine un panel, todos los datos de métricas históricas dejarán de estar disponibles. Estos datos históricos se retienen durante 15 meses. Si desea acceder de nuevo a estos datos, cree un panel con el mismo nombre en la misma región de origen que el que se eliminó. 

# Uso de la consola de S3
<a name="storage_lens_console_deleting"></a>

Puede eliminar un panel de Lente de almacenamiento de Amazon S3 desde la consola de Amazon S3. Sin embargo, al eliminar un panel se impide que genere métricas en el futuro.

**Eliminación de un panel de Amazon S3 Storage Lens**

1. Inicie sesión en la Consola de administración de AWS y abra la consola de Amazon S3 en [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

1. En el panel de navegación izquierdo, elija **Storage Lens**, **Paneles**.

1. En la lista **Paneles**, elija el panel que desea eliminar y, a continuación, elija **Eliminar** en la parte superior de la lista.

1. En la página **Eliminar paneles**, confirme que desea eliminar el panel escribiendo el nombre del panel en el campo de texto. A continuación, seleccione **Confirm (Confirmar)**. 

# Uso de AWS CLI
<a name="storage_lens_cli_deleting"></a>

**Example**  
 En el siguiente ejemplo, se elimina una configuración de Lente de almacenamiento de S3. Para utilizar estos ejemplos, sustituya `user input placeholders` por su propia información.  

```
aws s3control delete-storage-lens-configuration --account-id=222222222222 --region=us-east-1 --config-id=your-configuration-id
```

## Uso de AWS SDK para Java
<a name="S3DeleteStorageLensConfigurationJava"></a>

**Example – Eliminación de una configuración de panel de Lente de almacenamiento de Amazon S3**  
En el siguiente ejemplo se muestra cómo eliminar una configuración de Lente de almacenamiento de S3 mediante SDK para 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.DeleteStorageLensConfigurationRequest;

import static com.amazonaws.regions.Regions.US_WEST_2;

public class DeleteDashboard {

    public static void main(String[] args) {
        String configurationId = "ConfigurationId";
        String sourceAccountId = "111122223333";
        try {
            AWSS3Control s3ControlClient = AWSS3ControlClient.builder()
                    .withCredentials(new ProfileCredentialsProvider())
                    .withRegion(US_WEST_2)
                    .build();

            s3ControlClient.deleteStorageLensConfiguration(new DeleteStorageLensConfigurationRequest()
                    .withAccountId(sourceAccountId)
                    .withConfigId(configurationId)
            );
        } 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();
        }
    }
}
```

# Obtención de lista de paneles de Lente de almacenamiento de Amazon S3
<a name="storage_lens_list_dashboard"></a>

 

# Uso de la consola de S3
<a name="storage_lens_console_listing"></a>

**Obtención de lista de paneles de Lente de almacenamiento de S3**

1. Inicie sesión en la Consola de administración de AWS y abra la consola de Amazon S3 en [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

1. En el panel de navegación izquierdo, vaya a **Lente de almacenamiento**.

1. Elija **Paneles**. Ahora puede ver los paneles de su Cuenta de AWS.

## Uso de AWS CLI
<a name="S3ListStorageLensConfigurationsCLI"></a>

**Example**  
Con el siguiente comando de ejemplo, se obtiene una lista de los paneles de Lente de almacenamiento de S3 en su Cuenta de AWS. Para utilizar estos ejemplos, sustituya `user input placeholders` por su propia información.  

```
aws s3control list-storage-lens-configurations --account-id=222222222222 --region=us-east-1 --next-token=abcdefghij1234
```

**Example**  
El siguiente ejemplo presenta una lista de las configuraciones de Lente de almacenamiento de S3 sin el siguiente token. Para utilizar estos ejemplos, sustituya `user input placeholders` por su propia información.  

```
aws s3control list-storage-lens-configurations --account-id=222222222222 --region=us-east-1
```

## Uso de AWS SDK para Java
<a name="S3ListStorageLensConfigurationsJava"></a>

**Example – Obtención de lista de las configuraciones de paneles de Lente de almacenamiento de S3**  
En el siguiente ejemplo se muestra cómo obtener una lista de las configuraciones de Lente de almacenamiento de S3 en SDK para Java. Para utilizar este ejemplo, reemplace los `user input placeholders` con su propia información. para la descripción de cada ejemplo.  

```
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.ListStorageLensConfigurationEntry;
import com.amazonaws.services.s3control.model.ListStorageLensConfigurationsRequest;

import java.util.List;

import static com.amazonaws.regions.Regions.US_WEST_2;

public class ListDashboard {

    public static void main(String[] args) {
        String sourceAccountId = "111122223333";
        String nextToken = "nextToken";

        try {
            AWSS3Control s3ControlClient = AWSS3ControlClient.builder()
                    .withCredentials(new ProfileCredentialsProvider())
                    .withRegion(US_WEST_2)
                    .build();

            final List<ListStorageLensConfigurationEntry> configurations =
                    s3ControlClient.listStorageLensConfigurations(new ListStorageLensConfigurationsRequest()
                            .withAccountId(sourceAccountId)
                            .withNextToken(nextToken)
                    ).getStorageLensConfigurationList();

            System.out.println(configurations.toString());
        } 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();
        }
    }
}
```

# Visualización de los detalles de configuración de paneles de Lente de almacenamiento de Amazon S3
<a name="storage_lens_viewing"></a>

Puede ver un panel de Lente de almacenamiento de Amazon S3 desde la consola de Amazon S3, la AWS CLI y SDK para Java.

# Uso de la consola de S3
<a name="storage_lens_console_viewing"></a>

**Visualización de los detalles de configuración de paneles de Lente de almacenamiento de S3**

1. Inicie sesión en la Consola de administración de AWS y abra la consola de Amazon S3 en [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

1. En el panel de navegación izquierdo, vaya a **Lente de almacenamiento**.

1. Elija **Paneles**.

1. En la lista **Paneles**, haga clic en el panel que desee ver. Ahora puede revisar los detalles de su panel de Lente de almacenamiento.

## Uso de AWS CLI
<a name="S3ListStorageLensConfigurationsCLI"></a>

**Example**  
El siguiente ejemplo recupera una configuración de Lente de almacenamiento de S3 para que pueda ver los detalles de la configuración. Para utilizar estos ejemplos, sustituya `user input placeholders` por su propia información.  

```
aws s3control get-storage-lens-configuration --account-id=222222222222 --config-id=your-configuration-id --region=us-east-1
```

## Uso de AWS SDK para Java
<a name="S3GetStorageLensConfigurationJava"></a>

**Example — Recuperación y visualización de una configuración de Lente de almacenamiento de S3**  
El siguiente ejemplo muestra cómo recuperar una configuración de Lente de almacenamiento de S3 en SDK para Java para que pueda ver los detalles de la configuración. Para utilizar este ejemplo, sustituya `user input placeholders` por su propia información.  

```
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.GetStorageLensConfigurationRequest;
import com.amazonaws.services.s3control.model.GetStorageLensConfigurationResult;
import com.amazonaws.services.s3control.model.StorageLensConfiguration;

import static com.amazonaws.regions.Regions.US_WEST_2;

public class GetDashboard {

    public static void main(String[] args) {
        String configurationId = "ConfigurationId";
        String sourceAccountId = "111122223333";

        try {
            AWSS3Control s3ControlClient = AWSS3ControlClient.builder()
                    .withCredentials(new ProfileCredentialsProvider())
                    .withRegion(US_WEST_2)
                    .build();

            final StorageLensConfiguration configuration =
                    s3ControlClient.getStorageLensConfiguration(new GetStorageLensConfigurationRequest()
                            .withAccountId(sourceAccountId)
                            .withConfigId(configurationId)
                    ).getStorageLensConfiguration();

            System.out.println(configuration.toString());
        } 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();
        }
    }
}
```

# Administración de etiquetas de recursos de AWS con Lente de almacenamiento de S3
<a name="storage-lens-groups-manage-tags-dashboard"></a>

Cada panel de Lente de almacenamiento de Amazon S3 se cuenta como un recurso de AWS con su propio nombre de recurso de Amazon (ARN). Por lo tanto, al configurar su panel de Lente de almacenamiento, opcionalmente puede añadir etiquetas de recursos de AWS al panel. Puede añadir un máximo de 50 etiquetas a cada panel de Lente de almacenamiento. Para crear un panel de Lente de almacenamiento con etiquetas, debe tener los siguientes [permisos de Lente de almacenamiento de S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage_lens_iam_permissions.html):
+ `s3:ListStorageLensConfigurations`
+ `s3:GetStorageLensConfiguration`
+ `s3:GetStorageLensConfigurationTagging`
+ `s3:PutStorageLensConfiguration`
+ ` s3:PutStorageLensConfigurationTagging`

Puede usar etiquetas de recursos de AWS para clasificar los recursos por departamento, línea de negocio o proyecto. Esto es útil cuando se tienen muchos recursos del mismo tipo. Al aplicar etiquetas, puede identificar rápidamente un panel de Lente de almacenamiento de S3 específico en función de las etiquetas que le haya asignado. También puede utilizar etiquetas para realizar un seguimiento de los costes y asignarlos.

Además, cuando agrega una etiqueta de recurso de AWS a su panel de Lente de almacenamiento, activa el [control de acceso basado en atributos (ABAC](https://docs.aws.amazon.com/IAM/latest/UserGuide/introduction_attribute-based-access-control.html)). ABAC es una estrategia de autorización que define permisos basados en atributos como etiquetas. También puede utilizar las condiciones que especifican etiquetas de recursos en sus políticas de IAM para [controlar el acceso a los recursos de AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html#access_tags_control-resources).

Puede editar las claves y los valores de las etiquetas y también puede eliminar etiquetas de un recurso en cualquier momento. Además, debe tener en cuenta las siguientes limitaciones:
+ Las claves y los valores de las etiquetas distinguen entre mayúsculas y minúsculas.
+ Si añade una etiqueta con la misma clave que una etiqueta existente en ese recurso, el nuevo valor sobrescribirá al antiguo.
+ Si elimina un recurso, también se eliminará cualquier etiqueta asignada a dicho recurso. 
+ No incluya datos privados o confidenciales en sus etiquetas de recursos de AWS.
+ No se admiten etiquetas del sistema (con claves de etiqueta que comiencen por `aws:`).
+ La longitud de cada clave de etiqueta no puede superar los 128 caracteres. La longitud del valor de cada etiqueta no puede superar los 256 caracteres.

En los siguientes ejemplos, se muestra cómo utilizar etiquetas de recursos de AWS con paneles de Lente de almacenamiento.

**Topics**
+ [

# Adición de etiquetas de recursos de AWS a un panel de Lente de almacenamiento
](storage-lens-add-tags.md)
+ [

# Recuperación de etiquetas de recursos de AWS para un panel de Lente de almacenamiento
](storage-lens-get-tags.md)
+ [

# Actualización de etiquetas de panel de Lente de almacenamiento
](storage-lens-update-tags.md)
+ [

# Eliminación de etiquetas de recursos de AWS de un panel de Lente de almacenamiento de S3
](storage-lens-dashboard-delete-tags.md)

# Adición de etiquetas de recursos de AWS a un panel de Lente de almacenamiento
<a name="storage-lens-add-tags"></a>

En los siguientes ejemplos, se demuestra cómo añadir etiquetas de recursos de AWS a un panel de Lente de almacenamiento de S3. Puede añadir etiquetas de recursos mediante la consola de Amazon S3, AWS Command Line Interface (AWS CLI) y AWS SDK para Java.

## Uso de la consola de S3
<a name="storage-lens-add-tags-console"></a>

**Adición de etiquetas de recursos de AWS a un panel de Lente de almacenamiento**

1. Inicie sesión en la Consola de administración de AWS y abra la consola de Amazon S3 en [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

1. En el panel de navegación izquierdo, vaya a **Lente de almacenamiento**.

1. Elija **Paneles**.

1. Seleccione el botón de opción del panel de Lente de almacenamiento que quiera actualizar. A continuación, elija **Edit** (Editar).

1. En **General**, seleccione **Agregar etiqueta**.

1. En la página **Agregar etiqueta**, añada el nuevo par clave-valor.
**nota**  
Si añade una nueva etiqueta con la misma clave que una etiqueta existente, se sobrescribirá el valor de la etiqueta anterior.

1. (Opcional) Para añadir más de una etiqueta nueva, vuelve a elegir **Agregar etiqueta** para seguir añadiendo nuevas entradas. Puede añadir un máximo de 50 etiquetas de recursos de AWS a su panel de Lente de almacenamiento.

1. (Opcional) Si desea eliminar una entrada recién agregada, elija **Eliminar** junto a la etiqueta que desea eliminar.

1. Elija **Save changes (Guardar cambios)**.

## Mediante AWS CLI
<a name="storage-lens-add-tags-cli"></a>

**Example**  
En el siguiente comando de ejemplo, se añaden etiquetas a una configuración de panel de Lente de almacenamiento de S3. Para utilizar estos ejemplos, sustituya `user input placeholders` por su propia información.  

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

## Uso de AWS SDK para Java
<a name="storage-lens-add-tags-sdk-java"></a>

En el siguiente ejemplo se añaden etiquetas a una configuración de Lente de almacenamiento de Amazon S3 en SDK para Java. Para utilizar este ejemplo, sustituya `user input placeholders` por su propia información.

**Example – Adición de etiquetas a una configuración de Lente de almacenamiento de S3**  

```
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.PutStorageLensConfigurationTaggingRequest;
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 PutDashboardTagging {

    public static void main(String[] args) {
        String configurationId = "ConfigurationId";
        String sourceAccountId = "111122223333";

        try {
            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.putStorageLensConfigurationTagging(new PutStorageLensConfigurationTaggingRequest()
                    .withAccountId(sourceAccountId)
                    .withConfigId(configurationId)
                    .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();
        }
    }
}
```

# Recuperación de etiquetas de recursos de AWS para un panel de Lente de almacenamiento
<a name="storage-lens-get-tags"></a>

En los siguientes ejemplos, se demuestra cómo recuperar etiquetas de recursos de AWS para un panel de Lente de almacenamiento de S3. Puede obtener etiquetas de recursos mediante la consola de Amazon S3, la AWS Command Line Interface (AWS CLI) y AWS SDK para Java.

# Uso de la consola de S3
<a name="storage-lens-get-tags-console"></a>

**Recuperación de etiquetas de recursos de AWS para un panel de Lente de almacenamiento**

1. Inicie sesión en la Consola de administración de AWS y abra la consola de Amazon S3 en [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

1. En el panel de navegación izquierdo, vaya a **Lente de almacenamiento**.

1. Elija **Paneles**.

1. Seleccione el botón de opción de la configuración del panel de Lente de almacenamiento que quiera ver. A continuación, elija **Ver la configuración del panel**.

1. En **Etiquetas**, revise las etiquetas asociadas al panel.

1. (Opcional) Si desea agregar una etiqueta nueva, elija **Editar**. A continuación, elija **Agregar etiqueta**. En la página **Agregar etiqueta**, añada el nuevo par clave-valor.
**nota**  
Si añade una nueva etiqueta con la misma clave que una etiqueta existente, se sobrescribirá el valor de la etiqueta anterior.

1. (Opcional) Si desea eliminar una entrada recién agregada, elija **Eliminar** junto a la etiqueta que desea eliminar.

1. Elija **Save changes (Guardar cambios)**.

## Mediante AWS CLI
<a name="storage-lens-get-tags-cli"></a>

**Example**  
En el siguiente comando de ejemplo, se recuperan etiquetas para una configuración de panel de Lente de almacenamiento de S3. Para utilizar estos ejemplos, sustituya `user input placeholders` por su propia información.  

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

## Uso de AWS SDK para Java
<a name="S3GetStorageLensConfigurationTaggingJava"></a>

**Example – Obtención de etiquetas para una configuración de panel de Lente de almacenamiento de S3**  
En el siguiente ejemplo, se muestra cómo recuperar etiquetas para una configuración de panel de Lente de almacenamiento de S3 en SDK para Java. Para utilizar este ejemplo, sustituya `user input placeholders` por su propia información.  

```
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.DeleteStorageLensConfigurationRequest;
import com.amazonaws.services.s3control.model.GetStorageLensConfigurationTaggingRequest;
import com.amazonaws.services.s3control.model.StorageLensTag;

import java.util.List;

import static com.amazonaws.regions.Regions.US_WEST_2;

public class GetDashboardTagging {

    public static void main(String[] args) {
        String configurationId = "ConfigurationId";
        String sourceAccountId = "111122223333";
        try {
            AWSS3Control s3ControlClient = AWSS3ControlClient.builder()
                    .withCredentials(new ProfileCredentialsProvider())
                    .withRegion(US_WEST_2)
                    .build();

            final List<StorageLensTag> s3Tags = s3ControlClient
                    .getStorageLensConfigurationTagging(new GetStorageLensConfigurationTaggingRequest()
                            .withAccountId(sourceAccountId)
                            .withConfigId(configurationId)
                    ).getTags();

            System.out.println(s3Tags.toString());
        } 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();
        }
    }
}
```

# Actualización de etiquetas de panel de Lente de almacenamiento
<a name="storage-lens-update-tags"></a>

En los siguientes ejemplos, se muestra cómo actualizar las etiquetas de panel de Lente de almacenamiento mediante la consola de Amazon S3, AWS Command Line Interface (AWS CLI) y AWS SDK para Java.

## Uso de la consola de S3
<a name="storage-lens-dashboard-update-tags-console"></a>

**Actualización de una etiqueta de recursos de AWS para un panel de Lente de almacenamiento**

1. Inicie sesión en la Consola de administración de AWS y abra la consola de Amazon S3 en [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

1. En el panel de navegación izquierdo, vaya a **Lente de almacenamiento**.

1. Elija **Paneles**.

1. Seleccione el botón de opción de la configuración del panel de Lente de almacenamiento que quiera ver. A continuación, elija **Ver la configuración del panel**.

1. En **Etiquetas**, revise las etiquetas asociadas al panel.

1. (Opcional) Si desea agregar una etiqueta nueva, elija **Editar**. A continuación, elija **Agregar etiqueta**. En la página **Agregar etiqueta**, añada el nuevo par clave-valor.
**nota**  
Si añade una nueva etiqueta con la misma clave que una etiqueta existente, se sobrescribirá el valor de la etiqueta anterior.

1. (Opcional) Si desea eliminar una entrada recién agregada, elija **Eliminar** junto a la etiqueta que desea eliminar.

1. Elija **Save changes (Guardar cambios)**.

## Mediante AWS CLI
<a name="storage-lens-dashboard-update-tags-cli"></a>

**Example**  
En el siguiente comando de ejemplo, se añaden o sustituyen etiquetas en una configuración existente de panel de Lente de almacenamiento de Amazon S3. Para utilizar estos ejemplos, sustituya `user input placeholders` por su propia información.  

```
aws s3control put-storage-lens-configuration-tagging --account-id=111122223333 --config-id=example-dashboard-configuration-id --region=us-east-1 --config-id=your-configuration-id
```

## Uso de AWS SDK para Java
<a name="storage-lens-dashboard-update-tags-sdk-java"></a>

En el siguiente ejemplo de AWS SDK para Java, se actualizan las etiquetas de recursos de AWS en un panel de Lente de almacenamiento existente. Para utilizar este ejemplo, sustituya `user input placeholders` por su propia información.

**Example — Actualización de las etiquetas en una configuración de panel de Lente de almacenamiento existente**  

```
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.PutStorageLensConfigurationTaggingRequest;
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 PutDashboardTagging {

    public static void main(String[] args) {
        String configurationId = "ConfigurationId";
        String sourceAccountId = "111122223333";

        try {
            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.putStorageLensConfigurationTagging(new PutStorageLensConfigurationTaggingRequest()
                    .withAccountId(sourceAccountId)
                    .withConfigId(configurationId)
                    .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();
        }
    }
}
```

# Eliminación de etiquetas de recursos de AWS de un panel de Lente de almacenamiento de S3
<a name="storage-lens-dashboard-delete-tags"></a>

En los siguientes ejemplos, se muestra cómo eliminar etiquetas de recursos de AWS de un panel de Lente de almacenamiento existente. Puede eliminar etiquetas mediante la consola de Amazon S3, AWS Command Line Interface (AWS CLI) y AWS SDK para Java.

## Uso de la consola de S3
<a name="storage-lens-groups-delete-tags-console"></a>

**Eliminación de las etiquetas de recursos de AWS de un panel de Lente de almacenamiento existente**

1. Inicie sesión en la Consola de administración de AWS y abra la consola de Amazon S3 en [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

1. En el panel de navegación izquierdo, vaya a **Lente de almacenamiento**.

1. Elija **Paneles**.

1. Seleccione el botón de opción de la configuración del panel de Lente de almacenamiento que quiera ver. A continuación, elija **Ver la configuración del panel**.

1. En **Etiquetas**, revise las etiquetas asociadas al panel.

1. Elija **Eliminar** junto a la etiqueta que desee eliminar.

1. Elija **Save changes (Guardar cambios)**.

## Mediante AWS CLI
<a name="storage-lens-dashboard-delete-tags-cli"></a>

El siguiente comando AWS CLI elimina las etiquetas de recursos de AWS de un panel de Lente de almacenamiento existente. Para utilizar este comando de ejemplo, sustituya `user input placeholders` por su propia información.

**Example**  

```
aws s3control delete-storage-lens-configuration-tagging --account-id=222222222222 --config-id=your-configuration-id --region=us-east-1
```

## Uso de AWS SDK para Java
<a name="storage-lens-dashboard-delete-tags-sdk-java"></a>

El siguiente ejemplo de AWS SDK para Java elimina una etiqueta de recursos de AWS del panel de Lente de almacenamiento con el nombre de recurso de Amazon (ARN) que especifica en la cuenta `111122223333`. Para utilizar este ejemplo, sustituya `user input placeholders` por su propia información.

**Example – Eliminación de etiquetas para una configuración de panel de Lente de almacenamiento de S3**  

```
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.DeleteStorageLensConfigurationTaggingRequest;

import static com.amazonaws.regions.Regions.US_WEST_2;

public class DeleteDashboardTagging {

    public static void main(String[] args) {
        String configurationId = "ConfigurationId";
        String sourceAccountId = "111122223333";
        try {
            AWSS3Control s3ControlClient = AWSS3ControlClient.builder()
                    .withCredentials(new ProfileCredentialsProvider())
                    .withRegion(US_WEST_2)
                    .build();

            s3ControlClient.deleteStorageLensConfigurationTagging(new DeleteStorageLensConfigurationTaggingRequest()
                    .withAccountId(sourceAccountId)
                    .withConfigId(configurationId)
            );
        } 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();
        }
    }
}
```

# 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/*"
        }
    ]
}
```