To upload or update an asset file, first get a signed URL, and then use it to upload the file.

If you are a private cloud user, please see this link for the steps for uploading data files to a shared folder.

Caution: If you do not know the folderId of the shared folder, use List Shared Folders to return a list of your created shared folders.

Get Signed URL for Folder

API Explorer: folders//s3/sign

First, use the folderId and fileName to get a signed URL, which will later be used to upload the specified file to the test. The sample code returns a URL for a folderId of 5b7dc9c6c7dc9739167b23c8 and a fileName of colors.csv. Replace colors.csv with the actual file name, and 5b7dc9c6c7dc9739167b23c8 with your folderId.

curl 'https://a.blazemeter.com/api/v4/folders/5b7dc9c6c7dc9739167b23c8/s3/sign?fileName=colors.csv' \
    -H 'Content-Type: application/json' \
    --user 'api_key_id:api_key_secret'

{
    "api_version": 4,
    "error": null,
    "result": "https://blazemeter.s3.amazonaws.com/organizations/123429/shared/ApiTest/colors.csv?x-amz-acl=private&x-amz-server-side-encryption=AES256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAJPZOF6U7I33QK2CQ%2F20190309%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20190309T154412Z&X-Amz-SignedHeaders=host%3Bx-amz-acl%3Bx-amz-server-side-encryption&X-Amz-Expires=1200&X-Amz-Signature=f48f6fdb85d8d928709b5d6193ba452c20684f14da2a89bee7b00f9854224a70"
}

Upload File to Signed URL for Folder

Once you have obtained the signed URL (in result above), construct a PUT request with the file as your body. Use the following template for the file path and name:

'@*path to file*/*file*.*ext*'

In the example to the right, replace @/my/path/to/colors.csv with the actual path and file name.

To update the contents of an uploaded file, repeat the same two-step operation (GET signed url, PUT to signed url given). Be sure to upload the updated file using the same file name.

curl 'https://blazemeter.s3.amazonaws.com/organizations/123429/shared/ApiTest/colors.csv?x-amz-acl=private&x-amz-server-side-encryption=AES256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=AKIAJPZOF6U7I33QK2CQ%2F20190309%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20190309T154412Z&X-Amz-SignedHeaders=host%3Bx-amz-acl%3Bx-amz-server-side-encryption&X-Amz-Expires=1200&X-Amz-Signature=f48f6fdb85d8d928709b5d6193ba452c20684f14da2a89bee7b00f9854224a70' \
    -X PUT \
    -H 'Content-Type: application/octet-stream' \
    --data-binary '@/my/path/to/colors.csv'

Shared Folder File Requirements

The file naming requirements, limitations on file content, file size and impact of uploaded files on start time remain the same as the single test.