# Uso de grupos de Lente de almacenamiento
<a name="storage-lens-group-tasks"></a>

Los grupos de Lente de almacenamiento de Amazon S3 agregan métricas mediante filtros personalizados basados en metadatos de objetos. Puede analizar y filtrar las métricas de S3 Lente de almacenamiento mediante prefijos, sufijos, etiquetas de objetos, tamaño de objetos y antigüedad de objetos. Con los grupos de Lente de almacenamiento de Amazon S3, también puede clasificar su uso dentro de buckets de Amazon S3 y entre ellos. Como resultado, podrá comprender y optimizar mejor su almacenamiento de S3.

Para empezar a visualizar los datos de un grupo de Lente de almacenamiento, primero debe [asociar el grupo de Lente de almacenamiento a un panel de S3 Lente de almacenamiento](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage-lens-groups-dashboard-console.html#storage-lens-groups-attach-dashboard-console). Si necesita administrar los grupos de Lente de almacenamiento en el panel, puede editar la configuración del panel. Para comprobar qué grupos de Lente de almacenamiento están en su cuenta, puede incluirlos en una lista. Para comprobar qué grupos de Lente de almacenamiento están asociados a su panel, siempre puede consultar la pestaña **Grupos de Lente de almacenamiento** en el panel. Para revisar o actualizar el ámbito de un grupo de Lente de almacenamiento existente, puede ver sus detalles. También puede eliminar permanentemente un grupo de Lente de almacenamiento.

Para administrar los permisos, puede crear y agregar etiquetas de recursos de AWS definidas por el usuario a sus grupos de Lente de almacenamiento. Puede usar etiquetas de recursos de AWS para clasificar recursos según el departamento, la línea de negocio o el proyecto. Esto resulta útil cuando se tienen muchos recursos del mismo tipo. Al aplicar etiquetas, puede identificar rápidamente un grupo de Lente de almacenamiento específico en función de las etiquetas que le haya asignado. 

Además, cuando agrega una etiqueta de recurso de AWS a su grupo 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, en este caso, 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).

**Topics**
+ [Creación de un grupo de Lente de almacenamiento](storage-lens-groups-create.md)
+ [Asociación o eliminación de grupos de S3 Lente de almacenamiento a o desde su panel](storage-lens-groups-dashboard-console.md)
+ [Visualización de los datos de grupos de Lente de almacenamiento](storage-lens-groups-visualize.md)
+ [Actualización de un grupo de Lente de almacenamiento](storage-lens-groups-update.md)
+ [Administración de etiquetas de recursos de AWS con grupos de Lente de almacenamiento](storage-lens-groups-manage-tags.md)
+ [Enumeración de todos los grupos de Lente de almacenamiento](storage-lens-groups-list.md)
+ [Visualización de los detalles del grupo de Lente de almacenamiento](storage-lens-groups-view.md)
+ [Eliminación de un grupo de Lente de almacenamiento](storage-lens-groups-delete.md)

# Creación de un grupo de Lente de almacenamiento
<a name="storage-lens-groups-create"></a>

En los siguientes ejemplos se muestra cómo crear un grupo de Lente de almacenamiento de Amazon S3 mediante la consola de Amazon S3, AWS Command Line Interface (AWS CLI) yAWS SDK para Java.

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

**Para crear un grupo 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 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 izquierdo, elija **Grupos de Storage Lens**.

1. Elija **Crear grupo de Lente de almacenamiento**.

1. En **General**, vea la **Región de origen** e introduzca el nombre de su **grupo de lentes de almacenamiento**.

1. En **Ámbito**, elija el filtro que desea aplicar a su grupo de Lente de almacenamiento. Para aplicar varios filtros, elíjalos y, a continuación, elija el operador lógico **AND** u **OR**.
   + Para el filtro **Prefijos**, elija **Prefijos** e introduzca una cadena de prefijos. Para añadir varios prefijos, elija **Agregar prefijo**. Para eliminar un prefijo, elija **Eliminar** que está ubicado junto al prefijo que desea eliminar.
   + Para el filtro **Etiquetas de objetos**, elija **Etiquetas de objeto** e introduzca el par clave-valor del objeto. A continuación, elija **Agregar etiqueta**. Para eliminar una etiqueta, elija **Eliminar** junto a la etiqueta que desee eliminar.
   + Para el filtro **Sufijos**, elija **Sufijos** e introduzca una cadena de sufijos. Para añadir varios sufijos, elija **Agregar sufijo.** Para eliminar un sufijo, elija **Eliminar** que está ubicado junto al sufijo que desea eliminar.
   + Para el filtro **Antigüedad**, especifique el rango de antigüedad de objeto en días. Elija **Especificar la edad mínima del objeto** e introduzca la edad mínima del objeto. A continuación, elija **Especificar la edad máxima del objeto** e introduzca la edad máxima del objeto.
   + Para el filtro **Tamaño**, especifique el rango de tamaño de objeto y la unidad de medida. Elija **Especificar el tamaño mínimo del objeto** e introduzca el tamaño mínimo del objeto. Elija **Especificar el tamaño máximo del objeto** e introduzca el tamaño máximo del objeto.

1. (Opcional) Para las etiquetas de recursos de AWS, añada el par clave-valor y, a continuación, seleccione **Agregar etiqueta**.

1. Seleccione **Crear grupo de Lente de almacenamiento**.

## Uso de AWS CLI
<a name="create-storage-lens-group-cli"></a>

El siguiente comando de AWS CLI de ejemplo crea un grupo de Storage Lens. Para utilizar este comando de ejemplo, sustituya `user input placeholders` por su propia información.

```
aws s3control create-storage-lens-group --account-id 111122223333 \ 
--region us-east-1 --storage-lens-group=file://./marketing-department.json
```

El siguiente comando de ejemplo de AWS CLI crea un grupo de Lente de almacenamiento con dos etiquetas de recursos de AWS. Para utilizar este comando de ejemplo, sustituya `user input placeholders` por su propia información.

```
aws s3control create-storage-lens-group --account-id 111122223333 \ 
--region us-east-1 --storage-lens-group=file://./marketing-department.json \
--tags Key=k1,Value=v1 Key=k2,Value=v2
```

