Cyberduck Mountain Duck CLI

Changes between Version 59 and Version 60 of help/en/howto/s3


Ignore:
Timestamp:
Jun 22, 2010 8:40:55 AM (11 years ago)
Author:
dkocher
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • help/en/howto/s3

    v59 v60  
    55Transfer files to your [http://aws.amazon.com/s3 S3] account and browse the S3 buckets and files in a hierarchical way as you are used to with other remote file systems supported by Cyberduck. For a short overview of Amazon S3, refer to the Wikipedia [http://en.wikipedia.org/wiki/Amazon_S3 article].
    66
    7 === Connecting to Amazon S3 ===
     7== Connecting to Amazon S3 ==
    88
    99You must obtain the login credentials (''Access Key ID'' and ''Secret Access Key'') of your Amazon Web Services [http://aws.amazon.com/account/ Account] from the ''AWS Access Identifiers'' [http://aws-portal.amazon.com/gp/aws/developer/account/index.html?action=access-key page]. In the login prompt of Cyberduck upon connecting to S3 you enter the ''Access Key ID'' for the username and ''Secret Access Key'' for the password.
    1010
    11 ==== Thirdparty S3 providers ====
     11=== Thirdparty S3 providers ===
    1212
    1313There are several third parties beside Amazon offering S3 compatible cloud storage software or solutions.
     
    1616 * [wiki:help/en/howto/dunkel Dunkel Cloud Storage]
    1717
    18 ==== Use S3 without SSL ====
     18=== Use S3 without SSL ===
    1919
    2020'''It is discouraged to enable this option to connect plaintext to Amazon S3.'''
     
    2828You will then have the added option ''S3/HTTP (Amazon Simple Storage Service)'' in the protocol dropdown selection in the [wiki:help/en/howto/connection Connection] and [wiki:help/en/howto/bookmarks Bookmark] panels.
    2929
    30 ==== Storage Class ====
     30=== Storage Class ===
    3131
    3232You have the option to store files using the ''Reduced Redundancy Storage (RRS)'' to reduce costs by storing non-critical, reproducible data at lower levels of redundancy. Set the default storage class in ''Preferences → S3'' and [wiki:help/en/howto/info#CloudProviderS3CloudFilesPanel edit the storage class] for already uploaded files using ''File → Info → S3''.
    3333
    34 === Buckets ===
     34== Buckets ==
    3535
    3636To create a new [http://docs.amazonwebservices.com/AmazonS3/2006-03-01/index.html?UsingBucket.html bucket] for your account, browse to the root and choose ''File → New Folder...''.
     
    4444'''Important''': Because the bucket name must be globally unique the operation might fail if the name is already taken by someone else (E.g. don't assume any common name like ''media'' or ''images'' will be available).
    4545
    46 ==== Bucket Access Logging ====
     46=== Bucket Access Logging ===
    4747
    4848When this option is enabled in the ''File →  Info'' panel of a bucket or any file within, available log records for this bucket are periodically aggregated into log files and delivered to `<bucketname>/logs`.
     
    5050To toggle ''CloudFront'' access logging, select the the [wiki:help/en/howto/cloudfront#CloudFrontAccessLogging Distribution] panel in the ''File → Info '' window.
    5151
    52 === Folders ===
     52== Folders ==
    5353
    5454Creating a folder inside a bucket will create a placeholder object named after the directory, has no data content and the mimetype `application/x-directory`.
     
    6060You must give ''Other'' read permissions for your objects in ''File → Info → Permissions'' to make them accessible using a regular web browser for everyone.
    6161
    62 === Distribution (CDN) ===
     62== Distribution (CDN) ==
    6363
    6464Refer to Amazon [wiki:help/en/howto/cloudfront CloudFront] distribution.
    6565
    66 === Files ===
     66== Files ==
    6767
    68 ==== Signed URLs ====
     68=== Signed URLs ===
    6969
    7070Use ''File → Info'' to copy the signed public URL from the S3 section valid for 24 hours.
     
    7676}}}
    7777
    78 ==== BitTorrent URLs ====
     78=== BitTorrent URLs ===
    7979
    8080Use ''File →  Info → S3'' to copy the BitTorrent URL of a selected file.
    8181
    82 ==== Metadata ====
     82=== Metadata ===
    8383
    8484You can edit standard HTTP headers [wiki:help/en/howto/info#MetadataHTTPheaders add] custom HTTP headers to files to store [http://docs.amazonwebservices.com/AmazonS3/latest/index.html?UsingMetadata.html metadata]. Choose ''File → Info → S3'' to edit headers.
    8585
    8686
    87 ==== Cache Control Setting ====
     87=== Cache Control Setting ===
    8888
    8989This option lets you control how long a client accessing objects from your S3 bucket will cache the content and thus lowering the number of access to your S3 storage. In conjunction with Amazon CloudFront, it controls the time an object stays in an edge location until it expires. After the object expires, CloudFront must go back to the origin server the next time that edge location needs to serve that object. By default, all objects automatically expire after 24 hours when no custom `Cache-Control` header is set.
     
    102102'''Tip:''' Use `curl -I <http://<bucketname>.s3.amazonaws.com/<key>` to debug HTTP headers.
    103103
    104 === Problems ===
    105 ==== SSL certificate trust verification ====
     104== Problems ==
     105=== SSL certificate trust verification ===
    106106
    107107When listing a bucket that has a `.` in its name, connecting will give a trust verification failure ''The certificate is not valid (host name mismatch)'' for the wildcard certificate `*.s3.amazonaws.com`. Because the wildcard only applies to one level in the domain name, you must manually trust this certificate.
    108108
    109 === References ===
     109== References ==
    110110 * [http://aws.amazon.com/s3/faqs/ Amazon Simple Storage Service FAQs]
    111111 * [http://docs.amazonwebservices.com/AmazonS3/latest Amazon Simple Storage Service Developer Guide]