Crie um relatório de cache para seu S3 File Gateway

O S3 File Gateway pode gerar um relatório dos metadados dos arquivos que estão atualmente no cache de upload local para um compartilhamento de arquivos específico. Você pode aplicar filtros e critérios adicionais que determinam quais tipos específicos de arquivos em cache aparecem no relatório. Você pode usar esse relatório para ajudar a identificar e resolver problemas de gateway. Por exemplo, se houver falha no upload de arquivos do seu gateway para o Amazon S3, você pode gerar um relatório que lista os arquivos específicos que não estão sendo carregados e os motivos da falha no upload. O relatório é um arquivo CSV contendo uma lista de arquivos que correspondem ao conjunto de parâmetros de filtro que você especifica. O arquivo de saída é armazenado como um objeto do Amazon S3 em um local de bucket que você especifica ao configurar o relatório. Para criar um relatório de cache usando a AWS Storage Gateway API, consulte a Referência StartCacheReportda API do Storage Gateway. Para criar um relatório de cache no console do Storage Gateway, use o procedimento a seguir.

Pré-requisitos

• Seu gateway deve ter s3:PutObject s3:AbortMultipartUpload permissões para o bucket do Amazon S3 em que você deseja armazenar o relatório de cache.

• Atualmente, nenhum outro relatório de cache pode estar em andamento para o compartilhamento de arquivos.

• Deve haver menos de 10 relatórios de cache existentes para o compartilhamento de arquivos.

• O gateway deve estar on-line e conectado AWS a.

• O disco raiz do gateway deve ter pelo menos 20 GB de espaço livre.

Para criar um relatório de cache usando o console do Storage Gateway

1. Abra o console do Storage Gateway em https://console.aws.amazon.com/storagegateway/casa/.

2. No painel de navegação no lado esquerdo da página, escolha Compartilhamentos de arquivos e escolha o compartilhamento de arquivos para o qual você deseja criar um relatório de cache.

3. No menu suspenso Ações, escolha Criar relatório de cache.

4. Para a localização do Amazon S3, insira o bucket do Amazon S3 e o prefixo do local em que você deseja salvar o objeto de arquivo CSV do relatório de cache completo no Amazon S3. Para selecionar o bucket e o prefixo do seu armazenamento Amazon S3 existente, escolha Browse S3.

5. Para a função do IAM, faça o seguinte para especificar uma função do IAM que conceda ao seu File Gateway permissões para gerar e armazenar seu relatório de cache:

   • Para especificar uma função existente do IAM, escolha uma função na lista suspensa.

   • Para criar manualmente uma nova função do IAM, escolha Criar uma função e, em seguida, crie a nova função usando o console do IAM.

   nota

   A função do IAM que você especificar deve ter as seguintes permissões para gravar objetos na localização do Amazon S3 do repositório de relatórios e interromper os carregamentos de várias partes para o repositório de relatórios:

   • s3:PutObject

   • s3:AbortMultipartUpload

   A função também deve permitir que o storagegateway.amazonaws.com serviço assuma a função usando a sts:AssumeRole ação.

6. Em Filtro de relatório, siga um destes procedimentos para determinar quais arquivos serão incluídos no relatório de cache:

   • Para incluir todos os arquivos em cache que estão atualmente com falha no upload para o Amazon S3, escolha Todos os arquivos com falha no upload.

   • Para incluir somente os arquivos que falharam no upload para o Amazon S3 por um motivo específico, escolha Somente motivos específicos da falha no upload. Em seguida, em Motivos de falha, selecione um ou mais dos seguintes motivos:

     • Classe de armazenamento inacessível — O gateway não pode acessar a classe de armazenamento Amazon S3 em que o objeto está armazenado. Para obter mais informações, consulte Erro: InaccessibleStorageClass.

     • Estado de objeto inválido — O estado do arquivo no gateway não corresponde ao estado no Amazon S3. Para obter mais informações, consulte Erro: InvalidObjectState.

     • Objeto ausente — O objeto foi excluído ou movido no Amazon S3. Para obter mais informações, consulte Erro: ObjectMissing.

     • Acesso negado ao S3 — A função IAM de acesso ao bucket do Amazon S3 não permite que o gateway execute a operação de upload. Para obter mais informações, consulte Erro: S3 AccessDenied.

   nota

   O sinalizador Files Failing Upload é redefinido a cada 24 horas e durante a reinicialização do gateway. Se esse relatório capturar os arquivos após a redefinição, mas antes de serem sinalizados novamente, eles não serão reportados como Arquivos com falha no upload.

7. Para usar um VPC endpoint para se conectar ao S3? , faça o seguinte para especificar como seu gateway se conectará ao bucket do Amazon S3:

   • Para se conectar diretamente sem usar a Amazon VPC, escolha Conectar diretamente ao bucket.

   • Para pesquisar uma lista de endpoints existentes da Amazon VPC, escolha Escolher um endpoint de VPC e, em seguida, especifique um endpoint na lista suspensa de VPC endpoints que aparece.

   • Para especificar um endpoint Amazon VPC existente por seu nome DNS, escolha Inserir um nome DNS do endpoint VPC e, em seguida, insira o nome DNS no campo Nome DNS do VPC endpoint que aparece.

   nota

   Se seu compartilhamento de arquivos usa um VPC endpoint para se conectar ao Amazon S3 para operações normais, recomendamos usar a mesma VPC ao configurar seu relatório de cache. A criação do relatório de cache falhará se o gateway não conseguir se conectar ao bucket do Amazon S3 por qualquer motivo, incluindo configuração de VPC inválida.

8. (Opcional) Em Tags - opcional, escolha Adicionar nova tag e insira uma chave e um valor para seu relatório de cache.

   Uma tag é um par de valores-chave com distinção entre maiúsculas e minúsculas que ajuda você a categorizar seus recursos do Storage Gateway. Adicionar tags pode facilitar a filtragem e a pesquisa do seu relatório de cache. Você pode repetir essa etapa para adicionar até 50 tags.

9. Escolha Criar relatório quando terminar.

   O Storage Gateway começa a gerar o relatório. Você pode verificar o progresso e visualizar o status na guia Relatórios de cache da página de detalhes do compartilhamento de arquivos.