Shares restricted access to objects
An access generated using uplink share with no arguments creates an access to your entire project with read permissions.
the serialized access, or name of the access to use
url for shared auth service, by default
the base url for link sharing, by default
if true, disallow deletes
if true, disallow lists
if true, disallow reads
if true, disallow writes
specify your custom hostname. if set, returns dns settings for web hosting. implies --register and --public
path to export the shared access to
help for share
disallow access after this time (e.g. '+2h', '2020-01-02T15:01:01-01:00')
disallow access before this time (e.g. '+2h', '2020-01-02T15:01:01-01:00')
if true, the access will be public. --dnsand --urloverride this
implies --disallow-writes and --disallow-deletes
if true, creates and registers access grant
if true, returns a url for the shared path. implies --register and --public
implies --disallow-reads and --disallow-lists
Share a single object
Notice that by default, only download (read) and list operations are allowed.
Share a bucket with all permissions
As the --readonly flag is set to false, uploads and deletes are allowed.
Register with Gateway MT
Generate credentials to use with our S3 multitenant gateway: AWS CLI and Hosted Gateway MT
Notice the endpoint generated for Gateway MT: https://gateway.storjshare.io.
You can also generate a URL to share your projects/buckets/objects
Note that specifying --base-url is optional, but the --not-after is mandatory. If you do not want to specify date or offset - you can specify --not-after=none.
See share for details.
Also note that the URL uses the same Gateway MT access key, so if you have that already, you don't necessarily need to run this command to generate a shareable link.
https://link.storjshare.io/s/<access key>/<object path>
To download content directly, use /raw/ in Linkshare URL ex: https://link.storjshare.io/raw/ju34skavohcqezr6vlfgshg5nmjq/dwebdemo/isthataquestion.mp4
To view the object location map, use /s/ in Linkshare URL ex: https://link.storjshare.io/s/ju34skavohcqezr6vlfgshg5nmjq/dwebdemo/isthataquestion.mp4
For more detail, visit the documentation on Host a Static Website with the Uplink CLI and Linksharing Service.
While you may share individual objects with the above linksharing instructions, you must share a bucket or object prefix for webhosting. Your web address will render the index.html file.
Use the generated DNS info to connect your domain name to your shared objects.
Note you can use any hostname in place of www.mysite.com in the example. The base-url is also optional.