Administrator’s Command Line Guide

Table Of Contents

Chapter 3. Accessing Storage Clusters via S3 Protocol

3.4.1 Listing S3 Bucket Contents

You can list bucket contents with a web browser. To do this, visit the URL that consists of the external DNS

name for the S3 endpoint that you speciﬁed when creating the S3 cluster and the bucket name. For example,

mys3storage.example.com/mybucket or mybucket.mys3storage.example.com (depending on DNS conﬁguration).

Note: You can also copy the link to bucket contents by right-clicking it in CyberDuck, and then

selecting Copy URL.

3.4.2 Listing S3 Storage Buckets

You can list all buckets in the S3 object storage with the ostor-s3-admin list-all-buckets command. For

each bucket, the command shows owner, creation data, versioning status, and total size (the size of all

objects stored in the bucket plus the size of all unﬁnished multipart uploads for this bucket). For example:

# ostor-s3-admin list-all-buckets -V 0100000000000002

Total 3 buckets

BUCKET OWNER CREATION_DATE VERSIONING TOTAL SIZE, BYTES

bucket1 968d1a79968d1a79 2015-08-18T09:32:35.000Z none 1024

bucket2 968d1a79968d1a79 2015-08-18T09:18:20.000Z enabled 0

bucket3 968d1a79968d1a79 2015-08-18T09:22:15.000Z suspended 1024000

To output the list in XML, use the -X option. For example:

# ostor-s3-admin list-all-buckets -X

<?xml version="1.0" encoding="UTF-8"?><ListBucketsResult><Buckets><Bucket><Name>bucker2</Name><Own

er>d7c53fc1f931661f</Owner><CreationDate>2017-04-03T17:11:44.000Z</CreationDate><Versioning>none</

Versioning><Notary>off</Notary><TotalSize>0</TotalSize></Bucket><Bucket><Name>bucket1</Name><Owner

>d7c53fc1f931661f</Owner><CreationDate>2017-04-03T17:11:33.000Z</CreationDate><Versioning>none</Ve

rsioning><Notary>off</Notary><TotalSize>0</TotalSize></Bucket></Buckets></ListBucketsResult>

To ﬁlter buckets by user who owns them, use the -i option. For example:

# ostor-s3-admin list-all-buckets -i d7c53fc1f931661f

BUCKET OWNER CREATION_DATE VERSIONING TOTAL_SIZE NOTARY NOTARY_PROVIDER

bucker2 d7c53fc1f931661f 2017-04-03T17:11:44.000Z none 0 off 0