openstack-manuals/doc/user-guide/source/dashboard_manage_containers.rst

Create and manage object containers

OpenStack Object Storage provides a distributed, API-accessible storage platform that can be integrated directly into an application or used to store any type of file, including VM images, backups, archives, or media files. In the OpenStack dashboard, you can only manage containers and objects.

In OpenStack Object Storage, containers provide storage for objects in a manner similar to a Windows folder or Linux file directory, though they cannot be nested. An object in OpenStack consists of the file to be stored in the container and any accompanying metadata.

Create a container

1. Log in to the dashboard, choose a project, and click Containers.
2. Click Create Container.
3. In the Create Container dialog box, enter a name for the container, and then click Create Container.

You have successfully created a container.

Upload an object

1. Log in to the dashboard, choose a project, and click Containers.

2. Select the container in which you want to store your object.

3. Click Upload Object.

   The Upload Object To Container: <name> dialog box appears. ``<name>`` is the name of the container to which you are uploading the object.

4. Enter a name for the object.

5. Browse to and select the file that you want to upload.

6. Click Upload Object.

You have successfully uploaded an object to the container.

Manage an object

To edit an object

1. Log in to the dashboard, choose a project, and click Containers.

2. Select the container in which you want to store your object.

3. Click More and choose Edit from the dropdown list.

   The Edit Object dialog box is displayed.

4. Browse to and select the file that you want to upload.

5. Click Update Object.

To copy an object from one container to another

1. Log in to the dashboard, choose a project, and click Containers.
2. Select the container in which you want to store your object.
3. Click More and choose Copy from the dropdown list.
4. In the Copy Object launch dialog box, enter the following values:

• Destination Container: Choose the destination container from the list.
• Path: Specify a path in which the new copy should be stored inside of the selected container.
• Destination object name: Enter a name for the object in the new container.

1. Click Copy Object.

To create a metadata-only object without a file

You can create a new object in container without a file available and can upload the file later when it is ready. This temporary object acts a place-holder for a new object, and enables the user to share object metadata and URL info in advance.

1. Log in to the dashboard, choose a project, and click Containers.

2. Select the container in which you want to store your object.

3. Click Upload Object.

   The Upload Object To Container: ``<name>`` dialog box is displayed.

   ``<name>`` is the name of the container to which you are uploading the object.

4. Enter a name for the object.

5. Click Update Object.

To create a pseudo-folder

Pseudo-folders are similar to folders in your desktop operating system. They are virtual collections defined by a common prefix on the object's name.

1. Log in to the dashboard, choose a project, and click Containers.

2. Select the container in which you want to store your object.

3. Click Create Pseudo-folder.

   The Create Pseudo-Folder in Container ``<name> `` dialog box is displayed. ``<name> `` is the name of the container to which you are uploading the object.

4. Enter a name for the pseudo-folder.

   A slash (/) character is used as the delimiter for pseudo-folders in Object Storage.

5. Click Create.