Faça upload de arquivos para um bucket do Amazon Lightsail - Amazon Lightsail
Nomes de chaves de objeto e controle de versãoFaça upload de arquivos para um bucket usando o console do LightsailCarregar arquivos para um bucket usando o AWS CLIConfigure a AWS CLI para solicitações somente IPv6Gerenciando buckets e objetos no Lightsail

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á.

Faça upload de arquivos para um bucket do Amazon Lightsail

Quando você carrega um arquivo no seu bucket no serviço de armazenamento de objetos Amazon Lightsail, ele é armazenado como um objeto. Os objetos consistem em dados e metadados de arquivo que descrevem o objeto. Você pode ter qualquer número de objetos no bucket.

Você pode carregar qualquer tipo de arquivo (imagens, backups, dados, filmes) em um bucket. O tamanho máximo do arquivo que você pode carregar usando o console Lightsail é de 2 GB. Para fazer upload de um arquivo maior, use a API LightsailAWS Command Line Interface, AWS CLI () ou SDKs. AWS

O Lightsail oferece as seguintes opções, dependendo do tamanho do arquivo que você deseja carregar:

  • Faça upload de um objeto de até 2 GB usando o console do Lightsail — Com o console do Lightsail, você pode carregar um único objeto de até 2 GB. Para obter mais informações, consulte Fazer upload de arquivos em um bucket usando o console do Lightsail posteriormente neste guia.

  • Carregar um objeto de até 5 GB de tamanho com uma única operação usando AWS SDKs, a API REST ou a AWS CLI: com uma única operação PUT, você pode carregar um único objeto de até 5 GB. Para obter mais informações, consulte Carregar arquivos para um bucket usando o AWS CLI mais adiante neste guia.

  • Carregar um objeto em partes usando AWS SDKs, a API REST ou a AWS CLI: usando a API de carregamento multiparte, é possível fazer carregamento de um único objeto grande, de 5 MB até 5 TB de tamanho. A API multipart upload API foi projetada para melhorar a experiência de upload de objetos maiores. É possível fazer upload de um objeto em partes. O upload dessas partes de objetos pode ser feito independentemente, em qualquer ordem, e em paralelo. Para obter mais informações, consulte Upload files to a bucket using multipart upload.

Para obter mais informações sobre buckets, consulte Armazenamento de objetos.

Nomes de chaves de objeto e controle de versão

Quando você carrega um arquivo usando o console do Lightsail, o nome do arquivo é usado como nome da chave do objeto. Uma chave de objeto (ou nome da chave) identifica, unicamente, um objeto armazenado em um bucket. A pasta na qual o arquivo é carregado, se houver, é usada como o prefixo do nome da chave. Por exemplo, se você carregar um arquivo chamado sailbot.jpg para uma pasta em seu bucket chamada images, o nome completo da chave do objeto e o prefixo serão images/sailbot.jpg. Contudo, o objeto é exibido no console como sailbot.jpg na pasta images. Para obter mais informações sobre nomes de chaves de objeto, consulte Key names for object storage buckets.

Quando você carrega um diretório usando o console do Lightsail, todos os arquivos e subpastas do diretório são enviados para o bucket. Em seguida, o Lightsail atribui um nome de chave de objeto que é uma combinação de cada um dos nomes dos arquivos enviados e do nome da pasta. Por exemplo, se você fizer upload de uma pasta chamada images que contém dois arquivos sample1.jpg esample2.jpg, o Lightsail carrega os arquivos e, em seguida, atribui os nomes de chave correspondentes, e. images/sample1.jpg images/sample2.jpg Os objetos são exibidos no console como sample1.jpg e sample2.jpg na pasta images.

Se você carregar um arquivo com um nome de chave que já existe, e seu bucket não tiver o versionamento habilitado, o novo objeto carregado substituirá o objeto anterior. No entanto, se o seu bucket tiver o versionamento ativado, o Lightsail criará uma nova versão do objeto em vez de substituir o objeto existente. Para obter mais informações, consulte Enable and suspend bucket object versioning.

Faça upload de arquivos para um bucket usando o console do Lightsail

