View a markdown version of this page

Criar sistemas de arquivos - Amazon Simple Storage Service

Criar sistemas de arquivos

É possível criar sistemas de arquivos usando o Console da AWS, a AWS Command Line Interface (AWS CLI) ou a API do Amazon S3 para qualquer bucket de uso geral novo ou existente do S3. Para ter mais informações sobre como criar um bucket, consulte Criar um bucket de uso geral.

Permissões necessárias do IAM para criar sistemas de arquivos

Ao criar um sistema de arquivos do S3, você deve especificar um perfil do IAM que o S3 Files assume para ler e gravar no bucket do S3. Esse perfil permite que o S3 Files sincronize as alterações entre o sistema de arquivos e o bucket do S3. Quando um sistema de arquivos é criado por meio do Console da AWS, o S3 Files cria automaticamente esse perfil do IAM com as permissões necessárias. Se você estiver usando a AWS CLI ou a API S3, consulte Perfil do IAM para acessar um bucket pelo sistema de arquivos.

Para obter mais informações sobre como gerenciar permissões para operações de API, consulte Como o S3 Files funciona com o IAM.

Status de um sistema de arquivos

Um sistema de arquivos pode ter um dos valores de status descritos na tabela a seguir, que podem ser obtidos usando o comando get-file-system.

Estado do sistema de arquivos Descrição
AVAILABLE O sistema de arquivos está em um estado íntegro e está acessível e disponível para uso.
CREATING O S3 files está criando o sistema de arquivos.
DELETING O S3 Files está excluindo o sistema de arquivos em resposta a uma solicitação de exclusão iniciada pelo usuário.
DELETED O S3 Files excluiu o sistema de arquivos em resposta a uma solicitação de exclusão iniciada pelo usuário.
ERROR O sistema de arquivos está em um estado de falha e é irrecuperável. Para acessar os dados do sistema de arquivos, restaure um backup desse sistema de arquivos em um novo sistema de arquivos. Verifique o campo StatusMessage para obter informações sobre o erro.
nota

O S3 Files exibe um erro quando você tenta criar um sistema de arquivos com escopo para um prefixo com um grande número de objetos. Esse erro alerta que grandes operações recursivas de renomeação ou movimentação podem afetar o desempenho do sistema de arquivos e aumentar os custos de solicitação do S3, pois cada arquivo exige solicitações separadas de cópia e exclusão para o bucket do S3. Se você ainda quiser criar um sistema de arquivos com escopo para esse prefixo, é possível adicionar o parâmetro --AcceptBucketWarning.

Esta seção explica como usar o console do Amazon S3 para criar um sistema de arquivos para o S3 Files.

  • Abra o console do Amazon S3, em https://console.aws.amazon.com/s3/.

  • Na barra de navegação, na parte superior da página, verifique se você está na região da AWS desejada.

  • No painel de navegação à esquerda, selecione Sistemas de arquivos.

  • Selecione Criar sistema de arquivos.

  • Na página de criação, escolha o bucket ou prefixo do S3 para criar um sistema de arquivos. É possível inserir o URI do S3 diretamente (por exemplo, s3://bucket-name/prefix) ou escolher Procurar no S3 para navegar e selecionar o bucket ou prefixo.

  • Selecione uma VPC para o sistema de arquivos. O S3 Files seleciona sua VPC padrão automaticamente. Essa é a VPC na qual seus recursos de computação se conectam ao sistema de arquivos. Para usar uma VPC diferente, escolha uma no menu suspenso.

  • Selecione Criar e aguarde até que o status do sistema de arquivos se torne Available.

Configurações padrão no Console de Gerenciamento da AWS

O S3 Files criará o sistema de arquivos com a seguinte configuração:

  • Criptografia: o S3 Files define a configuração de criptografia do bucket de origem do S3 e a aplica aos dados em repouso no sistema de arquivos.

  • Perfil do IAM: o S3 Files cria um perfil do IAM que ele assume para gerenciar a sincronização de dados entre o sistema de arquivos e o bucket.

  • Destinos de montagem: o S3 Files cria automaticamente um destino de montagem em cada zona de disponibilidade na VPC que você escolher.

  • Ponto de acesso: o S3 Files cria um ponto de acesso para o sistema de arquivos.

Ao usar a AWS CLI, esses recursos são criados em ordem. Primeiro, crie um sistema de arquivos. Depois, é possível criar destinos de montagem e outras tags opcionais para o sistema de arquivos usando comandos da AWS CLI correspondentes.

O exemplo de comando create-file-system a seguir mostra como usar a AWS CLI para criar um sistema de arquivos para o S3 Files.

aws s3files create-file-system --region aws-region --bucket s3-bucket-arn --client-token idempotency-token --role-arn iam-role

Substitua os seguintes valores pelos valores desejados:

  • aws-region: a região da AWS do bucket. Por exemplo, us-east-1.

  • bucket-arn: o ARN do bucket do S3.

  • idempotency-token: um token de idempotência. Isso é opcional.

  • iam-role: o ARN do perfil do IAM que o S3 Files assume para ler e gravar no bucket do S3. Verifique se você adicionou as permissões corretas a esse perfil do IAM. Para ter mais informações, consulte Perfil do IAM para acessar um bucket pelo sistema de arquivos.

Depois que o sistema de arquivos é criado com êxito, o S3 Files exibe a descrição do sistema de arquivos no formato JSON.