# Atualizar um painel da Lente de Armazenamento do Amazon S3
O painel padrão da Lente de Armazenamento do Amazon S3 é `default-account-dashboard`. Esse painel é pré-configurado pelo Amazon S3 para ajudar você a visualizar tendências e insights resumidos para as métricas gratuitas e avançadas agregadas de toda a sua conta no console. Você não pode modificar o escopo de configuração padrão do painel, mas pode atualizar a seleção de métricas das métricas gratuitas para as métricas e recomendações avançadas pagas, configurar a exportação opcional de métricas ou até mesmo desativar o painel padrão. O painel padrão não pode ser excluído, só pode ser desabilitado. Para obter mais informações, consulte [Usar o console do S3](storage_lens_console_deleting.md).
## Usar o console do S3
Use as etapas a seguir para atualizar um painel do Amazon S3 Storage Lens no console do Amazon S3.
**Etapa 1: atualizar o painel e definir configurações gerais**
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 esquerdo, escolha **Storage Lens, Dashboards** (Lente de Armazenamento, Painéis).
1. Escolha o painel que você deseja editar.
1. Selecione **Exibir configuração do painel**.
1. Escolha **Editar**. Agora você pode analisar detalhadamente a configuração do painel. Para fazer alterações em qualquer uma das etapas, clique diretamente na etapa usando a navegação à esquerda. Para ver instruções sobre como atualizar essas etapas:
**nota**
Você não pode alterar o seguinte:
O nome do painel
A região inicial
1. Na página **Painel**, na seção **Geral**, é possível alterar o seguinte:
+ Escolha **Habilitado** ou **Desabilitado** para indicar se você está recebendo métricas diárias em seu painel.
+ (Opcional) Você pode optar por adicionar **tags** ao seu painel. Você pode usar tags para gerenciar permissões para seu painel e rastrear os custos para o S3 Storage Lens. Para obter mais informações, consulte [Controlar o acesso a recursos da AWS usando tags](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html) no *Guia do usuário do IAM* e [Usar tags geradas pela AWS](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/aws-tags.html) no *Guia do usuário do AWS Billing*.
**nota**
Você pode adicionar até 50 tags à configuração do painel.
1. Escolha **Próximo** para salvar as alterações e prosseguir.
**Etapa 2: Atualizar o escopo do painel**
1. Na seção **Escopo do painel**, atualize as regiões e os buckets que deseja que a Lente de Armazenamento do S3 inclua ou exclua do painel.
**nota**
Você pode incluir ou excluir regiões e buckets. Essa opção é limitada a regiões somente ao criar painéis no nível da organização em contas de membro na sua organização.
Você pode escolher até cinquenta buckets para incluir ou excluir.
1. Escolha os buckets nas regiões selecionadas que deseja que o S3 Storage Lens inclua ou exclua. Você pode incluir ou excluir buckets, mas não ambos. Essa opção não está disponível quando ao criar painéis em nível de organização.
**nota**
Você pode incluir ou excluir regiões e buckets. Essa opção é limitada a regiões somente ao criar painéis no nível da organização em contas de membro na sua organização.
Você pode escolher até cinquenta buckets para incluir ou excluir.
1. Escolha **Próximo** para salvar as alterações e prosseguir.
**Etapa 3: atualizar o nível da Lente de Armazenamento e configurar a seleção de métricas**
1. Na seção **Seleção de métricas** de **Nível da Lente de Armazenamento**, atualize o nível de métricas que você deseja agregar para esse painel.
**nota**
Se você estiver atualizando do **nível gratuito** para o **nível avançado**, precisará atualizar suas configurações em **Agregação de métricas**. Para atualizar suas **configurações de agregação de métricas**, consulte **Etapa 4: atualizar a agregação de métricas**.
Se você estiver atualizando o nível da Lente de Armazenamento do **nível avançado** para o **nível gratuito**, não precisará atualizar nenhuma configuração de **agregação de métricas**. O recurso de **agregação de métricas** se aplica somente às categorias de métricas de **nível avançado**.
1. Para incluir métricas gratuitas agregadas por bucket e disponíveis para consultas por 14 dias, escolha **Nível gratuito**.
1. Para habilitar métricas avançadas, escolha **Nível avançado**. Essas opções incluem agregação de prefixos, publicação no Amazon CloudWatch e recomendações contextuais. Os dados ficam disponíveis para consultas por 15 meses. As métricas e recomendações avançadas têm um custo adicional. Para obter mais informações, consulte [Preço do Amazon S3](https://aws.amazon.com/s3/pricing/).
Para obter mais informações sobre métricas avançadas e métricas gratuitas, consulte [Seleção de métricas](storage_lens_basics_metrics_recommendations.md#storage_lens_basics_metrics_selection).
1. Em **Categorias de métricas avançadas**, escolha a categoria de métricas que deseja habilitar:
+ **Métricas de atividade**
+ **Detailed status code metrics (Métricas detalhadas do código de status**
+ **Métricas de otimização de custos**
+ **Métricas de proteção de dados**
+ **Métricas de performance**
Para visualizar quais métricas estão incluídas em cada categoria, use o botão de seta suspenso abaixo da lista de caixas de seleção da categoria de métricas. Para obter mais informações sobre categorias de métricas, consulte [Categorias de métricas](storage_lens_basics_metrics_recommendations.md#storage_lens_basics_metrics_types). Para obter uma lista completa de métricas, consulte [Glossário de métricas de lente de armazenamento do Amazon S3](storage_lens_metrics_glossary.md).
1. Escolha ou especifique um **delimitador de prefixo** para distinguir os níveis em cada prefixo. Este valor é usado para identificar cada nível de prefixo. O valor padrão no Amazon S3 é o caractere “`/`“, mas sua estrutura de armazenamento pode usar outros caracteres delimitadores.
1. Escolha **Próximo** para salvar as alterações e prosseguir.
**Etapa 4: (opcional) atualizar a agregação de métricas**
1. Em **Agregação de métricas adicionais**, indique quais métricas você deseja agregar escolhendo uma das seguintes opções:
+ Agregação de prefixo
+ Agregação de grupos da Lente de Armazenamento
1. Se você habilitou a **Agregação de prefixo**, especifique o **limite de prefixo** mínimo para o painel e a **profundidade do prefixo**. Escolha **Próximo** para salvar e prosseguir.
1. Se você habilitou a **Agregação de grupos do Storage Lens**, escolha uma das seguintes opções:
+ **Incluir grupos do Storage Lens**
+ **Excluir grupos do Storage Lens**
1. Ao incluir grupos da Lente de Armazenamento em sua agregação, é possível **incluir todos os grupos da Lente de Armazenamento em sua região de origem** ou especificar grupos da Lente de Armazenamento a serem incluídos.
1. Escolha **Próximo** para salvar as alterações e prosseguir.
**Etapa 5: (opcional) atualizar as configurações de exportação e publicação de métricas**
1. Em **Publicação de métricas**, escolha **Publicação do CloudWatch** se quiser acessar as métricas da Lente de Armazenamento no painel do CloudWatch.
**nota**
As métricas em nível de prefixo não estão disponíveis no CloudWatch.
1. Em **Exportação de métricas**, escolha quais dados do painel da Lente de Armazenamento você deseja exportar diariamente:
+ **Relatório de métricas padrão**
+ **Relatório ampliado de métricas de prefixos**
1. (Opcional) Se você escolheu **Relatório de métricas padrão**, nas configurações de **Relatório de métricas padrão**, escolha o tipo de bucket. É possível exportar o relatório para um bucket de uso geral do S3 ou um bucket de tabela somente leitura do S3. Com base no tipo de bucket selecionado, atualize as **Configurações de destino no bucket de uso geral** ou as opções de **Configurações de destino no bucket de tabelas**.
**nota**
O **relatório de métricas padrão** inclui apenas prefixos dentro do limite e profundidade definidos nas configurações de agregação de prefixo. Se a agregação de prefixo ainda não estiver configurada, o limite inclui até os cem maiores prefixos por tamanho.
Se você optou por especificar uma chave de criptografia, deverá escolher uma chave do AWS KMS (SSE-KMS) ou uma chave gerenciada pelo Amazon S3 (SSE-S3). Se sua política de bucket de destino exigir criptografia, será necessário fornecer uma chave de criptografia para a exportação de métricas. Sem a chave de criptografia, a exportação para o S3 apresenta falha. Para obter mais informações, consulte [Usar uma AWS KMS key para criptografar suas exportações de métricas](storage_lens_encrypt_permissions.md).
1. Escolha **Próximo** para salvar as alterações e prosseguir.
1. (Opcional) Se você escolheu **Relatório ampliado de métricas de prefixos** nas configurações de **Relatório ampliado de métricas de prefixos**, escolha o tipo de bucket. É possível exportar o relatório para um bucket de uso geral do S3 ou um bucket de tabela somente leitura do S3. Com base no tipo de bucket selecionado, atualize as **Configurações de destino no bucket de uso geral** ou as **Configurações de destino no bucket de tabelas**.
**nota**
O **relatório ampliado de métricas de prefixos** inclui prefixos em todos os buckets especificados no escopo do painel.
Se você optou por especificar uma chave de criptografia, deverá escolher uma chave do AWS KMS (SSE-KMS) ou uma chave gerenciada pelo Amazon S3 (SSE-S3). Se sua política de bucket de destino exigir criptografia, será necessário fornecer uma chave de criptografia para a exportação de métricas. Sem a chave de criptografia, a exportação para o S3 apresenta falha. Para obter mais informações, consulte [Usar uma AWS KMS key para criptografar suas exportações de métricas](storage_lens_encrypt_permissions.md).
1. Escolha **Próximo** para salvar as alterações e prosseguir.
**Etapa 6: analisar e atualizar a configuração do painel**
1. Na seção **Geral**, analise suas configurações. Escolha **Editar** para fazer quaisquer alterações.
1. Na seção **Escopo do painel**, analise suas configurações. Escolha **Editar** para fazer quaisquer alterações.
1. Na seção **Nível da Lente de Armazenamento**, analise suas configurações. Escolha **Editar** para fazer quaisquer alterações.
1. Na seção **Agregação de métricas**, analise suas configurações. Escolha **Editar** para fazer quaisquer alterações.
1. Na seção **Exportação de métricas**, analise suas configurações. Escolha **Editar** para fazer quaisquer alterações.
1. Depois de analisar e confirmar todas as configurações do painel, escolha **Enviar** para atualizar o painel.
Depois que o novo painel da Lente de Armazenamento for atualizado com êxito, será possível visualizar a configuração atualizada na página **Painel** da Lente de Armazenamento.
## Como usar o AWS CLI
**Example**
O exemplo de comando a seguir atualiza uma configuração de painel da Lente de Armazenamento do Amazon S3. Para usar esses exemplos, substitua os `{{user input placeholders}}` por suas próprias informações.
```
aws s3control put-storage-lens-configuration --account-id={{111122223333}} --config-id={{example-dashboard-configuration-id}} --region={{us-east-1}} --storage-lens-configuration={{file://./config.json}} --tags={{file://./tags.json}}
```
## Usar o AWS SDK para Java
**Example – Atualizar uma configuração da Lente de Armazenamento do Amazon S3 com métricas e recomendações avançadas**
Os exemplos a seguir mostram como atualizar a configuração padrão da Lente de Armazenamento do S3 com métricas e recomendações avançadas no SDK para Java:
```
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.ActivityMetrics;
import com.amazonaws.services.s3control.model.BucketLevel;
import com.amazonaws.services.s3control.model.Format;
import com.amazonaws.services.s3control.model.Include;
import com.amazonaws.services.s3control.model.OutputSchemaVersion;
import com.amazonaws.services.s3control.model.PrefixLevel;
import com.amazonaws.services.s3control.model.PrefixLevelStorageMetrics;
import com.amazonaws.services.s3control.model.PutStorageLensConfigurationRequest;
import com.amazonaws.services.s3control.model.S3BucketDestination;
import com.amazonaws.services.s3control.model.SSES3;
import com.amazonaws.services.s3control.model.SelectionCriteria;
import com.amazonaws.services.s3control.model.StorageLensAwsOrg;
import com.amazonaws.services.s3control.model.StorageLensConfiguration;
import com.amazonaws.services.s3control.model.StorageLensDataExport;
import com.amazonaws.services.s3control.model.StorageLensDataExportEncryption;
import com.amazonaws.services.s3control.model.StorageLensTag;
import java.util.Arrays;
import java.util.List;
import static com.amazonaws.regions.Regions.{{US_WEST_2}};
public class UpdateDefaultConfigWithPaidFeatures {
public static void main(String[] args) {
String configurationId = "default-account-dashboard"; // This configuration ID cannot be modified.
String sourceAccountId = "{{111122223333}}";
try {
SelectionCriteria selectionCriteria = new SelectionCriteria()
.withDelimiter("{{/}}")
.withMaxDepth({{5}})
.withMinStorageBytesPercentage({{10.0}});
PrefixLevelStorageMetrics prefixStorageMetrics = new PrefixLevelStorageMetrics()
.withIsEnabled({{true}})
.withSelectionCriteria(selectionCriteria);
BucketLevel bucketLevel = new BucketLevel()
.withActivityMetrics(new ActivityMetrics().withIsEnabled({{true}}))
.withPrefixLevel(new PrefixLevel().withStorageMetrics(prefixStorageMetrics));
AccountLevel accountLevel = new AccountLevel()
.withActivityMetrics(new ActivityMetrics().withIsEnabled({{true}}))
.withBucketLevel(bucketLevel);
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();
}
}
}
```
Para acessar prefixos expandidos ou grupos da Lente de Armazenamento do S3, é necessário atualizar o painel para usar o nível avançado. Aplicam-se cobranças adicionais. Para ter mais informações sobre métricas do nível gratuito e do avançado, consulte [Seleção de métricas](storage_lens_basics_metrics_recommendations.md#storage_lens_basics_metrics_selection). Para obter mais informações sobre grupos de Lente de Armazenamento do S3, consulte [Trabalhar com grupos da Lente de Armazenamento do S3 para filtrar e agregar métricas](storage-lens-groups-overview.md).