Conclua o procedimento a seguir para fazer upload de arquivos e diretórios usando o console do Lightsail.

  1. Faça login no console do Lightsail.

  2. Na página inicial do Lightsail, escolha a guia Armazenamento.

  3. Escolha o nome do bucket no qual você deseja carregar seus arquivos ou pastas.

  4. Na guia Objetos execute uma das seguintes ações:

    • Arraste e solte arquivos e pastas para a página Objetos.

    • Selecione Carregar e escolha Arquivo para carregar um arquivo individual, ou Diretório para carregar uma pasta e todo o seu conteúdo.

      nota

      Você também pode criar uma pasta escolhendo Criar nova pasta. Em seguida, você pode navegar para a nova pasta e carregar arquivos para ela.

    Uma mensagem Carregamento bem-sucedido é exibida quando o carregamento for concluído.

Carregar arquivos para um bucket usando o AWS CLI

Conclua o procedimento a seguir para carregar arquivos e pastas em um bucket usando a AWS Command Line Interface (AWS CLI). Faça isso usando o comando put-object. Para obter mais informações, consulte put-object na AWS CLI Command Reference.

nota

Você deve instalar AWS CLI e configurá-lo para o Lightsail e o Amazon S3 antes de continuar com esse procedimento. Para obter mais informações, consulte Configurar o AWS CLI para trabalhar com o Lightsail.

  1. Abra um prompt de comando ou uma janela de terminal.

  2. Digite o comando a seguir para carregar um arquivo para o seu bucket.

    aws s3api put-object --bucket BucketName --key ObjectKey --body LocalDirectory --acl bucket-owner-full-control

    No comando, substitua o seguinte exemplo de texto pelo seu próprio:

    • BucketNamecom o nome do bucket para o qual você deseja fazer o upload do arquivo.

    • ObjectKeycom a chave de objeto completa do objeto em seu bucket.

    • LocalDirectoryFirecom o caminho da pasta do diretório local em seu computador do arquivo a ser carregado.

    Exemplo:

    • Em um computador Linux ou Unix:

      aws s3api put-object --bucket DOC-EXAMPLE-BUCKET --key images/sailbot.jpg --body home/user/Pictures/sailbot.jpg --acl bucket-owner-full-control

    • Em um computador Windows:

      aws s3api put-object --bucket DOC-EXAMPLE-BUCKET --key images/sailbot.jpg --body "C:\Users\user\Pictures\sailbot.jpg" --acl bucket-owner-full-control

    Você deverá ver um resultado semelhante ao seguinte exemplo:

    Resultado do comando put-object AWS CLI

Configure a AWS CLI para solicitações somente IPv6

O Amazon S3 oferece suporte ao acesso ao bucket via IPv6. Você faz solicitações com chamadas da API do Amazon S3 por meio do IPv6 usando endpoints de pilha dupla. Esta seção fornece exemplos de como fazer solicitações para um endpoint de pilha dupla, via IPv6. Para obter mais informações, consulte Usando endpoints de pilha dupla do Amazon S3 no Guia do usuário do Amazon S3. Para obter instruções sobre como configurar oAWS CLI, consulte Como configurar o AWS Command Line Interface para trabalhar com o Amazon Lightsail.

Importante

O cliente e a rede que estão acessando o bucket devem ter permissão para usar o IPv6. Para obter mais informações, consulte Acessibilidade IPv6.

Há duas maneiras de fazer solicitações do S3 a partir de uma instância somente IPv6. Você pode configurar o AWS CLI para direcionar todas as solicitações do Amazon S3 para o endpoint de pilha dupla para o especificado. Região da AWS Ou, se quiser usar um endpoint de pilha dupla somente para AWS CLI comandos específicos (não para todos os comandos), você pode adicionar o endpoint de pilha dupla S3 a cada comando.

Configurar o AWS CLI

Defina o valor use_dualstack_endpoint da configuração true em um perfil no seu arquivo AWS Config para direcionar todas as solicitações do Amazon S3 feitas pelos comandos Amazon S3 e AWS CLI s3api para o endpoint de pilha dupla da região especificada. Você especifica a região no arquivo de AWS CLI configuração ou em um comando usando a opção --region.

