Trabalhar com objetos do Amazon S3

Os arquivos, pastas e outros dados armazenados no bucket de recursos do S3 são conhecidos como objetos do S3.

As seções a seguir descrevem como trabalhar com objetos do Amazon S3 por meio do AWS Toolkit for Visual Studio Code. Para obter mais informações sobre como trabalhar com recursos do Amazon S3, como buckets do S3, pelo AWS Toolkit for Visual Studio Code, consulte o tópico Trabalhar com recursos do S3 neste guia do usuário.

Paginação de objetos

Se você estiver trabalhando com um grande número de objetos e pastas do Amazon S3, a paginação permitirá especificar o número de itens que deseja exibir em uma página.

1. Acesse a Barra de atividades do VS Code e selecione Extensões.

2. Na extensão do kit de ferramentas da AWS, escolha o ícone de configurações e selecione Configurações de extensão.

3. Na página Configurações, role para baixo até a configuração AWS > S3: máximo de itens por página.

4. Altere o valor padrão do número de itens do S3 que você deseja exibir antes que a mensagem “carregar mais” seja exibida.

   nota

   Os valores válidos incluem qualquer número entre 3 e 1.000. Essa configuração se aplica somente ao número de objetos ou pastas exibidos ao mesmo tempo. Todos os buckets que você criou são exibidos de uma vez. Por padrão, você pode criar até 100 buckets em cada conta da AWS.

5. Feche a página Configurações para confirmar as alterações.

Você também pode atualizar as configurações em um arquivo formatado em JSON escolhendo o ícone Abrir configurações (JSON) no canto superior direito da página Configurações.

Carregar e baixar objetos do Amazon S3

Você pode carregar arquivos armazenados localmente para buckets do Amazon S3 ou baixar objetos remotos do Amazon S3 no sistema local usando o AWS Toolkit for Visual Studio Code.

Carregar um arquivo usando o kit de ferramentas

1. No Explorer do kit de ferramentas, expanda o serviço Amazon S3 para ver uma lista dos recursos do S3.

2. Selecione o ícone Carregar arquivo localizado próximo a um bucket ou pasta para abrir a caixa de diálogo Carregar arquivo. Ou você pode abrir o menu de contexto (clique com o botão direito do mouse) e selecionar Carregar arquivo.

   nota

   Para carregar um arquivo na pasta ou no recurso principal do objeto, abra o menu de contexto (clique com o botão direito do mouse) de qualquer objeto do S3 e selecione Carregar principal.

3. Use o gerenciador de arquivos do sistema para selecionar um arquivo e escolha Carregar arquivo para fechar a caixa de diálogo e carregar o arquivo.

Carregar um arquivo usando a paleta de comandos

Você pode usar a interface do kit de ferramentas ou a paleta de comandos para carregar um arquivo em um bucket.

1. Para selecionar um arquivo para carregar, selecione a guia do arquivo no VS Code.

2. Pressione Ctrl + Shift + P para exibir o painel Paleta de comandos.

3. Na Paleta de comandos, insira a frase upload file para exibir uma lista dos comandos recomendados.

4. Escolha o comando AWS:carregar arquivo para abrir a caixa de diálogo AWS: carregar arquivo.

5. Quando solicitado, escolha o arquivo que deseja carregar e escolha o bucket no qual deseja carregá-lo.

6. Confirme o upload para fechar a caixa de diálogo e iniciar o processo de upload. Quando o upload for concluído, o objeto será exibido no menu do kit de ferramentas com metadados que incluem tamanho do objeto, data da última modificação e caminho.

Baixar um objeto do Amazon S3

1. No Explorer do kit de ferramentas, expanda o serviço S3.

2. Em um bucket ou pasta, abra o menu de contexto (clique com o botão direito do mouse) de um objeto que você deseja baixar. Em seguida, selecione Fazer download como para abrir a caixa de diálogo Fazer download como. Ou escolha o ícone Fazer download como próximo ao objeto.

3. Ao usar o gerenciador de arquivos do sistema, selecione uma pasta de destino, insira um nome de arquivo e escolha Fazer download para fechar a caixa de diálogo e iniciar o download.

Editar objetos remotos

Você pode usar o AWS Toolkit for Visual Studio Code para editar os objetos do Amazon S3 que estão armazenados nos recursos remotos do Amazon S3.

1. No Explorer do kit de ferramentas, expanda o serviço S3.

2. Expanda o recurso do S3 que contém o arquivo que você deseja editar.

3. Para editar o arquivo, escolha o ícone de lápis (Editar arquivo).

4. Para editar um arquivo aberto no modo somente leitura, visualize o arquivo no editor do VS Code e escolha o ícone de lápis localizado no canto superior direito da interface de usuário.

nota

• Se você reiniciar ou sair do VS Code, o IDE se desconectará dos recursos do S3. Se algum arquivo remoto do S3 estiver sendo editado quando você se desconectar, a edição será interrompida. Você deverá reiniciar o VS Code e reabrir a guia de edição para retomar a edição.

• O botão Editar arquivo fica no canto superior direito da interface de usuário. Ele só fica visível quando você está visualizando ativamente um arquivo somente leitura no editor do VS Code.

• Arquivos que não são de texto não podem ser abertos no modo somente leitura. Eles sempre abrem no modo de edição.

• Não é possível voltar para o modo somente leitura do modo somente edição, apenas o contrário.

Copiar o caminho de um objeto do Amazon S3

O procedimento a seguir descreve como copiar o caminho de um objeto do Amazon S3 no AWS Toolkit for Visual Studio Code.

1. No Explorer do kit de ferramentas, expanda o serviço S3.

2. Expanda o bucket de recursos que contém o objeto cujo caminho você deseja copiar.

3. Abra o menu de contexto (clique com o botão direito do mouse) do objeto para o qual você deseja copiar o caminho e selecione Copiar caminho para copiar o caminho do objeto na área de transferência local.

Gerar um presigned URL para um objeto do Amazon S3

Você pode compartilhar objetos privados do Amazon S3 com outras pessoas concedendo permissões por tempo limitado para downloads por meio do recurso de URL pré-assinado. Para obter mais informações, consulte Compartilhar objetos com URLs pré-assinados.

1. No Explorer do kit de ferramentas, expanda o serviço S3.

2. Em um bucket ou pasta, abra o menu de contexto (clique com o botão direito do mouse) de um objeto que você deseja compartilhar. Em seguida, selecione Gerar URL pré-assinado para abrir a paleta de comandos.

3. Na paleta de comandos, insira o número de minutos em que o URL pode ser usado para acessar o objeto. Em seguida, selecione Enter para confirmar e fechar a caixa de diálogo.

4. Depois que o URL pré-assinado é gerado, a Barra de status do VS Code exibe o URL pré-assinado do objeto que foi copiado para a área de transferência local.

Excluir um objeto do Amazon S3

Se um objeto estiver em um bucket sem versão, você poderá excluí-lo permanentemente. No caso de buckets com versionamento habilitado, uma solicitação de exclusão não exclui permanentemente esse objeto. Em vez disso, o Amazon S3 insere um marcador de exclusão no bucket. Para obter mais informações, consulte Excluir versões de objeto.

1. No Explorer do kit de ferramentas, expanda o serviço S3 para ver uma lista de recursos do S3.

2. Abra o menu de contexto (clique com o botão direito do mouse) de um objeto que você deseja excluir e selecione Excluir para abrir a caixa de diálogo de confirmação.

3. Selecione Excluir. . . para confirmar que deseja excluir o objeto S3. Em seguida, feche a caixa de diálogo.