# Configurar análise de classe de armazenamento
<a name="configure-analytics-storage-class"></a>

Usando a ferramenta de análise de classe de armazenamento do Amazon S3, é possível analisar padrões de acesso de armazenamento para ajudar a decidir quando fazer a transição dos dados certos para a classe de armazenamento certa. A análise de classe de armazenamento observa padrões de acesso de dados para ajudar você a determinar quando fazer a transição do armazenamento STANDARD, acessado menos frequentemente, para a classe de armazenamento STANDARD\_IA (IA, para acesso raro). Para obter mais informações sobre STANDARD\_IA, consulte as [perguntas frequentes do Amazon S3](https://aws.amazon.com/s3/faqs/#sia) e [Compreender e gerenciar classes de armazenamento do Amazon S3](storage-class-intro.md).

Para configurar a análise de classe de armazenamento, configure os dados de objeto que você deseja analisar. Você pode configurar a análise de classe de armazenamento para fazer o seguinte:
+ **Analisar o conteúdo completo de um bucket.**

  Você receberá uma análise para todos os objetos no bucket.
+ **Analisar objetos agrupados por prefixo e por tags.**

  Você pode configurar filtros que agrupam objetos para análise por prefixo, por tags de objeto ou por uma combinação de prefixo e tags. Você recebe uma análise separada para cada filtro configurado. Você pode ter várias configurações de filtro por bucket, até 1.000. 
+ **Exportar dados de análise.** 

  Quando você configura a análise de classe de armazenamento para um bucket ou filtro, pode optar por exportar os dados de análise para um arquivo todo dia. A análise do dia é adicionada ao arquivo para formar um registro histórico de análise para o filtro configurado. O arquivo é atualizado diariamente no destino escolhido por você. Ao selecionar dados para exportar, especifique um bucket de destino e um prefixo de destino opcional onde o arquivo é gravado.

Você pode usar o console do Amazon S3, a API REST, a AWS CLI ou os AWS SDKs para configurar a análise de classe de armazenamento.

**Importante**  
A análise da classe de armazenamento não fornece recomendações de transições para as classes de armazenamento ONEZONE\_IA ou S3 Glacier Flexible Retrieval.  
Se você quiser configurar a análise de classe de armazenamento para exportar suas descobertas como um arquivo.csv e o bucket de destino usar criptografia de bucket padrão com uma AWS KMS key, atualize a política de chaves do AWS KMS para conceder permissão ao Amazon S3 para criptografar o arquivo.csv. Para instruções, consulte [Conceder permissão para que o Amazon S3 use a sua chave gerenciada pelo cliente para criptografia](configure-inventory.md#configure-inventory-kms-key-policy).

Para obter mais informações sobre análises, consulte [Análise do Amazon S3 – Análise de classe de armazenamento](analytics-storage-class.md).

## Uso do console do S3
<a name="storage-class-analysis-console"></a>

**Para configurar a análise de classe 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, escolha **Buckets de uso geral** ou **Buckets de diretórios**.

1. Na lista de buckets, escolha o nome do bucket para o qual você deseja configurar a análise de classe de armazenamento.

1. Escolha a guia **Metrics**.

1. Em **Storage Class Analysis (Análise de classe de armazenamento)**, escolha **Create analytics configuration (Criar configuração de análise)**.

1. Digite um nome para o filtro. Se você quiser analisar o bucket todo, deixe o campo **Prefix (Prefixo)** vazio.

1. No campo **Prefix (Prefixo)** digite o texto para o prefixo para os objetos que você deseja analisar.

1. Para adicionar uma tag, escolha **Add tag**. Insira uma chave e um valor para a tag. Você pode inserir um prefixo e várias tags.

1. Opcionalmente, você pode escolher **Enable (Habilitar)** em **Export CSV (Exportar CSV)** para exportar relatórios de análise para um arquivo simples com valores separados por vírgula (.csv). Escolha um bucket de destino onde o arquivo pode ser armazenado. Você pode digitar um prefixo para o bucket de destino. O bucket de destino deve estar na mesma Região da AWS que o bucket para o qual você está configurando a análise. O bucket de destino pode estar em uma diferente Conta da AWS. 

   Se o bucket de destino do arquivo .csv usar criptografia de bucket padrão com uma chave de KMS, você deverá atualizar a política de chaves do AWS KMS para conceder permissão do Amazon S3 para criptografar o arquivo .csv. Para instruções, consulte [Conceder permissão para que o Amazon S3 use a sua chave gerenciada pelo cliente para criptografia](configure-inventory.md#configure-inventory-kms-key-policy).

1. Selecione **Create Configuration (Criar configuração)**.

 O Amazon S3 cria uma política de bucket no bucket de destino que concede ao Amazon S3 permissão para gravação. Isso permitirá gravar os dados de exportação no bucket. 

 Se ocorrer um erro quando você tentar criar a política de bucket, serão fornecidas instruções sobre como resolvê-lo. Por exemplo, se você escolher um bucket de destino em outra Conta da AWS e não tiver permissões para ler e gravar na política de bucket, verá a mensagem a seguir. Você deve pedir ao proprietário do bucket de destino para adicionar a política de bucket exibida ao bucket de destino. Se a política não for adicionada ao bucket de destino, você não terá os dados de exportação porque o Amazon S3 não terá permissão para gravar no bucket de destino. Se o bucket de origem for de uma conta diferente da conta do usuário atual, o ID de conta correto do bucket de origem deverá ser substituído na política.

Para obter informações sobre os dados exportados e como o filtro funciona, consulte [Análise do Amazon S3 – Análise de classe de armazenamento](analytics-storage-class.md).

## Uso dos REST API
<a name="storage-class-apis"></a>

Para configurar a Análise de classe de armazenamento usando a API REST, use [PutBucketAnalyticsConfiguration](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketPUTAnalyticsConfig.html). Você também pode usar a operação equivalente com a AWS CLI ou os AWS SDKs. 

Você pode usar as seguintes APIs REST para trabalhar com a Análise de classe de armazenamento:
+  [ Configuração de DELETE Bucket Analytics](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketDELETEAnalyticsConfiguration.html) 
+  [ Configuração de GET Bucket Analytics](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketGETAnalyticsConfig.html) 
+  [ Listar configuração de análise de bucket](https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketListAnalyticsConfigs.html)