• Bucket

Get Bucket Info

Gets bucket information for the specified bucket.

Query Parameters

Required Roles

Requires one of the following roles:

• SYSTEM_ADMIN

• SYSTEM_MONITOR

Prerequisites

The following conditions must be met in order to call this operation.

• Bucket name should not be null or empty.

• Bucket must exist.

Response Body

Response contains the following bucket information

Examples

GET https://192.168.0.0:4443/object/bucket/standalone-bucket/info

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"?>
<bucket_info>
    <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>
    <compliance_enabled>false</compliance_enabled>
    <locked>false</locked>
    <namespace>s3</namespace>
    <notification_size>-1</notification_size>
    <vpool>urn:storageos:ReplicationGroupInfo:b3bf2d47-d732-457c-bb9b-d260eb53a76b:global</vpool>
</bucket_info>

GET https://192.168.0.0:4443/object/bucket/standalone-bucket/info.json

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

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

{
    "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,
    "compliance_enabled": "false",
    "default_retention": -2,
    "block_size": -1,
    "notification_size": -1,
    "owner": "wuser1@sanity.local",
    "api_type": "S3"
}

curl -H $token -H "Content-Type: application/xml" -X GET https://$nodeIp:4443/object/bucket/standalone-bucket/info

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

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<bucket_info>
    <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>
    <compliance_enabled>false</compliance_enabled>
    <locked>false</locked>
    <namespace>s3</namespace>
    <notification_size>-1</notification_size>
    <vpool>urn:storageos:ReplicationGroupInfo:b3bf2d47-d732-457c-bb9b-d260eb53a76b:global</vpool>
</bucket_info>