Docs

File Storage vePFS

Data Flow

CreatePreSignedUrl - Generate a temporary file upload link

Call the CreatePreSignedUrl API to generate a temporary file upload link.

Debug

API Explorer

You can initiate calls online through API Explorer without paying attention to the signature generation process and quickly obtain the call results.

Go to debug

Request parameters

Only unique request parameters and selected common parameters for this API are listed below. For more information, see Common Parameters.

Action string required Example: CreatePreSignedUrl

The action to execute: CreatePreSignedUrl.

Version string required Example: 2022-01-01

API version. Value: 2022-01-01.

Private boolean Optional Example: false

Specify whether to return a private upload URL. Values are described as follows:

true: Returned.

false: Not returned.

Response Parameters

Only the response parameters unique to this API are listed below. For more details, refer to Response Structure.

FileKey string Example value: 210037****/2025-05-21/e88f40fd-5290-409c-9e7d-16e8d36a****

Resource name.

FileUrl string Example: https://anser-vepfs-5b000579****.tos-cn-beijing.volces.com/****

Temporary resource URL.

Expires integer Example: 300

Expiration time for the temporary URL, measured in seconds.

Sample Request

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: 20260114T081538Z​
X-Content-Sha256: 287e874e******d653b44d21e​
Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20260114/cn-beijing/vepfs/request, SignedHeaders=host;x-content-sha256;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f​
​
{​
  "Private": true​
}​

Sample Response

{​
  "ResponseMetadata": {​
    "RequestId": "20260114161543099118191146A9****",​
    "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​
  }​
}​

Error Codes

The following table lists error codes related to the business logic of this API. For common error codes, see the Common Error Codes documentation.

Status Code	Error codes	Error message	Note
500	InternalError	Service has some internal Error. Pls Contact With Admin.	Internal error.

Last updated: 2026.03.03 10:36:49