Criar um relatório de cache para seu Gateway de Arquivos do S3 - AWS Storage Gateway

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Criar um relatório de cache para seu Gateway de Arquivos do S3

O Gateway de Arquivos do S3 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 determinem 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 do gateway. Por exemplo, se houver falha no upload de arquivos do seu gateway para o Amazon S3, você poderá gerar um relatório que liste os arquivos específicos cujo upload não está sendo feito e os motivos da falha no upload. O relatório é um arquivo CSV que contém uma lista de arquivos que correspondem ao conjunto de parâmetros de filtro especificado por você. 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 as permissões s3:PutObject e s3:AbortMultipartUpload para o bucket do Amazon S3 em que você deseja armazenar o relatório de cache.

  • Nenhum outro relatório de cache pode estar em andamento no momento para o compartilhamento de arquivos.

  • Deve haver menos de dez 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.

Como 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, depois, 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. Em Localização do Amazon S3, informe o bucket do Amazon S3 e o prefixo do local onde 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 do Amazon S3 existente, escolha Procurar S3.

  5. Em Perfil do IAM, realize uma das seguintes ações para especificar um perfil do IAM que conceda permissões do Gateway de Arquivos para gerar e armazenar o relatório de cache:

    • Para especificar um perfil do IAM existente, escolha um na lista suspensa.

    • Para criar manualmente um perfil do IAM, escolha Criar um perfil e, depois, crie o perfil usando o console do IAM.

    nota

    O perfil do IAM que você especificar deverá ter as seguintes permissões para gravar objetos no Local do Amazon S3 do bucket de relatórios e interromper os uploads fragmentados no bucket de relatórios:

    • s3:PutObject

    • s3:AbortMultipartUpload

    O perfil também deve permitir que o serviço storagegateway.amazonaws.com assuma o perfil utilizando a ação sts:AssumeRole.

  6. Em Filtro de relatório, siga um destes procedimentos para decidir 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 Falha no upload de todos os arquivos.

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

      • Classe de armazenamento inacessível: o gateway não consegue acessar a classe de armazenamento do Amazon S3 na qual 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 ao S3 negado: o perfil do IAM de acesso ao bucket do Amazon S3 não permite que o gateway realize a operação de upload. Para obter mais informações, consulte Erro: S3 AccessDenied.

    nota

    O sinalizador de arquivos com falha de 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 que eles sejam sinalizados novamente, eles não serão relatados como arquivos com falha de upload.

  7. Em Usar um endpoint da VPC para se conectar ao S3?, realize uma das seguintes ações para especificar como o gateway se conectará ao bucket do Amazon S3:

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

    • Para pesquisar uma lista de endpoints existentes da Amazon VPC, escolha Escolher um endpoint da VPC e, depois, especifique um endpoint na lista suspensa Endpoints da VPC exibida.

    • Para especificar um endpoint da Amazon VPC existente por seu nome DNS, escolha Insira o nome DNS de um endpoint da VPC e, depois, digite o nome DNS no campo Inserir nome DNS do endpoint da VPC exibido.

    nota

    Se seu compartilhamento de arquivos usa um endpoint da VPC 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 o seu relatório de cache.

    Tag é um par de chave-valor que diferencia maiúsculas de minúsculas e ajuda você a categorizar os recursos do Storage Gateway. Adicionar tags pode facilitar a filtragem e a pesquisa do seu relatório de cache. Repita essa etapa para adicionar até cinquenta tags.

  9. Quando terminar, escolha Criar relatório.

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