# 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).