S3 API - Service Operations

Service Operations

List Buckets

GET / returns a list of buckets made by the user making the request. GET / only returns buckets created by an authenticated user. You cannot make an anonymous request.

Syntax

GET / HTTP/1.1
Host: s3.z1storage.com
Authorization: AWS {access-key}:{hash-of-header-and-secret}

Response Entities

Name Type Description
Buckets Container Container for list of buckets.
Bucket Container Container for bucket information.
Name String Bucket name.
CreationDate Date UTC time when the bucket was created.
ListAllMyBucketsResult Container A container for the result.
Owner Container A container for the bucket owner’s ID and DisplayName.
ID String The bucket owner’s ID.
DisplayName String The bucket owner’s display name.

Get Usage Stats

Gets usage stats per user, similar to the admin command Get User Usage Stats.

Syntax

GET /?usage HTTP/1.1
Host: s3.z1storage.com
Authorization: AWS {access-key}:{hash-of-header-and-secret}

Response Entities

Name Type Description
Name Type Description
Summary Container Summary of total stats by user.
TotalBytes Integer Bytes used by user
TotalBytesRounded Integer Bytes rounded to the nearest 4k boundary
TotalEntries Integer Total object entries