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