Skip to content
Data Ocean

Upload a fileset

Filesets are used to manage a collection of file objects as a single file resource within the Data Ocean. This allows for access management of these files to be performed in aggregate. You can use the same base download URL to access all of the file objects.

Filesets are not replicated outside of the primary region.

Example use cases for filesets:

  • Hosting simple web pages
  • Storing partitioned data (XYZ map tile sets, Potree point clouds)

The following instructions provide specific steps for uploading a fileset. See Upload a file for detailed instructions for uploading a single file.

  1. Create a file object.

    POST {base URL}/api/files

    Include the following in the body:

     * fileset: true
     * path\_template: This field can include your file naming convention as a reminder for download.

  2. Upload the file.

    Use the upload URL provided in the response to upload your compressed fileset (.zip, .tar, or .tar.gz).

    The example below shows three files in the archive structure and the paths Data Ocean generates. The files are located under the file ID for the main fileset object.

    Diagram

Reference Materials

Data Ocean API definition