Uploading Files

Although the bulk of each tenant's content is likely to be uploaded by applications that integrate with Swarm, you can view and upload files directly from the Content UI.

Tip

The Content IDs bucket is a system-generated container that manages all unnamed objects, which are identified by the UUID. Files are stored with new UUIDs with the source file name saved as the Content-Disposition metadata value if uploaded to this bucket.

When uploading files, a Retention Time is required to be set, but the Settings panel can be expanded, which allows additional control over the upload. Complete the options in this order:

Tip

Set the upload options carefully and verify the target names before selecting Start Upload. It is faster to delete files from the upload queue than to clear out objects created erroneously.

Setting	Values	Example	Notes

Setting

Values

Example

Notes

Retention time

Keep until deleted
1 year
3 years
5 years
Date selector

3 years

Required. Defaults to Keep until deleted, which retains the object indefinitely. Select a preset duration or pick a date after which the files are automatically deleted by Swarm.

Note

The uploaded content does not have a Lifepoint defined in its metadata if the default is kept and no expiration is set.

File Name Prefix

{string}

2016/Q3/West/

(optional) Enter the prefix to add to the name of each file being uploaded.

Use slashes in the prefix to help organize the content, but performing this does not create buckets or folders within buckets: the prefix becomes part of the content's name in Swarm. No trailing '/' is appended to the prefix, so a prefix of "2016/Q3/West" and a file name of "filename.txt" results in an object name of "2016/Q3/Westfilename.txt".

Metadata

{custom·header} = {custom·value}

x-status-meta = active

x-public-meta = true

(optional) Add one or more tags to the uploaded content. Metadata is stored with every object and may be used for Collections and searching within Swarm. Metadata names must match one of these patterns:

x-*-meta
x-*-meta-*

After you start the upload, the status of each file upload is displayed dynamically: