Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision
Previous revision
Next revisionBoth sides next revision
s3compatibleapi [2018_08_24 23:26] stevens3compatibleapi [2018_08_28 09:56] dan
Line 5: Line 5:
 The S3 API is available on our SaaS services and on the appliance. The S3 API is available on our SaaS services and on the appliance.
  
-It can be used by may tools including:+## Client Configuration
  
- * [[https://aws.amazon.com/cli/|awscli]] - Allowing command line access to cloud files +To use the S3 API you will need the:
- * [[https://rclone.org/|rclone]] - Useful for migrating lots of data +
- * [[standalone/explorer|]] - Desktop applications for users to easily access S3-compatible and other object storage +
- * CloudBerry +
- * Cyberduck+
  
-## Authentication + 1. Cloud S3 Endpoint
- +
-To use the S3 API you will need an: +
- +
- 1. Endpoint+
  1. Access Key ID  1. Access Key ID
  1. Secret Access Key  1. Secret Access Key
  
-### 1. Endpoint+### 1. Cloud S3 Endpoint
  
 For our SaaS services use one of the following S3 API endpoints: For our SaaS services use one of the following S3 API endpoints:
Line 42: Line 34:
 You can obtain the API secret key by logging into the File Fabric going to **My Account** from the sidebar and copying the key from where it says **API secret key**. You can obtain the API secret key by logging into the File Fabric going to **My Account** from the sidebar and copying the key from where it says **API secret key**.
  
-## Usefulness+## Use With a Variety of S3 Clients
  
-The S3 API can be useful in a number of scenariosFor example+The File Fabric'S3 interface can be used with almost any S3-compatible tool including Storage Made Easy's S3 Cloud Explorer and AWS' command line iterface (AWS CLI) Here are links to some information about those tools
-  * Building an S3 compatible Cloud but using one or more different Storage implementations to deliver it, using the SMEStorage Cloud Appliance. +  * [[standalone/explorer|]] - SME desktop application for users to easily access S3-compatible and other object storage 
-  * Transitioning from existing S3 use to a different Cloud but without having to change code ieonly changing the endpoint implementation +  * [[https://aws.amazon.com/cli/|awscli]] - Allowing command line access to cloud files 
-  * Using S3 Tools and scripts to work with Clouds other than S3+  * [[https://blog.storagemadeeasy.com/the-comprehensive-guide-to-installing-aws-cli-on-windows-mac-or-linux/|The Comprehensive Guide to Installing AWS CLI on Windows, Mac or Linux]] 
 +  * [[https://blog.storagemadeeasy.com/simplifying-aws-s3-cli-usage-with-aliases/|Simplifying AWS S3 CLI Usage with Aliases]] 
 +  * [[https://blog.storagemadeeasy.com/how-to-use-the-aws-cli-with-almost-any-storage/|How to use the AWS CLI with almost any Storage]]
  
-## Restrictions +## API Implementation
- +
-SME S3 API does not support multi-part upload. +
- +
-Certain S3 client tools may need you to change a setting to turn off multi-part upload. +
- +
-For example you need to do this with Cyberduck.Multipart uploads can be disabled by setting the hidden option s3.upload.multipart to false..   See https://trac.cyberduck.ch/wiki/help/en/howto/s3 for further information. +
- +
-## Implementation+
  
 SME supports the following Amazon S3 API Requests: SME supports the following Amazon S3 API Requests:
Line 70: Line 56:
  * **[[http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTObjectCOPY.html|PUT with header]]** x-amz-copy-source to copy object   * **[[http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTObjectCOPY.html|PUT with header]]** x-amz-copy-source to copy object 
  * **[[http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTObjectHEAD.html|HEAD]]** to get object metadata  * **[[http://docs.amazonwebservices.com/AmazonS3/latest/API/RESTObjectHEAD.html|HEAD]]** to get object metadata
-