# Anexar ao painel ou remover do painel grupos da Lente de Armazenamento do S3
<a name="storage-lens-groups-dashboard-console"></a>

Depois de atualizar para o nível avançado na Lente de Armazenamento do Amazon S3, você poderá anexar um [grupo da Lente de Armazenamento](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage-lens-groups-overview.html) ao seu painel. Se você tiver vários grupos da Lente de Armazenamento, poderá incluir ou excluir os grupos desejados. 

Seus grupos da Lente de Armazenamento devem residir na região inicial designada na conta do painel. Depois de anexar um grupo da Lente de Armazenamento ao painel, você receberá os dados adicionais de agregação do grupo da Lente de Armazenamento na exportação de métricas em até 48 horas.

**nota**  
Para visualizar métricas agregadas ao grupo da Lente de Armazenamento, você deve anexá-las ao painel da Lente de Armazenamento. Para obter exemplos de arquivos de configuração JSON do grupo da Lente de Armazenamento, consulte [Exemplo de configuração da Lente de Armazenamento do S3 com grupos da Lente de Armazenamento em JSON](S3LensHelperFilesCLI.md#StorageLensGroupsHelperFilesCLI). 

## Usar o console do S3
<a name="storage-lens-groups-attach-dashboard-console"></a>

**Para anexar um grupo da Lente de Armazenamento a um painel da Lente de Armazenamento**

1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon S3 em [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

1. No painel de navegação à esquerda, em **Lente de Armazenamento**, selecione **Painéis**.

1. Selecione botão de opção para o painel da Lente de Armazenamento ao qual você deseja anexar um grupo da Lente de Armazenamento.

1. Escolha **Editar**.

1. Em **Seleção de métricas**, escolha **Métricas e recomendações avançadas**.

1. Selecione a opção **Agregação do grupo da Lente de Armazenamento**.
**nota**  
Por padrão, a opção **Métricas avançadas** também é selecionada. No entanto, você também pode desmarcar essa configuração, pois ela não é necessária para agregar dados de grupos da Lente de Armazenamento.

1. Role para baixo até **Agregação do grupo da Lente de Armazenamento** e especifique o grupo ou grupos da Lente de Armazenamento que você deseja incluir ou excluir na agregação de dados. Você pode usar as seguintes opções de filtro:
   + Para incluir determinados grupos da Lente de Armazenamento, escolha **Incluir grupos da Lente de Armazenamento**. Em **Grupos da Lente de Armazenamento a serem incluídos**, selecione seus grupos da Lente de Armazenamento.
   + Para incluir todos os grupos da Lente de Armazenamento, selecione **Incluir todos os grupos da Lente de Armazenamento na região de origem nesta conta**.
   + Para excluir determinados grupos da Lente de Armazenamento, selecione **Excluir grupos da Lente de Armazenamento**. Em **Grupos da Lente de Armazenamento a serem excluídos**, selecione os grupos da Lente de Armazenamento que você deseja excluir.

1. Escolha **Salvar alterações**. Se tiver configurado seus grupos da Lente de Armazenamento corretamente, você verá os dados adicionais de agregação do grupo da Lente de Armazenamento em seu painel dentro de 48 horas.

**Como remover um grupo da Lente de Armazenamento de um painel da Lente de Armazenamento do S3**

1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon S3 em [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).

1. No painel de navegação à esquerda, em **Lente de Armazenamento**, selecione **Painéis**.

1. Selecione o botão de opção para o painel da Lente de Armazenamento do qual você deseja remover um grupo da Lente de Armazenamento.

1. Selecione **Exibir configuração do painel**.

1. Escolha **Editar**.

1. Role para baixo até a seção **Seleção de métricas**.

1. Em **Agregação de grupo da Lente de Armazenamento**, selecione o **X** ao lado do grupo da Lente de Armazenamento que você deseja remover. Isso remove o grupo da Lente de Armazenamento.

   Se você tiver incluído todos os grupos da Lente de Armazenamento em seu painel, desmarque a caixa de seleção ao lado de **Incluir todos os grupos da Lente de Armazenamento na região inicial nesta conta**. 

1. Escolha **Salvar alterações**.
**nota**  
Levará até 48 horas para que seu painel mostre as atualizações de configuração.

## Usar o AWS SDK para Java
<a name="StorageLensGroupsConfigurationJava"></a>

**Example – Anexar todos os grupos da Lente de Armazenamento a um painel**  
O exemplo de SDK para Java a seguir anexa todos os grupos da Lente de Armazenamento na conta *111122223333* ao painel *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 – Anexar dois grupos da Lente de Armazenamento a um painel**  
O exemplo do AWS SDK para Java a seguir anexa dois grupos da Lente de Armazenamento (*StorageLensGroupName1* e *StorageLensGroupName2*) ao painel *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 – Anexar todos os grupos da Lente de Armazenamento com exclusões**  
O exemplo de SDK para Java a seguir anexa todos os grupos da Lente de Armazenamento ao painel *ExampleDashboardConfigurationId*, exceto os dois especificados (*StorageLensGroupName1* e *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();
        }
    }
}
```