# Exemplos de uploads (AWS Signature Version 2)**** **Topics** + [Upload de arquivo](#HTTPPOSTExamplesFileUpload) + [Upload de área de texto](#HTTPPOSTExamplesTextArea) **nota** A autenticação de solicitação discutida nesta seção é baseada no AWS Signature Version 2, um protocolo para autenticar solicitações de entrada da API para serviços da AWS. Agora, o Amazon S3 é compatível com o Signature Version 4, um protocolo para autenticação de solicitações de API de entrada para produtos da AWS, em todas as Regiões da AWS. Neste momento, as Regiões da AWS criadas antes de 30 de janeiro de 2014 continuarão oferecendo suporte ao protocolo anterior, Signature Version 2. Todas as regiões novas a partir de 30 de janeiro de 2014 oferecerão suporte apenas ao Signature versão 4. Portanto, todas as solicitações para essas regiões devem ser feitas com o Signature versão 4. Para obter mais informações, consulte [Exemplos: upload baseado em navegador usando HTTP POST (usando o AWS Signature Version 4)](https://docs.aws.amazon.com/AmazonS3/latest/API/sigv4-post-example.html) na *Referência de APIs do Amazon Simple Storage Service*. ## Upload de arquivo Este exemplo mostra o processo completo para criação de uma política e um formulário que pode ser usado para carregar um arquivo anexo. ### Criação de política e formulário A política a seguir é compatível com uploads para o bucket awsexamplebucket1 do Amazon S3. ``` 1. { "expiration": "2007-12-01T12:00:00.000Z", 2. "conditions": [ 3. {"bucket": "awsexamplebucket1"}, 4. ["starts-with", "$key", "user/eric/"], 5. {"acl": "public-read"}, 6. {"success_action_redirect": "https://awsexamplebucket1.s3.us-west-1.amazonaws.com/successful_upload.html"}, 7. ["starts-with", "$Content-Type", "image/"], 8. {"x-amz-meta-uuid": "14365123651274"}, 9. ["starts-with", "$x-amz-meta-tag", ""] 10. ] 11. } ``` Esta política requer o seguinte: + O upload deve ocorrer antes das 12:00 UTC em 1º de dezembro de 2007. + O upload do conteúdo deve ser feito para o bucket awsexamplebucket1. + A chave deve começar com "user/eric/". + A ACL está definida para leitura pública. + O success\_action\_redirect está definido como https://awsexamplebucket1.s3.us-west-1.amazonaws.com/successful\_upload.html. + O objeto é um arquivo de imagem. + A tag x-amz-meta-uuid deve ser definida como 14365123651274. + A tag x-amz-meta-tag pode conter qualquer valor. Veja a seguir uma versão codificada em Base64 dessa política. ``` 1. eyAiZXhwaXJhdGlvbiI6ICIyMDA3LTEyLTAxVDEyOjAwOjAwLjAwMFoiLAogICJjb25kaXRpb25zIjogWwogICAgeyJidWNrZXQiOiAiam9obnNtaXRoIn0sCiAgICBbInN0YXJ0cy13aXRoIiwgIiRrZXkiLCAidXNlci9lcmljLyJdLAogICAgeyJhY2wiOiAicHVibGljLXJlYWQifSwKICAgIHsic3VjY2Vzc19hY3Rpb25fcmVkaXJlY3QiOiAiaHR0cDovL2pvaG5zbWl0aC5zMy5hbWF6b25hd3MuY29tL3N1Y2Nlc3NmdWxfdXBsb2FkLmh0bWwifSwKICAgIFsic3RhcnRzLXdpdGgiLCAiJENvbnRlbnQtVHlwZSIsICJpbWFnZS8iXSwKICAgIHsieC1hbXotbWV0YS11dWlkIjogIjE0MzY1MTIzNjUxMjc0In0sCiAgICBbInN0YXJ0cy13aXRoIiwgIiR4LWFtei1tZXRhLXRhZyIsICIiXQogIF0KfQo= ``` Crie uma assinatura usando suas credenciais. Por exemplo `0RavWzkygo6QX9caELEqKi9kDbU=` é a assinatura para o documento de política anterior. O formulário a seguir comporta uma solicitação POST para o bucket amzn-s3-demo-bucket que usa essa política. ``` 1. 2. 3. ... 4. 5. ... 6. 7. 8. ... 9.
10. Key to upload:
11. 12. 13. Content-Type:
14. 15. Tags for File:
16. 17. 18. 19. File:
20. 21. 22.
23. ... 24. ``` ### Exemplo de solicitação Essa solicitação pressupões que a imagem carregada tem 117.108 bytes; os dados da imagem não estão inclusos. ``` 1. POST / HTTP/1.1 2. Host: awsexamplebucket1.s3.us-west-1.amazonaws.com 3. User-Agent: Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.8.1.10) Gecko/20071115 Firefox/2.0.0.10 4. Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5 5. Accept-Language: en-us,en;q=0.5 6. Accept-Encoding: gzip,deflate 7. Accept-Charset: ISO-8859-1,utf-8;q=0.7,*;q=0.7 8. Keep-Alive: 300 9. Connection: keep-alive 10. Content-Type: multipart/form-data; boundary=9431149156168 11. Content-Length: 118698 12. 13. --9431149156168 14. Content-Disposition: form-data; name="key" 15. 16. user/eric/MyPicture.jpg 17. --9431149156168 18. Content-Disposition: form-data; name="acl" 19. 20. public-read 21. --9431149156168 22. Content-Disposition: form-data; name="success_action_redirect" 23. 24. https://awsexamplebucket1.s3.us-west-1.amazonaws.com/successful_upload.html 25. --9431149156168 26. Content-Disposition: form-data; name="Content-Type" 27. 28. image/jpeg 29. --9431149156168 30. Content-Disposition: form-data; name="x-amz-meta-uuid" 31. 32. 14365123651274 33. --9431149156168 34. Content-Disposition: form-data; name="x-amz-meta-tag" 35. 36. Some,Tag,For,Picture 37. --9431149156168 38. Content-Disposition: form-data; name="AWSAccessKeyId" 39. 40. AKIAIOSFODNN7EXAMPLE 41. --9431149156168 42. Content-Disposition: form-data; name="Policy" 43. 44. eyAiZXhwaXJhdGlvbiI6ICIyMDA3LTEyLTAxVDEyOjAwOjAwLjAwMFoiLAogICJjb25kaXRpb25zIjogWwogICAgeyJidWNrZXQiOiAiam9obnNtaXRoIn0sCiAgICBbInN0YXJ0cy13aXRoIiwgIiRrZXkiLCAidXNlci9lcmljLyJdLAogICAgeyJhY2wiOiAicHVibGljLXJlYWQifSwKICAgIHsic3VjY2Vzc19hY3Rpb25fcmVkaXJlY3QiOiAiaHR0cDovL2pvaG5zbWl0aC5zMy5hbWF6b25hd3MuY29tL3N1Y2Nlc3NmdWxfdXBsb2FkLmh0bWwifSwKICAgIFsic3RhcnRzLXdpdGgiLCAiJENvbnRlbnQtVHlwZSIsICJpbWFnZS8iXSwKICAgIHsieC1hbXotbWV0YS11dWlkIjogIjE0MzY1MTIzNjUxMjc0In0sCiAgICBbInN0YXJ0cy13aXRoIiwgIiR4LWFtei1tZXRhLXRhZyIsICIiXQogIF0KfQo= 45. --9431149156168 46. Content-Disposition: form-data; name="Signature" 47. 48. 0RavWzkygo6QX9caELEqKi9kDbU= 49. --9431149156168 50. Content-Disposition: form-data; name="file"; filename="MyFilename.jpg" 51. Content-Type: image/jpeg 52. 53. ...file content... 54. --9431149156168 55. Content-Disposition: form-data; name="submit" 56. 57. Upload to Amazon S3 58. --9431149156168-- ``` ### Exemplo de resposta ``` 1. HTTP/1.1 303 Redirect 2. x-amz-request-id: 1AEE782442F35865 3. x-amz-id-2: cxzFLJRatFHy+NGtaDFRR8YvI9BHmgLxjvJzNiGGICARZ/mVXHj7T+qQKhdpzHFh 4. Content-Type: application/xml 5. Date: Wed, 14 Nov 2007 21:21:33 GMT 6. Connection: close 7. Location: https://awsexamplebucket1.s3.us-west-1.amazonaws.com/successful_upload.html?bucket=awsexamplebucket1&key=user/eric/MyPicture.jpg&etag="39d459dfbc0faabbb5e179358dfb94c3" 8. Server: AmazonS3 ``` ## Upload de área de texto **Topics** + [Criação de política e formulário](#HTTPPOSTExamplesTextAreaPolicy) + [Exemplo de solicitação](#HTTPPOSTExamplesTextAreaRequest) + [Exemplo de resposta](#HTTPPOSTExamplesTextAreaResponse) O exemplo a seguir mostra o processo completo para criação de uma política e um formulário para carregar uma área de texto. Fazer upload de uma área de texto é útil para o envio de conteúdo criado pelo usuário, como postagens de um blog. ### Criação de política e formulário A política a seguir é compatível com uploads de área de texto para o bucket awsexamplebucket1 do Amazon S3. ``` 1. { "expiration": "2007-12-01T12:00:00.000Z", 2. "conditions": [ 3. {"bucket": "awsexamplebucket1"}, 4. ["starts-with", "$key", "user/eric/"], 5. {"acl": "public-read"}, 6. {"success_action_redirect": "https://awsexamplebucket1.s3.us-west-1.amazonaws.com/new_post.html"}, 7. ["eq", "$Content-Type", "text/html"], 8. {"x-amz-meta-uuid": "14365123651274"}, 9. ["starts-with", "$x-amz-meta-tag", ""] 10. ] 11. } ``` Esta política requer o seguinte: + O upload deve ocorrer antes das 12:00 GMT em 1º de dezembro de 2007. + O upload do conteúdo deve ser feito para o bucket awsexamplebucket1. + A chave deve começar com "user/eric/". + A ACL está definida para leitura pública. + O success\_action\_redirect está definido como https://awsexamplebucket1.s3.us-west-1.amazonaws.com/new\_post.html. + O objeto é texto HTML. + A tag x-amz-meta-uuid deve ser definida como 14365123651274. + A tag x-amz-meta-tag pode conter qualquer valor. Veja a seguir uma versão codificada em Base64 dessa política. ``` 1. eyAiZXhwaXJhdGlvbiI6ICIyMDA3LTEyLTAxVDEyOjAwOjAwLjAwMFoiLAogICJjb25kaXR 2. pb25zIjogWwogICAgeyJidWNrZXQiOiAiam9obnNtaXRoIn0sCiAgICBbInN0YXJ0cy13aXRoIiwgIiRrZXkiLCAidXNlci9lcmljLyJd 3. LAogICAgeyJhY2wiOiAicHVibGljLXJlYWQifSwKICAgIHsic3VjY2Vzc19hY3Rpb25fcmVkaXJlY3QiOiAiaHR0cDovL2pvaG5zbWl0a 4. C5zMy5hbWF6b25hd3MuY29tL25ld19wb3N0Lmh0bWwifSwKICAgIFsiZXEiLCAiJENvbnRlbnQtVHlwZSIsICJ0ZXh0L2h0bWwiXSwKI 5. CAgIHsieC1hbXotbWV0YS11dWlkIjogIjE0MzY1MTIzNjUxMjc0In0sCiAgICBbInN0YXJ0cy13aXRoIiwgIiR4LWFtei1tZXRhLXRhZy 6. IsICIiXQogIF0KfQo= ``` Crie uma assinatura usando suas credenciais. Por exemplo, `qA7FWXKq6VvU68lI9KdveT1cWgF=` é a assinatura para o documento de política anterior. O formulário a seguir comporta uma solicitação POST para o bucket amzn-s3-demo-bucket que usa essa política. ``` 1. 2. 3. ... 4. 5. ... 6. 7. 8. ... 9.
10. Key to upload:
11. 12. 13. 14. 15. Tags for File:
16. 17. 18. 19. Entry:
24. 25. 26.
27. ... 28. ``` ### Exemplo de solicitação Essa solicitação pressupões que a imagem carregada tem 117.108 bytes; os dados da imagem não estão inclusos. ``` 1. POST / HTTP/1.1 2. Host: awsexamplebucket1.s3.us-west-1.amazonaws.com 3. User-Agent: Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.8.1.10) Gecko/20071115 Firefox/2.0.0.10 4. Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5 5. Accept-Language: en-us,en;q=0.5 6. Accept-Encoding: gzip,deflate 7. Accept-Charset: ISO-8859-1,utf-8;q=0.7,*;q=0.7 8. Keep-Alive: 300 9. Connection: keep-alive 10. Content-Type: multipart/form-data; boundary=178521717625888 11. Content-Length: 118635 12. 13. -178521717625888 14. Content-Disposition: form-data; name="key" 15. 16. ser/eric/NewEntry.html 17. --178521717625888 18. Content-Disposition: form-data; name="acl" 19. 20. public-read 21. --178521717625888 22. Content-Disposition: form-data; name="success_action_redirect" 23. 24. https://awsexamplebucket1.s3.us-west-1.amazonaws.com/new_post.html 25. --178521717625888 26. Content-Disposition: form-data; name="Content-Type" 27. 28. text/html 29. --178521717625888 30. Content-Disposition: form-data; name="x-amz-meta-uuid" 31. 32. 14365123651274 33. --178521717625888 34. Content-Disposition: form-data; name="x-amz-meta-tag" 35. 36. Interesting Post 37. --178521717625888 38. Content-Disposition: form-data; name="AWSAccessKeyId" 39. 40. AKIAIOSFODNN7EXAMPLE 41. --178521717625888 42. Content-Disposition: form-data; name="Policy" 43. eyAiZXhwaXJhdGlvbiI6ICIyMDA3LTEyLTAxVDEyOjAwOjAwLjAwMFoiLAogICJjb25kaXRpb25zIjogWwogICAgeyJidWNrZXQiOiAiam9obnNtaXRoIn0sCiAgICBbInN0YXJ0cy13aXRoIiwgIiRrZXkiLCAidXNlci9lcmljLyJdLAogICAgeyJhY2wiOiAicHVibGljLXJlYWQifSwKICAgIHsic3VjY2Vzc19hY3Rpb25fcmVkaXJlY3QiOiAiaHR0cDovL2pvaG5zbWl0aC5zMy5hbWF6b25hd3MuY29tL25ld19wb3N0Lmh0bWwifSwKICAgIFsiZXEiLCAiJENvbnRlbnQtVHlwZSIsICJ0ZXh0L2h0bWwiXSwKICAgIHsieC1hbXotbWV0YS11dWlkIjogIjE0MzY1MTIzNjUxMjc0In0sCiAgICBbInN0YXJ0cy13aXRoIiwgIiR4LWFtei1tZXRhLXRhZyIsICIiXQogIF0KfQo= 44. 45. --178521717625888 46. Content-Disposition: form-data; name="Signature" 47. 48. qA7FWXKq6VvU68lI9KdveT1cWgF= 49. --178521717625888 50. Content-Disposition: form-data; name="file" 51. 52. ...content goes here... 53. --178521717625888 54. Content-Disposition: form-data; name="submit" 55. 56. Upload to Amazon S3 57. --178521717625888-- ``` ### Exemplo de resposta ``` 1. HTTP/1.1 303 Redirect 2. x-amz-request-id: 1AEE782442F35865 3. x-amz-id-2: cxzFLJRatFHy+NGtaDFRR8YvI9BHmgLxjvJzNiGGICARZ/mVXHj7T+qQKhdpzHFh 4. Content-Type: application/xml 5. Date: Wed, 14 Nov 2007 21:21:33 GMT 6. Connection: close 7. Location: https://awsexamplebucket1.s3.us-west-1.amazonaws.com/new_post.html?bucket=awsexamplebucket1&key=user/eric/NewEntry.html&etag=40c3271af26b7f1672e41b8a274d28d4 8. Server: AmazonS3 ```