Swift CLI | Basics

The Bulk Storage CLI tools are a veritable force. After installing the OpenStack CLI toolchain you're ready to become familiar with the swift client.

The Fly-through

I'm going to take you through a hands-on walkthrough of the swift client. We'll do some exploring, create a file, download, change ACLs, and clean up when we're done.

Let's start by exploring our account.

$ swift stat
Account: AUTH_<tenant_id>
Containers: 0
Objects: 0
Bytes: 0

Looks like we don't have anything yet, you can see that there are 0 containers, 0 objects, taking up 0 bytes. So let's start by uploading a file. Note that this will create a container if one doesn't exist (it doesn't).

$ swift upload demo index.html

Now we can see the demo container has 1 object of 370 bytes.

$ swift stat demo
Account: AUTH_<tenant_id>
Container: demo
Objects: 1
Bytes: 370
Read ACL:
Write ACL:
Sync To:
Sync Key:

Next, check to see what's in the bucket.

$ swift list demo

We'll download the new file and see if it worked.

$ swift download demo index.html
index.html [auth 0.816s, headers 1.133s, total 1.134s, 0.012 MB/s]
$ cat index.html

Huzzah! Now let's make the container publicly accessible!

$ swift post -r ".r:*" demo
$ wget https://swift.ca-ns-1.clouda.ca:8443/v1/AUTH_<YOUR_TENANT_ID>/demo/index.html
HTTP request sent, awaiting response... 200 OK
Length: 370 [text/html]
Saving to: 'index.html'
100%[==========================================================>] 370
--.-K/s   in 0s
2014-05-28 21:49:40 (25.2 MB/s) - 'index.html' saved [370/370]

And now, let's clean up after ourselves.

$ swift delete demo
$ swift stat demo
Container 'demo' not found

This is just the tip of the iceberg, we'll be posting more thorough documentation for the swift client, and APIs soon. Keep your eyes peeled!

Still need help? Get in touch!
Last updated on 8th Jun 2016