Para ver configuraciones de JSON de ejemplo, consulte [Configuración de grupos de Lente de almacenamiento](storage-lens-groups.md#storage-lens-groups-configuration).

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

El siguiente ejemplo de AWS SDK para Java crea un grupo de Lente de almacenamiento. Para utilizar este ejemplo, sustituya `user input placeholders` por su propia información.

**Example — Crear un grupo de Lente de almacenamiento con un solo filtro**  
El ejemplo siguiente crea un grupo de Storage Lens denominado `Marketing-Department`: Este grupo tiene un filtro de antigüedad de objetos que especifica el rango de antigüedad como de `90` a `30` días. 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 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.CreateStorageLensGroupRequest;
import software.amazon.awssdk.services.s3control.model.MatchObjectAge;
import software.amazon.awssdk.services.s3control.model.StorageLensGroup;
import software.amazon.awssdk.services.s3control.model.StorageLensGroupFilter;
 
public class CreateStorageLensGroupWithObjectAge {
    public static void main(String[] args) {
        String storageLensGroupName = "Marketing-Department";
        String accountId = "111122223333";
        
        try {
            StorageLensGroupFilter objectAgeFilter = StorageLensGroupFilter.builder()
                    .matchObjectAge(MatchObjectAge.builder()
                            .daysGreaterThan(30)
                            .daysLessThan(90)
                            .build())
                    .build();

            StorageLensGroup storageLensGroup = StorageLensGroup.builder()
                    .name(storageLensGroupName)
                    .filter(objectAgeFilter)
                    .build();

            CreateStorageLensGroupRequest createStorageLensGroupRequest = CreateStorageLensGroupRequest.builder()
                    .storageLensGroup(storageLensGroup)
                    .accountId(accountId).build();

            S3ControlClient s3ControlClient = S3ControlClient.builder()
                    .region(Region.US_WEST_2)
                    .credentialsProvider(ProfileCredentialsProvider.create())
                    .build();
            s3ControlClient.createStorageLensGroup(createStorageLensGroupRequest);
        } 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();
        }
    }
}
```

**Example — Crear un grupo de Lente de almacenamiento con un operador `AND` que incluya varios filtros**  
El ejemplo siguiente crea un grupo de Storage Lens denominado `Marketing-Department`: Este grupo usa el operador `AND` para indicar que los objetos deben coincidir con **todas** las condiciones de filtro. 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 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.CreateStorageLensGroupRequest;
import software.amazon.awssdk.services.s3control.model.MatchObjectAge;
import software.amazon.awssdk.services.s3control.model.MatchObjectSize;
import software.amazon.awssdk.services.s3control.model.S3Tag;
import software.amazon.awssdk.services.s3control.model.StorageLensGroup;
import software.amazon.awssdk.services.s3control.model.StorageLensGroupAndOperator;
import software.amazon.awssdk.services.s3control.model.StorageLensGroupFilter;


public class CreateStorageLensGroupWithAndFilter {
    public static void main(String[] args) {
        String storageLensGroupName = "Marketing-Department";
        String accountId = "111122223333";

        try {
            // Create object tags.
            S3Tag tag1 = S3Tag.builder()
                    .key("object-tag-key-1")
                    .value("object-tag-value-1")
                    .build();
            S3Tag tag2 = S3Tag.builder()
                    .key("object-tag-key-2")
                    .value("object-tag-value-2")
                    .build();

            StorageLensGroupAndOperator andOperator = StorageLensGroupAndOperator.builder()
                    .matchAnyPrefix("prefix-1", "prefix-2", "prefix-3/sub-prefix-1")
                    .matchAnySuffix(".png", ".gif", ".jpg")
                    .matchAnyTag(tag1, tag2)
                    .matchObjectAge(MatchObjectAge.builder()
                            .daysGreaterThan(30)
                            .daysLessThan(90).build())
                    .matchObjectSize(MatchObjectSize.builder()
                            .bytesGreaterThan(1000L)
                            .bytesLessThan(6000L).build())
                    .build();

            StorageLensGroupFilter andFilter = StorageLensGroupFilter.builder()
                    .and(andOperator)
                    .build();

            StorageLensGroup storageLensGroup = StorageLensGroup.builder()
                    .name(storageLensGroupName)
                    .filter(andFilter)
                    .build();

            CreateStorageLensGroupRequest createStorageLensGroupRequest = CreateStorageLensGroupRequest.builder()
                    .storageLensGroup(storageLensGroup)
                    .accountId(accountId).build();

            S3ControlClient s3ControlClient = S3ControlClient.builder()
                    .region(Region.US_WEST_2)
                    .credentialsProvider(ProfileCredentialsProvider.create())
                    .build();
            s3ControlClient.createStorageLensGroup(createStorageLensGroupRequest);
        } 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();
        }
    }
}
```

**Example — Crear un grupo de Lente de almacenamiento con un operador `OR` que incluya varios filtros**  
El ejemplo siguiente crea un grupo de Storage Lens denominado `Marketing-Department` Este grupo usa un operador `OR` para aplicar un filtro de prefijo (`prefix-1`, `prefix-2`, `prefix3/sub-prefix-1`) o un filtro de tamaño de objeto con un rango de tamaño entre `1000` bytes y `6000` bytes. 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 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.CreateStorageLensGroupRequest;
import software.amazon.awssdk.services.s3control.model.MatchObjectSize;
import software.amazon.awssdk.services.s3control.model.StorageLensGroup;
import software.amazon.awssdk.services.s3control.model.StorageLensGroupFilter;
import software.amazon.awssdk.services.s3control.model.StorageLensGroupOrOperator;

