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_28 01:18] stevens3compatibleapi [2019_05_07 14:26] – [S3 Signatures Supported] jim
Line 1: Line 1:
 # Amazon S3 compatible API # Amazon S3 compatible API
  
-We provide support for the Amazon S3 API. This means you can use the S3 compatible object storage API to access files on Google Docs, RackSpace Cloud Files, or Microsoft OneDrive, or any of the many other clouds that we support.+The Enterprise File Fabric provides support for an Amazon S3 compatible API. This means the S3 compatible object storage API can be used to access files that have been mapped to the File Fabric, such as files available on Google Drive, RackSpace Cloud Files, or Microsoft OneDrive, or any of the many other clouds that the solution supports.
  
-The S3 API is available on our SaaS services and on the appliance.+The S3 API is available on the SaaS hosted service and also on the enterprise on-premises edition of the product.
  
 ## Client Configuration ## Client Configuration
  
-To use the S3 API you will need the:+To use the S3 API the:
  
  1. Cloud S3 Endpoint  1. Cloud S3 Endpoint
- 1. Access Key ID + 2. Access Key ID 
- 1. Secret Access Key+ 3. Secret Access Key 
 + 
 +are required.
  
 ### 1. Cloud S3 Endpoint ### 1. Cloud S3 Endpoint
  
-For our SaaS services use one of the following S3 API endpoints:+For the SaaS hosted service it is required to use one of the following S3 API endpoints:
  
  * http://s3.storagemadeeasy.com (US Server)  * http://s3.storagemadeeasy.com (US Server)
Line 24: Line 26:
 Naturally http endpoints are not secure and should not be used for production data. Naturally http endpoints are not secure and should not be used for production data.
  
-For appliances contact your administrator for the "Cloud S3 Domain Name".+For the enterprise on-premises version of the product the S3 access nomenclature is set through the ConfigServer.
  
 ### 2. Access Key ID ### 2. Access Key ID
  
-The Access Key ID is your SME or File Fabric username.+The Access Key ID is the SME or File Fabric username.
  
 ### 3. Secret Access Key  ### 3. Secret Access Key 
Line 34: Line 36:
 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
- +
-It can be used by may tools including: +
- +
- * [[https://aws.amazon.com/cli/|awscli]] - Allowing command line access to cloud files+
  
 +The File Fabric's 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:
 +  * [[standalone/explorer|]] - SME desktop application for users to easily access S3-compatible and other object storage
 +  * [[https://aws.amazon.com/cli/|awscli]] - Allowing command line access to cloud files
   * [[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/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/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]]   * [[https://blog.storagemadeeasy.com/how-to-use-the-aws-cli-with-almost-any-storage/|How to use the AWS CLI with almost any Storage]]
- * [[standalone/explorer|]] - Desktop applications for users to easily access S3-compatible and other object storage 
- * CloudBerry 
- * Cyberduck 
- 
  
-## Implementation+## API Implementation
  
 SME supports the following Amazon S3 API Requests: SME supports the following Amazon S3 API Requests:
Line 62: Line 59:
  * **[[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
  
 +## S3 Signatures Supported
  
 +The S3 API supports V2 and V4 signatures. Which one is used is dependent on the client request.