Fazer upload de objetos para um bucket do Amazon S3 - Ferramentas da AWS para PowerShell (versão 4)
Observação sobre multipart upload

A versão 5 (V5) do Ferramentas da AWS para PowerShell foi lançada!

Para começar a usar a nova versão do SDK, consulte o Guia do usuário do Ferramentas da AWS para PowerShell (V5), especialmente o tópico Migração para V5.

Fazer upload de objetos para um bucket do Amazon S3

Use o cmdlet Write-S3Object para fazer upload de arquivos do seu sistema de arquivos local para um bucket do Amazon S3 como objetos. O exemplo a seguir cria e carrega dois arquivos HTML simples para um bucket do Amazon S3 e verifica a existência dos objetos carregados. O parâmetro -File para Write-S3Object especifica o nome do arquivo no sistema de arquivos local. O parâmetro -Key especifica o nome que o objeto correspondente terá no Amazon S3.

A Amazon deduz o tipo de conteúdo dos objetos a partir das extensões de arquivos, nesse caso, ".html".

PS > # Create the two files using here-strings and the Set-Content cmdlet
PS > $index_html = @"
>> <html>
>>   <body>
>>     <p>
>>       Hello, World!
>>     </p>
>>   </body>
>> </html>
>> "@
>>
PS > $index_html | Set-Content index.html
PS > $error_html = @"
>> <html>
>>   <body>
>>     <p>
>>       This is an error page.
>>     </p>
>>   </body>
>> </html>
>> "@
>>
>>$error_html | Set-Content error.html
>># Upload the files to Amazon S3 using a foreach loop
>>foreach ($f in "index.html", "error.html") {
>> Write-S3Object -BucketName website-example -File $f -Key $f -CannedACLName public-read
>> }
>>
PS > # Verify that the files were uploaded
PS > Get-S3BucketWebsite -BucketName website-example

IndexDocumentSuffix                                         ErrorDocument
-------------------                                         -------------
index.html                                                  error.html

Opções pré-configuradas de ACL

Os valores para especificar ACLs pré-configuradas com o Tools for Windows PowerShell são os mesmos que os usados pelo AWS SDK para .NET. Observe, no entanto, que eles são diferentes dos valores usados pela ação Put Object do Amazon S3. O Tools for Windows PowerShell oferece suporte às seguintes ACLs pré-configuradas:

  • NoACL

  • privado

  • public-read

  • public-read-write

  • aws-exec-read

  • authenticated-read

  • bucket-owner-read

  • bucket-owner-full-control

  • log-delivery-write

Para obter mais informações sobre essas configurações de ACL pré-configurada, consulte Visão geral da lista de controle de acesso.

Observação sobre multipart upload

Se você usar a API do Amazon S3 para fazer upload de um arquivo com mais de 5 GB, será necessário utilizar o carregamento fracionado. No entanto, o cmdlet Write-S3Object fornecido pelo Tools for Windows PowerShell pode tratar de maneira transparente uploads de arquivos com mais de 5 GB.

Testar o site

Nesse momento, você pode testar o site, navegando até ele com um navegador. Os URLs para sites estáticos hospedados no Amazon S3 seguem um formato padrão.

http://<bucket-name>.s3-website-<region>.amazonaws.com

Por exemplo:

http://website-example.s3-website-us-west-1.amazonaws.com

Consulte também