上传策略是资源上传时附带的一组配置设定。通过这组配置信息，七牛云存储可以了解用户上传的需求：它将上传什么资源，上传到哪个空间，上传结果是回调通知还是使用重定向跳转，是否需要设置反馈信息的内容，以及授权上传的截止时间等等。

上传策略同时还参与请求验证，可以验证用户对某个资源的上传请求是否完整。

格式

1. {
2.  
3. "scope": "<Bucket string>",
4. "deadline": "<UnixTimestamp uint32>",
5. "insertOnly": "<AllowFileUpdating int>",
6.  
7. "endUser": "<EndUserId string>",
8.  
9. "returnUrl": "<RedirectURL string>",
10. "returnBody": "<ResponseBodyForAppClient string>",
11.  
12. "callbackUrl": "<RequestUrlForAppServer string>",
13. "callbackHost": "<RequestHostForAppServer string>",
14. "callbackBody": "<RequestBodyForAppServer string>",
15. "callbackBodyType": "<RequestBodyTypeForAppServer string>",
16. "callbackFetchKey": "<RequestKeyForApp int>",
17.  
18. "persistentOps": "<persistentOpsCmds string>",
19. "persistentNotifyUrl": "<persistentNotifyUrl string>",
20. "persistentPipeline": "<persistentPipeline string>",
21. "saveKey": "<SaveKey string>",
22. "fsizeMin": "<FileSizeMin int64>",
23. "fsizeLimit": "<FileSizeLimit int64>",
24.  
25. "detectMime": "<AutoDetectMimeType int>",
26.  
27. "mimeLimit": "<MimeLimit string>",
28. "deleteAfterDays": "<deleteAfterDays int>",
29. "fileType": "<fileType int>"
30. }

callbackFetchKey详解

上传策略中的callbackFetchKey是指，是否启用 fetchKey 上传模式，0 为关闭，1 为启用。 如果启用 fetchKey 上传模式，上传的 key 是由回调的结果指定的。如果回调成功，回调服务应对七牛云存储作出类似如下的响应：

1. {
2. "key": "<key>",
3. "payload": "<callback-json-object>"
4. }

七牛云存储将对上面的回调结果进行解析，<key>字段作为资源的名称存入存储中。<payload>部分返回给客户端。 例如，回调服务对七牛云存储作出如下的响应：

1. {
2. "key": "sunflowerc.jpg",
3. "payload":
4. {
5. "success": "true",
6. "name": "sunflowerc.jpg"
7. }
8. }

则sunflowerc.jpg作为资源的key存入云存储中，返回给客户端的内容为：

1. {
2. "success": "true",
3. "name":"sunflowerc.jpg"
4. }

persistentOps详解

persistentOps 字段用于指定预转数据处理命令和保存处理结果的存储空间与资源名。

为此字段指定非空值，则在成功上传一个文件后，会启动一个异步数据处理任务。persistentId 字段，唯一标识此任务。 当 returnBody 中指定了 persistentId 魔法变量时，客户端收到的响应内容 (returnBody) 中会有 persistentId；当没有指定 returnBody 时，默认也会返回 persistentId。

• 使用默认的存储空间和资源名

  当只指定了数据处理命令时，服务端会选择上传文件的 Bucket 作为数据处理结果的存储空间，Key 由七牛服务器自动生成。

• 使用指定的存储空间和资源名

  在数据处理命令后用管道符 | 拼接 saveas/<encodedEntryURI> 指令，指示七牛服务器使用 EncodedEntryURI 格式中指定的 Bucket 与 Key 来保存处理结果。如：avthumb/flv|saveas/cWJ1Y2tldDpxa2V5，是将上传的视频文件转码成flv格式后存储为 qbucket:qkey ，其中 cWJ1Y2tldDpxa2V5 是 qbucket:qkey 的URL安全的Base64编码 结果。以上方式可以同时作用于多个数据处理命令，用;分隔，如：avthumb/mp4|saveas/cWJ1Y2tldDpxa2V5;avthumb/flv|saveas/cWJ1Y2tldDpxa2V5Mg==

注意：

• Key必须采用 utf-8 编码，使用非 utf-8 编码的资源名访问时会报错。
• callbackUrl 与 callbackBody 配合使用。returnUrl 与 returnBody 配合使用。callbackXXX 与 returnXXX 不可混用。
• 文件上传后的命名将遵循以下规则：
  • 源Bucket和目标Bucket必须在同一区域，即处理结果不能跨区域另存。
  • 客户端已指定Key，以Key命名。
  • 客户端未指定Key，上传策略中设置了saveKey，以saveKey的格式命名。
  • 客户端未指定Key，上传策略中未设置saveKey，以文件hash(etag)命名。

示例

persistentOps与persistentNotifyUrl字段

上传一个视频资源，并在成功后触发两个预转处理（转成 mp4 资源和对原资源进行 HLS 切片）：

1. {
2. "scope": "qiniu-ts-demo",
3. "deadline": 1390528576,
4. "persistentOps": "avthumb/mp4;avthumb/m3u8/noDomain/1/segtime/15/vb/440k",
5. "persistentNotifyUrl": "http://fake.com/qiniu/notify"
6. }

关于 avthumb 接口的详细信息请参阅 音视频转码 (avthumb)。