View a markdown version of this page

示例：使用 HTTP POST 的基于浏览器的上传（使用 Amazon 签名版本 4） - Amazon Simple Storage Service
使用 HTTP POST 将文件上传到 Amazon S3
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

示例：使用 HTTP POST 的基于浏览器的上传（使用 Amazon 签名版本 4）

本节展示了使用 HTTP POST 请求将内容直接上传到 Amazon S3 的示例。

有关签名版本 4 的更多信息，请参阅签名版本 4 签名流程。

使用 HTTP POST 将文件上传到 Amazon S3

此示例提供示例 POST 策略和可用于上传文件的表单。本主题使用示例策略和虚拟凭证来向您介绍工作流程以及生成的签名和策略哈希值。您可以将此数据用作测试套件来验证签名计算代码。

该示例使用以下示例凭证进行签名计算。您可以使用这些凭证来验证签名计算代码。但是，在向 Amazon 发送请求时，您必须将这些凭证替换为自己的凭证。

参数 值
AWSAccessKeyId AKIAIOSFODNN7EXAMPLE
AWSSecretAccessKey wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY

策略和表单示例

以下 POST 策略支持在特定条件下上传到 Amazon S3。

{ "expiration": "2015-12-30T12:00:00.000Z",
  "conditions": [
    {"bucket": "sigv4examplebucket"},
    ["starts-with", "$key", "user/user1/"],
    {"acl": "public-read"},
    {"success_action_redirect": "http://sigv4examplebucket.s3.amazonaws.com/successful_upload.html"},
    ["starts-with", "$Content-Type", "image/"],
    {"x-amz-meta-uuid": "14365123651274"},
    {"x-amz-server-side-encryption": "AES256"},
    ["starts-with", "$x-amz-meta-tag", ""],

    {"x-amz-credential": "AKIAIOSFODNN7EXAMPLE/20151229/us-east-1/s3/aws4_request"},
    {"x-amz-algorithm": "AWS4-HMAC-SHA256"},
    {"x-amz-date": "20151229T000000Z" }
  ]
}

此 POST 策略针对请求设置了以下条件：

  • 上传必须在 UTC 时间 2015 年 12 月 30 日中午之前进行。

  • 内容只能上传到 sigv4examplebucket。存储桶必须位于您在凭证范围（x-amz-credential 表单参数）中指定的区域，因为您提供的签名仅在此范围内有效。

  • 您可以提供任何以 user/user1 开头的键名称。例如 user/user1/MyPhoto.jpg。

  • ACL 必须设置为 public-read。

  • 如果上传成功，则用户的浏览器将重定向到 http://sigv4examplebucket.s3.amazonaws.com/successful_upload.html。

  • 对象必须是一个映像文件。

  • x-amz-meta-uuid 标签必须设置为 14365123651274。

  • x-amz-meta-tag 可以包含任意值。

下面是此 POST 策略的 Base64 编码版本。在签名计算中，您可以使用此值作为 StringToSign。

eyAiZXhwaXJhdGlvbiI6ICIyMDE1LTEyLTMwVDEyOjAwOjAwLjAwMFoiLA0KICAiY29uZGl0aW9ucyI6IFsNCiAgICB7ImJ1Y2tldCI6ICJzaWd2NGV4YW1wbGVidWNrZXQifSwNCiAgICBbInN0YXJ0cy13aXRoIiwgIiRrZXkiLCAidXNlci91c2VyMS8iXSwNCiAgICB7ImFjbCI6ICJwdWJsaWMtcmVhZCJ9LA0KICAgIHsic3VjY2Vzc19hY3Rpb25fcmVkaXJlY3QiOiAiaHR0cDovL3NpZ3Y0ZXhhbXBsZWJ1Y2tldC5zMy5hbWF6b25hd3MuY29tL3N1Y2Nlc3NmdWxfdXBsb2FkLmh0bWwifSwNCiAgICBbInN0YXJ0cy13aXRoIiwgIiRDb250ZW50LVR5cGUiLCAiaW1hZ2UvIl0sDQogICAgeyJ4LWFtei1tZXRhLXV1aWQiOiAiMTQzNjUxMjM2NTEyNzQifSwNCiAgICB7IngtYW16LXNlcnZlci1zaWRlLWVuY3J5cHRpb24iOiAiQUVTMjU2In0sDQogICAgWyJzdGFydHMtd2l0aCIsICIkeC1hbXotbWV0YS10YWciLCAiIl0sDQoNCiAgICB7IngtYW16LWNyZWRlbnRpYWwiOiAiQUtJQUlPU0ZPRE5ON0VYQU1QTEUvMjAxNTEyMjkvdXMtZWFzdC0xL3MzL2F3czRfcmVxdWVzdCJ9LA0KICAgIHsieC1hbXotYWxnb3JpdGhtIjogIkFXUzQtSE1BQy1TSEEyNTYifSwNCiAgICB7IngtYW16LWRhdGUiOiAiMjAxNTEyMjlUMDAwMDAwWiIgfQ0KICBdDQp9

当您复制/粘贴上述策略时，它应包含回车符和换行符，以便您计算的哈希值与此值匹配（即带有 CRLF 行终止符的 ASCII 文本）。

使用示例凭证创建签名，签名值如下所示 [在签名计算中，日期与策略中的 x-amz-date 日期相同（20151229）]：

8afdbf4008c03f22c2cd3cdb72e4afbb1f6a588f3255ac628749a66d7f09699e

以下示例表单指定了上述 POST 策略，并支持向 sigv4examplebucket 发出 POST 请求。将内容复制/粘贴到文本编辑器中，然后将其另存为 exampleform.html。然后，您可以使用 exampleform.html 将映像文件上传到特定的存储桶。如果您提供的签名与 Amazon S3 计算出的签名相匹配，您的请求将会成功。

注意

您必须使用有效的值更新存储桶名称、日期、凭证、策略和签名，以便将其成功上传到 S3。

<html>
  <head>
    
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
    
  </head>
  <body>

  <form action="http://sigv4examplebucket.s3.amazonaws.com/" method="post" enctype="multipart/form-data">
    Key to upload: 
    <input type="input"  name="key" value="user/user1/${filename}" /><br />
    <input type="hidden" name="acl" value="public-read" />
    <input type="hidden" name="success_action_redirect" value="http://sigv4examplebucket.s3.amazonaws.com/successful_upload.html" />
    Content-Type: 
    <input type="input"  name="Content-Type" value="image/jpeg" /><br />
    <input type="hidden" name="x-amz-meta-uuid" value="14365123651274" /> 
    <input type="hidden" name="x-amz-server-side-encryption" value="AES256" /> 
    <input type="text"   name="X-Amz-Credential" value="AKIAIOSFODNN7EXAMPLE/20151229/us-east-1/s3/aws4_request" />
    <input type="text"   name="X-Amz-Algorithm" value="AWS4-HMAC-SHA256" />
    <input type="text"   name="X-Amz-Date" value="20151229T000000Z" />

    Tags for File: 
    <input type="input"  name="x-amz-meta-tag" value="" /><br />
    <input type="hidden" name="Policy" value='<Base64-encoded policy string>' />
    <input type="hidden" name="X-Amz-Signature" value="<signature-value>" />
    File: 
    <input type="file"   name="file" /> <br />
    <!-- The elements after this will be ignored -->
    <input type="submit" name="submit" value="Upload to Amazon S3" />
  </form>
  
</html>

POST 参数不区分大小写。举例来说，可以指定 x-amz-signature 或 X-Amz-Signature。