The SaveGroup API allows the Account Owner to create or update a specified Group.
In apstrata, data read and write permissions are controlled using ACLs (from wikipedia: Access Control Lists). Each read or write ACL contains a list of Users and/or Groups specifying who can read or write the data for which the ACL is defined.
Users with the same privileges are set as members of the same Group. A user can belong to one or more Groups or no Group at all. Once a Group is created, it can be used in ACLs to define access permissions for more than one user at the same time.
For specific details on the creation of a Group, please check the SaveGroup API.
Specific Request Parameters
(Refer to Common Request Parameters)
The group name to create.
Alphanumeric characters, "_" and "-"
Maximum length 243 characters
Should be set to true in order to update existing group
This is sent when the user wishes to rename the group.
Specific Response Elements
(Refer to Common Response Elements)
Specific Logical Errors
(Refer to Common Logical Error Codes)
Group [ newGroupName ] already exists
Invalid group [" + groupName + "]. Group name should be alphanumeric (a-z A-Z 0-9) with dashes (-) and underscores (_). It should not be shorter than 1 character or exceed 128
Cannot find group [ groupName ]
Sample XML Response
Sample JSON Response