# Trabalhar com a Lente de Armazenamento do Amazon S3 usando o console e a API
A Lente de Armazenamento do Amazon S3 é um recurso de análise de armazenamento em nuvem que você pode usar para obter visibilidade em toda a organização sobre o uso e a atividade do armazenamento de objetos. Use as métricas da Lente de Armazenamento do S3 para gerar insights resumidos, como descobrir quanto armazenamento você tem em toda a organização ou quais são os buckets e prefixos que mais crescem. Você também pode usar as métricas da Lente de Armazenamento do S3 para identificar oportunidades de otimização de custos, implementar práticas recomendadas de proteção e segurança de dados, e melhorar a performance das workloads de aplicações. Por exemplo, você pode identificar buckets que não têm regras de Ciclo de Vida do S3 para expirar multipart uploads incompletos com mais de 7 dias. Você também pode identificar buckets que não estão seguindo as práticas recomendadas de proteção de dados, como usar a Replicação do S3 ou o Versionamento do S3. A Lente de Armazenamento do S3 também analisa as métricas para fornecer recomendações contextuais que você pode usar para otimizar os custos de armazenamento e aplicar as práticas recomendadas de proteção de dados.
A Lente de Armazenamento do S3 agrega suas métricas e exibe as informações na seção **Account snapshot** (Snapshot da conta) na página **Buckets** do console do Amazon S3. A Lente de Armazenamento do S3 também oferece um painel interativo para visualizar insights e tendências, sinalizar discrepâncias e receber recomendações para otimizar os custos de armazenamento e aplicar as práticas recomendadas de proteção de dados. O painel tem opções de detalhamento para gerar e visualizar insights no nível da organização, conta, Região da AWS, classe de armazenamento, bucket, prefixo ou grupo de Lente de Armazenamento. Também é possível enviar um relatório diário de métricas no formato CSV ou Parquet a um bucket do S3 de uso geral ou exportar as métricas diretamente para um bucket de tabela do S3 gerenciado pela AWS.
**nota**
A Lente de Armazenamento agrega apenas métricas para [buckets de uso geral do S3](UsingBucket.md).
Esta seção contém exemplos de criação, atualização e exibição de configurações do S3 Storage Lens e execução de operações relacionadas ao recurso. Se você estiver usando o S3 Storage Lens com o AWS Organizations, esses exemplos também abordam esses casos de uso. Nos exemplos, substitua quaisquer valores de espaço reservado.
**Topics**
+ [Criar um painel da Lente de Armazenamento do Amazon S3](storage_lens_creating_dashboard.md)
+ [Atualizar um painel da Lente de Armazenamento do Amazon S3](storage_lens_editing.md)
+ [Desabilitar um painel da Lente de Armazenamento do Amazon S3](storage_lens_disabling.md)
+ [Excluir um painel da Lente de Armazenamento do Amazon S3](storage_lens_deleting.md)
+ [Listar painéis da Lente de Armazenamento do Amazon S3](storage_lens_list_dashboard.md)
+ [Visualizar detalhes de configuração do painel da Lente de Armazenamento do Amazon S3](storage_lens_viewing.md)
+ [Gerenciamento de tags de recursos da AWS com a Lente de Armazenamento do S3](storage-lens-groups-manage-tags-dashboard.md)
+ [Arquivos auxiliares para usar o Amazon S3 Storage Lens](S3LensHelperFilesCLI.md)
# Criar um painel da Lente de Armazenamento do Amazon S3
Você pode criar painéis personalizados adicionais da Lente de Armazenamento do S3 que podem ser colocados no escopo de sua organização no AWS Organizations ou em Regiões da AWS específicas ou buckets específicos em uma conta.
**nota**
As atualizações na configuração do painel podem levar até 48 horas para serem exibidas ou visualizadas com precisão.
## Usar o console do S3
Use as etapas a seguir para criar um painel do Amazon S3 Storage Lens no console do Amazon S3.
**Etapa 1: 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. 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 esquerdo, em **Lente de Armazenamento do S3**, selecione **Painéis**.
1. Escolha **Create dashboard (Criar painel)**.
1. Na página **Dashboard** (Painel), na seção **General** (Geral), faça o seguinte:
1. Visualize a **Região de origem** para seu painel. A região de origem é a Região da AWS em que a configuração e as métricas referentes a esse painel do Lente de Armazenamento estão armazenadas.
1. Insira um nome de painel.
Os nomes do painel devem ter menos de 65 caracteres e não devem conter caracteres ou espaços especiais.
**nota**
Não é possível alterar o nome do painel depois que o painel for criado.
1. Escolha **Habilitado** para exibir métricas diárias atualizadas em seu painel.
1. (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: Definir o escopo do painel**
1. Na seção **Escopo do painel**, escolha as regiões e os buckets que deseja que a Lente de Armazenamento do S3 inclua ou exclua do painel.
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: escolher o nível da Lente de Armazenamento**
1. Na seção **Lente de Armazenamento**, escolha o nível de recursos que deseja agregar para esse painel.
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 a agregação de prefixos ou grupos da Lente de Armazenamento, a publicação no Amazon CloudWatch, o relatório de prefixos ampliado 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**, selecione 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) escolher quais métricas agregar**
1. Em **Agregação de métricas adicionais**, escolha quais métricas você deseja agregar:
+ 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.
**nota**
A configuração **Profundidade do prefixo** determina em quantos níveis hierárquicos a Lente de Armazenamento do S3 analisará seus prefixos de objeto, com um limite máximo de dez níveis. O **limite de prefixo** especifica a porcentagem mínima do armazenamento total que um prefixo deve representar para ser incluído nas métricas da Lente de Armazenamento.
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) escolher suas 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 do S3 gerenciado pela AWS. 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 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. (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** abrange prefixos de até cinquenta níveis de profundidade em todos os buckets selecionados que são 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.
1. Analise tudo na página **Analisar e criar**. Se não houver alterações adicionais, escolha **Próximo** para salvar as alterações e criar o painel.
**Etapa 6: analisar a configuração do painel e criá-lo**
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 criar o painel.
Depois que o novo painel da Lente de Armazenamento for criado com êxito, será possível visualizá-lo na página **Painel** da Lente de Armazenamento.
## Como usar o AWS CLI
**Example**
O comando de exemplo a seguir cria uma configuração da Lente de Armazenamento do Amazon S3 com tags. 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
```
**Example**
O comando de exemplo a seguir cria uma configuração da Lente de Armazenamento do Amazon S3 sem tags. Para usar esses exemplos, substitua os `user input placeholders` por suas próprias informações.
```
aws s3control put-storage-lens-configuration --account-id=222222222222 --config-id=your-configuration-id --region=us-east-1 --storage-lens-configuration=file://./config.json
```
## Usar o AWS SDK para Java
**Example – Criar e atualizar uma configuração da Lente de Armazenamento do Amazon S3**
O exemplo a seguir cria e atualiza uma configuração da Lente de Armazenamento do Amazon S3 no SDK para Java:
```
package aws.example.s3control;
import software.amazon.awssdk.awscore.exception.AwsServiceException;
import software.amazon.awssdk.core.exception.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.AccountLevel;
import software.amazon.awssdk.services.s3control.model.ActivityMetrics;
import software.amazon.awssdk.services.s3control.model.AdvancedCostOptimizationMetrics;
import software.amazon.awssdk.services.s3control.model.AdvancedDataProtectionMetrics;
import software.amazon.awssdk.services.s3control.model.AdvancedPerformanceMetrics;
import software.amazon.awssdk.services.s3control.model.BucketLevel;
import software.amazon.awssdk.services.s3control.model.CloudWatchMetrics;
import software.amazon.awssdk.services.s3control.model.DetailedStatusCodesMetrics;
import software.amazon.awssdk.services.s3control.model.Format;
import software.amazon.awssdk.services.s3control.model.Include;
import software.amazon.awssdk.services.s3control.model.OutputSchemaVersion;
import software.amazon.awssdk.services.s3control.model.PrefixLevel;
import software.amazon.awssdk.services.s3control.model.PrefixLevelStorageMetrics;
import software.amazon.awssdk.services.s3control.model.PutStorageLensConfigurationRequest;
import software.amazon.awssdk.services.s3control.model.S3BucketDestination;
import software.amazon.awssdk.services.s3control.model.SSES3;
import software.amazon.awssdk.services.s3control.model.SelectionCriteria;
import software.amazon.awssdk.services.s3control.model.StorageLensAwsOrg;
import software.amazon.awssdk.services.s3control.model.StorageLensConfiguration;
import software.amazon.awssdk.services.s3control.model.StorageLensDataExport;
import software.amazon.awssdk.services.s3control.model.StorageLensDataExportEncryption;
import software.amazon.awssdk.services.s3control.model.StorageLensExpandedPrefixesDataExport;
import software.amazon.awssdk.services.s3control.model.StorageLensTableDestination;
import software.amazon.awssdk.services.s3control.model.StorageLensTag;
import java.util.Arrays;
import java.util.List;
public class CreateAndUpdateDashboard {
public static void main(String[] args) {
String configurationId = "ConfigurationId";
String sourceAccountId = "111122223333";
String exportAccountId = "Destination Account ID";
String exportBucketArn = "arn:aws:s3:::destBucketName"; // The destination bucket for your metrics export must be in the same Region as your S3 Storage Lens configuration.
String awsOrgARN = "arn:aws:organizations::123456789012:organization/o-abcdefgh";
Format exportFormat = Format.CSV;
try {
SelectionCriteria selectionCriteria = SelectionCriteria.builder()
.delimiter("/")
.maxDepth(5)
.minStorageBytesPercentage(10.0)
.build();
PrefixLevelStorageMetrics prefixStorageMetrics = PrefixLevelStorageMetrics.builder()
.isEnabled(true)
.selectionCriteria(selectionCriteria)
.build();
BucketLevel bucketLevel = BucketLevel.builder()
.activityMetrics(ActivityMetrics.builder().isEnabled(true).build())
.advancedCostOptimizationMetrics(AdvancedCostOptimizationMetrics.builder().isEnabled(true).build())
.advancedDataProtectionMetrics(AdvancedDataProtectionMetrics.builder().isEnabled(true).build())
.advancedPerformanceMetrics(AdvancedPerformanceMetrics.builder().isEnabled(true).build())
.detailedStatusCodesMetrics(DetailedStatusCodesMetrics.builder().isEnabled(true).build())
.prefixLevel(PrefixLevel.builder().storageMetrics(prefixStorageMetrics).build())
.build();
AccountLevel accountLevel = AccountLevel.builder()
.activityMetrics(ActivityMetrics.builder().isEnabled(true).build())
.advancedCostOptimizationMetrics(AdvancedCostOptimizationMetrics.builder().isEnabled(true).build())
.advancedPerformanceMetrics(AdvancedPerformanceMetrics.builder().isEnabled(true).build())
.advancedDataProtectionMetrics(AdvancedDataProtectionMetrics.builder().isEnabled(true).build())
.detailedStatusCodesMetrics(DetailedStatusCodesMetrics.builder().isEnabled(true).build())
.bucketLevel(bucketLevel)
.build();
Include include = Include.builder()
.buckets(Arrays.asList("arn:aws:s3:::bucketName"))
.regions(Arrays.asList("us-west-2"))
.build();
StorageLensDataExportEncryption exportEncryption = StorageLensDataExportEncryption.builder()
.sses3(SSES3.builder().build())
.build();
S3BucketDestination s3BucketDestination = S3BucketDestination.builder()
.accountId(exportAccountId)
.arn(exportBucketArn)
.encryption(exportEncryption)
.format(exportFormat)
.outputSchemaVersion(OutputSchemaVersion.V_1)
.prefix("Prefix")
.build();
StorageLensTableDestination s3TablesDestination = StorageLensTableDestination.builder()
.encryption(exportEncryption)
.isEnabled(true)
.build();
CloudWatchMetrics cloudWatchMetrics = CloudWatchMetrics.builder()
.isEnabled(true)
.build();
StorageLensDataExport dataExport = StorageLensDataExport.builder()
.cloudWatchMetrics(cloudWatchMetrics)
.s3BucketDestination(s3BucketDestination)
.storageLensTableDestination(s3TablesDestination)
.build();
StorageLensAwsOrg awsOrg = StorageLensAwsOrg.builder()
.arn(awsOrgARN)
.build();
StorageLensExpandedPrefixesDataExport expandedPrefixesDataExport = StorageLensExpandedPrefixesDataExport.builder()
.s3BucketDestination(s3BucketDestination)
.storageLensTableDestination(s3TablesDestination)
.build();
StorageLensConfiguration configuration = StorageLensConfiguration.builder()
.id(configurationId)
.accountLevel(accountLevel)
.include(include)
.dataExport(dataExport)
.awsOrg(awsOrg)
.expandedPrefixesDataExport(expandedPrefixesDataExport)
.prefixDelimiter("/")
.isEnabled(true)
.build();
List tags = Arrays.asList(
StorageLensTag.builder().key("key-1").value("value-1").build(),
StorageLensTag.builder().key("key-2").value("value-2").build()
);
S3ControlClient s3ControlClient = S3ControlClient.builder()
.region(Region.US_WEST_2)
.credentialsProvider(ProfileCredentialsProvider.create())
.build();
s3ControlClient.putStorageLensConfiguration(PutStorageLensConfigurationRequest.builder()
.accountId(sourceAccountId)
.configId(configurationId)
.storageLensConfiguration(configuration)
.tags(tags)
.build()
);
} catch (AwsServiceException 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).
# 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).
# Desabilitar um painel da Lente de Armazenamento do Amazon S3
É possível desabilitar um painel da Lente de Armazenamento do Amazon S3 pelo console do Amazon S3. Desabilitar um painel impede que ele gere métricas no futuro. Um painel desativado ainda mantém suas informações de configuração, para que possa ser facilmente retomado quando reativado. Um painel desabilitado retém seus dados históricos até que não estejam mais disponíveis para consultas.
# Usar o console do S3
Use as etapas a seguir para desabilitar um painel da Lente de Armazenamento do Amazon S3 no console do Amazon S3.
**Como desabilitar um painel da Lente de Armazenamento do Amazon 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 esquerdo, escolha **Storage Lens** (Lente de Armazenamento) e **Dashboards** (Painéis).
1. Na lista **Dashboards** (Painéis), escolha o painel que deseja desativar e, em seguida, escolha **Disable** (Desativar) na parte superior da lista.
1. Na página de confirmação, confirme se deseja desativar o painel inserindo o nome do painel no campo de texto e escolha **Confirmar**.
# Excluir um painel da Lente de Armazenamento do Amazon S3
Você não pode excluir o painel padrão. No entanto, você poderá desabilitá-lo. Antes de excluir um painel que você criou, considere o seguinte:
+ Como alternativa à exclusão de um painel, você pode *desativar* o painel para que ele esteja disponível para ser reativado no futuro. Para obter mais informações, consulte [Usar o console do S3](storage_lens_console_disabling.md).
+ A exclusão do painel excluirá todas as configurações associadas a ele.
+ A exclusão de um painel torna todos os dados de métricas históricas indisponíveis. Esses dados históricos ainda são mantidos por 15 meses. Se você quiser acessar esses dados novamente, crie um painel com o mesmo nome na mesma região inicial daquele que foi excluído.
# Usar o console do S3
É possível excluir um painel da Lente de Armazenamento do Amazon S3 do console do Amazon S3. No entanto, excluir um painel impede que ele gere métricas no futuro.
**Exclusão de um painel do Amazon S3 Storage Lens**
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** (Lente de Armazenamento) e **Dashboards** (Painéis).
1. Na lista **Dashboards** (Painéis), escolha o painel que deseja excluir e escolha **Delete** (Excluir) na parte superior da lista.
1. Na página **Excluir painéis**, confirme se deseja excluir o painel inserindo o nome do painel no campo de texto. Depois, selecione **Confirm** (Confirmar).
# Como usar o AWS CLI
**Example**
O exemplo a seguir exclui uma configuração da Lente de Armazenamento do S3. Para usar esses exemplos, substitua os `user input placeholders` por suas próprias informações.
```
aws s3control delete-storage-lens-configuration --account-id=222222222222 --region=us-east-1 --config-id=your-configuration-id
```
## Usar o AWS SDK para Java
**Example – Excluir uma configuração de painel da Lente de Armazenamento do Amazon S3**
O exemplo a seguir mostra como excluir uma configuração da Lente de Armazenamento do S3 usando o 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.DeleteStorageLensConfigurationRequest;
import static com.amazonaws.regions.Regions.US_WEST_2;
public class DeleteDashboard {
public static void main(String[] args) {
String configurationId = "ConfigurationId";
String sourceAccountId = "111122223333";
try {
AWSS3Control s3ControlClient = AWSS3ControlClient.builder()
.withCredentials(new ProfileCredentialsProvider())
.withRegion(US_WEST_2)
.build();
s3ControlClient.deleteStorageLensConfiguration(new DeleteStorageLensConfigurationRequest()
.withAccountId(sourceAccountId)
.withConfigId(configurationId)
);
} 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();
}
}
}
```
# Listar painéis da Lente de Armazenamento do Amazon S3
# Usar o console do S3
**Como listar painéis 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, acesse **Lente de Armazenamento**.
1. Escolha **Painéis**. Agora você pode visualizar os painéis em sua Conta da AWS.
## Como usar o AWS CLI
**Example**
O exemplo de comando a seguir lista os painéis da Lente de Armazenamento do S3 em sua Conta da AWS. Para usar esses exemplos, substitua os `user input placeholders` por suas próprias informações.
```
aws s3control list-storage-lens-configurations --account-id=222222222222 --region=us-east-1 --next-token=abcdefghij1234
```
**Example**
O exemplo a seguir lista configurações da Lente de Armazenamento do S3 sem um próximo token. Para usar esses exemplos, substitua os `user input placeholders` por suas próprias informações.
```
aws s3control list-storage-lens-configurations --account-id=222222222222 --region=us-east-1
```
## Usar o AWS SDK para Java
**Example – Listar configurações do painel da Lente de Armazenamento do S3**
Os exemplos a seguir mostram como listar as configurações da Lente de Armazenamento do S3 no SDK para Java. Para usar esse exemplo, substitua os `user input placeholders` por suas próprias informações. para cada descrição de exemplo.
```
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.ListStorageLensConfigurationEntry;
import com.amazonaws.services.s3control.model.ListStorageLensConfigurationsRequest;
import java.util.List;
import static com.amazonaws.regions.Regions.US_WEST_2;
public class ListDashboard {
public static void main(String[] args) {
String sourceAccountId = "111122223333";
String nextToken = "nextToken";
try {
AWSS3Control s3ControlClient = AWSS3ControlClient.builder()
.withCredentials(new ProfileCredentialsProvider())
.withRegion(US_WEST_2)
.build();
final List configurations =
s3ControlClient.listStorageLensConfigurations(new ListStorageLensConfigurationsRequest()
.withAccountId(sourceAccountId)
.withNextToken(nextToken)
).getStorageLensConfigurationList();
System.out.println(configurations.toString());
} 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();
}
}
}
```
# Visualizar detalhes de configuração do painel da Lente de Armazenamento do Amazon S3
É possível visualizar um painel da Lente de Armazenamento do Amazon S3 do console do Amazon S3, da AWS CLI e do SDK para Java.
# Usar o console do S3
**Como visualizar detalhes da configuração do 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, acesse **Lente de Armazenamento**.
1. Escolha **Painéis**.
1. Na lista **Painéis**, clique no painel que você deseja visualizar. Agora, você pode visualizar os detalhes do painel da Lente de Armazenamento.
## Como usar o AWS CLI
**Example**
O exemplo a seguir recupera uma configuração da Lente de Armazenamento do S3 para que você possa visualizar os detalhes da configuração. Para usar esses exemplos, substitua os `user input placeholders` por suas próprias informações.
```
aws s3control get-storage-lens-configuration --account-id=222222222222 --config-id=your-configuration-id --region=us-east-1
```
## Usar o AWS SDK para Java
**Example – Recuperar e visualizar uma configuração da Lente de Armazenamento do S3**
O exemplo a seguir mostra como recuperar uma configuração da Lente de Armazenamento do S3 no SDK para Java para que você possa visualizar os detalhes da configuração. 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 com.amazonaws.auth.profile.ProfileCredentialsProvider;
import com.amazonaws.services.s3control.AWSS3Control;
import com.amazonaws.services.s3control.AWSS3ControlClient;
import com.amazonaws.services.s3control.model.GetStorageLensConfigurationRequest;
import com.amazonaws.services.s3control.model.GetStorageLensConfigurationResult;
import com.amazonaws.services.s3control.model.StorageLensConfiguration;
import static com.amazonaws.regions.Regions.US_WEST_2;
public class GetDashboard {
public static void main(String[] args) {
String configurationId = "ConfigurationId";
String sourceAccountId = "111122223333";
try {
AWSS3Control s3ControlClient = AWSS3ControlClient.builder()
.withCredentials(new ProfileCredentialsProvider())
.withRegion(US_WEST_2)
.build();
final StorageLensConfiguration configuration =
s3ControlClient.getStorageLensConfiguration(new GetStorageLensConfigurationRequest()
.withAccountId(sourceAccountId)
.withConfigId(configurationId)
).getStorageLensConfiguration();
System.out.println(configuration.toString());
} 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();
}
}
}
```
# Gerenciamento de tags de recursos da AWS com a Lente de Armazenamento do S3
Cada painel da Lente de Armazenamento do Amazon S3 é contado como um recurso da AWS com o próprio nome do recurso da Amazon (ARN). Portanto, ao configurar o painel da Lente de Armazenamento, você tem a opção de adicionar tags de recursos da AWS ao painel. Você pode adicionar até 50 tags para cada painel da Lente de Armazenamento. Para criar um painel da Lente de Armazenamento com tags, você deve ter as seguintes [permissões da Lente de Armazenamento do S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage_lens_iam_permissions.html):
+ `s3:ListStorageLensConfigurations`
+ `s3:GetStorageLensConfiguration`
+ `s3:GetStorageLensConfigurationTagging`
+ `s3:PutStorageLensConfiguration`
+ ` s3:PutStorageLensConfigurationTagging`
Use tags de recursos AWS para categorizar os recursos de acordo com o departamento, a linha de negócios ou o projeto. Isso é útil quando você tem muitos recursos do mesmo tipo. Ao aplicar tags, é possível identificar rapidamente um painel específico da Lente de Armazenamento do S3 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 recurso da AWS ao painel 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, como 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 da AWS com o painel da Lente de Armazenamento.
**Topics**
+ [Adicionar tags de recursos da AWS a um painel da Lente de Armazenamento](storage-lens-add-tags.md)
+ [Recuperar tags de recursos da AWS para um painel da Lente de Armazenamento](storage-lens-get-tags.md)
+ [Atualizar tags do painel da Lente de Armazenamento](storage-lens-update-tags.md)
+ [Excluir tags de recursos da AWS de um painel da Lente de Armazenamento do S3](storage-lens-dashboard-delete-tags.md)
# Adicionar tags de recursos da AWS a um painel da Lente de Armazenamento
Os exemplos a seguir demonstram como adicionar tags de recursos da AWS a um painel da Lente de Armazenamento do 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
**Como adicionar tags de recursos da AWS 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, acesse **Lente de Armazenamento**.
1. Escolha **Painéis**.
1. Selecione botão de opção do painel da Lente de Armazenamento que você deseja atualizar. Em seguida, escolha **Edit** (Editar).
1. Em **Geral**, escolha **Adicionar tag**.
1. Na página **Adicionar tag**, adicione o novo par de chave-valor.
**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 da AWS ao painel 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
**Example**
O exemplo de comando a seguir adiciona tags a uma configuração de painel da Lente de Armazenamento do S3. Para usar esses exemplos, substitua os `user input placeholders` por suas próprias informações.
```
aws s3control put-storage-lens-configuration-tagging --account-id=222222222222 --region=us-east-1 --config-id=your-configuration-id --tags=file://./tags.json
```
## Usar o AWS SDK para Java
O exemplo a seguir adiciona tags a uma configuração da Lente de Armazenamento do Amazon S3 com SDK para Java. Para usar esse exemplo, substitua os `user input placeholders` por suas próprias informações.
**Example – Adicionar tags a uma configuração da Lente de Armazenamento do S3**
```
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.PutStorageLensConfigurationTaggingRequest;
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 PutDashboardTagging {
public static void main(String[] args) {
String configurationId = "ConfigurationId";
String sourceAccountId = "111122223333";
try {
List tags = Arrays.asList(
new StorageLensTag().withKey("key-1").withValue("value-1"),
new StorageLensTag().withKey("key-2").withValue("value-2")
);
AWSS3Control s3ControlClient = AWSS3ControlClient.builder()
.withCredentials(new ProfileCredentialsProvider())
.withRegion(US_WEST_2)
.build();
s3ControlClient.putStorageLensConfigurationTagging(new PutStorageLensConfigurationTaggingRequest()
.withAccountId(sourceAccountId)
.withConfigId(configurationId)
.withTags(tags)
);
} 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();
}
}
}
```
# Recuperar tags de recursos da AWS para um painel da Lente de Armazenamento
Os exemplos a seguir demonstram como adicionar tags de recursos da AWS a um painel da Lente de Armazenamento do S3. É possível adicionar tags de recursos usando o console do Amazon S3, a AWS Command Line Interface (AWS CLI) e o AWS SDK para Java.
# Usar o console do S3
**Como recuperar as tags de recursos da AWS para 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, acesse **Lente de Armazenamento**.
1. Escolha **Painéis**.
1. Selecione botão de opção da configuração do painel da Lente de Armazenamento que você deseja visualizar. Depois, selecione **Visualizar configuração do painel**.
1. Em **Tags**, revise as tags associadas ao painel.
1. (Opcional) Se quiser adicionar uma nova tag, escolha **Editar**. Selecione **Adicionar tag**. Na página **Adicionar tag**, adicione o novo par de chave-valor.
**nota**
Adicionar uma nova tag com a mesma chave de tag existente substitui o valor da tag anterior.
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
**Example**
O exemplo de comando a seguir recupera tags para uma configuração de painel da Lente de Armazenamento do S3. Para usar esses exemplos, substitua os `user input placeholders` por suas próprias informações.
```
aws s3control get-storage-lens-configuration-tagging --account-id=222222222222 --region=us-east-1 --config-id=your-configuration-id --tags=file://./tags.json
```
## Usar o AWS SDK para Java
**Example – Obter tags para uma configuração de painel da Lente de Armazenamento do S3**
O exemplo a seguir mostra como recuperar tags para uma configuração de painel da Lente de Armazenamento do S3 no SDK para Java. 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 com.amazonaws.auth.profile.ProfileCredentialsProvider;
import com.amazonaws.services.s3control.AWSS3Control;
import com.amazonaws.services.s3control.AWSS3ControlClient;
import com.amazonaws.services.s3control.model.DeleteStorageLensConfigurationRequest;
import com.amazonaws.services.s3control.model.GetStorageLensConfigurationTaggingRequest;
import com.amazonaws.services.s3control.model.StorageLensTag;
import java.util.List;
import static com.amazonaws.regions.Regions.US_WEST_2;
public class GetDashboardTagging {
public static void main(String[] args) {
String configurationId = "ConfigurationId";
String sourceAccountId = "111122223333";
try {
AWSS3Control s3ControlClient = AWSS3ControlClient.builder()
.withCredentials(new ProfileCredentialsProvider())
.withRegion(US_WEST_2)
.build();
final List s3Tags = s3ControlClient
.getStorageLensConfigurationTagging(new GetStorageLensConfigurationTaggingRequest()
.withAccountId(sourceAccountId)
.withConfigId(configurationId)
).getTags();
System.out.println(s3Tags.toString());
} 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();
}
}
}
```
# Atualizar tags do painel da Lente de Armazenamento
Os exemplos a seguir demonstram como atualizar as tags de painel da Lente de Armazenamento usando o console do Amazon S3, a AWS Command Line Interface (AWS CLI) e o AWS SDK para Java.
## Usar o console do S3
**Como atualizar uma tag de recursos da AWS de 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, acesse **Lente de Armazenamento**.
1. Escolha **Painéis**.
1. Selecione botão de opção da configuração do painel da Lente de Armazenamento que você deseja visualizar. Depois, selecione **Visualizar configuração do painel**.
1. Em **Tags**, revise as tags associadas ao painel.
1. (Opcional) Se quiser adicionar uma nova tag, escolha **Editar**. Selecione **Adicionar tag**. Na página **Adicionar tag**, adicione o novo par de chave-valor.
**nota**
Adicionar uma nova tag com a mesma chave de tag existente substitui o valor da tag anterior.
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
**Example**
O exemplo de comando a seguir adiciona ou substitui tags em uma configuração existente do 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-tagging --account-id=111122223333 --config-id=example-dashboard-configuration-id --region=us-east-1 --config-id=your-configuration-id
```
## Usar o AWS SDK para Java
O exemplo do AWS SDK para Java a seguir atualiza as tags de recursos da AWS em um painel existente da Lente de Armazenamento. Para usar esse exemplo, substitua os `user input placeholders` por suas próprias informações.
**Example – Atualizar tags em uma configuração existente do painel da Lente de Armazenamento**
```
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.PutStorageLensConfigurationTaggingRequest;
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 PutDashboardTagging {
public static void main(String[] args) {
String configurationId = "ConfigurationId";
String sourceAccountId = "111122223333";
try {
List tags = Arrays.asList(
new StorageLensTag().withKey("key-1").withValue("value-1"),
new StorageLensTag().withKey("key-2").withValue("value-2")
);
AWSS3Control s3ControlClient = AWSS3ControlClient.builder()
.withCredentials(new ProfileCredentialsProvider())
.withRegion(US_WEST_2)
.build();
s3ControlClient.putStorageLensConfigurationTagging(new PutStorageLensConfigurationTaggingRequest()
.withAccountId(sourceAccountId)
.withConfigId(configurationId)
.withTags(tags)
);
} 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();
}
}
}
```
# Excluir tags de recursos da AWS de um painel da Lente de Armazenamento do S3
Os exemplos a seguir demonstram como excluir tags de recursos da AWS de um painel existente 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
**Como excluir tags de recursos da AWS de um painel existente 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, acesse **Lente de Armazenamento**.
1. Escolha **Painéis**.
1. Selecione botão de opção da configuração do painel da Lente de Armazenamento que você deseja visualizar. Depois, selecione **Visualizar configuração do painel**.
1. Em **Tags**, revise as tags associadas ao painel.
1. Escolha **Remover** ao lado da tag que você deseja remover.
1. Escolha **Salvar alterações**.
## Como usar o AWS CLI
O comando AWS CLI a seguir exclui tags de recursos da AWS de um painel existente da Lente de Armazenamento. Para usar esse exemplo de comando, substitua os `user input placeholders` por suas próprias informações.
**Example**
```
aws s3control delete-storage-lens-configuration-tagging --account-id=222222222222 --config-id=your-configuration-id --region=us-east-1
```
## Usar o AWS SDK para Java
O exemplo do AWS SDK para Java a seguir exclui uma tag de recurso da AWS do painel da Lente de Armazenamento usando o nome do recurso da Amazon (ARN) especificado na conta `111122223333`. Para usar esse exemplo, substitua os `user input placeholders` por suas próprias informações.
**Example – Excluir tags de uma configuração de painel da Lente de Armazenamento do S3**
```
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.DeleteStorageLensConfigurationTaggingRequest;
import static com.amazonaws.regions.Regions.US_WEST_2;
public class DeleteDashboardTagging {
public static void main(String[] args) {
String configurationId = "ConfigurationId";
String sourceAccountId = "111122223333";
try {
AWSS3Control s3ControlClient = AWSS3ControlClient.builder()
.withCredentials(new ProfileCredentialsProvider())
.withRegion(US_WEST_2)
.build();
s3ControlClient.deleteStorageLensConfigurationTagging(new DeleteStorageLensConfigurationTaggingRequest()
.withAccountId(sourceAccountId)
.withConfigId(configurationId)
);
} 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();
}
}
}
```
# Arquivos auxiliares para usar o Amazon S3 Storage Lens
Use os seguintes arquivos JSON e suas principais entradas para seus exemplos.
## Exemplo de configuração da Lente de Armazenamento do S3 em JSON
**Example `config.json`**
O arquivo `config.json` contém os detalhes de uma configuração de *métricas e recomendações avançadas* para organizações da Lente de Armazenamento do S3. Para usar o exemplo a seguir, substitua `user input placeholders` por suas próprias informações.
Aplicam-se cobranças adicionais para métricas e recomendações avançadas. Para obter mais informações, consulte [Métricas e recomendações avançadas](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage_lens_basics_metrics_recommendations.html#storage_lens_basics_metrics_selection).
```
{
"Id": "SampleS3StorageLensConfiguration", //Use this property to identify your S3 Storage Lens configuration.
"AwsOrg": { //Use this property when enabling S3 Storage Lens for AWS Organizations.
"Arn": "arn:aws:organizations::123456789012:organization/o-abcdefgh"
},
"AccountLevel": {
"ActivityMetrics": {
"IsEnabled":true
},
"AdvancedCostOptimizationMetrics": {
"IsEnabled":true
},
"AdvancedDataProtectionMetrics": {
"IsEnabled":true
},
"DetailedStatusCodesMetrics": {
"IsEnabled":true
},
"BucketLevel": {
"ActivityMetrics": {
"IsEnabled":true
},
"AdvancedDataProtectionMetrics": {
"IsEnabled":true
},
"AdvancedCostOptimizationMetrics": {
"IsEnabled":true
},
"DetailedStatusCodesMetrics": {
"IsEnabled":true
},
"PrefixLevel":{
"StorageMetrics":{
"IsEnabled":true,
"SelectionCriteria":{
"MaxDepth":5,
"MinStorageBytesPercentage":1.25,
"Delimiter":"/"
}
}
}
}
},
"Exclude": { //Replace with "Include" if you prefer to include Regions.
"Regions": [
"eu-west-1"
],
"Buckets": [ //This attribute is not supported for AWS Organizations-level configurations.
"arn:aws:s3:::amzn-s3-demo-source-bucket"
]
},
"IsEnabled": true, //Whether the configuration is enabled
"DataExport": { //Details about the metrics export
"S3BucketDestination": {
"OutputSchemaVersion": "V_1",
"Format": "CSV", //You can add "Parquet" if you prefer.
"AccountId": "111122223333",
"Arn": "arn:aws:s3:::
amzn-s3-demo-destination-bucket", // The destination bucket for your metrics export must be in the same Region as your S3 Storage Lens configuration.
"Prefix": "prefix-for-your-export-destination",
"Encryption": {
"SSES3": {}
}
},
"CloudWatchMetrics": {
"IsEnabled": true
}
}
}
```
## Exemplo de configuração da Lente de Armazenamento do S3 com grupos da Lente de Armazenamento em JSON
**Example `config.json`**
O arquivo `config.json` contém os detalhes para aplicar à configuração de Lente de Armazenamento ao usar grupos de Lente de Armazenamento. Para usar o exemplo, substitua `user input placeholders` pelas suas próprias informações.
Para anexar todos os grupos da Lente de Armazenamento ao seu painel, atualize a configuração da Lente de Armazenamento com a seguinte sintaxe:
```
{
"Id": "ExampleS3StorageLensConfiguration",
"AccountLevel": {
"ActivityMetrics": {
"IsEnabled":true
},
"AdvancedCostOptimizationMetrics": {
"IsEnabled":true
},
"AdvancedDataProtectionMetrics": {
"IsEnabled":true
},
"BucketLevel": {
"ActivityMetrics": {
"IsEnabled":true
},
"StorageLensGroupLevel": {},
"IsEnabled": true
}
```
Para incluir apenas dois grupos da Lente de Armazenamento na configuração do painel da Lente de Armazenamento (*slg-1* and *slg-2*), use a seguinte sintaxe:
```
{
"Id": "ExampleS3StorageLensConfiguration",
"AccountLevel": {
"ActivityMetrics": {
"IsEnabled":true
},
"AdvancedCostOptimizationMetrics": {
"IsEnabled":true
},
"AdvancedDataProtectionMetrics": {
"IsEnabled":true
},
"BucketLevel": {
"ActivityMetrics": {
"IsEnabled":true
},
"StorageLensGroupLevel": {
"SelectionCriteria": {
"Include": [
"arn:aws:s3:us-east-1:111122223333:storage-lens-group/slg-1",
"arn:aws:s3:us-east-1:444455556666:storage-lens-group/slg-2"
]
},
"IsEnabled": true
}
```
Para impedir que apenas determinados grupos da Lente de Armazenamento sejam anexados à configuração do seu painel, use a seguinte sintaxe:
```
{
"Id": "ExampleS3StorageLensConfiguration",
"AccountLevel": {
"ActivityMetrics": {
"IsEnabled":true
},
"AdvancedCostOptimizationMetrics": {
"IsEnabled":true
},
"AdvancedDataProtectionMetrics": {
"IsEnabled":true
},
"BucketLevel": {
"ActivityMetrics": {
"IsEnabled":true
},
"StorageLensGroupLevel": {
"SelectionCriteria": {
"Exclude": [
"arn:aws:s3:us-east-1:111122223333:storage-lens-group/slg-1",
"arn:aws:s3:us-east-1:444455556666:storage-lens-group/slg-2"
]
},
"IsEnabled": true
}
```
## Configuração de tags de exemplo da Lente de Armazenamento do S3 em JSON
**Example `tags.json`**
O arquivo `tags.json` contém as etiquetas que você deseja aplicar à configuração da Lente de Armazenamento do S3. Para usar esse exemplo, substitua os `user input placeholders` por suas próprias informações.
```
[
{
"Key": "key1",
"Value": "value1"
},
{
"Key": "key2",
"Value": "value2"
}
]
```
## Exemplo de configuração da Lente de Armazenamento do S3 Permissões IAM
**Example `permissions.json`: nome de painel específico**
Este exemplo de política mostra um arquivo `permissions.json` do IAM da Lente de Armazenamento do S3 com um nome de painel especificado. Substitua *`value1`*, `us-east-1`, `your-dashboard-name` e `example-account-id` pelos seus próprios valores.
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"s3:GetStorageLensConfiguration",
"s3:DeleteStorageLensConfiguration",
"s3:PutStorageLensConfiguration"
],
"Condition": {
"StringEquals": {
"aws:ResourceTag/key1": "value1"
}
},
"Resource": "arn:aws:s3:us-east-1:111122223333:storage-lens/your-dashboard-name"
}
]
}
```
**Example `permissions.json`: sem um nome de painel específico**
Este exemplo de política mostra um arquivo `permissions.json` do IAM da Lente de Armazenamento do S3 sem um nome de painel especificado. Substitua *`value1`*, `us-east-1` e `example-account-id` pelos seus próprios valores.
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"s3:GetStorageLensConfiguration",
"s3:DeleteStorageLensConfiguration",
"s3:PutStorageLensConfiguration"
],
"Condition": {
"StringEquals": {
"aws:ResourceTag/key1": "value1"
}
},
"Resource": "arn:aws:s3:us-east-1:111122223333:storage-lens/*"
}
]
}
```