# Storage Class: Amazon S3

Before configuring a remote Amazon S3 Storage Class, ensure that the required certificates are imported as described in the [Understanding and managing Amazon S3 STS authentication](/data-mover-1.21/transfer-protocols-and-connectors/client-connections/client-connection-amazon-s3.md#understanding-and-managing-amazon-s3-sts-authentication) section.

Once you have done that, these are the fields you must complete to create a new Amazon S3 Storage Class. Fields with an asterisk are mandatory. 

<table><thead><tr><th width="229.99993896484375">Field</th><th>Description</th></tr></thead><tbody><tr><td><strong>NAME (*)</strong></td><td>Assign a Name to the Storage Class.<br>A maximum of 128 characters is allowed.</td></tr><tr><td><strong>DESCRIPTION</strong></td><td>Enter the description of the Storage Class.</td></tr><tr><td><strong>LOCATION TYPE (*)</strong></td><td>The location where files are stored. Choose Amazon S3.</td></tr><tr><td><strong>CONNECTION TIMEOUT (*)</strong></td><td>Number of seconds without network activity to wait before closing a session due to inactivity.<br>Default value: 60.</td></tr><tr><td><strong>ACCESS KEY ID (*)</strong></td><td>Enter the AWS access key ID.</td></tr><tr><td><strong>SECRET ACCESS KEY (*)</strong></td><td>Enter the AWS secret access key.</td></tr><tr><td><strong>BUCKET NAME *</strong></td><td>Enter the name of the S3 bucket. The minimum number of characters is 3 and the maximum is 63. Blanks are not supported.</td></tr><tr><td><strong>REGION *</strong></td><td>Select the region of the S3 bucket specified in the BUCKET NAME field.</td></tr><tr><td><strong>ENDPOINT URL</strong></td><td>Enter the URL of the entry point for the AWS web service.<br>This field is optional and is used only to override the bucket name and region.<br>It is recommended to leave this value blank unless connecting to a non-standard service endpoint. When empty, the endpoint is determined automatically based on the Region specified in the Basic field. If used, this property overrides the bucket name and the region.</td></tr><tr><td><strong>UPLOAD PART SIZE *</strong></td><td>This is the size of each part in a multipart upload. By default it is set to 5 MB and the value must be less than 10 MB.<br>Multipart upload allows uploading an object (file) as a set of parts. Once uploaded, the object will be available as a unique part. This facilitates the upload, especially in case of pause and resume.</td></tr><tr><td><strong>INTERNAL FILES LOCATION (*)</strong></td><td>Enter the physical path where INTERNAL files must be saved. The path must start with "/". If omitted, the system automatically adds it.</td></tr><tr><td><strong>EXTERNAL FILES LOCATION (*)</strong></td><td>Enter the physical path where EXTERNAL files must be saved. The path must start with "/". If omitted, the system automatically adds it.</td></tr><tr><td><strong>TEMPORARY FILES LOCATION (*)</strong></td><td>Enter the physical path where incoming external files are temporarily saved before their transfer is completed. The path must begin with /. If omitted, the system automatically adds it.</td></tr><tr><td><strong>CLUSTER</strong></td><td>Select the Cluster you want to associate with the Storage Class.</td></tr><tr><td><strong>SYMMETRIC KEYS</strong></td><td><p>Select the Symmetric Key to associate with the Storage Class. The Symmetric Key displayed in the drop‑down menu must have been created in <strong>Setup</strong> → <strong>Key Store</strong> → <a href="/pages/sVBaPb8jrcZVf8mouQjQ">Symmetric keys</a>.</p><p>The selected Symmetric Key is used to encrypt the files that are stored using this specific Storage Class.</p><p>If the option is read‑only, one or more files are already associated with the Storage Class. The Storage Class must be empty in order to associate a Symmetric Key.</p></td></tr><tr><td><strong>CONFIGURATION TEST</strong></td><td><p>Use this section to validate whether the remote Storage Class is correctly configured and fully usable by Data Mover on a specific Cluster.</p><p>Choose the <strong>Cluster</strong> on which you want to validate the Storage Class configuration. If only one Cluster is available, it is selected automatically. Click <strong>TEST</strong> to start the validation process. </p><p>Each action is displayed with a status icon:</p><ul><li>✅ <strong>Green check:</strong> the action completed successfully.</li><li>❌ <strong>Red error icon:</strong> the action failed and cannot be performed.</li></ul><p>Hovering over an action displays a tooltip with detailed diagnostic information.<br><strong>Warning</strong>: We recommend choosing a remote Storage Class that can sustain all actions listed in this test.</p></td></tr></tbody></table>

Once you have created the Storage Class, press **Save** and your Storage Class will appear in the Result list.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.primeur.com/data-mover-1.21/virtual-file-systems/storage-classes/storage-class-amazon-s3.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.