表单字段定义 (HTML Form Fields)
Qiniu S3 API 服务表单上传中表单字段支持自定义模板字符串，即所有上传字段中如果包含 ${filename} 子串，则服务器端会使用最终上传文件的名称替换该字串。如：表单中指定上传文件的名称 (key) 为 uploads/avatar/${filename}，客户端上传的文件名称为 gopher.png，则最终上传文件的名称为 uploads/avatar/gopher.png。模板字符串同样适用于上传策略 (Policy)。
HTML Form 字段
注意：Form 字段区分大小写
AWS V4 认证签名表单字段
| 字段名称 | 描述 | 要求 |
|---|---|---|
| X-Amz-Algorithm | 指定请求认证签名算法，AWS V4 签名对应值为 AWS4-HMAC-SHA256 |
Y |
| X-Amz-Credential | 指定请求认证签名信息，格式为 <qiniu-access-key-id>/<date>/<region>/<service>/aws4_request；如： WeyUtAXps-_5dIDvFWF-rKZ5XyzWf-BmOEI_vNtk/20060102/cn-east-1/s3/aws4_request |
Y |
| X-Amz-Date | 指定请求的日期时间，使用 ISO8601 日期时间格式，如 20060102T15:03:04.000Z |
Y |
| X-Amz-Signature | 指定请求 Policy 客户端签名值 | Y |
| Policy | 指定请求的上传策略，使用 Base64 编码的 Policy 字符串 | CY |
| Content-Type | 指定上传文件的 MIME 类型，默认七牛 S3 API 服务将根据上传文件的扩展名生成文件 MIME 类型；如 application/zip |
N |
| success_action_redirect | 指定当上传成功后客户端跳转的 URL，默认服务器端返回 HTTP 状态码 204 | N |
| success_action_status | 指定当上传成功后返回客户端的 HTTP 状态码，此值仅当 success_action_redirect 为空时有效 |
N |
| key | 指定上传文件的名称，支持模板字符串，默认使用客户端上传文件的名称；如客户端可以使用 uploads/avatar/${filename} 格式模板名称 |
N |
| file | 指定上传文件 | Y |
- CY, 条件约束必须
- Y, 必须
AWS V2 认证签名表单字段
| 字段名称 | 描述 | 要求 |
|---|---|---|
| AWSAccessKeyId | 指定请求认证的 Qiniu Access Key Id | Y |
| Signature | 指定请求 Policy 客户端签名值 | Y |
| Policy | 指定请求的上传策略，使用 Base64 编码的 Policy 字符串 | CY |
| Content-Type | 指定上传文件的 MIME 类型，默认七牛 S3 API 服务将根据上传文件的扩展名生成文件 MIME 类型；如 application/zip |
N |
| success_action_redirect | 指定当上传成功后客户端跳转的 URL，默认服务器端返回 HTTP 状态码 204 | N |
| success_action_status | 指定当上传成功后返回客户端的 HTTP 状态码，此值仅当 success_action_redirect 为空时有效 |
N |
| key | 指定上传文件的名称，支持模板字符串，默认使用客户端上传文件的名称；如客户端可以使用 uploads/avatar/${filename} 格式模板名称 |
N |
| file | 指定上传文件 | Y |
- CY, 条件约束必须
- Y, 必须