表单策略定义 (HTML Form Policy)

Qiniu S3 API 服务支持以 JSON 格式定义 HTML 表单 (Form) 上传的认证策略 (Policy)，认证策略中同样可以使用模板字符串 ${filename} 代表客户端最终上传文件的名称。

格式定义

{
    "expiration": "2006-01-02T15:03:04.000Z",
    "conditions": [
        {"bucket": "s3_bucket" },
        ["starts-with", "$key", "uploads/avatar/"]
    ]
}

有效期 (expiration)

指定 HTML 表单 (Form) 策略 (Policy) 的截止有效日期时间，使用 ISO8601 日期格式。

约束条件 (conditions)

指定 HTML 表单 (Form) 上传的各种约束条件。约束规则支持两种匹配模式:

• 精确匹配，如 ["eq", "$bucket", "s3_bucket"] 指定上传文件的空间 (Bucket) 名称，精确匹配亦可简写成 {"bucket": "s3_bucket"};

• 前缀匹配，如 ["starts-with", "$key", "camera_"] 指定客户端只能上传文件名称以 camera_ 开头的对象；

字段定义

注意：策略 (Policy) 字段区分大小写