Object Storage Quick Start

Create a Container

In the Openstack web interface, expand Object Store and then click Containers on the left hand side of the screen.

../_images/1-menu.png

Click + Container.

../_images/2-create-container.png

On the Create Container screen, enter a name for the container and select whether the container should be publicly accessible, then click Submit.

../_images/3-create-container-form.png

Warning

Selecting “public” will allow the contents of a container to be viewed by anyone, with no authentication required. See Editing Container Metadata or Containers for greater control over read and write access.

If successful, the container will be listed below the + Container button.

../_images/5-container-list.png

Details of the container may be viewed by clicking on the listing. This will also display a checkbox that may be clicked to enable or disable public access.

../_images/6-container-details.png

Upload a File

Having selected a listed container, click the Upload icon next to + Folder.

../_images/7-object-upload.png

Select a file to upload, and a unique name for it in the container. Then click Upload File.

../_images/8-object-form.png

Warning

Files uploaded in this way must be less than 5GiB. See Large Files for instructions on uploading larger files. If Error: Unable to upload the object is displayed for a file smaller than this, you may need to contact the Cloud team to request a quota increase.

If successful, the file will be listed below the Upload icon.

../_images/10-object-list.png

To view file details, select the arrow next to Download to view the options, then click View Details.

../_images/11-object-options.png

The file details will then be shown.

../_images/12-object-details.png

Create a Folder

To create an empty folder, click + Folder.

../_images/13-folder-create.png

Enter a unique folder name, then click Create Folder.

../_images/14-folder-form.png

Alternatively, folders may be created by including a new folder name, followed by a delimiter (‘/’), before the name of an uploaded file.

../_images/16-folder-form-alt.png

If successful, the folder will be listed with other files in the container.

../_images/17-folder-list.png

The contents of a folder may be viewed by clicking the folder listing.

../_images/18-folder-contents.png

Create Deep Folders

When viewing a folder, a deep folder can be created by selecting + Folder, as previously when viewing a container.

../_images/19-subfolder-create.png

Multiple levels of folders may be created by including delimiters (‘/’) between each folder name. Any folders specified that do not exist will be created.

../_images/20-subfolders-create.png

This can equivalently be done when viewing the container, outside all folders.

../_images/21-subfolders-create-alt.png

Alternatively, the new folder names may be included when uploading a file.

../_images/22-subfolders-create-alt-2.png

As when viewing a container, the next level of folders will be listed alongside files in the folder you are viewing. Deeper folders and files will not be displayed without navigating into their parent folders by selecting them.

../_images/23-subfolders-contents.png

Delete a File

To delete an individual file, select the arrow next to Download to view the file options, then clicking Delete.

../_images/11-object-options.png

On the Delete Files screen, select Delete to begin deletion.

../_images/24-delete-file.png

If successful, a progress bar should fill, and the Delete Files screen can be dismissed by clicking OK or X.

Delete a Folder

To delete a folder and its contents, click the Delete button.

../_images/25-delete-folder.png

As for a file, on the Delete Files screen, select Delete to begin deletion.

../_images/26-delete-folder-final.png

If successful, a progress bar should fill, and the Delete Files screen can be dismissed by clicking OK or X.

Delete Multiple Files or Folders

Select the files and/or folders to be deleted by clicking the checkbox next to each. All file and folder in the current folder or container can be selected by clicking the checkbox next to Name.

../_images/27-files-select.png

Click the Delete icon next to + Folder.

../_images/28-files-delete.png

As for individual files and folders, select Delete on the Delete Files screen to begin deletion. You can then dismiss the Delete Files screen.

Delete a Container

In order to delete a container, all files and folders in the container must first be deleted. Then, with the container selected, click the Delete icon next to its name.

../_images/29-container-delete.png

On the the Confirm Delete screen, select Delete to begin deletion.

../_images/30-container-delete-final.png

If successful, a success message will appear, and the container will no longer be listed.

Edit a File

To edit a file, select the arrow next to Download to view the options, then click Edit.

../_images/11-object-options.png

On the Edit File screen, select Choose file to specify the new contents of the file, then click Edit File.

../_images/31-object-edit.png

If successful, a success message will appear, and the file details will be updated.

Warning

Editing a file will remove any existing properties, apart from Orig-Filename, which will be set to the uploaded file name. See also: Editing Object Metadata

Copy a File

To copy a file, select the arrow next to Download to view the options, then click Copy.

../_images/11-object-options.png

On the Copy Object screen, enter the name of the destination container and destination file name, then click Copy Object.

../_images/32-object-copy.png

If successful, a success message will appear, and the copied file will be listed.

Limitations

Some Swift features are unavabile through the GUI, and so must be performed using the Python SDK and/or the CLI. For example:

References

https://docs.openstack.org/horizon/train/user/manage-containers.html