Amazon Simple Storage Service
Getting Started Guide (API Version 2006-03-01)
Print this pageEmail this pageGo to the ForumsView the PDFShare this page on TwitterShare this page on FacebookBookmark this page on DeliciousSubmit this page to RedditSubmit this page to DiggDid this page help you?  Yes  No   Tell us about it...

Add an Object to a Bucket

Now that you've created a bucket, you're ready to add an object to it. An object can be any kind of file: a text file, a photo, a video and so forth. When you add a file to Amazon S3, you have the option of including metadata with the file and setting permissions to control access to the file.

[Important]Important

The bucket you created is not in a sandbox. In this exercise you add an object to a real bucket and you will be charged a nominal amount for putting an object into the bucket, the time that you store the object in the bucket, and downloading the object from the bucket. For more information about Amazon S3 pricing, go to the Amazon S3 Pricing page.

To upload an object

  1. In the Amazon S3 console, click the bucket you want to upload an object into and then click Upload in the Objects and Folders panel.

    The Upload - Select Files wizard opens as shown in the following sample wizard in Firefox:

  2. If you want to upload a folder you must click Enable Enhanced Uploader for the Java applet. After you download the Java applet, the Enable Enhanced Uploader link disappears from the wizard. You only need to do this once per console session and you can transfer entire folders.

    [Note]Note

    If you are behind any corporate firewall you will need to install your corporate supported proxy client for the Java applet to work.

  3. Click Add Files to select the file to upload from your computer.

    A file selection dialog box opens:

    • If you enabled advanced uploader in step 2, you see a Java file selection dialog box.

    • If not, you see an operating system specific dialog box.

    The following image shows a sample Java file selection dialog box.

  4. Select the file you want to upload and click Open.

    The Upload - Select Files wizard shows the files and folders you've selected to upload.

  5. Click Start Upload.

    You can watch the progress of the upload using the Transfer panel. The Transfer panel appears on the bottom of the screen as soon as a you begin the upload.

    [Tip]Tip

    If you want to toggle between hiding and viewing the Transfer panel, click the Transfers button in the top right of the Objects and Folders panel.

    After the object uploads successfully to Amazon S3, it appears in the object listing.

You've added a file to your bucket.

Viewing an object to a bucket.