• Bucket

Get Buckets

Gets the list of buckets for the specified namespace. If namespace to this bucket creation does not exist then user's namespace is used.

Query Parameters

Required Roles

Requires one of the following roles:

• SYSTEM_ADMIN

• SYSTEM_MONITOR

Response Body

List of buckets associated with the given namespace.

Examples

GET https://192.168.0.0:4443/object/bucket HTTP/1.1  

Concept-Type: application/xml 
X-SDS-AUTH-TOKEN: <AUTH_TOKEN>

HTTP/1.1 200 OK
Content-Type: application/xml 

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<object_buckets>
    <object_bucket>
        <name>LockedBucket82440140-c11e-11e4-8580-0050569c6fd7</name>
        <tags/>
        <api_type>S3</api_type>
        <block_size>-1</block_size>
        <owner>wuser1@sanity.local</owner>
        <created>2015-03-02T20:48:15.650Z</created>
        <default_retention>-2</default_retention>
        <fs_access_enabled>false</fs_access_enabled>
        <is_stale_allowed>false</is_stale_allowed>
        <locked>true</locked>
        <search_metadata>
        <search_enabled>true</search_enabled>
            <metadata>
                <datatype>integer</datatype>
                <name>x-amz-meta-custom</name>
                <type>User</type>
            </metadata>
        </search_metadata>
        <namespace>s3</namespace>
        <notification_size>-1</notification_size>
        <vpool>urn:storageos:ReplicationGroupInfo:b3bf2d47-d732-457c-bb9b-d260eb53a76b:global</vpool>
    </object_bucket>
    <object_bucket>
        <name>standalone-bucket</name>
        <tags/>
        <api_type>S3</api_type>
        <block_size>-1</block_size>
        <owner>wuser1@sanity.local</owner>
        <created>2015-03-02T19:44:29.283Z</created>
        <default_retention>-2</default_retention>
        <fs_access_enabled>false</fs_access_enabled>
        <is_stale_allowed>false</is_stale_allowed>
        <locked>false</locked>
        <search_metadata>
            <metadata>
                <datatype>integer</datatype>
                <name>SomeKey</name>
            </metadata>
            <metadata>
                <datatype>decimal</datatype>
                <name>SomeKey2</name>
            </metadata>
        </search_metadata>
        <namespace>s3</namespace>
        <notification_size>-1</notification_size>
        <vpool>urn:storageos:ReplicationGroupInfo:b3bf2d47-d732-457c-bb9b-d260eb53a76b:global</vpool>
    </object_bucket>
</object_buckets>

GET https://192.168.0.0:4443/object/bucket.json HTTP/1.1 

Content-Type: application/json
X-SDS-AUTH-TOKEN: <AUTH_TOKEN>

HTTP/1.1 200 OK 
Content-Type: application/json 
{
   "object_bucket":[
      {
         "name":"f4cb8ba2-c11e-11e4-8580-0050569c6fd7",
         "global":null,
         "remote":null,
         "vdc":null,
         "tags":[

         ],
         "namespace":"s3",
         "locked":false,
         "created":"2015-03-02T20:51:28.034Z",
         "vpool":"urn:storageos:ReplicationGroupInfo:b3bf2d47-d732-457c-bb9b-d260eb53a76b:global",
         "fs_access_enabled":false,
         "is_stale_allowed":false,
         "default_retention":-2,
         "block_size":-1,
         "notification_size":-1,
         "owner":"wuser1@sanity.local",
         "api_type":"S3",
         "search_metadata":{
            "search_enabled": true,
               "metadata":[
                  {
                     "datatype": "integer",
                     "name": "x-amz-meta-custom",
                     "type": "User"
                  }
               ]
         }
      },
      {
         "name":"standalone-bucket",
         "global":null,
         "remote":null,
         "vdc":null,
         "tags":[

         ],
         "namespace":"s3",
         "locked":false,
         "created":"2015-03-02T19:44:29.283Z",
         "vpool":"urn:storageos:ReplicationGroupInfo:b3bf2d47-d732-457c-bb9b-d260eb53a76b:global",
         "fs_access_enabled":false,
         "is_stale_allowed":false,
         "default_retention":-2,
         "block_size":-1,
         "notification_size":-1,
         "owner":"wuser1@sanity.local",
         "api_type":"S3",
         "search_metadata":{
            "metadata":[
               {
                  "datatype":"integer",
                  "name":"SomeKey"
               },
               {
                  "datatype":"decimal",
                  "name":"SomeKey2"
               }
            ]
         }
      }
   ]
}