This call lets you queue a job to export a file from a project on the Platform into a volume. The file selected for export must not be a public file or an alias. Aliases are objects stored in your cloud storage bucket which have been made available on the Platform. The volume you are exporting to must be configured for read-write access. To do this, set the access_mode parameter to RW when creating or modifying a volume.
Essentially, the call writes to your cloud storage bucket via the volume. If this call is successful, the original project file will become an alias to the newly exported object on the volume. The source file will be deleted from the Platform and, if no more copies of this file exist, it will no longer count towards your total storage price on the Platform. In summary, once you export a file from the Platform to a volume, it is no longer part of the storage on the Platform and cannot be exported again.
If you want to export multiple files, the recommended way is to do it in bulk considering the API rate limit (learn more).
Learn more about using the Volumes API for Amazon S3.
If you are using Seven Bridges Platform EU, please use the following endpoint:
https://eu-api.sbgenomics.com/v2/storage/exports
When exporting a file from the Platform to an attached volume, export is possible only to a volume that is in the same location (cloud provider and region) as the project from which the file is being exported.
{
"destination":{
"volume":"rfranklin/output",
"location":"output.vcf"
},
"source":{
"file":"567890abc1e5339df0414123"
},
"overwrite":false
}
Response
Response body
The response object contains information about the status of the export job. The information is structured using the following key-value pairs:
| Key | Data type of value | Description of value |
|---|---|---|
id | String | ID of this export job |
state | String | The state of this export job. Possible values are:PENDING: the export is queuedRUNNING: the export is runningCOMPLETED: the export has completed successfullyFAILED: the export has failed |
source | Object | Export source, as passed when this job was started. |
destination | Object | Export destination, as passed when this job was started. |
result | Object | File object that was exported. |
error | Object | In case of error in the export job, standard API error is returned here. |