Bucket:Get Groups

Search (SHIFT+S)

ECS Management API

ECS Object Service API

ECS API Changes

Get Groups

GET /object/bucket/acl/groups

Gets all ACL groups.

Required Roles

Requires one of the following roles:

SYSTEM_ADMIN
SYSTEM_MONITOR
NAMESPACE_ADMIN

Response Body

Contains details of the groups associated with the ACL.

Field	Description	Type	Notes
groups
group			0-* Elements
id	Group id	String
display_name	Display name	String
description	Description	String

Examples

Request

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

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

Response

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

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<groups>
    <group>
        <id>public</id>
        <display_name>public</display_name>
        <description>all users including authenticated users and anonymous</description>
    </group>
</groups>

Request

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

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

Response

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

{
    "group": [
        {
            "id": "public",
            "display_name": "public",
            "description": "all users including authenticated users and anonymous"
        }
    ]
}