UpCloud

Object Storage Groups

IAM groups allow you to organize users and apply policies to multiple users at once. Users can belong to multiple groups and inherit all policies attached to those groups.

GET/1.3/object-storage-2/{service_uuid}/groups

List groups

Returns a list of available service groups by given {service_uuid}.

Request

GET
/1.3/object-storage-2/{service_uuid}/groups
curl -X GET https://api.upcloud.com/1.3/object-storage-2/0ab2f83f-03f3-4c48-9a38-0a3e89c6d024/groups \
  -u your_username:your_password
GET/1.3/object-storage-2/{service_uuid}/groups/{group_name}

Get group details

Get a single group identified by {service_uuid} and {group_name}.

Request

GET
/1.3/object-storage-2/{service_uuid}/groups/{group_name}
curl -X GET https://api.upcloud.com/1.3/object-storage-2/0ab2f83f-03f3-4c48-9a38-0a3e89c6d024/groups/test-group \
  -u your_username:your_password
POST/1.3/object-storage-2/{service_uuid}/groups

Create group

Creates a new IAM group.

Attributes

  • Name
    name
    Type
    string
    Description

    A valid string to represent the name of the IAM group. 1-128 characters.

Request

POST
/1.3/object-storage-2/{service_uuid}/groups
curl -X POST https://api.upcloud.com/1.3/object-storage-2/0ab2f83f-03f3-4c48-9a38-0a3e89c6d024/groups \
  -u your_username:your_password \
  -H "Content-Type: application/json" \
  -d '{
    "name": "new-group"
  }'
DELETE/1.3/object-storage-2/{service_uuid}/groups/{group_name}

Delete group

Deletes a group identified by {group_name}.

Request

DELETE
/1.3/object-storage-2/{service_uuid}/groups/{group_name}
curl -X DELETE https://api.upcloud.com/1.3/object-storage-2/0ab2f83f-03f3-4c48-9a38-0a3e89c6d024/groups/test-group \
  -u your_username:your_password
POST/1.3/object-storage-2/{service_uuid}/groups/{group_name}/users/{username}

Attach user to group

Attaches an IAM user to a group identified by {group_name} and {username}.

Request

POST
/1.3/object-storage-2/{service_uuid}/groups/{group_name}/users/{username}
curl -X POST https://api.upcloud.com/1.3/object-storage-2/0ab2f83f-03f3-4c48-9a38-0a3e89c6d024/groups/developers/users/john_doe \
  -u your_username:your_password
DELETE/1.3/object-storage-2/{service_uuid}/groups/{group_name}/users/{username}

Remove user from group

Removes an IAM user from the group identified by {group_name} and {username}.

Request

DELETE
/1.3/object-storage-2/{service_uuid}/groups/{group_name}/users/{username}
curl -X DELETE https://api.upcloud.com/1.3/object-storage-2/0ab2f83f-03f3-4c48-9a38-0a3e89c6d024/groups/developers/users/john_doe \
  -u your_username:your_password
GET/1.3/object-storage-2/{service_uuid}/groups/{group_name}/inline-policies

List group inline policies

Lists the group inline policies by the given {service_uuid} and {group_name}.

Request

GET
/1.3/object-storage-2/{service_uuid}/groups/{group_name}/inline-policies
curl -X GET https://api.upcloud.com/1.3/object-storage-2/0ab2f83f-03f3-4c48-9a38-0a3e89c6d024/groups/developers/inline-policies \
  -u your_username:your_password
GET/1.3/object-storage-2/{service_uuid}/groups/{group_name}/inline-policies/{policy_name}

Get group inline policy

Get the group inline policy by the given {service_uuid}, {group_name} and {policy_name}.

Request

GET
/1.3/object-storage-2/{service_uuid}/groups/{group_name}/inline-policies/{policy_name}
curl -X GET https://api.upcloud.com/1.3/object-storage-2/0ab2f83f-03f3-4c48-9a38-0a3e89c6d024/groups/developers/inline-policies/sample-policy \
  -u your_username:your_password
POST/1.3/object-storage-2/{service_uuid}/groups/{group_name}/inline-policies

Create group inline policy

Creates a group inline policy by the given {service_uuid} and {group_name}.

Attributes

  • Name
    name
    Type
    string
    Description

    The name of the policy. 1-128 characters.

  • Name
    document
    Type
    string
    Description

    A valid policy document in JSON format. 1-6144 characters.

Request

POST
/1.3/object-storage-2/{service_uuid}/groups/{group_name}/inline-policies
curl -X POST https://api.upcloud.com/1.3/object-storage-2/0ab2f83f-03f3-4c48-9a38-0a3e89c6d024/groups/developers/inline-policies \
  -u your_username:your_password \
  -H "Content-Type: application/json" \
  -d '{
    "name": "sample-policy",
    "document": "{\"Version\":\"2012-10-17\",\"Statement\":[{\"Action\":\"sts:AssumeRole\",\"Effect\":\"Allow\",\"Resource\":\"*\"}]}"
  }'
DELETE/1.3/object-storage-2/{service_uuid}/groups/{group_name}/inline-policies/{policy_name}

Delete group inline policy

Deletes a group inline policy by the given {service_uuid}, {group_name} and {policy_name}.

Request

DELETE
/1.3/object-storage-2/{service_uuid}/groups/{group_name}/inline-policies/{policy_name}
curl -X DELETE https://api.upcloud.com/1.3/object-storage-2/0ab2f83f-03f3-4c48-9a38-0a3e89c6d024/groups/developers/inline-policies/sample-policy \
  -u your_username:your_password
GET/1.3/object-storage-2/{service_uuid}/groups/{group_name}/policies

List group policies

Lists the attached policies for a group by the given {service_uuid} and {group_name}.

Request

GET
/1.3/object-storage-2/{service_uuid}/groups/{group_name}/policies
curl -X GET https://api.upcloud.com/1.3/object-storage-2/0ab2f83f-03f3-4c48-9a38-0a3e89c6d024/groups/developers/policies \
  -u your_username:your_password
PUT/1.3/object-storage-2/{service_uuid}/groups/{group_name}/policies/{policy_name}

Attach group policy

Attaches a policy to a group by the given {service_uuid}, {group_name} and {policy_name}.

Request

PUT
/1.3/object-storage-2/{service_uuid}/groups/{group_name}/policies/{policy_name}
curl -X PUT https://api.upcloud.com/1.3/object-storage-2/0ab2f83f-03f3-4c48-9a38-0a3e89c6d024/groups/developers/policies/ECSS3FullAccess \
  -u your_username:your_password
DELETE/1.3/object-storage-2/{service_uuid}/groups/{group_name}/policies/{policy_name}

Detach group policy

Detaches a policy from a group by the given {service_uuid}, {group_name} and {policy_name}.

Request

DELETE
/1.3/object-storage-2/{service_uuid}/groups/{group_name}/policies/{policy_name}
curl -X DELETE https://api.upcloud.com/1.3/object-storage-2/0ab2f83f-03f3-4c48-9a38-0a3e89c6d024/groups/developers/policies/ECSS3FullAccess \
  -u your_username:your_password