Cyberduck Mountain Duck CLI

Changes between Version 47 and Version 48 of help/en/howto/s3


Ignore:
Timestamp:
May 26, 2010 2:51:07 AM (10 years ago)
Author:
dkocher
Comment:

--

Legend:

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

    v47 v48  
    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.
     10
     11==== Use S3 without SSL ====
     12
     13'''It is discouraged to enable this option to connect plaintext to Amazon S3.'''
     14
     15If you have a S3 implementation in your local network and can't connect using SSL, you can enable a hidden configuration option to connect using HTTP only without transport layer security.
     16
     17{{{
     18defaults write ch.sudo.cyberduck protocol.s3.enable true
     19}}}
     20
     21You 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.
     22
     23==== Storage Class ====
     24
     25You have the option to store files using the ''Reduced Redundancy Storage (RSS)'' to reduce costs by storing non-critical, reproducible data at lower levels of redundancy. Set the default storage class in ''Preferences → S3'' and edit the storage class for already uploaded files using ''File → Info → S3''.
    1026
    1127=== Buckets ===
     
    2036
    2137'''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).
     38
     39==== Bucket Access Logging ====
     40
     41When 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`.
     42
     43Citing the Amazon S3 [http://docs.amazonwebservices.com/AmazonS3/2006-03-01/index.html?LoggingHowTo.html documentation]:
     44''An Amazon S3 bucket can be configured to create access log records for the requests made against it. An access log record contains details about the request such as the request type, the resource with which the request worked, and the time and date that the request was processed. Server access logs are useful for many applications, because they give bucket owners insight into the nature of requests made by clients not under their control. 'There is no extra charge for enabling the server access logging feature on an Amazon S3 bucket, however any log files the system delivers to you will accrue the usual charges for storage (you can delete the log files at any time). No data transfer charges will be assessed for log file delivery, but access to the delivered log files is charged for data transfer in the usual way.''
     45
     46To toggle ''CloudFront'' access logging, select the the [wiki:help/en/howto/cloudfront#CloudFrontAccessLogging distribution] panel in the ''File → Info '' window.
    2247
    2348=== Folders ===
     
    3560Refer to Amazon [wiki:help/en/howto/cloudfront CloudFront] distribution.
    3661
    37 === Signed URLs ===
     62=== Files ===
     63
     64==== Signed URLs ====
    3865
    3966Use ''File → Info'' to copy the signed public URL from the S3 section valid for 24 hours.
     
    4572}}}
    4673
    47 === Cache Control Setting ===
     74==== BitTorrent URLs ====
     75
     76Use ''File →  Info → S3'' to copy the BitTorrent URL of a selected file.
     77
     78==== Metadata ====
     79
     80You can [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 custom headers.
     81
     82
     83==== Cache Control Setting ====
    4884
    4985This 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.
     
    6298'''Tip:''' Use `curl -I <http://<bucketname>.s3.amazonaws.com/<key>` to debug HTTP headers.
    6399
    64 === Bucket Access Logging ===
    65 
    66 When 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`.
    67 
    68 Citing the Amazon S3 [http://docs.amazonwebservices.com/AmazonS3/2006-03-01/index.html?LoggingHowTo.html documentation]:
    69 ''An Amazon S3 bucket can be configured to create access log records for the requests made against it. An access log record contains details about the request such as the request type, the resource with which the request worked, and the time and date that the request was processed. Server access logs are useful for many applications, because they give bucket owners insight into the nature of requests made by clients not under their control. 'There is no extra charge for enabling the server access logging feature on an Amazon S3 bucket, however any log files the system delivers to you will accrue the usual charges for storage (you can delete the log files at any time). No data transfer charges will be assessed for log file delivery, but access to the delivered log files is charged for data transfer in the usual way.''
    70 
    71 To toggle ''CloudFront'' access logging, select the the [wiki:help/en/howto/cloudfront#CloudFrontAccessLogging distribution] panel in the ''File → Info '' window.
    72 
    73 === BitTorrent Distribution ===
    74 
    75 Use ''File →  Info'' to copy the BitTorrent URL to your content from the S3 section.
    76 
    77 === Metadata ===
    78 
    79 You can [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 custom headers.
    80 
    81 === Storage Class ===
    82 
    83 You have the option to store files using the ''Reduced Redundancy Storage (RSS)'' to reduce costs by storing non-critical, reproducible data at lower levels of redundancy. Set the default storage class in ''Preferences → S3'' and edit the storage class for already uploaded files using ''File → Info → S3''.
    84 
    85 === Use S3 without SSL ===
    86 
    87 '''It is discouraged to enable this option to connect plaintext to Amazon S3.'''
    88 
    89 If you have a S3 implementation in your local network and can't connect using SSL, you can enable a hidden configuration option to connect using HTTP only without transport layer security.
    90 
    91 {{{
    92 defaults write ch.sudo.cyberduck protocol.s3.enable true
    93 }}}
    94 
    95 You 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.
    96 
    97 
    98 
    99100=== References ===
    100101 * [http://aws.amazon.com/s3/faqs/ Amazon Simple Storage Service FAQs]
swiss made software