Wiki source code of Amazon S3
Last modified by Aurelie Bertrand on 2026/01/12 16:46
Show last authors
| author | version | line-number | content |
|---|---|---|---|
| 1 | {{ddtoc/}} | ||
| 2 | |||
| 3 | ---- | ||
| 4 | |||
| 5 | = Requirements = | ||
| 6 | |||
| 7 | * An Amazon Web Services (AWS) account with user creation via the console interface available at this address :((( | ||
| 8 | (% class="box infomessage" %) | ||
| 9 | ((( | ||
| 10 | console.aws.amazon.com | ||
| 11 | ))) | ||
| 12 | |||
| 13 | Use the Identity Access Management (IAM) service to create and manage your users**(Services** > **Security, Identity & Compliance** > **IAM**). | ||
| 14 | ))) | ||
| 15 | |||
| 16 | [[image:amazonS3_fr_html_270afb69f10317bf.png||queryString="width=526&height=371" data-xwiki-image-style-alignment="center" height="371" width="526"]] | ||
| 17 | |||
| 18 | |||
| 19 | * When creating users, be sure to note the pairs (access key ID, secret access key) for each user so that you can provide them to the Digdash Amazon S3 client. | ||
| 20 | * Create a bucket with a universally unique name on Amazon S3. | ||
| 21 | |||
| 22 | (% class="box infomessage" %) | ||
| 23 | ((( | ||
| 24 | Amazon S3 is a cloud storage service for the Internet. To upload your data, you must first create a bucket in one of the AWS regions. You can then upload an unlimited number of objects to this bucket. | ||
| 25 | ))) | ||
| 26 | |||
| 27 | = Creating a new Amazon S3 file server = | ||
| 28 | |||
| 29 | You can create a new Amazon S3 File Server from within the Studio. | ||
| 30 | |||
| 31 | 1. In the Studio, click the **Managers **button in the sidebar on the left of the window, then select **Servers**. | ||
| 32 | ➡ The **Server URL Manager **dialog box appears. | ||
| 33 | 1. Click on the **+** button to the right of the search bar and then, in the menu that appears, select the type of server: Amazon S3. | ||
| 34 | ➡ The **Add a file server** box appears | ||
| 35 | 1. Fill in the fields as described in the Server configuration paragraph below. | ||
| 36 | |||
| 37 | = Server configuration = | ||
| 38 | |||
| 39 | == Server name == | ||
| 40 | |||
| 41 | Give your new Amazon S3 document server a name. | ||
| 42 | |||
| 43 | == URL == | ||
| 44 | |||
| 45 | Enter: | ||
| 46 | |||
| 47 | * the generic URL if your files are stored on Amazon S3: "https:~/~/s3.amazonaws.com" | ||
| 48 | * the URL of the hosting server if you are using another service or your own server. | ||
| 49 | |||
| 50 | == User document path == | ||
| 51 | |||
| 52 | The user document path __must__ begin with the name of the existing compartment you want to explore, followed by the path to the directory containing your documents. | ||
| 53 | |||
| 54 | It is also used to check that access to your account is valid. | ||
| 55 | |||
| 56 | (% class="box" %) | ||
| 57 | ((( | ||
| 58 | Example: Let's say the name of the following existing compartment: "dd-com-test-bucket". | ||
| 59 | ))) | ||
| 60 | |||
| 61 | Then a valid document path would be: | ||
| 62 | |||
| 63 | (% class="box" %) | ||
| 64 | ((( | ||
| 65 | **dd-com-test-bucket/directory1/directory2/directory3/** | ||
| 66 | ))) | ||
| 67 | |||
| 68 | == Exploring sub-folders == | ||
| 69 | |||
| 70 | You can limit the level of exploration from your document path. | ||
| 71 | |||
| 72 | By default, the document search is recursive and will explore all sub-folders. | ||
| 73 | |||
| 74 | |Fields|//Browse subfolders//|(% colspan="2" %)//Subfolder level// | ||
| 75 | |(% rowspan="2" %)Values|Enabled|((( | ||
| 76 | Empty | ||
| 77 | |||
| 78 | Default value, recursive exploration of all sub-folders | ||
| 79 | )))|((( | ||
| 80 | N > 0 | ||
| 81 | |||
| 82 | All N sub-folders will be searched | ||
| 83 | ))) | ||
| 84 | |Off|(% colspan="2" %)((( | ||
| 85 | 0 | ||
| 86 | |||
| 87 | No exploration in sub-folders, only in the current directory | ||
| 88 | ))) | ||
| 89 | |||
| 90 | == Read only == | ||
| 91 | |||
| 92 | Only reading is possible if this option is enabled. | ||
| 93 | |||
| 94 | == Access key ID == | ||
| 95 | |||
| 96 | Enter the access key ID supplied when your user was created. | ||
| 97 | |||
| 98 | == Secret access key == | ||
| 99 | |||
| 100 | Enter the secret access key supplied when your user was created. | ||
| 101 | |||
| 102 | = Possible actions = | ||
| 103 | |||
| 104 | You can use the **File Manager** to take action on the files on the FTP(S) server. | ||
| 105 | See the page[[ File Manager>>doc:Digdash.user_guide.studio.managers.Files.WebHome]] page for more details. |