# Trabalhar com grupos da Lente de Armazenamento do S3 para filtrar e agregar métricas
Um grupo da Lente de Armazenamento do Amazon S3 agrega métricas usando filtros personalizados com base nos metadados do objeto. Os grupos da Lente de Armazenamento ajudam a detalhar as características dos dados, como distribuição de objetos por idade, tipos de arquivo mais comuns e muito mais. Por exemplo, você pode filtrar métricas por tag de objeto para identificar conjuntos de dados de crescimento mais rápido ou visualizar armazenamento com base no tamanho e na idade do objeto para informar a estratégia de arquivamento de armazenamento. Como resultado, os grupos da Lente de Armazenamento do Amazon S3 ajudam a entender e otimizar o armazenamento do S3.
Ao usar grupos da Lente de Armazenamento, você pode analisar e filtrar as métricas da Lente de Armazenamento do S3 usando metadados de objetos, como prefixos, sufixos, [tags de objetos](https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-tagging.html), tamanho do objeto ou idade do objeto. Também é possível aplicar uma combinação desses filtros. Depois de anexar o grupo da Lente de Armazenamento ao painel da Lente de Armazenamento do S3, você pode visualizar as métricas da Lente de Armazenamento do S3 agregadas pelos grupos da Lente de Armazenamento do Amazon S3 diretamente no seu painel.
Você também pode filtrar métricas por tamanho de objeto ou faixa etária para determinar qual parte do armazenamento consiste em objetos pequenos. Você pode usar essas informações com o S3 Intelligent-Tiering ou o S3 Lifecycle para fazer a transição de objetos pequenos para diferentes classes de armazenamento a fim de otimizar custos e armazenamento.
**Topics**
+ [Como funcionam os grupos de Lente de Armazenamento do S3](storage-lens-groups.md)
+ [Uso de grupos da Lente de Armazenamento](storage-lens-group-tasks.md)
# Como funcionam os grupos de Lente de Armazenamento do S3
Você pode usar grupos da Lente de Armazenamento para agregar métricas usando filtros personalizados com base em metadados de objetos. Ao definir um filtro personalizado, você pode usar prefixos, sufixos, tags de objeto, tamanhos de objeto, idade do objeto ou uma combinação desses filtros personalizados. Durante a criação do grupo da Lente de Armazenamento, você também pode incluir um único filtro ou várias condições de filtro. Para especificar várias condições de filtro, você usa os operadores lógicos `And` ou `Or`.
Ao criar e configurar um grupo da Lente de Armazenamento, o próprio grupo da Lente de Armazenamento atua como um filtro personalizado no painel ao qual você anexa o grupo. No painel, você pode usar o filtro de grupo da Lente de Armazenamento para obter métricas de armazenamento com base no filtro personalizado definido no grupo.
Para visualizar os dados do grupo da Lente de Armazenamento no painel da Lente de Armazenamento do S3, você deve anexar o grupo ao painel depois de criá-lo. Depois que o grupo da Lente de Armazenamento for anexado ao painel da Lente de Armazenamento, o painel coletará métricas de uso de armazenamento em 48 horas. Visualize dados no painel da Lente de Armazenamento ou exporte por meio de uma exportação de métricas. Caso você se esqueça de anexar um grupo da Lente de Armazenamento a um painel, os dados do grupo da Lente de Armazenamento não serão capturados nem exibidos em nenhum lugar.
**nota**
Ao criar um grupo da Lente de Armazenamento do S3, você está criando um recurso AWS. Portanto, cada grupo da Lente de Armazenamento tem o próprio nome do recurso da Amazon (ARN), que você pode especificar ao [anexá-lo ou excluí-lo de um painel da Lente de Armazenamento do S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage-lens-groups-dashboard-console.html).
Se o seu grupo da Lente de Armazenamento não estiver anexado a um painel, você não incorrerá em nenhuma cobrança adicional pela criação de um grupo da Lente de Armazenamento.
A Lente de Armazenamento do S3 agrega métricas de uso de um objeto em todos os grupos da Lente de Armazenamento correspondentes. Portanto, se um objeto corresponder às condições de filtro de dois ou mais grupos da Lente de Armazenamento, você verá contagens repetidas do mesmo objeto em todo o uso do armazenamento.
Você pode criar um grupo da Lente de Armazenamento no nível da conta em uma região inicial especificada (na lista de suportes Regiões da AWS). Em seguida, você pode anexar seu grupo da Lente de Armazenamento a vários painéis da Lente de Armazenamento, desde que os painéis estejam no mesmo Conta da AWS e região inicial. Você pode criar até 50 grupos da Lente de Armazenamento por região inicial em cada Conta da AWS.
Você pode criar e gerenciar grupos de Lente de Armazenamento do S3 usando o console do Amazon S3, AWS Command Line Interface (AWS CLI), AWS SDKs ou a API REST do Amazon S3.
**Topics**
+ [Ver métricas agregadas do grupo da Lente de Armazenamento](#storage-lens-group-aggregation)
+ [Permissões de grupos de Lente de Armazenamento](#storage-lens-group-permissions)
+ [Configuração de grupos da Lente de Armazenamento](#storage-lens-groups-configuration)
+ [Tags de recursos AWS](#storage-lens-group-resource-tags)
+ [Exportação de métricas de grupos da Lente de Armazenamento](#storage-lens-groups-metrics-export)
## Ver métricas agregadas do grupo da Lente de Armazenamento
Você pode ver as métricas agregadas dos seus grupos da Lente de Armazenamento ao anexar os grupos a um painel. Os grupos da Lente de Armazenamento que deseja anexar devem estar na região inicial designada na conta do painel.
Para anexar um grupo da Lente de Armazenamento a um painel, você deve especificar o grupo na **Seção de agregação do grupo da Lente de Armazenamento** da configuração do seu painel. Se você tiver vários grupos da Lente de Armazenamento, poderá filtrar os resultados da **agregação do grupo da Lente de Armazenamento** para incluir ou excluir apenas os grupos desejados. Para obter mais informações sobre como anexar grupos aos seus painéis, consulte [Anexar ao painel ou remover do painel grupos da Lente de Armazenamento do S3](storage-lens-groups-dashboard-console.md).
Depois de anexar seus grupos, você verá os dados adicionais de agregação de grupos da Lente de Armazenamento em seu painel dentro de 48 horas.
**nota**
Para ver métricas agregadas para seu grupo da Lente de Armazenamento, você deve anexar o grupo a um painel da Lente de Armazenamento do S3.
## Permissões de grupos de Lente de Armazenamento
Os grupos de Lente de Armazenamento exigem determinadas permissões no AWS Identity and Access Management (IAM) para autorizar o acesso às ações do grupo de Lente de Armazenamento do S3. Para conceder essas permissões, você pode usar uma política do IAM baseada em identidade. Você pode vincular essa política a usuários, grupos ou funções do IAM para conceder permissões. Essas permissões podem incluir a capacidade de criar ou excluir grupos da Lente de Armazenamento, visualizar suas configurações ou gerenciar suas tags.
O usuário ou função do IAM ao qual você concede permissões deve pertencer à conta que criou ou é proprietária do grupo da Lente de Armazenamento.
Para usar grupos da Lente de Armazenamento e ver as métricas dos grupos da Lente de Armazenamento, primeiro você deve ter as permissões apropriadas para usar a Lente de Armazenamento do S3. Para obter mais informações, consulte [Configurar permissões da Lente de Armazenamento do Amazon S3](storage_lens_iam_permissions.md).
Para criar e gerenciar grupos da Lente de Armazenamento do S3, você deve ter as seguintes permissões do IAM, dependendo das ações que deseja executar:
| Ação | Permissões do IAM |
| --- | --- |
| Criar grupo da Lente de Armazenamento | `s3:CreateStorageLensGroup` |
| Criar grupo da Lente de Armazenamento com tags | `s3:CreateStorageLensGroup`, `s3:TagResource` |
| Atualizar um grupo da Lente de Armazenamento existente | `s3:UpdateStorageLensGroup` |
| Gerar os detalhes de uma configuração de grupo da Lente de Armazenamento | `s3:GetStorageLensGroup` |
| Listar todos os grupos da Lente de Armazenamento na região de origem | `s3:ListStorageLensGroups` |
| Excluir um grupo da Lente de Armazenamento | `s3:DeleteStorageLensGroup` |
| Listar as tags que foram adicionadas ao seu grupo da Lente de Armazenamento | `s3:ListTagsForResource` |
| Adicionar ou atualizar uma tag de grupo da Lente de Armazenamento para um grupo da Lente de Armazenamento existente | `s3:TagResource` |
| Excluir uma tag de um grupo da Lente de Armazenamento | `s3:UntagResource` |
Veja um exemplo de como configurar a política do IAM na conta que cria o grupo da Lente de Armazenamento. Para usar essa política, substitua `us-east-1` pela região inicial em que seu grupo e Lente de Armazenamento está localizado. Substitua `111122223333` pelo seu Conta da AWS ID e substitua `example-storage-lens-group` pelo nome do seu grupo da Lente de Armazenamento. Para aplicar essas permissões a todos os grupos da Lente de Armazenamento, substitua `example-storage-lens-group` por `*`.
```
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "EXAMPLE-Statement-ID",
"Effect": "Allow",
"Action": [
"s3:CreateStorageLensGroup",
"s3:UpdateStorageLensGroup",
"s3:GetStorageLensGroup",
"s3:ListStorageLensGroups",
"s3:DeleteStorageLensGroup,
"s3:TagResource",
"s3:UntagResource",
"s3:ListTagsForResource"
],
"Resource": "arn:aws:s3:us-east-1:111122223333:storage-lens-group/example-storage-lens-group"
}
]
}
```
Para obter mais informações sobre as permissões de Lente de Armazenamento do S3, consulte [Configurar permissões da Lente de Armazenamento do Amazon S3](storage_lens_iam_permissions.md). Para obter mais informações sobre a linguagem da política do IAM, consulte [Políticas e permissões no Amazon S3](access-policy-language-overview.md).
## Configuração de grupos da Lente de Armazenamento
### Nome do grupo da Lente de Armazenamento do S3
Recomendamos dar nomes aos grupos da Lente de Armazenamento que indiquem a finalidade para determinar quais grupos anexar aos seus painéis. Para [anexar um grupo da Lente de Armazenamento a um painel](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage-lens-groups-dashboard-console.html), você deve especificar o grupo na **Seção de agregação do grupo da Lente de Armazenamento** da configuração do painel.
Os nomes dos grupos de Lente de Armazenamento devem ser exclusivos na conta. Eles não devem exceder 64 caracteres e podem conter apenas letras (a–z, A–Z), números (0–9), hifens (`-`) e sublinhados (`_`).
### Região inicial
A região inicial é a Região da AWS em que o grupo da Lente de Armazenamento é criado e mantido. O grupo da Lente de Armazenamento é criado na mesma região inicial do painel da Lente de Armazenamento do Amazon S3. A configuração e as métricas do grupo da Lente de Armazenamento também são armazenadas nessa região. Você pode criar até 50 grupos da Lente de Armazenamento em uma região local.
Depois de criar seu grupo da Lente de Armazenamento, você não poderá editar a região inicial.
### Escopo
Para incluir objetos no grupo da Lente de Armazenamento, eles devem estar no escopo do painel da Lente de Armazenamento do Amazon S3. O escopo do painel da Lente de Armazenamento é determinado pelos buckets incluídos no **Escopo do painel** da configuração do painel da Lente de Armazenamento do S3.
Você pode usar filtros diferentes para seus objetos a fim de definir o escopo do seu grupo da Lente de Armazenamento. Para ver essas métricas de grupo da Lente de Armazenamento no painel da Lente de Armazenamento do S3, os objetos devem corresponder aos filtros incluídos nos grupos da Lente de Armazenamento. Por exemplo, suponha que seu grupo da Lente de Armazenamento inclua objetos com o prefixo `marketing` e o sufixo `.png`, mas nenhum objeto corresponda a esses critérios. Nesse caso, as métricas desse grupo da Lente de Armazenamento não serão geradas na exportação diária de métricas e nenhuma métrica desse grupo ficará visível no seu painel.
### Filtros
Você pode usar os seguintes filtros em um grupo da Lente de Armazenamento do S3:
+ **Prefixos**: especifica o [prefixo](https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-prefixes.html) dos objetos incluídos, que é uma sequência de caracteres no início do nome da chave do objeto. Por exemplo, um valor de `images` para o filtro **Prefixos** inclui objetos com qualquer um dos seguintes prefixos: `images/`, `images-marketing` e `images/production`. O comprimento máximo de um prefixo é 1.024 bytes.
+ **Sufixos**: especifica o sufixo dos objetos incluídos (por exemplo, `.png`, `.jpeg` ou `.csv`). O comprimento máximo de um sufixo é 1.024 bytes.
+ **Tags de objeto**: especifica a lista de [tags de objeto](https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-tagging.html) que você deseja filtrar. Uma chave de tag não pode exceder 128 caracteres Unicode, e um valor de tag não pode exceder 256 caracteres Unicode. Se o campo de valor da etiqueta do objeto ficar vazio, os grupos da Lente de Armazenamento do S3 só associarão o objeto a outros objetos que também tenham valores de etiqueta vazios.
+ **Idade**: especifica o intervalo de idade do objeto incluído em dias. Somente números inteiros são compatíveis.
+ **Tamanho**: especifica o intervalo de tamanho dos objetos incluídos em bytes. Somente números inteiros são compatíveis. O valor máximo permitido é 50 TB.
### Tags de objeto do grupo da Lente de Armazenamento
Você pode [criar um grupo da Lente de Armazenamento](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage-lens-groups-create.html) que inclua até 10 filtros de tags de objetos. O exemplo a seguir inclui dois pares de valores-chave de tags de objeto como filtros para um grupo da Lente de Armazenamento denominado `Marketing-Department`. Para usar esse exemplo, substitua `Marketing-Department` pelo nome do seu grupo e substitua `object-tag-key-1`, `object-tag-value-1` e assim por diante pelos pares de valores-chave da tag de objeto que você deseja filtrar.
```
{
"Name": "Marketing-Department",
"Filter": {
"MatchAnyTag":[
{
"Key": "object-tag-key-1",
"Value": "object-tag-value-1"
},
{
"Key": "object-tag-key-2",
"Value": "object-tag-value-2"
}
]
}
}
```
### Operadores lógicos (`And` ou `Or`)
Para incluir diversas condições de filtro em seu grupo da Lente de Armazenamento, use operadores lógicos (tanto `And` quanto `Or`). No exemplo a seguir, o grupo e Lente de Armazenamento `Marketing-Department` contém um operador `And` com os filtros `Prefix`, `ObjectAge` e `ObjectSize`. Como um operador `And` é usado, somente objetos que correspondam a **todas** as condições de filtro serão incluídos no escopo do grupo da Lente de Armazenamento.
Para usar esse exemplo, substitua `user input placeholders` pelos valores que você deseja filtrar.
```
{
"Name": "Marketing-Department",
"Filter": {
"And": {
"MatchAnyPrefix": [
"prefix-1",
"prefix-2",
"prefix-3/sub-prefix-1"
],
"MatchObjectAge": {
"DaysGreaterThan": 10,
"DaysLessThan": 60
},
"MatchObjectSize": {
"BytesGreaterThan": 10,
"BytesLessThan": 60
}
}
}
}
```
**nota**
Se desejar incluir objetos que correspondam a **qualquer** uma das condições nos filtros, substitua o operador lógico `And` pelo operador lógico `Or` deste exemplo.
## Tags de recursos AWS
Cada grupo da Lente de Armazenamento do S3 é contado como um recurso AWS com seu próprio nome do recurso da Amazon (ARN). Portanto, ao configurar o grupo da Lente de Armazenamento, você tem a opção de adicionar tags de recursos AWS ao grupo. Você pode adicionar até 50 tags para cada grupo da Lente de Armazenamento. Para criar um grupo da Lente de Armazenamento com tags, você deve ter as permissões `s3:CreateStorageLensGroup` e `s3:TagResource`.
Use tags de recursos AWS para categorizar os recursos de acordo com o departamento, a linha de negócios ou o projeto. Fazer isso é útil quando você tem muitos recursos do mesmo tipo. Ao aplicar tags, é possível identificar rapidamente um grupo específico da Lente de Armazenamento com base nas tags atribuídas a ele. Você também pode usar tags para rastrear e alocar custos.
Além disso, ao adicionar uma tag de recursos AWS ao grupo da Lente de Armazenamento, você ativa o [controle de acesso por atributo (ABAC)](https://docs.aws.amazon.com/IAM/latest/UserGuide/introduction_attribute-based-access-control.html). ABAC é uma estratégia de autorização que define permissões com base em atributos, neste caso, tags. É possível usar condições que especificam tags de recursos nas políticas do IAM para [controlar o acesso aos recursos AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html#access_tags_control-resources).
É possível editar chaves de tags e valores e é possível remover as tags de um recurso a qualquer momento. Além disso, esteja ciente das seguintes limitações:
+ As chaves e os valores das tags diferenciam maiúsculas de minúsculas.
+ Ao adicionar uma tag que tenha a mesma chave de uma tag existente nesse recurso, o novo valor substituirá o antigo.
+ Se você excluir um recurso, todas as tags do recurso também serão excluídas.
+ Não inclua dados privados ou confidenciais nas tags de recursos AWS.
+ As tags do sistema (ou tags com chaves de tag 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.
## Exportação de métricas de grupos da Lente de Armazenamento
As métricas do grupo da Lente de Armazenamento do S3 estão incluídas na [exportação de métricas de lente de armazenamento do Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage_lens_understanding_metrics_export_schema.html) para o painel ao qual o grupo da Lente de Armazenamento está anexado. Para obter informações gerais sobre o recurso de exportação de métricas da Lente de Armazenamento, consulte [Exibição de métricas de lente de armazenamento do Amazon S3 usando uma exportação de dados](storage_lens_view_metrics_export.md).
A exportação de métricas para grupos da Lente de Armazenamento inclui quaisquer métricas da Lente de Armazenamento do S3 que estejam no escopo do painel ao qual você anexou o grupo da Lente de Armazenamento. A exportação também inclui dados de métricas adicionais para grupos da Lente de Armazenamento.
Depois de criar seu grupo da Lente de Armazenamento, sua exportação de métricas será enviada diariamente para o bucket selecionado ao configurar a exportação de métricas para o painel ao qual seu grupo está anexado. Pode levar até 48 horas para você receber a primeira exportação de métricas.
Para gerar métricas na exportação diária, os objetos devem corresponder aos filtros incluídos nos grupos da Lente de Armazenamento. Se nenhum objeto corresponder aos filtros incluídos no grupo da Lente de Armazenamento, nenhuma métrica será gerada. No entanto, se um objeto corresponder a dois ou mais grupos da Lente de Armazenamento, o objeto será listado separadamente para cada grupo quando aparecer na exportação de métricas.
Você pode identificar métricas para grupos da Lente de Armazenamento procurando um dos seguintes valores na coluna `record_type` de exportação de métricas do seu painel:
+ `STORAGE_LENS_GROUP_BUCKET`
+ `STORAGE_LENS_GROUP_ACCOUNT`
A coluna `record_value` mostra o ARN do recurso para o grupo da Lente de Armazenamento (por exemplo, `arn:aws:s3:us-east-1:111122223333:storage-lens-group/Marketing-Department`).
# Uso de grupos da Lente de Armazenamento
A Lente de Armazenamento do Amazon S3 agrega métricas usando filtros personalizados com base nos metadados do objeto. Você pode analisar e filtrar as métricas da Lente de Armazenamento do S3 usando prefixos, sufixos, tags de objetos, tamanho do objeto ou idade do objeto. Com grupos da Lente de Armazenamento do Amazon S3, você também pode categorizar seu uso dentro de buckets e por meio deles no Amazon S3. Consequentemente, você poderá entender e otimizar melhor o armazenamento S3.
Para começar a visualizar os dados de um grupo da Lente de Armazenamento, você deve primeiro [anexar o grupo da Lente de Armazenamento a um painel da Lente de Armazenamento do S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage-lens-groups-dashboard-console.html#storage-lens-groups-attach-dashboard-console). Se precisar gerenciar grupos da Lente de Armazenamento no painel, edite a configuração do painel. Para verificar quais grupos da Lente de Armazenamento estão na sua conta, você pode listá-los. Para verificar quais grupos da Lente de Armazenamento estão anexados ao seu painel, verifique a guia **Grupos da Lente de Armazenamento** no painel. Para revisar ou atualizar o escopo de um grupo da Lente de Armazenamento existente, visualize os detalhes. Você também pode excluir permanentemente um grupo da Lente de Armazenamento.
Para gerenciar permissões, você pode criar e adicionar tags de recursos AWS definidas pelo usuário aos seus grupos da Lente de Armazenamento. Use tags de recursos AWS para categorizar os recursos de acordo com o departamento, a linha de negócios ou o projeto. Fazer isso é útil quando você tem muitos recursos do mesmo tipo. Ao aplicar tags, é possível identificar rapidamente um grupo específico da Lente de Armazenamento com base nas tags atribuídas a ele.
Além disso, ao adicionar uma tag de recursos AWS ao grupo da Lente de Armazenamento, você ativa o [controle de acesso por atributo (ABAC)](https://docs.aws.amazon.com/IAM/latest/UserGuide/introduction_attribute-based-access-control.html). ABAC é uma estratégia de autorização que define permissões com base em atributos, neste caso, tags. É possível usar condições que especificam tags de recursos nas políticas do IAM para [controlar o acesso aos recursos AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html#access_tags_control-resources).
**Topics**
+ [Criação de grupo da Lente de Armazenamento](storage-lens-groups-create.md)
+ [Anexar ao painel ou remover do painel grupos da Lente de Armazenamento do S3](storage-lens-groups-dashboard-console.md)
+ [Visualização de dados dos grupos da Lente de Armazenamento](storage-lens-groups-visualize.md)
+ [Atualização do grupo da Lente de Armazenamento](storage-lens-groups-update.md)
+ [Gerenciamento de tags de recursos AWS com grupos da Lente de Armazenamento](storage-lens-groups-manage-tags.md)
+ [Listagem de todos os grupos da Lente de Armazenamento](storage-lens-groups-list.md)
+ [Visualização de detalhes do grupo da Lente de Armazenamento](storage-lens-groups-view.md)
+ [Exclusão de grupo da Lente de Armazenamento](storage-lens-groups-delete.md)
# Criação de grupo da Lente de Armazenamento
Os exemplos a seguir demonstram como criar um grupo da Lente de Armazenamento do Amazon S3 usando o console do Amazon S3AWS Command Line Interface, (AWS CLI) e AWS SDK para Java.
## Usar o console do S3
**Para criar um grupo da Lente de Armazenamento**
1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon S3 em [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).
1. Na barra de navegação na parte superior da página, escolha o nome da região da AWS exibida no momento. Em seguida, escolha a região para a qual você deseja mudar.
1. No painel de navegação à esquerda, selecione **Grupos de Lente de Armazenamento**.
1. Selecione **Criar grupo da Lente de Armazenamento**.
1. Em **Geral**, visualize sua **Região de origem** e insira o **Nome do grupo do Storage Lens**.
1. Em **Escopo**, selecione o filtro para aplicar ao seu grupo da Lente de Armazenamento. Para aplicar vários filtros, selecione os filtros e, em seguida, escolha o operador lógico **AND** ou **OR**.
+ Para o filtro **Prefixos**, selecione **Prefixos** e insira uma sequência de prefixo. Para adicionar vários prefixos, selecione **Adicionar prefixo**. Para remover um prefixo, selecione **Remover** ao lado do prefixo para remover.
+ Para o filtro **Tags de objeto**, selecione **Tags de objeto** e insira o par de valores-chave para seu objeto. Selecione **Adicionar tag**. Para remover uma tag, selecione **Remover** ao lado da tag para remover.
+ Para o filtro **Sufixos**, selecione **Sufixos** e insira uma sequência de sufixo. Para adicionar vários sufixos, selecione **Adicionar sufixo**. Para remover um sufixo, selecione **Remover** ao lado do sufixo para remover.
+ Para o filtro **Idade**, especifique a faixa etária do objeto em dias. Selecione **Especificar idade mínima do objeto** e insira a idade mínima do objeto. Em seguida, selecione **Especificar idade máxima do objeto** e insira a idade máxima do objeto.
+ Para o filtro **Tamanho**, especifique a faixa de tamanho do objeto e a unidade de medida. Selecione **Especificar tamanho mínimo do objeto** e insira o tamanho mínimo do objeto. Selecione **Especificar tamanho máximo do objeto** e insira o tamanho máximo do objeto.
1. (Opcional) Para tags de recursos AWS, adicione o par de valores-chave e selecione **Adicionar tag**.
1. Selecione **Criar grupo da Lente de Armazenamento**.
## Como usar o AWS CLI
O comando de exemplo AWS CLI a seguir cria um grupo de Lente de Armazenamento. Para usar esse exemplo de comando, substitua os `user input placeholders` por suas próprias informações.
```
aws s3control create-storage-lens-group --account-id 111122223333 \
--region us-east-1 --storage-lens-group=file://./marketing-department.json
```
O comando de exemplo AWS CLI a seguir cria um grupo da Lente de Armazenamento com duas tags de recursos AWS. Para usar esse exemplo de comando, substitua os `user input placeholders` por suas próprias informações.
```
aws s3control create-storage-lens-group --account-id 111122223333 \
--region us-east-1 --storage-lens-group=file://./marketing-department.json \
--tags Key=k1,Value=v1 Key=k2,Value=v2
```
Para obter configurações de exemplo JSON, consulte [Configuração de grupos da Lente de Armazenamento](storage-lens-groups.md#storage-lens-groups-configuration).
## Usar o AWS SDK para Java
O exemplo AWS SDK para Java a seguir cria um grupo da Lente de Armazenamento Para usar esse exemplo, substitua os `user input placeholders` por suas próprias informações.
**Example — Crie um grupo da Lente de Armazenamento com um único filtro**
O exemplo a seguir cria um grupo de Lente de Armazenamento chamado `Marketing-Department`. Esse grupo tem um filtro de idade do objeto que especifica a faixa etária em `30` para `90` dias. Para usar esse exemplo, substitua os `user input placeholders` por suas próprias informações.
```
package aws.example.s3control;
import com.amazonaws.AmazonServiceException;
import com.amazonaws.SdkClientException;
import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider;
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.s3control.S3ControlClient;
import software.amazon.awssdk.services.s3control.model.CreateStorageLensGroupRequest;
import software.amazon.awssdk.services.s3control.model.MatchObjectAge;
import software.amazon.awssdk.services.s3control.model.StorageLensGroup;
import software.amazon.awssdk.services.s3control.model.StorageLensGroupFilter;
public class CreateStorageLensGroupWithObjectAge {
public static void main(String[] args) {
String storageLensGroupName = "Marketing-Department";
String accountId = "111122223333";
try {
StorageLensGroupFilter objectAgeFilter = StorageLensGroupFilter.builder()
.matchObjectAge(MatchObjectAge.builder()
.daysGreaterThan(30)
.daysLessThan(90)
.build())
.build();
StorageLensGroup storageLensGroup = StorageLensGroup.builder()
.name(storageLensGroupName)
.filter(objectAgeFilter)
.build();
CreateStorageLensGroupRequest createStorageLensGroupRequest = CreateStorageLensGroupRequest.builder()
.storageLensGroup(storageLensGroup)
.accountId(accountId).build();
S3ControlClient s3ControlClient = S3ControlClient.builder()
.region(Region.US_WEST_2)
.credentialsProvider(ProfileCredentialsProvider.create())
.build();
s3ControlClient.createStorageLensGroup(createStorageLensGroupRequest);
} catch (AmazonServiceException e) {
// The call was transmitted successfully, but Amazon S3 couldn't process
// it and returned an error response.
e.printStackTrace();
} catch (SdkClientException e) {
// Amazon S3 couldn't be contacted for a response, or the client
// couldn't parse the response from Amazon S3.
e.printStackTrace();
}
}
}
```
**Example — Crie um grupo da Lente de Armazenamento com um operador `AND` que inclua vários filtros**
O exemplo a seguir cria um grupo de Lente de Armazenamento chamado `Marketing-Department`. Este grupo utiliza o operador `AND` para indicar que os objetos devem corresponder a **todas** as condições de filtro. Para usar esse exemplo, substitua os `user input placeholders` por suas próprias informações.
```
package aws.example.s3control;
import com.amazonaws.AmazonServiceException;
import com.amazonaws.SdkClientException;
import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider;
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.s3control.S3ControlClient;
import software.amazon.awssdk.services.s3control.model.CreateStorageLensGroupRequest;
import software.amazon.awssdk.services.s3control.model.MatchObjectAge;
import software.amazon.awssdk.services.s3control.model.MatchObjectSize;
import software.amazon.awssdk.services.s3control.model.S3Tag;
import software.amazon.awssdk.services.s3control.model.StorageLensGroup;
import software.amazon.awssdk.services.s3control.model.StorageLensGroupAndOperator;
import software.amazon.awssdk.services.s3control.model.StorageLensGroupFilter;
public class CreateStorageLensGroupWithAndFilter {
public static void main(String[] args) {
String storageLensGroupName = "Marketing-Department";
String accountId = "111122223333";
try {
// Create object tags.
S3Tag tag1 = S3Tag.builder()
.key("object-tag-key-1")
.value("object-tag-value-1")
.build();
S3Tag tag2 = S3Tag.builder()
.key("object-tag-key-2")
.value("object-tag-value-2")
.build();
StorageLensGroupAndOperator andOperator = StorageLensGroupAndOperator.builder()
.matchAnyPrefix("prefix-1", "prefix-2", "prefix-3/sub-prefix-1")
.matchAnySuffix(".png", ".gif", ".jpg")
.matchAnyTag(tag1, tag2)
.matchObjectAge(MatchObjectAge.builder()
.daysGreaterThan(30)
.daysLessThan(90).build())
.matchObjectSize(MatchObjectSize.builder()
.bytesGreaterThan(1000L)
.bytesLessThan(6000L).build())
.build();
StorageLensGroupFilter andFilter = StorageLensGroupFilter.builder()
.and(andOperator)
.build();
StorageLensGroup storageLensGroup = StorageLensGroup.builder()
.name(storageLensGroupName)
.filter(andFilter)
.build();
CreateStorageLensGroupRequest createStorageLensGroupRequest = CreateStorageLensGroupRequest.builder()
.storageLensGroup(storageLensGroup)
.accountId(accountId).build();
S3ControlClient s3ControlClient = S3ControlClient.builder()
.region(Region.US_WEST_2)
.credentialsProvider(ProfileCredentialsProvider.create())
.build();
s3ControlClient.createStorageLensGroup(createStorageLensGroupRequest);
} catch (AmazonServiceException e) {
// The call was transmitted successfully, but Amazon S3 couldn't process
// it and returned an error response.
e.printStackTrace();
} catch (SdkClientException e) {
// Amazon S3 couldn't be contacted for a response, or the client
// couldn't parse the response from Amazon S3.
e.printStackTrace();
}
}
}
```
**Example — Crie um grupo da Lente de Armazenamento com um operador `OR` que inclua vários filtros**
O exemplo a seguir cria um grupo de Lente de Armazenamento chamado `Marketing-Department`. Este grupo usa um operador `OR` para aplicar um filtro de prefixo (`prefix-1`, `prefix-2`, `prefix3/sub-prefix-1`) ou um filtro de tamanho de objeto com intervalo de tamanho entre `1000` bytes e `6000` bytes. Para usar esse exemplo, substitua os `user input placeholders` por suas próprias informações.
```
package aws.example.s3control;
import com.amazonaws.AmazonServiceException;
import com.amazonaws.SdkClientException;
import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider;
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.s3control.S3ControlClient;
import software.amazon.awssdk.services.s3control.model.CreateStorageLensGroupRequest;
import software.amazon.awssdk.services.s3control.model.MatchObjectSize;
import software.amazon.awssdk.services.s3control.model.StorageLensGroup;
import software.amazon.awssdk.services.s3control.model.StorageLensGroupFilter;
import software.amazon.awssdk.services.s3control.model.StorageLensGroupOrOperator;
public class CreateStorageLensGroupWithOrFilter {
public static void main(String[] args) {
String storageLensGroupName = "Marketing-Department";
String accountId = "111122223333";
try {
StorageLensGroupOrOperator orOperator = StorageLensGroupOrOperator.builder()
.matchAnyPrefix("prefix-1", "prefix-2", "prefix-3/sub-prefix-1")
.matchObjectSize(MatchObjectSize.builder()
.bytesGreaterThan(1000L)
.bytesLessThan(6000L)
.build())
.build();
StorageLensGroupFilter orFilter = StorageLensGroupFilter.builder()
.or(orOperator)
.build();
StorageLensGroup storageLensGroup = StorageLensGroup.builder()
.name(storageLensGroupName)
.filter(orFilter)
.build();
CreateStorageLensGroupRequest createStorageLensGroupRequest = CreateStorageLensGroupRequest.builder()
.storageLensGroup(storageLensGroup)
.accountId(accountId).build();
S3ControlClient s3ControlClient = S3ControlClient.builder()
.region(Region.US_WEST_2)
.credentialsProvider(ProfileCredentialsProvider.create())
.build();
s3ControlClient.createStorageLensGroup(createStorageLensGroupRequest);
} catch (AmazonServiceException e) {
// The call was transmitted successfully, but Amazon S3 couldn't process
// it and returned an error response.
e.printStackTrace();
} catch (SdkClientException e) {
// Amazon S3 couldn't be contacted for a response, or the client
// couldn't parse the response from Amazon S3.
e.printStackTrace();
}
}
}
```
**Example – Crie um grupo da Lente de Armazenamento com um único filtro e duas tags de recursos AWS**
O exemplo a seguir cria um grupo da Lente de Armazenamento chamado `Marketing-Department`, que tem um filtro de sufixo. Este exemplo também adiciona duas tags de recursos AWS ao grupo da Lente de Armazenamento. Para usar esse exemplo, substitua os `user input placeholders` por suas próprias informações.
```
package aws.example.s3control;
import com.amazonaws.AmazonServiceException;
import com.amazonaws.SdkClientException;
import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider;
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.s3control.S3ControlClient;
import software.amazon.awssdk.services.s3control.model.CreateStorageLensGroupRequest;
import software.amazon.awssdk.services.s3control.model.StorageLensGroup;
import software.amazon.awssdk.services.s3control.model.StorageLensGroupFilter;
import software.amazon.awssdk.services.s3control.model.Tag;
public class CreateStorageLensGroupWithResourceTags {
public static void main(String[] args) {
String storageLensGroupName = "Marketing-Department";
String accountId = "111122223333";
try {
// Create AWS resource tags.
Tag resourceTag1 = Tag.builder()
.key("resource-tag-key-1")
.value("resource-tag-value-1")
.build();
Tag resourceTag2 = Tag.builder()
.key("resource-tag-key-2")
.value("resource-tag-value-2")
.build();
StorageLensGroupFilter suffixFilter = StorageLensGroupFilter.builder()
.matchAnySuffix(".png", ".gif", ".jpg")
.build();
StorageLensGroup storageLensGroup = StorageLensGroup.builder()
.name(storageLensGroupName)
.filter(suffixFilter)
.build();
CreateStorageLensGroupRequest createStorageLensGroupRequest = CreateStorageLensGroupRequest.builder()
.storageLensGroup(storageLensGroup)
.tags(resourceTag1, resourceTag2)
.accountId(accountId).build();
S3ControlClient s3ControlClient = S3ControlClient.builder()
.region(Region.US_WEST_2)
.credentialsProvider(ProfileCredentialsProvider.create())
.build();
s3ControlClient.createStorageLensGroup(createStorageLensGroupRequest);
} catch (AmazonServiceException e) {
// The call was transmitted successfully, but Amazon S3 couldn't process
// it and returned an error response.
e.printStackTrace();
} catch (SdkClientException e) {
// Amazon S3 couldn't be contacted for a response, or the client
// couldn't parse the response from Amazon S3.
e.printStackTrace();
}
}
}
```
Para obter configurações de exemplo JSON, consulte [Configuração de grupos da Lente de Armazenamento](storage-lens-groups.md#storage-lens-groups-configuration).
# Anexar ao painel ou remover do painel grupos da Lente de Armazenamento do S3
Depois de atualizar para o nível avançado na Lente de Armazenamento do Amazon S3, você poderá anexar um [grupo da Lente de Armazenamento](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage-lens-groups-overview.html) ao seu painel. Se você tiver vários grupos da Lente de Armazenamento, poderá incluir ou excluir os grupos desejados.
Seus grupos da Lente de Armazenamento devem residir na região inicial designada na conta do painel. Depois de anexar um grupo da Lente de Armazenamento ao painel, você receberá os dados adicionais de agregação do grupo da Lente de Armazenamento na exportação de métricas em até 48 horas.
**nota**
Para visualizar métricas agregadas ao grupo da Lente de Armazenamento, você deve anexá-las ao painel da Lente de Armazenamento. Para obter exemplos de arquivos de configuração JSON do grupo da Lente de Armazenamento, consulte [Exemplo de configuração da Lente de Armazenamento do S3 com grupos da Lente de Armazenamento em JSON](S3LensHelperFilesCLI.md#StorageLensGroupsHelperFilesCLI).
## Usar o console do S3
**Para anexar um grupo da Lente de Armazenamento a um painel da Lente de Armazenamento**
1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon S3 em [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).
1. No painel de navegação à esquerda, em **Lente de Armazenamento**, selecione **Painéis**.
1. Selecione botão de opção para o painel da Lente de Armazenamento ao qual você deseja anexar um grupo da Lente de Armazenamento.
1. Escolha **Editar**.
1. Em **Seleção de métricas**, escolha **Métricas e recomendações avançadas**.
1. Selecione a opção **Agregação do grupo da Lente de Armazenamento**.
**nota**
Por padrão, a opção **Métricas avançadas** também é selecionada. No entanto, você também pode desmarcar essa configuração, pois ela não é necessária para agregar dados de grupos da Lente de Armazenamento.
1. Role para baixo até **Agregação do grupo da Lente de Armazenamento** e especifique o grupo ou grupos da Lente de Armazenamento que você deseja incluir ou excluir na agregação de dados. Você pode usar as seguintes opções de filtro:
+ Para incluir determinados grupos da Lente de Armazenamento, escolha **Incluir grupos da Lente de Armazenamento**. Em **Grupos da Lente de Armazenamento a serem incluídos**, selecione seus grupos da Lente de Armazenamento.
+ Para incluir todos os grupos da Lente de Armazenamento, selecione **Incluir todos os grupos da Lente de Armazenamento na região de origem nesta conta**.
+ Para excluir determinados grupos da Lente de Armazenamento, selecione **Excluir grupos da Lente de Armazenamento**. Em **Grupos da Lente de Armazenamento a serem excluídos**, selecione os grupos da Lente de Armazenamento que você deseja excluir.
1. Escolha **Salvar alterações**. Se tiver configurado seus grupos da Lente de Armazenamento corretamente, você verá os dados adicionais de agregação do grupo da Lente de Armazenamento em seu painel dentro de 48 horas.
**Como remover um grupo da Lente de Armazenamento de um painel da Lente de Armazenamento do S3**
1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon S3 em [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).
1. No painel de navegação à esquerda, em **Lente de Armazenamento**, selecione **Painéis**.
1. Selecione o botão de opção para o painel da Lente de Armazenamento do qual você deseja remover um grupo da Lente de Armazenamento.
1. Selecione **Exibir configuração do painel**.
1. Escolha **Editar**.
1. Role para baixo até a seção **Seleção de métricas**.
1. Em **Agregação de grupo da Lente de Armazenamento**, selecione o **X** ao lado do grupo da Lente de Armazenamento que você deseja remover. Isso remove o grupo da Lente de Armazenamento.
Se você tiver incluído todos os grupos da Lente de Armazenamento em seu painel, desmarque a caixa de seleção ao lado de **Incluir todos os grupos da Lente de Armazenamento na região inicial nesta conta**.
1. Escolha **Salvar alterações**.
**nota**
Levará até 48 horas para que seu painel mostre as atualizações de configuração.
## Usar o AWS SDK para Java
**Example – Anexar todos os grupos da Lente de Armazenamento a um painel**
O exemplo de SDK para Java a seguir anexa todos os grupos da Lente de Armazenamento na conta *111122223333* ao painel *DashBoardConfigurationId*:
```
package aws.example.s3control;
import com.amazonaws.AmazonServiceException;
import com.amazonaws.SdkClientException;
import com.amazonaws.services.s3control.AWSS3Control;
import com.amazonaws.services.s3control.AWSS3ControlClient;
import com.amazonaws.services.s3control.model.BucketLevel;
import com.amazonaws.services.s3control.model.PutStorageLensConfigurationRequest;
import com.amazonaws.auth.profile.ProfileCredentialsProvider;
import com.amazonaws.services.s3control.model.AccountLevel;
import com.amazonaws.services.s3control.model.StorageLensConfiguration;
import com.amazonaws.services.s3control.model.StorageLensGroupLevel;
import static com.amazonaws.regions.Regions.US_WEST_2;
public class CreateDashboardWithStorageLensGroups {
public static void main(String[] args) {
String configurationId = "ExampleDashboardConfigurationId";
String sourceAccountId = "111122223333";
try {
StorageLensGroupLevel storageLensGroupLevel = new StorageLensGroupLevel();
AccountLevel accountLevel = new AccountLevel()
.withBucketLevel(new BucketLevel())
.withStorageLensGroupLevel(storageLensGroupLevel);
StorageLensConfiguration configuration = new StorageLensConfiguration()
.withId(configurationId)
.withAccountLevel(accountLevel)
.withIsEnabled(true);
AWSS3Control s3ControlClient = AWSS3ControlClient.builder()
.withCredentials(new ProfileCredentialsProvider())
.withRegion(US_WEST_2)
.build();
s3ControlClient.putStorageLensConfiguration(new PutStorageLensConfigurationRequest()
.withAccountId(sourceAccountId)
.withConfigId(configurationId)
.withStorageLensConfiguration(configuration)
);
} catch (AmazonServiceException e) {
// The call was transmitted successfully, but Amazon S3 couldn't process
// it and returned an error response.
e.printStackTrace();
} catch (SdkClientException e) {
// Amazon S3 couldn't be contacted for a response, or the client
// couldn't parse the response from Amazon S3.
e.printStackTrace();
}
}
}
```
**Example – Anexar dois grupos da Lente de Armazenamento a um painel**
O exemplo do AWS SDK para Java a seguir anexa dois grupos da Lente de Armazenamento (*StorageLensGroupName1* e *StorageLensGroupName2*) ao painel *ExampleDashboardConfigurationId*.
```
package aws.example.s3control;
import com.amazonaws.AmazonServiceException;
import com.amazonaws.SdkClientException;
import com.amazonaws.auth.profile.ProfileCredentialsProvider;
import com.amazonaws.services.s3control.AWSS3Control;
import com.amazonaws.services.s3control.AWSS3ControlClient;
import com.amazonaws.services.s3control.model.AccountLevel;
import com.amazonaws.services.s3control.model.BucketLevel;
import com.amazonaws.services.s3control.model.PutStorageLensConfigurationRequest;
import com.amazonaws.services.s3control.model.StorageLensConfiguration;
import com.amazonaws.services.s3control.model.StorageLensGroupLevel;
import com.amazonaws.services.s3control.model.StorageLensGroupLevelSelectionCriteria;
import static com.amazonaws.regions.Regions.US_WEST_2;
public class CreateDashboardWith2StorageLensGroups {
public static void main(String[] args) {
String configurationId = "ExampleDashboardConfigurationId";
String storageLensGroupName1 = "StorageLensGroupName1";
String storageLensGroupName2 = "StorageLensGroupName2";
String sourceAccountId = "111122223333";
try {
StorageLensGroupLevelSelectionCriteria selectionCriteria = new StorageLensGroupLevelSelectionCriteria()
.withInclude(
"arn:aws:s3:" + US_WEST_2.getName() + ":" + sourceAccountId + ":storage-lens-group/" + storageLensGroupName1,
"arn:aws:s3:" + US_WEST_2.getName() + ":" + sourceAccountId + ":storage-lens-group/" + storageLensGroupName2);
System.out.println(selectionCriteria);
StorageLensGroupLevel storageLensGroupLevel = new StorageLensGroupLevel()
.withSelectionCriteria(selectionCriteria);
AccountLevel accountLevel = new AccountLevel()
.withBucketLevel(new BucketLevel())
.withStorageLensGroupLevel(storageLensGroupLevel);
StorageLensConfiguration configuration = new StorageLensConfiguration()
.withId(configurationId)
.withAccountLevel(accountLevel)
.withIsEnabled(true);
AWSS3Control s3ControlClient = AWSS3ControlClient.builder()
.withCredentials(new ProfileCredentialsProvider())
.withRegion(US_WEST_2)
.build();
s3ControlClient.putStorageLensConfiguration(new PutStorageLensConfigurationRequest()
.withAccountId(sourceAccountId)
.withConfigId(configurationId)
.withStorageLensConfiguration(configuration)
);
} catch (AmazonServiceException e) {
// The call was transmitted successfully, but Amazon S3 couldn't process
// it and returned an error response.
e.printStackTrace();
} catch (SdkClientException e) {
// Amazon S3 couldn't be contacted for a response, or the client
// couldn't parse the response from Amazon S3.
e.printStackTrace();
}
}
}
```
**Example – Anexar todos os grupos da Lente de Armazenamento com exclusões**
O exemplo de SDK para Java a seguir anexa todos os grupos da Lente de Armazenamento ao painel *ExampleDashboardConfigurationId*, exceto os dois especificados (*StorageLensGroupName1* e *StorageLensGroupName2*):
```
package aws.example.s3control;
import com.amazonaws.AmazonServiceException;
import com.amazonaws.SdkClientException;
import com.amazonaws.auth.profile.ProfileCredentialsProvider;
import com.amazonaws.services.s3control.AWSS3Control;
import com.amazonaws.services.s3control.AWSS3ControlClient;
import com.amazonaws.services.s3control.model.AccountLevel;
import com.amazonaws.services.s3control.model.BucketLevel;
import com.amazonaws.services.s3control.model.PutStorageLensConfigurationRequest;
import com.amazonaws.services.s3control.model.StorageLensConfiguration;
import com.amazonaws.services.s3control.model.StorageLensGroupLevel;
import com.amazonaws.services.s3control.model.StorageLensGroupLevelSelectionCriteria;
import static com.amazonaws.regions.Regions.US_WEST_2;
public class CreateDashboardWith2StorageLensGroupsExcluded {
public static void main(String[] args) {
String configurationId = "ExampleDashboardConfigurationId";
String storageLensGroupName1 = "StorageLensGroupName1";
String storageLensGroupName2 = "StorageLensGroupName2";
String sourceAccountId = "111122223333";
try {
StorageLensGroupLevelSelectionCriteria selectionCriteria = new StorageLensGroupLevelSelectionCriteria()
.withInclude(
"arn:aws:s3:" + US_WEST_2.getName() + ":" + sourceAccountId + ":storage-lens-group/" + storageLensGroupName1,
"arn:aws:s3:" + US_WEST_2.getName() + ":" + sourceAccountId + ":storage-lens-group/" + storageLensGroupName2);
System.out.println(selectionCriteria);
StorageLensGroupLevel storageLensGroupLevel = new StorageLensGroupLevel()
.withSelectionCriteria(selectionCriteria);
AccountLevel accountLevel = new AccountLevel()
.withBucketLevel(new BucketLevel())
.withStorageLensGroupLevel(storageLensGroupLevel);
StorageLensConfiguration configuration = new StorageLensConfiguration()
.withId(configurationId)
.withAccountLevel(accountLevel)
.withIsEnabled(true);
AWSS3Control s3ControlClient = AWSS3ControlClient.builder()
.withCredentials(new ProfileCredentialsProvider())
.withRegion(US_WEST_2)
.build();
s3ControlClient.putStorageLensConfiguration(new PutStorageLensConfigurationRequest()
.withAccountId(sourceAccountId)
.withConfigId(configurationId)
.withStorageLensConfiguration(configuration)
);
} catch (AmazonServiceException e) {
// The call was transmitted successfully, but Amazon S3 couldn't process
// it and returned an error response.
e.printStackTrace();
} catch (SdkClientException e) {
// Amazon S3 couldn't be contacted for a response, or the client
// couldn't parse the response from Amazon S3.
e.printStackTrace();
}
}
}
```
# Visualização de dados dos grupos da Lente de Armazenamento
Visualize os dados dos grupos da Lente de Armazenamento [anexando o grupo ao painel da Lente de Armazenamento do Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage-lens-groups-dashboard-console.html#storage-lens-groups-attach-dashboard-console). Depois de incluir o grupo da Lente de Armazenamento na agregação do grupo na configuração do painel, pode levar até 48 horas para que os dados do grupo da Lente de Armazenamento sejam exibidos no painel.
Depois que a configuração do painel for atualizada, todos os grupos da Lente de Armazenamento recém-anexados aparecerão na lista de recursos disponíveis, na guia **Grupos da Lente de Armazenamento**. Você também pode analisar melhor o uso do armazenamento na guia **Visão geral**. É só dividir os dados em outra dimensão. Por exemplo, você pode selecionar um dos itens listados nas **três principais** categorias e escolher **Analisar por** para dividir os dados em outra dimensão. Não é possível aplicar a mesma dimensão do próprio filtro.
**nota**
Não é possível aplicar um filtro de grupo e Lente de Armazenamento junto com um filtro de prefixo e vice-versa. Você também não pode analisar de maneira mais aprofundada um grupo da Lente de Armazenamento usando um filtro de prefixo.
Você pode usar a guia **Grupos da Lente de Armazenamento** no painel da Lente de Armazenamento do Amazon S3 para personalizar a visualização de dados para os grupos da Lente de Armazenamento anexados ao seu painel. Você pode visualizar os dados de alguns grupos da Lente de Armazenamento que estão anexados ao seu painel ou de todos eles.
Ao visualizar os dados do grupo da Lente de Armazenamento no painel da Lente de Armazenamento do S3, esteja ciente do seguinte:
+ A Lente de Armazenamento do S3 agrega métricas de uso de um objeto em todos os grupos da Lente de Armazenamento correspondentes. Portanto, se um objeto corresponder às condições de filtro de dois ou mais grupos da Lente de Armazenamento, você verá contagens repetidas do mesmo objeto em todo o uso do armazenamento.
+ Os objetos devem corresponder aos filtros incluídos nos grupos da Lente de Armazenamento. Se nenhum objeto corresponder aos filtros incluídos no grupo da Lente de Armazenamento, nenhuma métrica será gerada. Para determinar se há objetos não atribuídos, verifique a contagem total de objetos no painel no nível da conta e do bucket.
# Atualização do grupo da Lente de Armazenamento
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
**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
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
O exemplo AWS SDK para Java a seguir mostra os detalhes da configuração do grupo da Lente de Armazenamento `Marketing-Department` na conta `111122223333`. Para usar esse exemplo, substitua os `user input placeholders` por suas próprias informações.
```
package aws.example.s3control;
import com.amazonaws.AmazonServiceException;
import com.amazonaws.SdkClientException;
import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider;
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.s3control.S3ControlClient;
import software.amazon.awssdk.services.s3control.model.GetStorageLensGroupRequest;
import software.amazon.awssdk.services.s3control.model.GetStorageLensGroupResponse;
public class GetStorageLensGroup {
public static void main(String[] args) {
String storageLensGroupName = "Marketing-Department";
String accountId = "111122223333";
try {
GetStorageLensGroupRequest getRequest = GetStorageLensGroupRequest.builder()
.name(storageLensGroupName)
.accountId(accountId).build();
S3ControlClient s3ControlClient = S3ControlClient.builder()
.region(Region.US_WEST_2)
.credentialsProvider(ProfileCredentialsProvider.create())
.build();
GetStorageLensGroupResponse response = s3ControlClient.getStorageLensGroup(getRequest);
System.out.println(response);
} catch (AmazonServiceException e) {
// The call was transmitted successfully, but Amazon S3 couldn't process
// it and returned an error response.
e.printStackTrace();
} catch (SdkClientException e) {
// Amazon S3 couldn't be contacted for a response, or the client
// couldn't parse the response from Amazon S3.
e.printStackTrace();
}
}
}
```
O exemplo a seguir atualiza o grupo da Lente de Armazenamento `Marketing-Department` na conta `111122223333`. Esse exemplo atualiza o escopo do painel para incluir objetos que correspondam a qualquer um dos seguintes sufixos: `.png`, `.gif`, `.jpg` ou `.jpeg`. Para usar esse exemplo, substitua os `user input placeholders` por suas próprias informações.
```
package aws.example.s3control;
import com.amazonaws.AmazonServiceException;
import com.amazonaws.SdkClientException;
import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider;
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.s3control.S3ControlClient;
import software.amazon.awssdk.services.s3control.model.StorageLensGroup;
import software.amazon.awssdk.services.s3control.model.StorageLensGroupFilter;
import software.amazon.awssdk.services.s3control.model.UpdateStorageLensGroupRequest;
public class UpdateStorageLensGroup {
public static void main(String[] args) {
String storageLensGroupName = "Marketing-Department";
String accountId = "111122223333";
try {
// Create updated filter.
StorageLensGroupFilter suffixFilter = StorageLensGroupFilter.builder()
.matchAnySuffix(".png", ".gif", ".jpg", ".jpeg")
.build();
StorageLensGroup storageLensGroup = StorageLensGroup.builder()
.name(storageLensGroupName)
.filter(suffixFilter)
.build();
UpdateStorageLensGroupRequest updateStorageLensGroupRequest = UpdateStorageLensGroupRequest.builder()
.name(storageLensGroupName)
.storageLensGroup(storageLensGroup)
.accountId(accountId)
.build();
S3ControlClient s3ControlClient = S3ControlClient.builder()
.region(Region.US_WEST_2)
.credentialsProvider(ProfileCredentialsProvider.create())
.build();
s3ControlClient.updateStorageLensGroup(updateStorageLensGroupRequest);
} catch (AmazonServiceException e) {
// The call was transmitted successfully, but Amazon S3 couldn't process
// it and returned an error response.
e.printStackTrace();
} catch (SdkClientException e) {
// Amazon S3 couldn't be contacted for a response, or the client
// couldn't parse the response from Amazon S3.
e.printStackTrace();
}
}
}
```
Para obter configurações de exemplo JSON, consulte [Configuração de grupos da Lente de Armazenamento](storage-lens-groups.md#storage-lens-groups-configuration).
# Gerenciamento de tags de recursos AWS com grupos da Lente de Armazenamento
Cada grupo da Lente de Armazenamento do Amazon S3 é contado como um recurso AWS com o próprio nome do recurso da Amazon (ARN). Portanto, ao configurar o grupo da Lente de Armazenamento, você tem a opção de adicionar tags de recursos AWS ao grupo. Você pode adicionar até 50 tags para cada grupo da Lente de Armazenamento. Para criar um grupo da Lente de Armazenamento com tags, você deve ter as permissões `s3:CreateStorageLensGroup` e `s3:TagResource`.
Use tags de recursos AWS para categorizar os recursos de acordo com o departamento, a linha de negócios ou o projeto. Fazer isso é útil quando você tem muitos recursos do mesmo tipo. Ao aplicar tags, é possível identificar rapidamente um grupo específico da Lente de Armazenamento com base nas tags atribuídas a ele. Você também pode usar tags para rastrear e alocar custos.
Além disso, ao adicionar uma tag de recursos AWS ao grupo da Lente de Armazenamento, você ativa o [controle de acesso por atributo (ABAC)](https://docs.aws.amazon.com/IAM/latest/UserGuide/introduction_attribute-based-access-control.html). ABAC é uma estratégia de autorização que define permissões com base em atributos, neste caso, tags. É possível usar condições que especificam tags de recursos nas políticas do IAM para [controlar o acesso aos recursos AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_tags.html#access_tags_control-resources).
É possível editar chaves de tags e valores e é possível remover as tags de um recurso a qualquer momento. Além disso, esteja ciente das seguintes limitações:
+ As chaves e os valores das tags diferenciam maiúsculas de minúsculas.
+ Ao adicionar uma tag que tenha a mesma chave de uma tag existente nesse recurso, o novo valor substituirá o antigo.
+ Se você excluir um recurso, todas as tags do recurso também serão excluídas.
+ Não inclua dados privados ou confidenciais nas tags de recursos AWS.
+ As tags do sistema (com chaves de tags que começam com `aws:`) não são compatíveis.
+ O comprimento de cada chave de tag não pode exceder 128 caracteres. O comprimento de cada valor de tag não pode exceder 256 caracteres.
Os exemplos a seguir demonstram como usar tags de recursos AWS com grupos da Lente de Armazenamento.
**Topics**
+ [Adicionar tag de recursos AWS a um grupo da Lente de Armazenamento](storage-lens-groups-add-tags.md)
+ [Atualização dos valores das tags de grupo da Lente de Armazenamento](storage-lens-groups-update-tags.md)
+ [Exclusão de tag de recursos AWS do grupo da Lente de Armazenamento](storage-lens-groups-delete-tags.md)
+ [Listagem de tags de grupo da Lente de Armazenamento](storage-lens-groups-list-tags.md)
# Adicionar tag de recursos AWS a um grupo da Lente de Armazenamento
Os exemplos a seguir demonstram como adicionar tags de recursos AWS a um grupo da Lente de Armazenamento do Amazon S3. Adicione tags de recurso usando o console do Amazon S3, AWS Command Line Interface (AWS CLI) e AWS SDK para Java.
## Usar o console do S3
**Para adicionar uma tag de recursos AWS a um grupo da Lente de Armazenamento**
1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon S3 em [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).
1. No painel de navegação à esquerda, selecione **Grupos de Lente de Armazenamento**.
1. Em **Grupos da Lente de Armazenamento**, selecione o grupo a ser atualizado.
1. Em **Tags de recursos AWS**, selecione **Adicionar tags**.
1. Na página **Adicionar tags**, adicione o novo par de valores-chave.
**nota**
Adicionar uma nova tag com a mesma chave de tag existente substitui o valor da tag anterior.
1. (Opcional) Para adicionar mais de uma tag nova, selecione **Adicionar tag** novamente para continuar adicionando novas entradas. Você pode adicionar até 50 tags de recursos AWS ao seu grupo da Lente de Armazenamento.
1. (Opcional) Para remover uma entrada recém-adicionada, selecione **Remover** ao lado da tag que você deseja remover.
1. Escolha **Salvar alterações**.
## Como usar o AWS CLI
O comando de exemplo AWS CLI a seguir adiciona duas tags de recursos a um grupo da Lente de Armazenamento existente chamado `marketing-department`. Para usar esse exemplo de comando, substitua os `user input placeholders` por suas próprias informações.
```
aws s3control tag-resource --account-id 111122223333 \
--resource-arn arn:aws:s3:us-east-1:111122223333:storage-lens-group/marketing-department \
--region us-east-1 --tags Key=k1,Value=v1 Key=k2,Value=v2
```
## Usar o AWS SDK para Java
O exemplo AWS SDK para Java a seguir adiciona duas tags de recursos AWS a um grupo da Lente de Armazenamento existente. Para usar esse exemplo, substitua os `user input placeholders` por suas próprias informações.
```
package aws.example.s3control;
import com.amazonaws.AmazonServiceException;
import com.amazonaws.SdkClientException;
import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider;
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.s3control.S3ControlClient;
import software.amazon.awssdk.services.s3control.model.Tag;
import software.amazon.awssdk.services.s3control.model.TagResourceRequest;
public class TagResource {
public static void main(String[] args) {
String resourceARN = "Resource_ARN";
String accountId = "111122223333";
try {
Tag resourceTag1 = Tag.builder()
.key("resource-tag-key-1")
.value("resource-tag-value-1")
.build();
Tag resourceTag2 = Tag.builder()
.key("resource-tag-key-2")
.value("resource-tag-value-2")
.build();
TagResourceRequest tagResourceRequest = TagResourceRequest.builder()
.resourceArn(resourceARN)
.tags(resourceTag1, resourceTag2)
.accountId(accountId)
.build();
S3ControlClient s3ControlClient = S3ControlClient.builder()
.region(Region.US_WEST_2)
.credentialsProvider(ProfileCredentialsProvider.create())
.build();
s3ControlClient.tagResource(tagResourceRequest);
} catch (AmazonServiceException e) {
// The call was transmitted successfully, but Amazon S3 couldn't process
// it and returned an error response.
e.printStackTrace();
} catch (SdkClientException e) {
// Amazon S3 couldn't be contacted for a response, or the client
// couldn't parse the response from Amazon S3.
e.printStackTrace();
}
}
}
```
# Atualização dos valores das tags de grupo da Lente de Armazenamento
Os exemplos a seguir demonstram como atualizar os valores das tags de grupo da Lente de Armazenamento usando o console Amazon S3, AWS Command Line Interface (AWS CLI) e AWS SDK para Java.
## Usar o console do S3
**Para atualizar uma tag de recursos AWS de um grupo da Lente de Armazenamento**
1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon S3 em [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).
1. No painel de navegação à esquerda, selecione **Grupos de Lente de Armazenamento**.
1. Em **Grupos da Lente de Armazenamento**, selecione o grupo a ser atualizado.
1. Em **Tags de recursos AWS**, selecione a tag a ser atualizada.
1. Adicione o novo valor da tag usando a mesma chave do par de valores-chave que você deseja atualizar. Escolha o ícone da marca de seleção para atualizar o valor da tag.
**nota**
Adicionar uma nova tag com a mesma chave de tag existente substitui o valor da tag anterior.
1. (Opcional) Para adicionar novas tags, selecione **Adicionar tag** para adicionar novas entradas. A página **Adicionar tags** é exibida.
Adicione até 50 tags de recursos AWS ao grupo da Lente de Armazenamento. Quando terminar de adicionar tags, selecione **Salvar alterações**.
1. (Opcional) Para remover uma entrada recém-adicionada, selecione **Remover** ao lado da tag que você deseja remover. Ao finalizar a remoção de tags, selecione **Salvar alterações**.
## Como usar o AWS CLI
O comando de exemplo AWS CLI a seguir atualiza dois valores de tags para o grupo da Lente de Armazenamento `marketing-department`. Para usar esse exemplo de comando, substitua os `user input placeholders` por suas próprias informações.
```
aws s3control tag-resource --account-id 111122223333 \
--resource-arn arn:aws:s3:us-east-1:111122223333:storage-lens-group/marketing-department \
--region us-east-1 --tags Key=k1,Value=v3 Key=k2,Value=v4
```
## Usar o AWS SDK para Java
O exemplo AWS SDK para Java a seguir atualiza dois valores de tags do grupo da Lente de Armazenamento. Para usar esse exemplo, substitua os `user input placeholders` por suas próprias informações.
```
package aws.example.s3control;
import com.amazonaws.AmazonServiceException;
import com.amazonaws.SdkClientException;
import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider;
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.s3control.S3ControlClient;
import software.amazon.awssdk.services.s3control.model.Tag;
import software.amazon.awssdk.services.s3control.model.TagResourceRequest;
public class UpdateTagsForResource {
public static void main(String[] args) {
String resourceARN = "Resource_ARN";
String accountId = "111122223333";
try {
Tag updatedResourceTag1 = Tag.builder()
.key("resource-tag-key-1")
.value("resource-tag-updated-value-1")
.build();
Tag updatedResourceTag2 = Tag.builder()
.key("resource-tag-key-2")
.value("resource-tag-updated-value-2")
.build();
TagResourceRequest tagResourceRequest = TagResourceRequest.builder()
.resourceArn(resourceARN)
.tags(updatedResourceTag1, updatedResourceTag2)
.accountId(accountId)
.build();
S3ControlClient s3ControlClient = S3ControlClient.builder()
.region(Region.US_WEST_2)
.credentialsProvider(ProfileCredentialsProvider.create())
.build();
s3ControlClient.tagResource(tagResourceRequest);
} catch (AmazonServiceException e) {
// The call was transmitted successfully, but Amazon S3 couldn't process
// it and returned an error response.
e.printStackTrace();
} catch (SdkClientException e) {
// Amazon S3 couldn't be contacted for a response, or the client
// couldn't parse the response from Amazon S3.
e.printStackTrace();
}
}
}
```
# Exclusão de tag de recursos AWS do grupo da Lente de Armazenamento
Os exemplos a seguir demonstram como excluir uma tag de recursos AWS de um grupo da Lente de Armazenamento. Exclua tags usando o console do Amazon S3, AWS Command Line Interface (AWS CLI) e AWS SDK para Java.
## Usar o console do S3
**Para excluir uma tags de recurso AWS de um grupo da Lente de Armazenamento**
1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon S3 em [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).
1. No painel de navegação à esquerda, selecione **Grupos de Lente de Armazenamento**.
1. Em **Grupos da Lente de Armazenamento**, selecione o grupo a ser atualizado.
1. Em **Tags de recursos AWS**, selecione o par de valores-chave a ser excluído.
1. Escolha **Excluir**. A caixa de diálogo **Excluir tags de recursos AWS** é exibida.
**nota**
Se tags forem usadas para controlar o acesso, prosseguir com essa ação poderá afetar os recursos relacionados. Depois de excluir permanentemente uma tag, ela não poderá ser restaurada.
1. Selecione **Excluir** para excluir permanentemente o par de valores-chave.
## Como usar o AWS CLI
O comando AWS CLI a seguir exclui duas tags de recursos AWS de um grupo da Lente de Armazenamento existente: para usar esse comando de exemplo, substitua `user input placeholders` por suas próprias informações.
```
aws s3control untag-resource --account-id 111122223333 \
--resource-arn arn:aws:s3:us-east-1:111122223333:storage-lens-group/Marketing-Department \
--region us-east-1 --tag-keys k1 k2
```
## Usar o AWS SDK para Java
O exemplo AWS SDK para Java a seguir exclui duas tags de recursos AWS do nome do recurso da Amazon (ARN) do grupo da Lente de Armazenamento especificado na conta `111122223333`. Para usar esse exemplo, substitua os `user input placeholders` por suas próprias informações.
```
package aws.example.s3control;
import com.amazonaws.AmazonServiceException;
import com.amazonaws.SdkClientException;
import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider;
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.s3control.S3ControlClient;
import software.amazon.awssdk.services.s3control.model.UntagResourceRequest;
public class UntagResource {
public static void main(String[] args) {
String resourceARN = "Resource_ARN";
String accountId = "111122223333";
try {
String tagKey1 = "resource-tag-key-1";
String tagKey2 = "resource-tag-key-2";
UntagResourceRequest untagResourceRequest = UntagResourceRequest.builder()
.resourceArn(resourceARN)
.tagKeys(tagKey1, tagKey2)
.accountId(accountId)
.build();
S3ControlClient s3ControlClient = S3ControlClient.builder()
.region(Region.US_WEST_2)
.credentialsProvider(ProfileCredentialsProvider.create())
.build();
s3ControlClient.untagResource(untagResourceRequest);
} catch (AmazonServiceException e) {
// The call was transmitted successfully, but Amazon S3 couldn't process
// it and returned an error response.
e.printStackTrace();
} catch (SdkClientException e) {
// Amazon S3 couldn't be contacted for a response, or the client
// couldn't parse the response from Amazon S3.
e.printStackTrace();
}
}
}
```
# Listagem de tags de grupo da Lente de Armazenamento
Os exemplos a seguir demonstram como listar as tags de recursos AWS associadas ao grupo da Lente de Armazenamento. Você pode listar as tags usando o console do Amazon S3, AWS Command Line Interface (AWS CLI) e AWS SDK para Java.
## Usar o console do S3
**Para revisar a lista de tags e valores de tags para o grupo da Lente de Armazenamento**
1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon S3 em [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).
1. No painel de navegação à esquerda, selecione **Grupos de Lente de Armazenamento**.
1. Em **Grupos da Lente de Armazenamento**, selecione o grupo da Lente de Armazenamento da sua preferência.
1. Role para baixo até a seção **Tags de recursos AWS**. Todas as tags de recursos AWS definidas pelo usuário que são adicionadas ao grupo da Lente de Armazenamento são listadas junto com os valores de tag.
## Como usar o AWS CLI
O comando de exemplo AWS CLI a seguir lista todos os valores de tag do grupo da Lente de Armazenamento para o grupo da Lente de Armazenamento `marketing-department`. Para usar esse exemplo de comando, substitua os `user input placeholders` por suas próprias informações.
```
aws s3control list-tags-for-resource --account-id 111122223333 \
--resource-arn arn:aws:s3:us-east-1:111122223333:storage-lens-group/marketing-department \
--region us-east-1
```
## Usar o AWS SDK para Java
O exemplo AWS SDK para Java a seguir lista os valores de tag do grupo da Lente de Armazenamento para o nome do recurso da Amazon (ARN) do grupo da Lente de Armazenamento que você especifica. Para usar esse exemplo, substitua os `user input placeholders` por suas próprias informações.
```
package aws.example.s3control;
import com.amazonaws.AmazonServiceException;
import com.amazonaws.SdkClientException;
import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider;
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.s3control.S3ControlClient;
import software.amazon.awssdk.services.s3control.model.ListTagsForResourceRequest;
import software.amazon.awssdk.services.s3control.model.ListTagsForResourceResponse;
public class ListTagsForResource {
public static void main(String[] args) {
String resourceARN = "Resource_ARN";
String accountId = "111122223333";
try {
ListTagsForResourceRequest listTagsForResourceRequest = ListTagsForResourceRequest.builder()
.resourceArn(resourceARN)
.accountId(accountId)
.build();
S3ControlClient s3ControlClient = S3ControlClient.builder()
.region(Region.US_WEST_2)
.credentialsProvider(ProfileCredentialsProvider.create())
.build();
ListTagsForResourceResponse response = s3ControlClient.listTagsForResource(listTagsForResourceRequest);
System.out.println(response);
} catch (AmazonServiceException e) {
// The call was transmitted successfully, but Amazon S3 couldn't process
// it and returned an error response.
e.printStackTrace();
} catch (SdkClientException e) {
// Amazon S3 couldn't be contacted for a response, or the client
// couldn't parse the response from Amazon S3.
e.printStackTrace();
}
}
}
```
# Listagem de todos os grupos da Lente de Armazenamento
Os exemplos a seguir demonstram como listar todos os grupos da Lente de Armazenamento do Amazon S3 em uma Conta da AWS e região local. Esses exemplos mostram como listar todos os grupos da Lente de Armazenamento usando o console do Amazon S3, AWS Command Line Interface (AWS CLI) e AWS SDK para Java.
## Usar o console do S3
**Para listar todos os grupos da Lente de Armazenamento em uma conta e região local**
1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon S3 em [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).
1. No painel de navegação à esquerda, selecione **Grupos de Lente de Armazenamento**.
1. Em **Grupos da Lente de Armazenamento**, a lista é exibida na sua conta.
## Como usar o AWS CLI
O exemplo AWS CLI a seguir lista todos os grupos da Lente de Armazenamento da sua conta. Para usar esse exemplo de comando, substitua os `user input placeholders` por suas próprias informações.
```
aws s3control list-storage-lens-groups --account-id 111122223333 \
--region us-east-1
```
## Usar o AWS SDK para Java
O exemplo AWS SDK para Java a seguir lista os grupos da Lente de Armazenamento da sua conta `111122223333`. Para usar esse exemplo, substitua os `user input placeholders` por suas próprias informações.
```
package aws.example.s3control;
import com.amazonaws.AmazonServiceException;
import com.amazonaws.SdkClientException;
import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider;
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.s3control.S3ControlClient;
import software.amazon.awssdk.services.s3control.model.ListStorageLensGroupsRequest;
import software.amazon.awssdk.services.s3control.model.ListStorageLensGroupsResponse;
public class ListStorageLensGroups {
public static void main(String[] args) {
String accountId = "111122223333";
try {
ListStorageLensGroupsRequest listStorageLensGroupsRequest = ListStorageLensGroupsRequest.builder()
.accountId(accountId)
.build();
S3ControlClient s3ControlClient = S3ControlClient.builder()
.region(Region.US_WEST_2)
.credentialsProvider(ProfileCredentialsProvider.create())
.build();
ListStorageLensGroupsResponse response = s3ControlClient.listStorageLensGroups(listStorageLensGroupsRequest);
System.out.println(response);
} catch (AmazonServiceException e) {
// The call was transmitted successfully, but Amazon S3 couldn't process
// it and returned an error response.
e.printStackTrace();
} catch (SdkClientException e) {
// Amazon S3 couldn't be contacted for a response, or the client
// couldn't parse the response from Amazon S3.
e.printStackTrace();
}
}
}
```
# Visualização de detalhes do grupo da Lente de Armazenamento
Os exemplos a seguir demonstram como visualizar detalhes de configuração do grupo da Lente de Armazenamento do Amazon S3. Visualize os detalhes usando o console do Amazon S3, AWS Command Line Interface (AWS CLI) e AWS SDK para Java.
## Usar o console do S3
**Para visualizar detalhes de configuração do grupo da Lente de Armazenamento**
1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon S3 em [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).
1. No painel de navegação à esquerda, selecione **Grupos de Lente de Armazenamento**.
1. Em **Grupos da Lente de Armazenamento**, selecione o botão ao lado do grupo da Lente de Armazenamento da sua preferência.
1. Escolha **Exibir detalhes**. Agora, você pode analisar os detalhes do grupo da Lente de Armazenamento.
## Como usar o AWS CLI
O exemplo AWS CLI a seguir replica os detalhes da configuração do grupo da Lente de Armazenamento. Para usar esse exemplo de comando, substitua os `user input placeholders` por suas próprias informações.
```
aws s3control get-storage-lens-group --account-id 111122223333 \
--region us-east-1 --name marketing-department
```
## Usar o AWS SDK para Java
O exemplo AWS SDK para Java a seguir replica os detalhes de configuração do grupo da Lente de Armazenamento `Marketing-Department` na conta `111122223333`. Para usar esse exemplo, substitua os `user input placeholders` por suas próprias informações.
```
package aws.example.s3control;
import com.amazonaws.AmazonServiceException;
import com.amazonaws.SdkClientException;
import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider;
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.s3control.S3ControlClient;
import software.amazon.awssdk.services.s3control.model.GetStorageLensGroupRequest;
import software.amazon.awssdk.services.s3control.model.GetStorageLensGroupResponse;
public class GetStorageLensGroup {
public static void main(String[] args) {
String storageLensGroupName = "Marketing-Department";
String accountId = "111122223333";
try {
GetStorageLensGroupRequest getRequest = GetStorageLensGroupRequest.builder()
.name(storageLensGroupName)
.accountId(accountId).build();
S3ControlClient s3ControlClient = S3ControlClient.builder()
.region(Region.US_WEST_2)
.credentialsProvider(ProfileCredentialsProvider.create())
.build();
GetStorageLensGroupResponse response = s3ControlClient.getStorageLensGroup(getRequest);
System.out.println(response);
} catch (AmazonServiceException e) {
// The call was transmitted successfully, but Amazon S3 couldn't process
// it and returned an error response.
e.printStackTrace();
} catch (SdkClientException e) {
// Amazon S3 couldn't be contacted for a response, or the client
// couldn't parse the response from Amazon S3.
e.printStackTrace();
}
}
}
```
# Exclusão de grupo da Lente de Armazenamento
Os exemplos a seguir demonstram como excluir um grupo da Lente de Armazenamento do Amazon S3 usando o console do Amazon S3AWS Command Line Interface, (AWS CLI) e AWS SDK para Java.
## Usar o console do S3
**Para excluir um grupo da Lente de Armazenamento**
1. Faça login no Console de gerenciamento da AWS e abra o console do Amazon S3 em [https://console.aws.amazon.com/s3/](https://console.aws.amazon.com/s3/).
1. No painel de navegação à esquerda, selecione **Grupos de Lente de Armazenamento**.
1. Em **Grupos da Lente de Armazenamento**, selecione o botão ao lado do grupo da Lente de Armazenamento para excluir.
1. Escolha **Excluir**. Uma caixa de diálogo **Excluir grupo da Lente de Armazenamento** é exibida.
1. Selecione **Excluir** novamente para excluir permanentemente o grupo da Lente de Armazenamento.
**nota**
Depois de excluir um grupo da Lente de Armazenamento, ele não poderá ser restaurado.
## Como usar o AWS CLI
O exemplo AWS CLI a seguir exclui o grupo de Lente de Armazenamento `marketing-department`. Para usar esse exemplo de comando, substitua os `user input placeholders` por suas próprias informações.
```
aws s3control delete-storage-lens-group --account-id 111122223333 \
--region us-east-1 --name marketing-department
```
## Usar o AWS SDK para Java
O exemplo AWS SDK para Java a seguir exclui o grupo da Lente de Armazenamento `Marketing-Department` na conta `111122223333`. Para usar esse exemplo, substitua os `user input placeholders` por suas próprias informações.
```
package aws.example.s3control;
import com.amazonaws.AmazonServiceException;
import com.amazonaws.SdkClientException;
import software.amazon.awssdk.auth.credentials.ProfileCredentialsProvider;
import software.amazon.awssdk.regions.Region;
import software.amazon.awssdk.services.s3control.S3ControlClient;
import software.amazon.awssdk.services.s3control.model.DeleteStorageLensGroupRequest;
public class DeleteStorageLensGroup {
public static void main(String[] args) {
String storageLensGroupName = "Marketing-Department";
String accountId = "111122223333";
try {
DeleteStorageLensGroupRequest deleteStorageLensGroupRequest = DeleteStorageLensGroupRequest.builder()
.name(storageLensGroupName)
.accountId(accountId).build();
S3ControlClient s3ControlClient = S3ControlClient.builder()
.region(Region.US_WEST_2)
.credentialsProvider(ProfileCredentialsProvider.create())
.build();
s3ControlClient.deleteStorageLensGroup(deleteStorageLensGroupRequest);
} catch (AmazonServiceException e) {
// The call was transmitted successfully, but Amazon S3 couldn't process
// it and returned an error response.
e.printStackTrace();
} catch (SdkClientException e) {
// Amazon S3 couldn't be contacted for a response, or the client
// couldn't parse the response from Amazon S3.
e.printStackTrace();
}
}
}
```