| content
| - %VOSNAV%
%TOC%
---++ Virtuoso Amazon S3 Folder
---+++ What
Virtuoso's WebDAV implementation includes a special folder type for binding to Amazon S3 Services ("S3 Buckets"). ODS-Briefcase and any WebDAV client may work with these folders as if they were hosted directly in Virtuoso.
---+++ Why
Amazon S3 provides a simple web services interface to a storage system that can be used to store and retrieve any amount of data. The service aims to maximize benefits of scale and to pass those benefits on to developers.
By providing a WebDAV interface to Amazon's service, the Virtuoso Amazon S3 Folder brings access to this storage system to any operating system (and any application running therein) with a WebDAV filesystem driver. This includes Windows ("Remote Directories"), Mac OS X ("Mount Server..."), Linux, and others.
---+++ How
---++++ Creation of Amazon S3 Folders
The folder is created just as other WebDAV folder, with some special properties:
1 <b><code>Folder Type</code></b> (tab <b><code>Main</code></b>) — must be set to <b><code>Amazon S3</code></b>.
1 <b><code>Access Key ID</code></b> (tab <b><code>S3 Properties</code></b>) — *Mandatory* setting. Set to <b>Amazon S3 user's access key</b>.
1 <b><code>Secret Key</code></b> (tab <b><code>S3 Properties</code></b>) — *Mandatory* setting. Set to <b>Amazon S3 user's secret key</b>.
1 <b><code>Bucket Name</code></b> (tab <b><code>S3 Properties</code></b>) — *Optional* setting. Set to <b>Amazon S3 Bucket name</b> to retrict WebDAV access to that S3 Bucket (and any sub-buckets). When not set (i.e., blank), all S3 Buckets available to this user are accessible through the WebDAV folder.
---++++ Working with S3 Folders
---+++++ When <code>Bucket Name</code> property is empty or unset
1 All available buckets are shown for this user.
1 New buckets can be created with the following name rules:
* Bucket and S3 Folder names must only contain lowercase letters, numbers, periods "<code><nowiki>.</nowiki></code>", and hyphens "<code><nowiki>-</nowiki></code>".
* Bucket and S3 Folder names must not contain forward slash (solidus) "<code><nowiki>/</nowiki></code>", backward slash "<code><nowiki>\</nowiki></code>", nor underscore "<code><nowiki>_</nowiki></code>"
* Bucket names must start with a number or letter, not a period or dash.
* Bucket names should not end with a dash.
* Bucket names should be between 3 and 63 characters long, and cannot be more than 255 characters long.
* Bucket names cannot be in an IP address style (that is, four period-separated octets, e.g., "<code>192.168.5.4</code>").
* Hyphens cannot appear next to periods. For example, "<code>my-.bucket</code>" and "<code>my.-bucket</code>" are both invalid; "<code>my-bucket</code>" and "<code>my.bucket</code>" are valid.
1 Bucket contents are shown through a tree widget.
---+++++ When <code>Bucket Name</code> property is not empty
1 Bucket contents are shown through a tree widget.
1 New files and folders can be created, updated, and deleted, within the bucket.
---++++Virtuoso Tutorials
* [[OdsBriefcaseAmazonS3][ODS Briefcase Amazon S3]]
---+++ References
* [[http://aws.amazon.com/s3/][Amazon S3 Services]]
* [[http://docs.amazonwebservices.com/AmazonCloudFront/latest/GettingStartedGuide/][Amazon Cloud Front Getting Started Guide]]
CategoryVirtuoso CategoryDAV CategorySpec CategoryWebDAV
%VOSCOPY%
|
![[RDF Data]](/fct/images/sw-rdf-blue.png)
![[cxml]](/fct/images/cxml_doc.png)
![[csv]](/fct/images/csv_doc.png)
![[text]](/fct/images/ntriples_doc.png)
![[turtle]](/fct/images/n3turtle_doc.png)
![[ld+json]](/fct/images/jsonld_doc.png)
![[rdf+json]](/fct/images/json_doc.png)
![[rdf+xml]](/fct/images/xml_doc.png)
![[atom+xml]](/fct/images/atom_doc.png)
![[html]](/fct/images/html_doc.png)