上传策略--veImageX-火山引擎

文档中心

veImageX

请输入

开发指南

上传策略

您可在使用 veImageX 服务端 SDK 签发临时上传凭证 UploadAuthToken（以下以 Go 为例）时，签入上传策略。

上传策略

您可通过imagex.GetUploadAuthWithExpire()配置 Token 的超时时间，单位为秒，默认值为 1 小时。建议取值不要过大，以免 Token 丢失导致存储被污染。

请确保您已在 veImageX 控制台的服务管理页面，在服务维度开启重名覆盖上传。
您可通过imagex.WithUploadOverwrite()为 Token 添加上传覆盖标识，完成后您可在使用上传 SDK 上传重名文件时覆盖旧文件。

您可以使用 imagex.WithUploadKeyPtn("表达式") 来限制上传的存储路径 StoreKey，默认为("*")表示不限制。
示例：

如果您在上传 SDK 指定了文件的存储 Key，那么您需要在获取上传凭证中设置为不限制，即("*")。

您可通过 imagex.WithUploadPolicy() 限制允许上传的文件类型和文件大小。具体参数如下所示：

参数	类型	是否必选	描述
ContentTypeBlackList	Array of String	否	限制用户上传的文件类型 Content-Type 黑名单，您可自定义。示例如下： `["text/"]`：禁止上传文本类型 `["image/"]` ：禁止上传图片类型 `["image/jpeg", "image/png"]` ：禁止上传 JPG 和 PNG 类型的图片 `["application/json", "text/plain"]` ：禁止上传 JSON 文本和纯文本。
ContentTypeWhiteList	Array of String	否	允许用户上传的文件类型 Content-Type 白名单。推荐`ContentTypeBlackList` 与`ContentTypeWhiteList` 参数二选一设置。如果 `ContentTypeBlackList` 和 `ContentTypeWhiteList`参数中设置的黑白名单均包含 A，由于黑名单优先级高于白名单，A 会被拒绝。
FileSizeUpLimit	String	否	上传文件大小的上限，单位为字节。
FileSizeBottomLimit	String	否	上传文件大小的下限，单位为字节。

最近更新时间：2025.05.21 11:42:59

这个页面对您有帮助吗？

有用

无用