public class CreateStorageLensGroupWithOrFilter {
    public static void main(String[] args) {
        String storageLensGroupName = "Marketing-Department";
        String accountId = "111122223333";

        try {
            StorageLensGroupOrOperator orOperator = StorageLensGroupOrOperator.builder()
                    .matchAnyPrefix("prefix-1", "prefix-2", "prefix-3/sub-prefix-1")
                    .matchObjectSize(MatchObjectSize.builder()
                            .bytesGreaterThan(1000L)
                            .bytesLessThan(6000L)
                            .build())
                    .build();

            StorageLensGroupFilter orFilter = StorageLensGroupFilter.builder()
                    .or(orOperator)
                    .build();

            StorageLensGroup storageLensGroup = StorageLensGroup.builder()
                    .name(storageLensGroupName)
                    .filter(orFilter)
                    .build();

            CreateStorageLensGroupRequest createStorageLensGroupRequest = CreateStorageLensGroupRequest.builder()
                    .storageLensGroup(storageLensGroup)
                    .accountId(accountId).build();

            S3ControlClient s3ControlClient = S3ControlClient.builder()
                    .region(Region.US_WEST_2)
                    .credentialsProvider(ProfileCredentialsProvider.create())
                    .build();
            s3ControlClient.createStorageLensGroup(createStorageLensGroupRequest);
        } 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();
        }
    }
}
```

**Example — Crear un grupo de Lente de almacenamiento con un solo filtro y dos etiquetas de recursos de AWS**  
En el siguiente ejemplo, se crea un grupo de Lente de almacenamiento denominado `Marketing-Department` que tiene un filtro de sufijo. En este ejemplo también se agregan dos etiquetas de recursos AWS al grupo de Lente de almacenamiento. 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 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.CreateStorageLensGroupRequest;
import software.amazon.awssdk.services.s3control.model.StorageLensGroup;
import software.amazon.awssdk.services.s3control.model.StorageLensGroupFilter;
import software.amazon.awssdk.services.s3control.model.Tag;

public class CreateStorageLensGroupWithResourceTags {
    public static void main(String[] args) {
        String storageLensGroupName = "Marketing-Department";
        String accountId = "111122223333";

        try {
            // Create AWS resource tags.
            Tag resourceTag1 = Tag.builder()
                    .key("resource-tag-key-1")
                    .value("resource-tag-value-1")
                    .build();
            Tag resourceTag2 = Tag.builder()
                    .key("resource-tag-key-2")
                    .value("resource-tag-value-2")
                    .build();

            StorageLensGroupFilter suffixFilter = StorageLensGroupFilter.builder()
                    .matchAnySuffix(".png", ".gif", ".jpg")
                    .build();

            StorageLensGroup storageLensGroup = StorageLensGroup.builder()
                    .name(storageLensGroupName)
                    .filter(suffixFilter)
                    .build();

            CreateStorageLensGroupRequest createStorageLensGroupRequest = CreateStorageLensGroupRequest.builder()
                    .storageLensGroup(storageLensGroup)
                    .tags(resourceTag1, resourceTag2)
                    .accountId(accountId).build();

            S3ControlClient s3ControlClient = S3ControlClient.builder()
                    .region(Region.US_WEST_2)
                    .credentialsProvider(ProfileCredentialsProvider.create())
                    .build();
            s3ControlClient.createStorageLensGroup(createStorageLensGroupRequest);
        } 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 ver configuraciones de JSON de ejemplo, consulte [Configuración de grupos de Lente de almacenamiento](storage-lens-groups.md#storage-lens-groups-configuration).

# Asociación o eliminación de grupos de S3 Lente de almacenamiento a o desde su panel
<a name="storage-lens-groups-dashboard-console"></a>

Una vez que se haya actualizado al nivel avanzado en Lente de almacenamiento de Amazon S3, puede asociar un [grupo de Lente de almacenamiento](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage-lens-groups-overview.html) a su panel. Si tiene varios grupos de Lente de almacenamiento, puede incluir o excluir los grupos que desee. 

Sus grupos de Lente de almacenamiento deben encontrarse en la región de origen designada en la cuenta del panel. Después de asociar un grupo de Lente de almacenamiento a su panel, recibirá los datos adicionales de agregación de grupos de Lente de almacenamiento en su exportación de métricas en un plazo de 48 horas.

**nota**  
Si desea ver las métricas agregadas para su grupo de Lente de almacenamiento, debe asociarlas al panel de Lente de almacenamiento. Para ver ejemplos de los archivos de configuración JSON del grupo de Lente de almacenamiento, consulte [Ejemplo de configuración de S3 Lente de almacenamiento con grupos de Lente de almacenamiento en JSON](S3LensHelperFilesCLI.md#StorageLensGroupsHelperFilesCLI). 

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

**Para asociar un grupo de Lente de almacenamiento 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, en **Storage Lens**, elija **Paneles**.

1. Seleccione el botón de opción del panel de Lente de almacenamiento al que desee asociar un grupo de Lente de almacenamiento.

1. Elija **Edit (Edición de)**.

1. En **Metrics selection** (Selección de métricas), elija **Advanced metrics and recommendations** (Métricas y recomendaciones avanzadas).

1. Seleccione la **Agregación de grupos de Lente de almacenamiento**.
**nota**  
De forma predeterminada, también está seleccionada la opción **Métricas avanzadas**. Sin embargo, también puede anular la selección de esta configuración, ya que no es necesaria para agregar los datos de los grupos de Lente de almacenamiento.

1. Desplácese hasta **Agregación de grupos de Lente de almacenamiento** y especifique el grupo o los grupos de Lente de almacenamiento que desee incluir o excluir en la agregación de datos. Puede utilizar las siguientes opciones de filtrado:
   + Si desea incluir determinados grupos de Lente de almacenamiento, elija **Incluir grupos de Lente de almacenamiento**. En **Grupos de Lente de almacenamiento para incluir**, seleccione sus grupos de Lente de almacenamiento.
   + Si desea incluir todos los grupos de Lente de almacenamiento, seleccione **Incluir todos los grupos de Lente de almacenamiento de la región de origen en esta cuenta**.
   + Si desea excluir determinados grupos de Lente de almacenamiento, elija **Excluir grupos de Lente de almacenamiento**. En **Grupos de Lente de almacenamiento para excluir**, seleccione los grupos de Lente de almacenamiento que desee excluir.

1. Seleccione **Save changes (Guardar cambios)**. Si ha configurado los grupos de Lente de almacenamiento correctamente, verá los datos de agregación de grupo de Lente de almacenamiento adicionales en su panel en un plazo de 48 horas.

**Para eliminar un grupo de Lente de almacenamiento de un panel de S3 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, en **Storage Lens**, elija **Paneles**.

1. Elija el botón de opción del panel de Lente de almacenamiento del que desee eliminar un grupo de Lente de almacenamiento.

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

1. Elija **Edit (Edición de)**.

1. Desplácese hasta la sección **Selección de métricas**.

1. En la sección **Agregación de grupos de Lente de almacenamiento**, elija la **X** situada junto al grupo de Lente de almacenamiento que desee eliminar. De este modo, se elimina el grupo de Lente de almacenamiento.

   Si ha incluido todos los grupos de Lente de almacenamiento en su panel, desactive la casilla situada junto a **Incluir todos los grupos de Lente de almacenamiento de la región de origen en esta cuenta**. 

1. Seleccione **Save changes (Guardar cambios)**.
**nota**  
El panel tardará hasta 48 horas en reflejar las actualizaciones de la configuración.

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

**Example – Asociación de todos los grupos de Lente de almacenamiento a un panel**  
En el siguiente ejemplo de SDK para Java, se asocian todos los grupos de Lente de almacenamiento de la cuenta *111122223333* al panel *DashboardConfigurationID*:  

```
package aws.example.s3control;


