空间是网宿云存储的一个虚拟的存储磁盘概念,每个空间下可以存放多个文件,而空间名是区别空间的唯一方式。
空间名:image
空间类型:图片
注:API文档表述使用bucket
代替空间。
空间类型是网宿云存储平台用来描述存储文件类型的概念,便于用户对文件分类管理。具体分为网页类、大文件、流媒体、移动应用4种类型。
注:API文档表述使用buckettype
代替空间类型。
文件名是网宿云存储平台用来描述资源的名称信息。文件名需满足以下要求
1. 长度不大于1000字节
2. 不能以'/'作为开头和结尾
3. 不能包含'/../', '/./'特殊字符串
与传统的文件系统不太一样的地方是,云存储是一个扁平化的文件系统,没有多级文件目录的概念,但是可以巧妙的利用文件名实现虚拟化路径文件。这也是云存储平台文件名与传统文件名稍微不太一样的地方。
包含虚拟化路径的文件名:book/2.jpg
注:下文表述使用key
代替文件名。
资源是网宿云存储的一个存储数据单元,每个资源都有唯一路径来访问它,这个访问路径由空间绑定的域名和文件名组合而成。
http://<domain>/{key}
EncodeEntryURI用于指定空间名与资源名:
EntryURI=<bucket>:<key>
EncodeEntryURI=Urlsafe_Base64_Encode(EntryURI)
特殊替换变量是一组网宿云存储预先定义的变量,格式为$(variable)
。
当云存储平台获取到特殊替换变量时,会将该变量替换成平台知道的值,随后放入返回结果中。
注:对特殊替换变量的支持情况详见具体的应用场景说明
自定义替换变量是客户端在上传请求中设定的变量,格式为$(x:variable)
。
客户端的请求到达云存储平台后,平台会识别出自定义替换变量,这时会搜寻上传请求中的参数中是否存在相应名字的,并使用该参数值替换掉
$(x:variable)
。
注:自定义变量必须是UTF-8格式,且不能含有&,否则会解析为乱码
例如callbackBody中设定了自定义替换变量:
position=
$(x:position)
&message=$(x:message)
其中
$(x:position)
和$(x:message)
是自定义替换变量,如x:position=4,x:message=upload,服务端会将请求中x:position和x:message的值,替换掉callbackBody中的原值。
通过上传域名进行文件上传,可在空间管理--访问域名中查询获取。
注:该上传域名为普通域名,若对上传速度较为敏感,有要求的客户建议采用网宿上传加速服务。
通过管理域名进行文件操作,如:音视频处理、删除文件等,可在空间管理--访问域名中查询获取
该域名为CDN加速域名,用户需要将加速域名绑定到云存储空间,通过该域名进行文件访问,信息查询。
对API文档上有一些约定的说明,以便您的理解。
替代字符:所有用尖括号<>包围的字符,均为需要根据实际情况做替换的地方,使用<>包围仅为了将其区分于其他字符,您在实际使用的时候,不需要加上 <>。
例如表示您需要使用一个string类型的字符串替代deadline