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

A Lente de Armazenamento do Amazon S3 agrega métricas usando filtros personalizados com base nos metadados do objeto. Você pode analisar e filtrar as métricas da Lente de Armazenamento do S3 usando prefixos, sufixos, tags de objetos, tamanho do objeto ou idade do objeto. Com grupos da Lente de Armazenamento do Amazon S3, você também pode categorizar seu uso dentro de buckets e por meio deles no Amazon S3. Consequentemente, você poderá entender e otimizar melhor o armazenamento S3.

Para começar a visualizar os dados de um grupo da Lente de Armazenamento, você deve primeiro [anexar o grupo da Lente de Armazenamento a um painel da Lente de Armazenamento do S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage-lens-groups-dashboard-console.html#storage-lens-groups-attach-dashboard-console). Se precisar gerenciar grupos da Lente de Armazenamento no painel, edite a configuração do painel. Para verificar quais grupos da Lente de Armazenamento estão na sua conta, você pode listá-los. Para verificar quais grupos da Lente de Armazenamento estão anexados ao seu painel, verifique a guia **Grupos da Lente de Armazenamento** no painel. Para revisar ou atualizar o escopo de um grupo da Lente de Armazenamento existente, visualize os detalhes. Você também pode excluir permanentemente um grupo da Lente de Armazenamento.

Para gerenciar permissões, você pode criar e adicionar tags de recursos AWS definidas pelo usuário aos seus grupos da Lente de Armazenamento. Use tags de recursos AWS para categorizar os recursos de acordo com o departamento, a linha de negócios ou o projeto. Fazer isso é útil quando você tem muitos recursos do mesmo tipo. Ao aplicar tags, é possível identificar rapidamente um grupo específico da Lente de Armazenamento com base nas tags atribuídas a ele. 

Além disso, ao adicionar uma tag de recursos AWS ao grupo da Lente de Armazenamento, você ativa o [controle de acesso por atributo (ABAC)](https://docs.aws.amazon.com/IAM/latest/UserGuide/introduction_attribute-based-access-control.html). ABAC é uma estratégia de autorização que define permissões com base em atributos, neste caso, tags. É possível usar condições que especificam tags de recursos nas políticas do IAM para [controlar o acesso aos recursos AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html#access_tags_control-resources).

**Topics**
+ [Criação de grupo da Lente de Armazenamento](storage-lens-groups-create.md)
+ [Anexar ao painel ou remover do painel grupos da Lente de Armazenamento do S3](storage-lens-groups-dashboard-console.md)
+ [Visualização de dados dos grupos da Lente de Armazenamento](storage-lens-groups-visualize.md)
+ [Atualização do grupo da Lente de Armazenamento](storage-lens-groups-update.md)
+ [Gerenciamento de tags de recursos AWS com grupos da Lente de Armazenamento](storage-lens-groups-manage-tags.md)
+ [Listagem de todos os grupos da Lente de Armazenamento](storage-lens-groups-list.md)
+ [Visualização de detalhes do grupo da Lente de Armazenamento](storage-lens-groups-view.md)
+ [Exclusão de grupo da Lente de Armazenamento](storage-lens-groups-delete.md)

# Criação de grupo da Lente de Armazenamento
<a name="storage-lens-groups-create"></a>

Os exemplos a seguir demonstram como criar um grupo da Lente de Armazenamento do Amazon S3 usando o console do Amazon S3AWS Command Line Interface, (AWS CLI) e AWS SDK para Java.

## Usar o console do S3
<a name="create-storage-lens-group-console"></a>

**Para criar um grupo 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. Na barra de navegação na parte superior da página, escolha o nome da região da AWS exibida no momento. Em seguida, escolha a região para a qual você deseja mudar. 

1. No painel de navegação à esquerda, selecione **Grupos de Lente de Armazenamento**.

1. Selecione **Criar grupo da Lente de Armazenamento**.

1. Em **Geral**, visualize sua **Região de origem** e insira o **Nome do grupo do Storage Lens**.

1. Em **Escopo**, selecione o filtro para aplicar ao seu grupo da Lente de Armazenamento. Para aplicar vários filtros, selecione os filtros e, em seguida, escolha o operador lógico **AND** ou **OR**.
   + Para o filtro **Prefixos**, selecione **Prefixos** e insira uma sequência de prefixo. Para adicionar vários prefixos, selecione **Adicionar prefixo**. Para remover um prefixo, selecione **Remover** ao lado do prefixo para remover.
   + Para o filtro **Tags de objeto**, selecione **Tags de objeto** e insira o par de valores-chave para seu objeto. Selecione **Adicionar tag**. Para remover uma tag, selecione **Remover** ao lado da tag para remover.
   + Para o filtro **Sufixos**, selecione **Sufixos** e insira uma sequência de sufixo. Para adicionar vários sufixos, selecione **Adicionar sufixo**. Para remover um sufixo, selecione **Remover** ao lado do sufixo para remover.
   + Para o filtro **Idade**, especifique a faixa etária do objeto em dias. Selecione **Especificar idade mínima do objeto** e insira a idade mínima do objeto. Em seguida, selecione **Especificar idade máxima do objeto** e insira a idade máxima do objeto.
   + Para o filtro **Tamanho**, especifique a faixa de tamanho do objeto e a unidade de medida. Selecione **Especificar tamanho mínimo do objeto** e insira o tamanho mínimo do objeto. Selecione **Especificar tamanho máximo do objeto** e insira o tamanho máximo do objeto.

1. (Opcional) Para tags de recursos AWS, adicione o par de valores-chave e selecione **Adicionar tag**.

1. Selecione **Criar grupo da Lente de Armazenamento**.

## Como usar o AWS CLI
<a name="create-storage-lens-group-cli"></a>

O comando de exemplo AWS CLI a seguir cria um grupo de Lente de Armazenamento. Para usar esse exemplo de comando, substitua os `user input placeholders` por suas próprias informações.

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

O comando de exemplo AWS CLI a seguir cria um grupo da Lente de Armazenamento com duas tags de recursos AWS. Para usar esse exemplo de comando, substitua os `user input placeholders` por suas próprias informações.

```
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 obter configurações de exemplo JSON, consulte [Configuração de grupos da Lente de Armazenamento](storage-lens-groups.md#storage-lens-groups-configuration).

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

O exemplo AWS SDK para Java a seguir cria um grupo da Lente de Armazenamento Para usar esse exemplo, substitua os `user input placeholders` por suas próprias informações.

**Example — Crie um grupo da Lente de Armazenamento com um único filtro**  
O exemplo a seguir cria um grupo de Lente de Armazenamento chamado `Marketing-Department`. Esse grupo tem um filtro de idade do objeto que especifica a faixa etária em `30` para `90` dias. Para usar esse exemplo, substitua os `user input placeholders` por suas próprias informações.  

```
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 — Crie um grupo da Lente de Armazenamento com um operador `AND` que inclua vários filtros**  
O exemplo a seguir cria um grupo de Lente de Armazenamento chamado `Marketing-Department`. Este grupo utiliza o operador `AND` para indicar que os objetos devem corresponder a **todas** as condições de filtro. Para usar esse exemplo, substitua os `user input placeholders` por suas próprias informações.   

```
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 — Crie um grupo da Lente de Armazenamento com um operador `OR` que inclua vários filtros**  
O exemplo a seguir cria um grupo de Lente de Armazenamento chamado `Marketing-Department`. Este grupo usa um operador `OR` para aplicar um filtro de prefixo (`prefix-1`, `prefix-2`, `prefix3/sub-prefix-1`) ou um filtro de tamanho de objeto com intervalo de tamanho entre `1000` bytes e `6000` bytes. Para usar esse exemplo, substitua os `user input placeholders` por suas próprias informações.  

```
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 – Crie um grupo da Lente de Armazenamento com um único filtro e duas tags de recursos AWS**  
O exemplo a seguir cria um grupo da Lente de Armazenamento chamado `Marketing-Department`, que tem um filtro de sufixo. Este exemplo também adiciona duas tags de recursos AWS ao grupo da Lente de Armazenamento. Para usar esse exemplo, substitua os `user input placeholders` por suas próprias informações.  

```
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 obter configurações de exemplo JSON, consulte [Configuração de grupos da Lente de Armazenamento](storage-lens-groups.md#storage-lens-groups-configuration).

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

# Visualização de dados dos grupos da Lente de Armazenamento
<a name="storage-lens-groups-visualize"></a>

Visualize os dados dos grupos da Lente de Armazenamento [anexando o grupo ao painel da Lente de Armazenamento do Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage-lens-groups-dashboard-console.html#storage-lens-groups-attach-dashboard-console). Depois de incluir o grupo da Lente de Armazenamento na agregação do grupo na configuração do painel, pode levar até 48 horas para que os dados do grupo da Lente de Armazenamento sejam exibidos no painel.

Depois que a configuração do painel for atualizada, todos os grupos da Lente de Armazenamento recém-anexados aparecerão na lista de recursos disponíveis, na guia **Grupos da Lente de Armazenamento**. Você também pode analisar melhor o uso do armazenamento na guia **Visão geral**. É só dividir os dados em outra dimensão. Por exemplo, você pode selecionar um dos itens listados nas **três principais** categorias e escolher **Analisar por** para dividir os dados em outra dimensão. Não é possível aplicar a mesma dimensão do próprio filtro.

**nota**  
Não é possível aplicar um filtro de grupo e Lente de Armazenamento junto com um filtro de prefixo e vice-versa. Você também não pode analisar de maneira mais aprofundada um grupo da Lente de Armazenamento usando um filtro de prefixo.

Você pode usar a guia **Grupos da Lente de Armazenamento** no painel da Lente de Armazenamento do Amazon S3 para personalizar a visualização de dados para os grupos da Lente de Armazenamento anexados ao seu painel. Você pode visualizar os dados de alguns grupos da Lente de Armazenamento que estão anexados ao seu painel ou de todos eles.

Ao visualizar os dados do grupo da Lente de Armazenamento no painel da Lente de Armazenamento do S3, esteja ciente do seguinte:
+ A Lente de Armazenamento do S3 agrega métricas de uso de um objeto em todos os grupos da Lente de Armazenamento correspondentes. Portanto, se um objeto corresponder às condições de filtro de dois ou mais grupos da Lente de Armazenamento, você verá contagens repetidas do mesmo objeto em todo o uso do armazenamento.
+ Os objetos devem corresponder aos filtros incluídos nos grupos da Lente de Armazenamento. Se nenhum objeto corresponder aos filtros incluídos no grupo da Lente de Armazenamento, nenhuma métrica será gerada. Para determinar se há objetos não atribuídos, verifique a contagem total de objetos no painel no nível da conta e do bucket.

# Atualização do grupo da Lente de Armazenamento
<a name="storage-lens-groups-update"></a>

Os exemplos a seguir demonstram como atualizar um grupo da Lente de Armazenamento do Amazon S3. Você pode atualizar um grupo da Lente de Armazenamento usando o console Amazon S3, AWS Command Line Interface (AWS CLI) e AWS SDK para Java.

## Usar o console do S3
<a name="update-storage-lens-group-console"></a>

**Para atualizar um grupo 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, selecione **Grupos de Lente de Armazenamento**.

1. Em **Grupos da Lente de Armazenamento**, selecione o grupo a ser atualizado.

1. Em **Escopo**, selecione **Editar**.

1. Na página **Escopo**, selecione o filtro a ser aplicado no grupo da Lente de Armazenamento. Para aplicar vários filtros, selecione os filtros e escolha o operador lógico **AND** ou **OR**.
   + Para o filtro **Prefixos**, selecione **Prefixos** e insira uma sequência de prefixo. Para adicionar vários prefixos, selecione **Adicionar prefixo**. Para remover um prefixo, selecione **Remover** ao lado do prefixo para remover.
   + Para o filtro **Tags de objeto**, insira o par de valores-chave ao objeto. Selecione **Adicionar tag**. Para remover uma tag, selecione **Remover** ao lado da tag para remover.
   + Para o filtro **Sufixos**, selecione **Sufixos** e insira uma sequência de sufixo. Para adicionar vários sufixos, selecione **Adicionar sufixo**. Para remover um sufixo, selecione **Remover** ao lado do sufixo para remover.
   + Para o filtro **Idade**, especifique a faixa etária do objeto em dias. Selecione **Especificar idade mínima do objeto** e insira a idade mínima do objeto. Em **Especificar idade máxima do objeto**, insira a idade máxima do objeto.
   + Para o filtro **Tamanho**, especifique a faixa de tamanho do objeto e a unidade de medida. Selecione **Especificar tamanho mínimo do objeto** e insira o tamanho mínimo do objeto. Em **Especificar tamanho máximo do objeto**, insira o tamanho máximo do objeto.

1. Escolha **Salvar alterações**. A página de detalhes do grupo da Lente de Armazenamento é exibida. 

1. (Opcional) Para adicionar uma nova tag de recursos AWS, acesse a seção **Tags de recursos AWS** e selecione **Adicionar tags**. A página **Adicionar tags** é exibida. 

   Adicione o novo par de valores-chave e selecione **Salvar alterações**. A página de detalhes do grupo da Lente de Armazenamento é exibida.

1. (Opcional) Para remover uma tag de recursos existente AWS, acesse a seção **Tags de recurso AWS** e selecione a tag de recursos. Em seguida, selecione **Excluir**. A caixa de diálogo **Excluir tags AWS** é exibida. 

   Selecione **Excluir** novamente para excluir permanentemente a tag de recursos AWS.
**nota**  
Depois de excluir permanentemente uma tag de recursos AWS, ela não poderá ser restaurada.

## Como usar o AWS CLI
<a name="update-storage-lens-group-cli"></a>

O comando de exemplo AWS CLI a seguir mostra os detalhes da configuração de um grupo da Lente de Armazenamento `marketing-department`. Para usar esse exemplo de comando, substitua os `user input placeholders` por suas próprias informações.



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

O exemplo AWS CLI a seguir atualiza um grupo da Lente de Armazenamento. Para usar esse exemplo de comando, substitua os `user input placeholders` por suas próprias informações. 

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

Para obter configurações de exemplo JSON, consulte [Configuração de grupos da Lente de Armazenamento](storage-lens-groups.md#storage-lens-groups-configuration).

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

O exemplo AWS SDK para Java a seguir mostra os detalhes da configuração do grupo da Lente de Armazenamento `Marketing-Department` na conta `111122223333`. Para usar esse exemplo, substitua os `user input placeholders` por suas próprias informações.

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

O exemplo a seguir atualiza o grupo da Lente de Armazenamento `Marketing-Department` na conta `111122223333`. Esse exemplo atualiza o escopo do painel para incluir objetos que correspondam a qualquer um dos seguintes sufixos: `.png`, `.gif`, `.jpg` ou `.jpeg`. Para usar esse exemplo, substitua os `user input placeholders` por suas próprias informações.

```
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 obter configurações de exemplo JSON, consulte [Configuração de grupos da Lente de Armazenamento](storage-lens-groups.md#storage-lens-groups-configuration).

# Gerenciamento de tags de recursos AWS com grupos da Lente de Armazenamento
<a name="storage-lens-groups-manage-tags"></a>

Cada grupo da Lente de Armazenamento do Amazon S3 é contado como um recurso AWS com o próprio nome do recurso da Amazon (ARN). Portanto, ao configurar o grupo da Lente de Armazenamento, você tem a opção de adicionar tags de recursos AWS ao grupo. Você pode adicionar até 50 tags para cada grupo da Lente de Armazenamento. Para criar um grupo da Lente de Armazenamento com tags, você deve ter as permissões `s3:CreateStorageLensGroup` e `s3:TagResource`.

Use tags de recursos AWS para categorizar os recursos de acordo com o departamento, a linha de negócios ou o projeto. Fazer isso é útil quando você tem muitos recursos do mesmo tipo. Ao aplicar tags, é possível identificar rapidamente um grupo específico da Lente de Armazenamento com base nas tags atribuídas a ele. Você também pode usar tags para rastrear e alocar custos.

Além disso, ao adicionar uma tag de recursos AWS ao grupo da Lente de Armazenamento, você ativa o [controle de acesso por atributo (ABAC)](https://docs.aws.amazon.com/IAM/latest/UserGuide/introduction_attribute-based-access-control.html). ABAC é uma estratégia de autorização que define permissões com base em atributos, neste caso, tags. É possível usar condições que especificam tags de recursos nas políticas do IAM para [controlar o acesso aos recursos AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html#access_tags_control-resources).

É possível editar chaves de tags e valores e é possível remover as tags de um recurso a qualquer momento. Além disso, esteja ciente das seguintes limitações:
+ As chaves e os valores das tags diferenciam maiúsculas de minúsculas.
+ Ao adicionar uma tag que tenha a mesma chave de uma tag existente nesse recurso, o novo valor substituirá o antigo.
+ Se você excluir um recurso, todas as tags do recurso também serão excluídas. 
+ Não inclua dados privados ou confidenciais nas tags de recursos AWS.
+ As tags do sistema (com chaves de tags que começam com `aws:`) não são compatíveis.
+ O comprimento de cada chave de tag não pode exceder 128 caracteres. O comprimento de cada valor de tag não pode exceder 256 caracteres.

Os exemplos a seguir demonstram como usar tags de recursos AWS com grupos da Lente de Armazenamento.

**Topics**
+ [Adicionar tag de recursos AWS a um grupo da Lente de Armazenamento](storage-lens-groups-add-tags.md)
+ [Atualização dos valores das tags de grupo da Lente de Armazenamento](storage-lens-groups-update-tags.md)
+ [Exclusão de tag de recursos AWS do grupo da Lente de Armazenamento](storage-lens-groups-delete-tags.md)
+ [Listagem de tags de grupo da Lente de Armazenamento](storage-lens-groups-list-tags.md)

# Adicionar tag de recursos AWS a um grupo da Lente de Armazenamento
<a name="storage-lens-groups-add-tags"></a>

Os exemplos a seguir demonstram como adicionar tags de recursos AWS a um grupo da Lente de Armazenamento do Amazon S3. Adicione tags de recurso usando o console do Amazon S3, AWS Command Line Interface (AWS CLI) e AWS SDK para Java.

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

**Para adicionar uma tag de recursos AWS a um grupo 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, selecione **Grupos de Lente de Armazenamento**.

1. Em **Grupos da Lente de Armazenamento**, selecione o grupo a ser atualizado.

1. Em **Tags de recursos AWS**, selecione **Adicionar tags**.

1. Na página **Adicionar tags**, adicione o novo par de valores-chave.
**nota**  
Adicionar uma nova tag com a mesma chave de tag existente substitui o valor da tag anterior.

1. (Opcional) Para adicionar mais de uma tag nova, selecione **Adicionar tag** novamente para continuar adicionando novas entradas. Você pode adicionar até 50 tags de recursos AWS ao seu grupo da Lente de Armazenamento.

1. (Opcional) Para remover uma entrada recém-adicionada, selecione **Remover** ao lado da tag que você deseja remover.

1. Escolha **Salvar alterações**.

## Como usar o AWS CLI
<a name="storage-lens-groups-add-tags-cli"></a>

O comando de exemplo AWS CLI a seguir adiciona duas tags de recursos a um grupo da Lente de Armazenamento existente chamado `marketing-department`. Para usar esse exemplo de comando, substitua os `user input placeholders` por suas próprias informações.

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

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

O exemplo AWS SDK para Java a seguir adiciona duas tags de recursos AWS a um grupo da Lente de Armazenamento existente. Para usar esse exemplo, substitua os `user input placeholders` por suas próprias informações.

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

# Atualização dos valores das tags de grupo da Lente de Armazenamento
<a name="storage-lens-groups-update-tags"></a>

Os exemplos a seguir demonstram como atualizar os valores das tags de grupo da Lente de Armazenamento usando o console Amazon S3, AWS Command Line Interface (AWS CLI) e AWS SDK para Java.

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

**Para atualizar uma tag de recursos AWS de um grupo 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, selecione **Grupos de Lente de Armazenamento**.

1. Em **Grupos da Lente de Armazenamento**, selecione o grupo a ser atualizado.

1. Em **Tags de recursos AWS**, selecione a tag a ser atualizada.

1. Adicione o novo valor da tag usando a mesma chave do par de valores-chave que você deseja atualizar. Escolha o ícone da marca de seleção para atualizar o valor da tag.
**nota**  
Adicionar uma nova tag com a mesma chave de tag existente substitui o valor da tag anterior.

1. (Opcional) Para adicionar novas tags, selecione **Adicionar tag** para adicionar novas entradas. A página **Adicionar tags** é exibida. 

   Adicione até 50 tags de recursos AWS ao grupo da Lente de Armazenamento. Quando terminar de adicionar tags, selecione **Salvar alterações**.

1. (Opcional) Para remover uma entrada recém-adicionada, selecione **Remover** ao lado da tag que você deseja remover. Ao finalizar a remoção de tags, selecione **Salvar alterações**. 

## Como usar o AWS CLI
<a name="storage-lens-groups-update-tags-cli"></a>

O comando de exemplo AWS CLI a seguir atualiza dois valores de tags para o grupo da Lente de Armazenamento `marketing-department`. Para usar esse exemplo de comando, substitua os `user input placeholders` por suas próprias informações.

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

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

O exemplo AWS SDK para Java a seguir atualiza dois valores de tags do grupo da Lente de Armazenamento. Para usar esse exemplo, substitua os `user input placeholders` por suas próprias informações.

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

# Exclusão de tag de recursos AWS do grupo da Lente de Armazenamento
<a name="storage-lens-groups-delete-tags"></a>

Os exemplos a seguir demonstram como excluir uma tag de recursos AWS de um grupo da Lente de Armazenamento. Exclua tags usando o console do Amazon S3, AWS Command Line Interface (AWS CLI) e AWS SDK para Java.

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

**Para excluir uma tags de recurso AWS de um grupo 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, selecione **Grupos de Lente de Armazenamento**.

1. Em **Grupos da Lente de Armazenamento**, selecione o grupo a ser atualizado.

1. Em **Tags de recursos AWS**, selecione o par de valores-chave a ser excluído.

1. Escolha **Excluir**. A caixa de diálogo **Excluir tags de recursos AWS** é exibida.
**nota**  
Se tags forem usadas para controlar o acesso, prosseguir com essa ação poderá afetar os recursos relacionados. Depois de excluir permanentemente uma tag, ela não poderá ser restaurada.

1. Selecione **Excluir** para excluir permanentemente o par de valores-chave.

## Como usar o AWS CLI
<a name="storage-lens-groups-delete-tags-cli"></a>

O comando AWS CLI a seguir exclui duas tags de recursos AWS de um grupo da Lente de Armazenamento existente: para usar esse comando de exemplo, substitua `user input placeholders` por suas próprias informações.

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

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

O exemplo AWS SDK para Java a seguir exclui duas tags de recursos AWS do nome do recurso da Amazon (ARN) do grupo da Lente de Armazenamento especificado na conta `111122223333`. Para usar esse exemplo, substitua os `user input placeholders` por suas próprias informações.

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

# Listagem de tags de grupo da Lente de Armazenamento
<a name="storage-lens-groups-list-tags"></a>

Os exemplos a seguir demonstram como listar as tags de recursos AWS associadas ao grupo da Lente de Armazenamento. Você pode listar as tags usando o console do Amazon S3, AWS Command Line Interface (AWS CLI) e AWS SDK para Java.

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

**Para revisar a lista de tags e valores de tags para o grupo 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, selecione **Grupos de Lente de Armazenamento**.

1. Em **Grupos da Lente de Armazenamento**, selecione o grupo da Lente de Armazenamento da sua preferência.

1. Role para baixo até a seção **Tags de recursos AWS**. Todas as tags de recursos AWS definidas pelo usuário que são adicionadas ao grupo da Lente de Armazenamento são listadas junto com os valores de tag.

## Como usar o AWS CLI
<a name="storage-lens-group-list-tags-cli"></a>

O comando de exemplo AWS CLI a seguir lista todos os valores de tag do grupo da Lente de Armazenamento para o grupo da Lente de Armazenamento `marketing-department`. Para usar esse exemplo de comando, substitua os `user input placeholders` por suas próprias informações.

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

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

O exemplo AWS SDK para Java a seguir lista os valores de tag do grupo da Lente de Armazenamento para o nome do recurso da Amazon (ARN) do grupo da Lente de Armazenamento que você especifica. Para usar esse exemplo, substitua os `user input placeholders` por suas próprias informações.

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

# Listagem de todos os grupos da Lente de Armazenamento
<a name="storage-lens-groups-list"></a>

Os exemplos a seguir demonstram como listar todos os grupos da Lente de Armazenamento do Amazon S3 em uma Conta da AWS e região local. Esses exemplos mostram como listar todos os grupos da Lente de Armazenamento usando o console do Amazon S3, AWS Command Line Interface (AWS CLI) e AWS SDK para Java.

## Usar o console do S3
<a name="storage-lens-group-list-console"></a>

**Para listar todos os grupos da Lente de Armazenamento em uma conta e região local**

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, selecione **Grupos de Lente de Armazenamento**.

1. Em **Grupos da Lente de Armazenamento**, a lista é exibida na sua conta.

## Como usar o AWS CLI
<a name="storage-lens-groups-list-cli"></a>

O exemplo AWS CLI a seguir lista todos os grupos da Lente de Armazenamento da sua conta. Para usar esse exemplo de comando, substitua os `user input placeholders` por suas próprias informações.

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

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

O exemplo AWS SDK para Java a seguir lista os grupos da Lente de Armazenamento da sua conta `111122223333`. Para usar esse exemplo, substitua os `user input placeholders` por suas próprias informações.

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

# Visualização de detalhes do grupo da Lente de Armazenamento
<a name="storage-lens-groups-view"></a>

Os exemplos a seguir demonstram como visualizar detalhes de configuração do grupo da Lente de Armazenamento do Amazon S3. Visualize os detalhes usando o console do Amazon S3, AWS Command Line Interface (AWS CLI) e AWS SDK para Java.

## Usar o console do S3
<a name="view-storage-lens-group-console"></a>



**Para visualizar detalhes de configuração do grupo 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, selecione **Grupos de Lente de Armazenamento**.

1. Em **Grupos da Lente de Armazenamento**, selecione o botão ao lado do grupo da Lente de Armazenamento da sua preferência.

1. Escolha **Exibir detalhes**. Agora, você pode analisar os detalhes do grupo da Lente de Armazenamento.

## Como usar o AWS CLI
<a name="view-storage-lens-group-cli"></a>

O exemplo AWS CLI a seguir replica os detalhes da configuração do grupo da Lente de Armazenamento. Para usar esse exemplo de comando, substitua os `user input placeholders` por suas próprias informações.

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

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

O exemplo AWS SDK para Java a seguir replica os detalhes de configuração do grupo da Lente de Armazenamento `Marketing-Department` na conta `111122223333`. Para usar esse exemplo, substitua os `user input placeholders` por suas próprias informações.

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

# Exclusão de grupo da Lente de Armazenamento
<a name="storage-lens-groups-delete"></a>

Os exemplos a seguir demonstram como excluir um grupo da Lente de Armazenamento do Amazon S3 usando o console do Amazon S3AWS Command Line Interface, (AWS CLI) e AWS SDK para Java.

## Usar o console do S3
<a name="delete-storage-lens-group-console"></a>

**Para excluir um grupo 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, selecione **Grupos de Lente de Armazenamento**.

1. Em **Grupos da Lente de Armazenamento**, selecione o botão ao lado do grupo da Lente de Armazenamento para excluir.

1. Escolha **Excluir**. Uma caixa de diálogo **Excluir grupo da Lente de Armazenamento** é exibida.

1. Selecione **Excluir** novamente para excluir permanentemente o grupo da Lente de Armazenamento.
**nota**  
Depois de excluir um grupo da Lente de Armazenamento, ele não poderá ser restaurado.

## Como usar o AWS CLI
<a name="delete-storage-lens-group-cli"></a>

O exemplo AWS CLI a seguir exclui o grupo de Lente de Armazenamento `marketing-department`. Para usar esse exemplo de comando, substitua os `user input placeholders` por suas próprias informações.

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

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

O exemplo AWS SDK para Java a seguir exclui o grupo da Lente de Armazenamento `Marketing-Department` na conta `111122223333`. Para usar esse exemplo, substitua os `user input placeholders` por suas próprias informações.

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