CreatePreSignedUrl - 生成临时文件上传链接--文件存储 vePFS-火山引擎

文档中心

立即注册

导航

CreatePreSignedUrl - 生成临时文件上传链接

最近更新时间：2025.05.26 11:42:50首次发布时间：2025.05.26 11:42:50

调用 CreatePreSignedUrl 接口生成临时文件上传列表。

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

参数	类型	是否必填	示例值	描述
Action	String	是	CreatePreSignedUrl	要执行的操作，取值：CreatePreSignedUrl。
Version	String	是	2022-01-01	API的版本，取值：2022-01-01。
Private	Boolean	否	false	是否返回私有的上传地址，取值说明如下： true：返回。 false：不返回。

返回参数

下表仅列出本接口特有的返回参数。更多信息请参见返回结构。

参数	类型	示例值	描述
FileKey	String	210037**/2025-05-21/e88f40fd-5290-409c-9e7d-16e8d36a**	资源名称。
FileUrl	String	https://anser-vepfs-5b000579**.tos-cn-beijing.volces.com/**	资源的临时 Url。
Expires	Integer	300	临时 Url 过期时间，单位为 s。

请求示例

POST /?Action=CreatePreSignedUrl&Version=2022-01-01 HTTP/1.1
Host: vepfs.cn-beijing.volcengineapi.com
Content-Type: application/json; charset=UTF-8
X-Date: 20250522T030953Z
X-Content-Sha256: 287e874e******d653b44d21e
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20250522/cn-beijing/vepfs/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f

{}

返回示例

{
  "ResponseMetadata": {
    "RequestId": "2025052211100105402512123333DED8",
    "Action": "CreatePreSignedUrl",
    "Version": "2022-01-01",
    "Service": "vepfs",
    "Region": "cn-beijing"
  },
  "Result": {
    "FileKey": "210037****/2025-05-21/e88f40fd-5290-409c-9e7d-16e8d36a****",
    "FileUrl": "https://anser-vepfs-5b000579****.tos-cn-beijing.volces.com/****",
    "Expires": 300
  }
}

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码	错误码	错误信息	说明
500	InternalError	Service has some internal Error. Pls Contact With Admin.	内部错误。