6. S3 Object Storage

In this area you manage your S3 objects (buckets, files) including the project and panel user permissions and S3 EC2 credentials (access key and secret).

6.1. Overview S3 Management

The following image illustrates the objects that you can manage in the Cloud Service Portal under S3 Object Storage. The structure refers to a project. If required, you can create and manage several projects.

../_images/cp-ui-client-s3-overview.png
Legend Overview S3 Management
Object Description
  1. Project
Permissions, buckets and EC2 credentials always belong to a project.
  1. Client Admin
The Client Admin is a user with extended rights and manages the projects and users and regulates their authorization.
  1. Client User
The client user sees the projects and buckets for which he has been authorized.
  1. Project EC2 Credentials
Access to buckets within a project is authorized via so-called EC2 credentials [1].
  1. Bucket
Buckets [2] is like a collection container for the objects (files) that are to be stored in the Object Storage.
  1. Objects
In the S3 Object Storage Panel single files can be uploaded or downloaded [3].
  1. Bucket2
You can create multiple buckets to better organize objects.
[1]An EC2 credential consists of an API and Secret Key and belongs to the project. You can create multiple EC2 credentials per project. Access via EC2 credentials means that all buckets in a project are always visible.
[2]Any number of buckets can be created in a project as part of fair usage.
[3]Larger amounts of data are usually loaded with an external tool (e.g. S3 Explorer or S3 CLI).

6.2. Create EC2 Credentials

Before you can create buckets, you must have created at least one EC2 credential.

  • To do this, navigate to S3 Object Storage on the left and then to Projects.
  • Now please click on the Manage Credentials button
../_images/cp-ui-client-manage-ec2-credentials-ssc.png
  • Then click on the Create Credentials button
../_images/cp-ui-client-create-ec2-credentials.png
  • The created EC2 credentials are displayed, complete the process by clicking Create.
../_images/cp-ui-client-create-ec2-credentials2.png
  • The EC2 credential has been created for this project and is displayed in the list.
  • Now create your bucket.

6.3. Create Bucket

To create a bucket, please proceed as follows.

  • To do this, navigate to S3 Object Storage on the left and then to Projects.
  • Now click on the small arrow next to the desired project in the list and then on Manage Buckets.
../_images/cp-ui-client-manage-buckets.png
  • Now please click on the Create Buckets button, enter a name and click on create
  • Please note the restrictions on the bucket name.
../_images/cp-ui-client-create-buckets.png

6.3.1. Restrictions bucket names

In general, bucket names should follow the restrictions for domain names.

  • Bucket names must be unique.
  • Bucket names cannot be formatted as IP addresses.
  • Bucket names can be between 3 and 63 characters long.
  • Bucket names must not contain capital letters or underscores.
  • Bucket names must begin with a lowercase letter or number.
  • Bucket names must be a series of one or more labels. Adjacent labels are separated by a single period (.).
  • Bucket names can contain lowercase letters, numbers, and hyphens. Each label must begin and end with a lowercase letter or number.

6.4. Upload Files

After you have created a bucket, you can now upload or download individual files in the S3 panel.

  • To do this, navigate to S3 Object Storage on the left and then to Buckets.
  • Now click on the small arrow next to the desired bucket in the list and then on Manage Bucket.
../_images/cp-ui-client-bucket-manage-bucket.png
  • Then click on the Upload File button
../_images/cp-ui-client-bucket-upload-file1.png
  • An input window appears in which you can select a file from your local file system by clicking on Choose File (1).
../_images/cp-ui-client-bucket-upload-file2.png
  • By clicking on Upload (2) the selected file will be uploaded.
  • A progress bar shows the status of the charging process.
../_images/cp-ui-client-bucket-upload-file3.png

6.5. Download File

After you have created a bucket and uploaded files, you can now download individual files in the S3 panel.

  • To do this, navigate to S3 Object Storage on the left and then to Buckets.
  • Now click on the small arrow next to the desired bucket in the list and then on Manage Bucket.
  • Now click on the small arrow next to the desired file in the list and then on Download.
../_images/cp-ui-client-bucket-download-file.png
  • The file will be placed in your download directory.

Note

Larger amounts of data are usually uploaded or downloaded using an external tool (e.g. S3 Explorer or S3cmd).

6.6. Manage Projects

If you as a client have received management rights for your projects from your reseller, you can create projects within the scope of the granted project quotas.

  • To do this, navigate to S3 Object Storage on the left and then to Manage Projects.
  • Now please click on the Create Project button
../_images/cp-ui-client-s3-create-project-ssc.png
  • Now enter a project name and a description.
  • Please select object-storage [4] as quota profile.
  • Then click on the Create button
[4]Profile object-storage - This special quota profile contains only #Projects quotas to avoid accidental usage of other resources (e.g. CPU, RAM).
../_images/cp-ui-client-s3-create-project2.png
  • The project has been created and is displayed in the list.
  • Now grant the user permissions for this project.

6.7. Manage Users

In order for a user to be able to manage a project in the Cloud Service Portal, for example to create a bucket in this project, you must grant the necessary rights.

Note

You do not need these permissions to access a bucket directly via EC2 credentials.

Proceed as follows:

  • To do this, navigate to S3 Object Storage on the left and then to Manage Projects.
  • Now please click on the Manage user button on the right side of the corresponding project
../_images/cp-ui-client-s3-project-manage-users.png
  • Then click on the button Edit roles on the right side of the corresponding user you want to authorize
../_images/cp-ui-client-s3-project-edit-roles.png
  • Now tick the s3 box and confirm with the create button
../_images/cp-ui-client-s3-project-edit-roles1.png