Insira os comandos a seguir para configurar AWS CLI o.

aws configure set default.s3.use_dualstack_endpoint true
aws configure set default.s3.addressing_style virtual
Adicione o endpoint de pilha dupla a um comando específico

Você pode usar o endpoint de pilha dupla por comando definindo o --endpoint-url parâmetro como https://s3.dualstack.aws-region.amazonaws.com ou http://s3.dualstack.aws-region.amazonaws.com para qualquer comando s3 ou s3api. No exemplo abaixo, substitua bucketname e aws-region pelo nome do seu bucket e do seu. Região da AWS

aws s3api list-objects --bucket bucketname --endpoint-url https://s3.dualstack.aws-region.amazonaws.com

Gerenciando buckets e objetos no Lightsail

Estas são as etapas gerais para gerenciar seu bucket de armazenamento de objetos do Lightsail:

  1. Saiba mais sobre objetos e buckets no serviço de armazenamento de objetos Amazon Lightsail. Para obter mais informações, consulte Armazenamento de objetos no Amazon Lightsail.

  2. Saiba mais sobre os nomes que você pode dar aos seus buckets no Amazon Lightsail. Para obter mais informações, consulte Regras de nomenclatura de buckets no Amazon Lightsail.

  3. Comece a usar o serviço de armazenamento de objetos Lightsail criando um bucket. Para obter mais informações, consulte Criação de buckets no Amazon Lightsail.

  4. Saiba mais sobre as práticas recomendadas de segurança para buckets e as permissões de acesso que você pode configurar para o bucket. Você pode tornar todos os objetos em seu bucket públicos ou privados, ou tem a opção de tornar públicos objetos individuais. Também é possível conceder acesso ao bucket criando chaves de acesso, anexando instâncias ao bucket e concedendo acesso a outras contas da AWS. Para obter mais informações, consulte Melhores práticas de segurança para armazenamento de objetos do Amazon Lightsail e Entendendo as permissões de bucket no Amazon Lightsail.

    Depois de aprender sobre as permissões de acesso ao bucket, consulte os seguintes guias para conceder acesso ao bucket:

  5. Saiba como habilitar o registro em log de acesso ao bucket e como usar logs de acesso para auditar a segurança do bucket. Para obter mais informações, consulte os guias a seguir.

  6. Crie uma política do IAM que conceda ao usuário a capacidade de gerenciar um bucket no Lightsail. Para obter mais informações, consulte a política do IAM para gerenciar buckets no Amazon Lightsail.

  7. Saiba mais sobre a forma como os objetos do bucket são rotulados e identificados. Para obter mais informações, consulte Entendendo nomes de chaves de objetos no Amazon Lightsail.

  8. Saiba como carregar arquivos e gerenciar objetos nos buckets. Para obter mais informações, consulte os guias a seguir.

  9. Habilite o versionamento de objeto para preservar, recuperar e restaurar todas as versões de cada objeto armazenado no bucket. Para obter mais informações, consulte Habilitar e suspender o controle de versão de objetos em um bucket no Amazon Lightsail.

  10. Depois de ativar o controle de versionamento de objetos, você pode restaurar versões anteriores de objetos do bucket. Para obter mais informações, consulte Restauração de versões anteriores de objetos em um bucket no Amazon Lightsail.

  11. Monitore a utilização do seu bucket. Para obter mais informações, consulte Visualização de métricas para seu bucket no Amazon Lightsail.

  12. Configure um alarme para que as métricas do bucket sejam notificadas quando a utilização do bucket ultrapassar um limite. Para obter mais informações, consulte Criação de alarmes métricos de bucket no Amazon Lightsail.

  13. Altere o plano de armazenamento do bucket se ele estiver com pouco armazenamento e transferência de rede. Para obter mais informações, consulte Alteração do plano do seu bucket no Amazon Lightsail.

  14. Saiba como conectar o bucket a outros recursos. Para obter mais informações, consulte os tutoriais a seguir.

  15. Exclua seu bucket se não o estiver mais usando. Para obter mais informações, consulte Excluir buckets no Amazon Lightsail.