Skip to main content

Your submission was sent successfully! Close

Thank you for signing up for our newsletter!
In these regular emails you will find the latest updates from Canonical and upcoming events where you can meet our team.Close

Thank you for contacting us. A member of our team will be in touch shortly. Close

Object Storage

The object storage service providing Swift and S3 endpoints is enabled automatically as soon as there are storage nodes in a cluster.

The object storage endpoints can be retrieved using openstack client. See Using OpenStack CLI on how to use OpenStack CLI.

Run the below command to get s3 endpoint:

openstack endpoint list --service s3 --interface public

Sample output of the above command:

+----------------------------------+-----------+--------------+--------------+---------+-----------+--------------------+
| ID                               | Region    | Service Name | Service Type | Enabled | Interface | URL                |
+----------------------------------+-----------+--------------+--------------+---------+-----------+--------------------+
| 74c9adaa7041422692a1f55adf0a65eb | RegionOne | s3           | s3           | True    | public    | http://10.20.21.10 |
+----------------------------------+-----------+--------------+--------------+---------+-----------+--------------------+

Run the below command to get swift endpoint:

openstack endpoint list --service swift --interface public

Sample output of the above command:

+----------------------------------+-----------+--------------+--------------+---------+-----------+-------------------------------------------------+
| ID                               | Region    | Service Name | Service Type | Enabled | Interface | URL                                             |
+----------------------------------+-----------+--------------+--------------+---------+-----------+-------------------------------------------------+
| d30b885de04b4b1090d2c7d05d4c6562 | RegionOne | swift        | object-store | True    | public    | http://10.20.21.10/swift/v1/AUTH_$(project_id)s |
+----------------------------------+-----------+--------------+--------------+---------+-----------+-------------------------------------------------+

Usage

To access using the swift protocol, users can use the openstack client.

Create a Swift container using command:

openstack container create foo

Sample output:

+---------------------------------------+-----------+--------------------------------------------------+
| account                               | container | x-trans-id                                       |
+---------------------------------------+-----------+--------------------------------------------------+
| AUTH_75a27eb3202d4fcda251647d1d78af2c | foo       | tx0000045042a8694f86bc4-0066877b39-121b1-default |
+---------------------------------------+-----------+--------------------------------------------------+ 

List containers using command:

openstack container list

Sample output:

+------+
| Name |
+------+
| foo  |
+------+

Upload an object in the container using command:

openstack object create foo test.txt --name test

Sample output:

+--------+-----------+----------------------------------+
| object | container | etag                             |
+--------+-----------+----------------------------------+
| test   | foo       | d8e8fca2dc0f896fd7cb4cb0031ba249 |
+--------+-----------+----------------------------------+

List the objects in the container using command:

openstack object list foo

Sample output:

+------+
| Name |
+------+
| test |
+------+

Delete an object from container using command:

openstack object delete foo test

Delete a container using command:

openstack container delete foo

Last updated 5 months ago. Help improve this document in the forum.