TOS 默认不保存处理后的图片。您可以在处理图片的 URL 后添加持久化参数,将处理后的图片保存至指定的存储桶。本文介绍图片处理持久化相关参数和使用示例。
使用图片处理持久化的账号必须拥有原图所在桶的读权限,图片转存的目标桶的写权限。
使用匿名用户将处理后的图片保存至指定的存储桶时,该存储桶必须为公共写权限。
原图所在桶与图片转存的目标桶必须属于同一地域。
转存图片的访问权限默认为私有,存储类型默认为标准存储。
参数 | 参数说明 | 取值说明 | 是否必须 |
---|---|---|---|
x-tos-save-object | 处理后的图片在目标桶中的名称。该名称必须进行 url 安全的 base64 编码。 | base64 编码的字符串。 | 是 |
x-tos-save-bucket | 处理后的图片转存的目标桶名称。该名称必须进行 url 安全的 base64 编码。 | base64 编码的字符串。默认为原图所在存储桶。 | 否 |
您可以使用以下两种方式转存图片:
注意
以下链接仅为示例,用于展示如何添加持久化参数。您没有示例链接存储桶的写权限,如果访问示例链接,将返回 AccessDenied
。
处理后的图片 URL:https://tos-tools.tos-cn-beijing.volces.com/misc/sample.png?x-tos-process=image/resize,w_100
将处理后的图片命名为 abc.png,并保存至原始图片所在桶,示例 URL 如下:
https://tos-tools.tos-cn-beijing.volces.com/misc/sample.png?x-tos-process=image/resize,w_100&x-tos-save-object=YWJjLnBuZw==
将处理后的图片命名为 abc.png,并保存至名为 arctic 的存储桶,示例 URL 如下:
https://tos-tools.tos-cn-beijing.volces.com/misc/sample.png?x-tos-process=image/resize,w_100&x-tos-save-object=YWJjLnBuZw==&x-tos-save-bucket=YXJjdGlj
将处理后的图片命名为 abc.png,并保存至原始图片所在桶,示例 URL 如下:
https://tos-tools.tos-cn-beijing.volces.com/misc%2Fvideo.mp4?x-tos-process=video/snapshot,t_26000,w_400,h_200,f_jpg&x-tos-save-object=YWJjLnBuZw==
将处理后的图片命名为 abc.png,并保存至 arctic 存储桶,示例 URL 如下:
https://tos-tools.tos-cn-beijing.volces.com/misc%2Fvideo.mp4?x-tos-process=video/snapshot,t_26000,w_400,h_200,f_jpg&x-tos-save-object=YWJjLnBuZw==&x-tos-save-bucket=YXJjdGlj