import com.amazonaws.AmazonServiceException;
import com.amazonaws.SdkClientException;
import com.amazonaws.services.s3control.AWSS3Control;
import com.amazonaws.services.s3control.AWSS3ControlClient;
import com.amazonaws.services.s3control.model.BucketLevel;
import com.amazonaws.services.s3control.model.PutStorageLensConfigurationRequest;
import com.amazonaws.auth.profile.ProfileCredentialsProvider;
import com.amazonaws.services.s3control.model.AccountLevel;
import com.amazonaws.services.s3control.model.StorageLensConfiguration;
import com.amazonaws.services.s3control.model.StorageLensGroupLevel;

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

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

        try {
            StorageLensGroupLevel storageLensGroupLevel = new StorageLensGroupLevel();

            AccountLevel accountLevel = new AccountLevel()
                    .withBucketLevel(new BucketLevel())
                    .withStorageLensGroupLevel(storageLensGroupLevel);

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

**Example – Asociación de dos grupos de Lente de almacenamiento a un panel**  
En el siguiente ejemplo de AWS SDK para Java, se asocian dos grupos de lentes de almacenamiento (*StorageLensGroupName1* y *StorageLensGroupName2*) al panel *ExampleDashboardConfigurationId*.  

```
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.BucketLevel;
import com.amazonaws.services.s3control.model.PutStorageLensConfigurationRequest;
import com.amazonaws.services.s3control.model.StorageLensConfiguration;
import com.amazonaws.services.s3control.model.StorageLensGroupLevel;
import com.amazonaws.services.s3control.model.StorageLensGroupLevelSelectionCriteria;

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

public class CreateDashboardWith2StorageLensGroups {
    public static void main(String[] args) {
        String configurationId = "ExampleDashboardConfigurationId";
        String storageLensGroupName1 = "StorageLensGroupName1";
        String storageLensGroupName2 = "StorageLensGroupName2";
        String sourceAccountId = "111122223333";

        try {
            StorageLensGroupLevelSelectionCriteria selectionCriteria = new StorageLensGroupLevelSelectionCriteria()
                    .withInclude(
                            "arn:aws:s3:" + US_WEST_2.getName() + ":" + sourceAccountId + ":storage-lens-group/" + storageLensGroupName1,
                            "arn:aws:s3:" + US_WEST_2.getName() + ":" + sourceAccountId + ":storage-lens-group/" + storageLensGroupName2);

            System.out.println(selectionCriteria);
            StorageLensGroupLevel storageLensGroupLevel = new StorageLensGroupLevel()
                    .withSelectionCriteria(selectionCriteria);

            AccountLevel accountLevel = new AccountLevel()
                    .withBucketLevel(new BucketLevel())
                    .withStorageLensGroupLevel(storageLensGroupLevel);

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

**Example – Asociación de todos los grupos de Lente de almacenamiento con exclusiones**  
El siguiente ejemplo de SDK para Java asocia todos los grupos de Lente de almacenamiento al panel *ExampleDashboardConfigurationID*, excepto los dos especificados (*StorageLensGroupName1* y *StorageLensGroupName2*):  

```
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.BucketLevel;
import com.amazonaws.services.s3control.model.PutStorageLensConfigurationRequest;
import com.amazonaws.services.s3control.model.StorageLensConfiguration;
import com.amazonaws.services.s3control.model.StorageLensGroupLevel;
import com.amazonaws.services.s3control.model.StorageLensGroupLevelSelectionCriteria;

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

public class CreateDashboardWith2StorageLensGroupsExcluded {
    public static void main(String[] args) {
        String configurationId = "ExampleDashboardConfigurationId";
        String storageLensGroupName1 = "StorageLensGroupName1";
        String storageLensGroupName2 = "StorageLensGroupName2";
        String sourceAccountId = "111122223333";

        try {
            StorageLensGroupLevelSelectionCriteria selectionCriteria = new StorageLensGroupLevelSelectionCriteria()
                    .withInclude(
                            "arn:aws:s3:" + US_WEST_2.getName() + ":" + sourceAccountId + ":storage-lens-group/" + storageLensGroupName1,
                            "arn:aws:s3:" + US_WEST_2.getName() + ":" + sourceAccountId + ":storage-lens-group/" + storageLensGroupName2);

            System.out.println(selectionCriteria);
            StorageLensGroupLevel storageLensGroupLevel = new StorageLensGroupLevel()
                    .withSelectionCriteria(selectionCriteria);

            AccountLevel accountLevel = new AccountLevel()
                    .withBucketLevel(new BucketLevel())
                    .withStorageLensGroupLevel(storageLensGroupLevel);

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

# Visualización de los datos de grupos de Lente de almacenamiento
<a name="storage-lens-groups-visualize"></a>

Puede visualizar sus datos de grupos de Lente de almacenamiento [asociando el grupo al panel de Lente de almacenamiento de Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage-lens-groups-dashboard-console.html#storage-lens-groups-attach-dashboard-console). Una vez que haya incluido el grupo de Lente de almacenamiento en la agregación de grupos de Lente de almacenamiento de la configuración del panel, pueden pasar hasta 48 horas para que los datos del grupo de Lente de almacenamiento se muestren en su panel.

Una vez actualizada la configuración del panel, todos los grupos de Lente de almacenamiento recién asociados aparecen en la lista de recursos disponibles en la pestaña **Grupos de Lente de almacenamiento**. También puede analizar aún más el uso del almacenamiento en la pestaña **Información general** dividiendo los datos por otra dimensión. Por ejemplo, puede elegir uno de los elementos que figuran en las **3 categorías principales** y, a continuación, **Analizar por** para dividir los datos por otra dimensión. No puede aplicar la misma dimensión que el propio filtro.

**nota**  
No puede aplicar un filtro de grupo de Lente de almacenamiento junto con un filtro de prefijo, ni a la inversa. Tampoco puede analizar aún más un grupo de Lente de almacenamiento mediante un filtro de prefijo.

Puede utilizar la pestaña **Grupos de Lente de almacenamiento** del panel de Lente de almacenamiento de Amazon S3 para personalizar la visualización de los datos de los grupos de Lente de almacenamiento asociados a su panel. Puede visualizar los datos de algunos grupos de Lente de almacenamiento que están asociados a su panel, o todos ellos.

Al visualizar los datos de los grupos de Lente de almacenamiento en el panel de S3 Lente de almacenamiento, tenga en cuenta lo siguiente:
+ S3 Lente de almacenamiento agrega las métricas de uso para un objeto en todos los grupos de Lente de almacenamiento coincidentes. Por lo tanto, si un objeto cumple las condiciones de filtrado de dos o más grupos de Lente de almacenamiento, verá recuentos repetidos para el mismo objeto a lo largo de su uso de almacenamiento.
+ Los objetos deben coincidir con los filtros que incluya en sus grupos de Lente de almacenamiento. Si ningún objeto coincide con los filtros que incluye en su grupo de Lente de almacenamiento, no se generará ninguna métrica. Para determinar si hay objetos sin asignar, compruebe el recuento total de objetos en el panel a nivel de cuenta y de bucket.

# Actualización de un grupo de Lente de almacenamiento
<a name="storage-lens-groups-update"></a>

En los siguientes ejemplos se muestra cómo actualizar un grupo de Lente de almacenamiento de Amazon S3. Puede actualizar un grupo 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="update-storage-lens-group-console"></a>

**Para actualizar un grupo 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, elija **Grupos de Storage Lens**.

1. En **Grupos de Lente de almacenamiento**, elija el grupo de Lente de almacenamiento que desee actualizar.

1. En **Ámbito**, elija **Editar**.

1. En la página **Ámbito**, seleccione el filtro que desee aplicar a su grupo de Lente de almacenamiento. Para aplicar varios filtros, selecciónelos y elija el operador lógico **AND** u **OR**.
   + Para el filtro **Prefijos**, seleccione **Prefijos** e introduzca una cadena de prefijos. Para añadir varios prefijos, elija **Agrgar prefijo**. Para eliminar un prefijo, elija **Eliminar** que está ubicado junto al prefijo que desea eliminar.
   + Para el filtro **Etiquetas de objetos**, introduzca el par clave-valor para el objeto. A continuación, elija **Agregar etiqueta**. Para eliminar una etiqueta, elija **Eliminar** junto a la etiqueta que desee eliminar.
   + Para el filtro **Sufijos**, seleccione **Sufijos** e introduzca una cadena de sufijos. Para añadir varios sufijos, elija **Agregar sufijo.** Para eliminar un sufijo, elija **Eliminar** que está ubicado junto al sufijo que desea eliminar.
   + Para el filtro **Antigüedad**, especifique el rango de antigüedad de objeto en días. Elija **Especificar la edad mínima del objeto** e introduzca la edad mínima del objeto. En **Especificar la edad máxima del objeto**, introduzca la edad máxima del objeto.
   + Para el filtro **Tamaño**, especifique el rango de tamaño de objeto y la unidad de medida. Elija **Especificar el tamaño mínimo del objeto** e introduzca el tamaño mínimo del objeto. En **Especificar el tamaño máximo del objeto**, introduzca el tamaño máximo del objeto.

1. Seleccione **Save changes (Guardar cambios)**. Aparecerá la página de detalles del grupo de Lente de almacenamiento. 

1. (Opcional) Si desea añadir una nueva etiqueta de recurso de AWS, desplácese hasta la sección de **etiquetas de recursos de AWS** y, a continuación, seleccione **Agregar etiquetas**. Aparece la página **Add tags (Agregar etiquetas)**. 

   Agregue el nuevo par clave-valor y, a continuación, elija **Guardar cambios**. Aparecerá la página de detalles del grupo de Lente de almacenamiento.

1. (Opcional) Si desea eliminar una etiqueta de recurso AWS, desplácese hasta la sección de **etiquetas de recursos de AWS** y seleccione la etiqueta de recurso. A continuación, elija **Eliminar**. Aparecerá el cuadro de diálogo **Eliminar etiquetas de AWS**. 

   Vuelva a elegir **Eliminar** para eliminar permanentemente la etiqueta de recurso de AWS.
**nota**  
Después de eliminar permanentemente una etiqueta de recurso de AWS, no se puede restaurar.

## Uso de AWS CLI
<a name="update-storage-lens-group-cli"></a>

El siguiente comando de ejemplo de AWS CLI devuelve los detalles de configuración de un grupo de Lente de almacenamiento denominado `marketing-department`. Para utilizar este comando de ejemplo, sustituya `user input placeholders` por su propia información.



```
aws s3control get-storage-lens-group --account-id 111122223333 \ 
--region us-east-1 --name marketing-department
```

En el siguiente ejemplo de AWS CLI, se actualiza un grupo de Lente de almacenamiento. Para utilizar este comando de ejemplo, sustituya `user input placeholders` por su propia información. 

```
aws s3control update-storage-lens-group --account-id 111122223333 \ 
--region us-east-1 --storage-lens-group=file://./marketing-department.json
```

Para ver configuraciones de JSON de ejemplo, consulte [Configuración de grupos de Lente de almacenamiento](storage-lens-groups.md#storage-lens-groups-configuration).

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

El siguiente ejemplo de AWS SDK para Java devuelve los detalles de configuración del grupo de Lente de almacenamiento `Marketing-Department` de la cuenta `111122223333`. 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 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.GetStorageLensGroupRequest;
import software.amazon.awssdk.services.s3control.model.GetStorageLensGroupResponse;

public class GetStorageLensGroup {
    public static void main(String[] args) {
        String storageLensGroupName = "Marketing-Department";
        String accountId = "111122223333";

        try {
            GetStorageLensGroupRequest getRequest = GetStorageLensGroupRequest.builder()
                    .name(storageLensGroupName)
                    .accountId(accountId).build();
            S3ControlClient s3ControlClient = S3ControlClient.builder()
                    .region(Region.US_WEST_2)
                    .credentialsProvider(ProfileCredentialsProvider.create())
                    .build();
            GetStorageLensGroupResponse response = s3ControlClient.getStorageLensGroup(getRequest);
            System.out.println(response);
        } 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();
        }
    }
}
```

En el siguiente ejemplo, se actualiza el grupo de Lente de almacenamiento denominado `Marketing-Department` en la cuenta `111122223333`. En este ejemplo, se actualiza el ámbito del panel para incluir objetos que coincidan con alguno de los siguientes sufijos: `.png`, `.gif`, `.jpg` o `.jpeg`. 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 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.StorageLensGroup;
import software.amazon.awssdk.services.s3control.model.StorageLensGroupFilter;
import software.amazon.awssdk.services.s3control.model.UpdateStorageLensGroupRequest;

public class UpdateStorageLensGroup {
    public static void main(String[] args) {
        String storageLensGroupName = "Marketing-Department";
        String accountId = "111122223333";

        try {
            // Create updated filter.
            StorageLensGroupFilter suffixFilter = StorageLensGroupFilter.builder()
                    .matchAnySuffix(".png", ".gif", ".jpg", ".jpeg")
                    .build();

            StorageLensGroup storageLensGroup = StorageLensGroup.builder()
                    .name(storageLensGroupName)
                    .filter(suffixFilter)
                    .build();

            UpdateStorageLensGroupRequest updateStorageLensGroupRequest = UpdateStorageLensGroupRequest.builder()
                    .name(storageLensGroupName)
                    .storageLensGroup(storageLensGroup)
                    .accountId(accountId)
                    .build();

            S3ControlClient s3ControlClient = S3ControlClient.builder()
                    .region(Region.US_WEST_2)
                    .credentialsProvider(ProfileCredentialsProvider.create())
                    .build();
            s3ControlClient.updateStorageLensGroup(updateStorageLensGroupRequest);
        } 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 ver configuraciones de JSON de ejemplo, consulte [Configuración de grupos de Lente de almacenamiento](storage-lens-groups.md#storage-lens-groups-configuration).

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

Cada grupo 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 grupo de Lente de almacenamiento, si lo desea, puede añadir etiquetas de recursos de AWS al grupo. Puede añadir un máximo de 50 etiquetas a cada grupo de Lente de almacenamiento. Para crear un grupo de Lente de almacenamiento con etiquetas, debe tener los permisos `s3:CreateStorageLensGroup` y `s3:TagResource`.

Puede usar etiquetas de recursos de AWS para clasificar los recursos por departamento, línea de negocio o proyecto. Esto resulta útil cuando se tienen muchos recursos del mismo tipo. Al aplicar etiquetas, puede identificar rápidamente un grupo de Lente de almacenamiento 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 grupo 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, en este caso, 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 grupos de Lente de almacenamiento.

**Topics**
+ [Adición de una etiqueta de recurso de AWS a un grupo de Lente de almacenamiento](storage-lens-groups-add-tags.md)
+ [Actualización de los valores de las etiquetas de grupo de Lente de almacenamiento](storage-lens-groups-update-tags.md)
+ [Eliminación de una etiqueta de recurso de AWS de un grupo de Lente de almacenamiento](storage-lens-groups-delete-tags.md)
+ [Enumeración de etiquetas de grupo de Lente de almacenamiento](storage-lens-groups-list-tags.md)

# Adición de una etiqueta de recurso de AWS a un grupo de Lente de almacenamiento
<a name="storage-lens-groups-add-tags"></a>

En los siguientes ejemplos se muestra cómo agregar etiquetas de recursos de AWS a un grupo de Lente de almacenamiento de Amazon 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-groups-add-tags-console"></a>

**Para agregar una etiqueta de recurso de AWS a un grupo 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, elija **Grupos de Storage Lens**.

1. En los **Grupos de Lente de almacenamiento**, elija el grupo de Lente de almacenamiento que desee actualizar.

1. En **Etiquetas de recursos de AWS**, elija **Agregar etiquetas**.

1. En la página **Agregar etiquetas**, 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 grupo 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-groups-add-tags-cli"></a>

El siguiente comando de ejemplo de AWS CLI añade dos etiquetas de recursos a un grupo de Lente de almacenamiento existente denominado `marketing-department`. Para utilizar este comando de ejemplo, sustituya `user input placeholders` por su propia información.

```
aws s3control tag-resource --account-id 111122223333 \
--resource-arn arn:aws:s3:us-east-1:111122223333:storage-lens-group/marketing-department \
--region us-east-1 --tags Key=k1,Value=v1 Key=k2,Value=v2
```

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

El siguiente ejemplo de AWS SDK para Java añade dos etiquetas de recursos de AWS a un grupo de Lente de almacenamiento existente. 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 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.Tag;
import software.amazon.awssdk.services.s3control.model.TagResourceRequest;

public class TagResource {
    public static void main(String[] args) {
        String resourceARN = "Resource_ARN";
        String accountId = "111122223333";

        try {
            Tag resourceTag1 = Tag.builder()
                .key("resource-tag-key-1")
                .value("resource-tag-value-1")
                .build();
            Tag resourceTag2 = Tag.builder()
                    .key("resource-tag-key-2")
                    .value("resource-tag-value-2")
                    .build();
            TagResourceRequest tagResourceRequest = TagResourceRequest.builder()
                    .resourceArn(resourceARN)
                    .tags(resourceTag1, resourceTag2)
                    .accountId(accountId)
                    .build();
            S3ControlClient s3ControlClient = S3ControlClient.builder()
                    .region(Region.US_WEST_2)
                    .credentialsProvider(ProfileCredentialsProvider.create())
                    .build();
            s3ControlClient.tagResource(tagResourceRequest);
        } 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 los valores de las etiquetas de grupo de Lente de almacenamiento
<a name="storage-lens-groups-update-tags"></a>

En los siguientes ejemplos se muestra cómo actualizar los valores de las etiquetas de grupo 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-groups-update-tags-console"></a>

**Para actualizar una etiqueta de recursos de AWS para un grupo 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, elija **Grupos de Storage Lens**.

1. En **Grupos de Lente de almacenamiento**, elija el grupo de Lente de almacenamiento que desee actualizar.

1. En las **Etiquetas de recursos de AWS**, selecciona la etiqueta que desee actualizar.

1. Añada el nuevo valor de etiqueta usando la misma clave del par clave-valor que desee actualizar. Haga clic en el icono de marca de verificación para actualizar el valor de la etiqueta.
**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 añadir nuevas etiquetas, elija **Agregar etiqueta** para añadir nuevas entradas. Aparece la página **Add tags (Agregar etiquetas)**. 

   Puede agregar hasta 50 etiquetas de recursos de AWS para su grupo de Lente de almacenamiento. Cuando haya terminado de añadir etiquetas, elija **Guardar cambios**.

1. (Opcional) Si desea eliminar una entrada recién agregada, elija **Eliminar** junto a la etiqueta que desea eliminar. Cuando haya terminado de eliminar etiquetas, elija **Guardar cambios**. 

## Uso de AWS CLI
<a name="storage-lens-groups-update-tags-cli"></a>

El siguiente comando AWS CLI de ejemplo actualiza dos valores de etiqueta para el grupo de Lente de almacenamiento denominado `marketing-department`. Para utilizar este comando de ejemplo, sustituya `user input placeholders` por su propia información.

```
aws s3control tag-resource --account-id 111122223333 \
--resource-arn arn:aws:s3:us-east-1:111122223333:storage-lens-group/marketing-department \
--region us-east-1 --tags Key=k1,Value=v3 Key=k2,Value=v4
```

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

El siguiente ejemplo de AWS SDK para Java actualiza dos valores de etiqueta de grupo de Lente de almacenamiento. 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 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.Tag;
import software.amazon.awssdk.services.s3control.model.TagResourceRequest;

public class UpdateTagsForResource {
    public static void main(String[] args) {
        String resourceARN = "Resource_ARN";
        String accountId = "111122223333";

        try {
            Tag updatedResourceTag1 = Tag.builder()
                .key("resource-tag-key-1")
                .value("resource-tag-updated-value-1")
                .build();
            Tag updatedResourceTag2 = Tag.builder()
                    .key("resource-tag-key-2")
                    .value("resource-tag-updated-value-2")
                    .build();
            TagResourceRequest tagResourceRequest = TagResourceRequest.builder()
                    .resourceArn(resourceARN)
                    .tags(updatedResourceTag1, updatedResourceTag2)
                    .accountId(accountId)
                    .build();
            S3ControlClient s3ControlClient = S3ControlClient.builder()
                    .region(Region.US_WEST_2)
                    .credentialsProvider(ProfileCredentialsProvider.create())
                    .build();
            s3ControlClient.tagResource(tagResourceRequest);
        } 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 una etiqueta de recurso de AWS de un grupo de Lente de almacenamiento
<a name="storage-lens-groups-delete-tags"></a>

En los siguientes ejemplos se muestra cómo eliminar una etiqueta de recurso de AWS de un grupo de Lente de almacenamiento. 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>

**Para eliminar una etiqueta de recurso de AWS de un grupo 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, elija **Grupos de Storage Lens**.

1. En **Grupos de Lente de almacenamiento**, elija el grupo de Lente de almacenamiento que desea actualizar.

1. En **Etiquetas de recursos de AWS**, seleccione el par clave-valor que desea eliminar.

1. Elija **Eliminar**. Aparece el cuadro de diálogo **Eliminar etiquetas de recursos de AWS**.
**nota**  
Si se utilizan etiquetas para controlar el acceso, continuar con esta acción puede afectar a los recursos relacionados. Después de eliminar una etiqueta de forma permanente, no se puede restaurar.

1. Elija **Eliminar** para eliminar el par clave-valor de forma permanente.

## Uso de AWS CLI
<a name="storage-lens-groups-delete-tags-cli"></a>

El siguiente comando de AWS CLI elimina dos etiquetas de recursos de AWS de un grupo de Lente de almacenamiento existente: para usar este comando de ejemplo, reemplace los `user input placeholders` por su propia información.

```
aws s3control untag-resource --account-id 111122223333 \
--resource-arn arn:aws:s3:us-east-1:111122223333:storage-lens-group/Marketing-Department \
--region us-east-1 --tag-keys k1 k2
```

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

El siguiente ejemplo de AWS SDK para Java elimina dos etiquetas de recursos de AWS del Nombre de Recurso de Amazon (ARN) del grupo de Lente de almacenamiento que especifica en la cuenta `111122223333`. 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 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.UntagResourceRequest;

public class UntagResource {
    public static void main(String[] args) {
        String resourceARN = "Resource_ARN";
        String accountId = "111122223333";

        try {
            String tagKey1 = "resource-tag-key-1";
            String tagKey2 = "resource-tag-key-2";
            UntagResourceRequest untagResourceRequest = UntagResourceRequest.builder()
                    .resourceArn(resourceARN)
                    .tagKeys(tagKey1, tagKey2)
                    .accountId(accountId)
                    .build();
            S3ControlClient s3ControlClient = S3ControlClient.builder()
                    .region(Region.US_WEST_2)
                    .credentialsProvider(ProfileCredentialsProvider.create())
                    .build();
            s3ControlClient.untagResource(untagResourceRequest);
        } 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();
        }
    }
}
```

# Enumeración de etiquetas de grupo de Lente de almacenamiento
<a name="storage-lens-groups-list-tags"></a>

En los siguientes ejemplos se muestra cómo enumerar las etiquetas de recursos de AWS asociadas a un grupo de Lente de almacenamiento. Puede enumerar 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-list-tags-console"></a>

**Para revisar la lista de etiquetas y los valores de las etiquetas de un grupo 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, elija **Grupos de Storage Lens**.

1. En **Grupos de Lente de almacenamiento**, elija el grupo de Lente de almacenamiento que le interesa.

1. Desplácese hasta la sección **Etiquetas de recursos de AWS**. Todas las etiquetas de recursos de AWS definidas por el usuario que se añaden a su grupo de Lente de almacenamiento aparecen junto con sus valores de etiqueta.

## Uso de AWS CLI
<a name="storage-lens-group-list-tags-cli"></a>

El siguiente comando de ejemplo de AWS CLI muestra todos los valores de etiqueta de grupo de Lente de almacenamiento del grupo Lente de almacenamiento denominado `marketing-department`. Para utilizar este comando de ejemplo, sustituya `user input placeholders` por su propia información.

```
aws s3control list-tags-for-resource --account-id 111122223333 \
--resource-arn arn:aws:s3:us-east-1:111122223333:storage-lens-group/marketing-department \
--region us-east-1
```

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

En el siguiente ejemplo de AWS SDK para Java se muestran los valores de etiqueta de grupo de Lente de almacenamiento para el nombre de recurso de Amazon (ARN) del grupo Lente de almacenamiento que especifique. 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 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.ListTagsForResourceRequest;
import software.amazon.awssdk.services.s3control.model.ListTagsForResourceResponse;

public class ListTagsForResource {
    public static void main(String[] args) {
        String resourceARN = "Resource_ARN";
        String accountId = "111122223333";

        try {
            ListTagsForResourceRequest listTagsForResourceRequest = ListTagsForResourceRequest.builder()
                    .resourceArn(resourceARN)
                    .accountId(accountId)
                    .build();
            S3ControlClient s3ControlClient = S3ControlClient.builder()
                    .region(Region.US_WEST_2)
                    .credentialsProvider(ProfileCredentialsProvider.create())
                    .build();
            ListTagsForResourceResponse response = s3ControlClient.listTagsForResource(listTagsForResourceRequest);
            System.out.println(response);
        } 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();
        }
    }
}
```

# Enumeración de todos los grupos de Lente de almacenamiento
<a name="storage-lens-groups-list"></a>

En los ejemplos siguientes, se muestra cómo enumerar todos los grupos de Lente de almacenamiento de Amazon S3 de una Cuenta de AWS y una región de origen. En estos ejemplos se muestra cómo enumerar todos los grupos de Lente de almacenamiento mediante la consola de Amazon S3, AWS Command Line Interface (AWS CLI) yAWS SDK para Java.

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

**Para enumerar todos los grupos de Lente de almacenamiento en una cuenta y región de origen**

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 **Grupos de Storage Lens**.

1. En **Grupos de Lente de almacenamiento**, se muestra la lista de grupos de Lente de almacenamiento de su cuenta.

## Uso de AWS CLI
<a name="storage-lens-groups-list-cli"></a>

El siguiente ejemplo de AWS CLI muestra todos los grupos de Lente de almacenamiento para su cuenta. Para utilizar este comando de ejemplo, sustituya `user input placeholders` por su propia información.

```
aws s3control list-storage-lens-groups --account-id 111122223333 \
--region us-east-1
```

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

El siguiente ejemplo de AWS SDK para Java muestra los grupos de Lente de almacenamiento para la cuenta `111122223333`. 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 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.ListStorageLensGroupsRequest;
import software.amazon.awssdk.services.s3control.model.ListStorageLensGroupsResponse;

public class ListStorageLensGroups {
    public static void main(String[] args) {
        String accountId = "111122223333";

        try {
            ListStorageLensGroupsRequest listStorageLensGroupsRequest = ListStorageLensGroupsRequest.builder()
                    .accountId(accountId)
                    .build();
            S3ControlClient s3ControlClient = S3ControlClient.builder()
                    .region(Region.US_WEST_2)
                    .credentialsProvider(ProfileCredentialsProvider.create())
                    .build();
            ListStorageLensGroupsResponse response = s3ControlClient.listStorageLensGroups(listStorageLensGroupsRequest);
            System.out.println(response);
        } 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 del grupo de Lente de almacenamiento
<a name="storage-lens-groups-view"></a>

En los siguientes ejemplos se muestra cómo ver los detalles de configuración del grupo de Lente de almacenamiento de Amazon S3. Puede ver estos detalles 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="view-storage-lens-group-console"></a>



**Para ver los detalles de configuración del grupo 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, elija **Grupos de Storage Lens**.

1. En los **Grupos de Lente de almacenamiento**, elija el botón de opción situado junto al grupo de Lente de almacenamiento que le interese.

1. Elija **Ver detalles**. Ahora puede revisar los detalles de su grupo de Lente de almacenamiento.

## Uso de AWS CLI
<a name="view-storage-lens-group-cli"></a>

El siguiente ejemplo de AWS CLI devuelve los detalles de configuración de un grupo de Lente de almacenamiento. Para utilizar este comando de ejemplo, sustituya `user input placeholders` por su propia información.

```
aws s3control get-storage-lens-group --account-id 111122223333 \ 
--region us-east-1 --name marketing-department
```

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

El siguiente ejemplo de AWS SDK para Java devuelve los detalles de configuración del grupo de Lente de almacenamiento denominado `Marketing-Department` en la cuenta `111122223333`. 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 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.GetStorageLensGroupRequest;
import software.amazon.awssdk.services.s3control.model.GetStorageLensGroupResponse;

public class GetStorageLensGroup {
    public static void main(String[] args) {
        String storageLensGroupName = "Marketing-Department";
        String accountId = "111122223333";

        try {
            GetStorageLensGroupRequest getRequest = GetStorageLensGroupRequest.builder()
                    .name(storageLensGroupName)
                    .accountId(accountId).build();
            S3ControlClient s3ControlClient = S3ControlClient.builder()
                    .region(Region.US_WEST_2)
                    .credentialsProvider(ProfileCredentialsProvider.create())
                    .build();
            GetStorageLensGroupResponse response = s3ControlClient.getStorageLensGroup(getRequest);
            System.out.println(response);
        } 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 un grupo de Lente de almacenamiento
<a name="storage-lens-groups-delete"></a>

En los siguientes ejemplos se muestra cómo eliminar un grupo de Lente de almacenamiento de Amazon S3 mediante la consola de Amazon S3, AWS Command Line Interface (AWS CLI) yAWS SDK para Java.

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

**Para eliminar un grupo 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, elija **Grupos de Storage Lens**.

1. En **Grupos de Lente de almacenamiento**, elija el botón de opción situado junto al grupo de Lente de almacenamiento que desea eliminar.

1. Elija **Eliminar**. Aparece un cuadro de diálogo **Eliminar grupo de Lente de almacenamiento**.

1. Vuelva a elegir **Eliminar** para eliminar permanentemente su grupo de Lente de almacenamiento.
**nota**  
Después de eliminar un grupo de Lente de almacenamiento, no se puede restaurar.

## Uso de AWS CLI
<a name="delete-storage-lens-group-cli"></a>

El siguiente ejemplo de AWS CLI elimina el grupo de Lente de almacenamiento denominado `marketing-department`. Para utilizar este comando de ejemplo, sustituya `user input placeholders` por su propia información.

```
aws s3control delete-storage-lens-group --account-id 111122223333 \ 
--region us-east-1 --name marketing-department
```

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

El siguiente ejemplo de AWS SDK para Java elimina el grupo de Lente de almacenamiento denominado `Marketing-Department` en la cuenta `111122223333`. 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 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.DeleteStorageLensGroupRequest;

public class DeleteStorageLensGroup {
    public static void main(String[] args) {
        String storageLensGroupName = "Marketing-Department";
        String accountId = "111122223333";

        try {
            DeleteStorageLensGroupRequest deleteStorageLensGroupRequest = DeleteStorageLensGroupRequest.builder()
                    .name(storageLensGroupName)
                    .accountId(accountId).build();
            S3ControlClient s3ControlClient = S3ControlClient.builder()
                    .region(Region.US_WEST_2)
                    .credentialsProvider(ProfileCredentialsProvider.create())
                    .build();
            s3ControlClient.deleteStorageLensGroup(deleteStorageLensGroupRequest);
        } 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();
        }
    }
}
```