...
XML | JSON | ||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
...
Delete a Group
...
Description
...
URI
...
HTTP Method
...
DELETE
...
Description
...
Deletes a Group.
...
URI Parameters
...
See Group Delete a Group URI Parameters, below.
...
Example URI
...
- http://localhost:9080/uc/resources/usergroup?groupname=Test_Group
- http://localhost:9080/uc/resources/usergroup?groupid=f93b9403aec546bcbef1c2c06cf26e3c
...
Example Response
...
- Status 200 /OK
User group {groupname} deleted successfully. - Status 400 /Bad Request
Mutual exclusion violation. Cannot specify groupid and groupname at the same time. - Status 404 /Not Found
User group with {groupname/groupid} does not exist.
...
Delete a Group: URI Parameters
...
Parameter
...
Description
...
Specifications
...
Required
...
Mutually Exclusive With
...
groupid
...
ID used within the Controller to identify this group.
...
String; URI parameter.
...
Y (unless groupname
is specified)
...
groupname
...
groupname
...
Name used within the Controller to identify this group.
...
String; URI parameter.
...
Y (unless groupid
is specified)
...
groupid
...
List Groups
...
Description
...
URI
...
HTTP Method
...
GET
...
Description
...
Retrieves information on all Groups.
...
Example URI
...
Authentication
...
HTTP Basic
...
Produces Content-Type
...
application/xml, application/json
...
Example
...
See Read a Group: XML and JSON Examples.
...
Group Properties
...
See Group Properties.
...
Group Member Properties
...
...
Group Permission Properties
...
See Group Permission Properties.
...
Group Role Properties
...
...
List Groups XML and JSON Examples
XML | JSON | |||||||||
---|---|---|---|---|---|---|---|---|---|---|
|
...
Read a Group
...
Description
...
URI
...
HTTP Method
...
GET
...
Description
...
Retrieves information on a specific Group.
...
URI Parameters
...
See Read a Group: URI Parameters, below.
...
Example URI
...
- http://localhost:8080/uc/resources/usergroup?groupname=test.group
- http://localhost:8080/uc/resources/usergroup?groupid=c489750500d444eca9325559d0ef9673
...
Authentication
...
HTTP Basic
...
Consumes Content-Type
...
n/a
...
Produces Content-Type
...
application/xml, application/json
...
Example Response
...
- Status 200 /OK
(See Read a Group: Example XML and JSON Examples, below.) - Status 404 /Not Found
A user group with id "f87848b00a0001037f43e7c81c8ec969" does not exist.
...
Response Group Member Properties
...
...
Response Group Permission Properties
...
See Group Permission Properties.
...
Response Group Role Properties
...
...
Read a Group: URI Parameters
Parameter | Description | Specifications | Required | Mutually Exclusive With | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ID used within the Controller to identify this group. | String; URI parameter. | Y (unless |
| |||||||||||
| Name
|
...
Modify a Group
...
Description
...
URI
...
HTTP Method
...
PUT
...
Description
...
Modifies the Group specified by the sysId
in the request.
To modify Group properties without modifying related records, see the excludeRelated property, below.
...
Example URI
...
Consumes Content-Type
...
application/xml, application/json
...
Produces Content-Type
...
n/a
...
Example Request
...
See Create and Modify a Group: XML and JSON Examples.
...
Group Properties
...
See Group Properties.
...
Group Member Properties
...
...
Group Permission Properties
...
See Group Permission Properties.
...
Group Role Properties
...
...
Example Response
...
- Status 200 /OK
Successfully updated the user group with sysId <sysId>.
|
Anchor | ||||
---|---|---|---|---|
|
Delete a Group
Description | |
---|---|
URI | http://host_name/uc/resources/usergroup |
HTTP Method | DELETE |
Description | Deletes a Group. |
URI Parameters | See Group Delete a Group URI Parameters, below. |
Example URI | |
Example Response |
|
Anchor | ||||
---|---|---|---|---|
|
Delete a Group: URI Parameters
Parameter | Description | Specifications | Required | Mutually Exclusive With |
---|---|---|---|---|
| ID used within the Controller to identify this group. | String; URI parameter. | Y (unless |
|
...
Read a Group XML and JSON Examples
The retainSysIds property is specified as an attribute in the <userGroup> element of the XML response.
XML | JSON | |
---|---|---|
Expand | | |
|
Code Block | ||
---|---|---|
| ||
<userGroup retainSysIds="true">
<ctrlNavigationVisibility>false</ctrlNavigationVisibility>
<description/>
<email/>
<groupMembers>
<groupMember>
<sysId>386bf68d82a74a9e94eab18c1b1844c2</sysId>
<user name="stone b branch">stonebranch-user-02</user>
</groupMember>
<groupMember>
<sysId>792aa1dc1a1b4decb0b02d82ed7e9422</sysId>
<user name="stone c branch">stonebranch-user-03</user>
</groupMember>
<groupMember>
<sysId>b78079e1166d4c5180d7e42443de44a0</sysId>
<user name="stone a branch">stonebranch-user-01</user>
</groupMember>
</groupMembers>
<groupRoles>
<groupRole>
<role description="The administrator role.">ops_admin</role>
<sysId>b80e78a42589435f92f3e176af6dc542</sysId>
</groupRole>
</groupRoles>
<manager/>
<name>stonebranch-group-01</name>
<navigationVisibility/>
<parent/>
<permissions>
<permission>
<allGroups>true</allGroups>
<commands/>
<defaultGroup>true</defaultGroup>
<nameWildcard>*</nameWildcard>
<notGroups>false</notGroups>
<opCreate>false</opCreate>
<opDelete>false</opDelete>
<opExecute>false</opExecute>
<opRead>true</opRead>
<opUpdate>false</opUpdate>
<opswiseGroups/>
<permissionType>Task Instance</permissionType>
<sysId>59e5565c9f6a45ed8633d05a91ac1019</sysId>
</permission>
</permissions>
<sysId>b39b2b8eac644e068a68f92f325b0c74</sysId>
</userGroup>883b1b5e1</sysId>
</userGroup> |
title | JSON |
---|
groupname
Name used within the Controller to identify this group.
String; URI parameter.
Y (unless groupid
is specified)
groupid
Anchor | ||||
---|---|---|---|---|
|
List Groups
Description | |
---|---|
URI | http://host_name/uc/resources/usergroup/list |
HTTP Method | GET |
Description | Retrieves information on all Groups. |
Example URI | http://localhost:8080/uc/resources/usergroup/list |
Authentication | HTTP Basic |
Produces Content-Type | application/xml, application/json |
Example | |
Group Properties | See Group Properties. |
Group Member Properties | |
Group Permission Properties | |
Group Role Properties |
Anchor | ||||
---|---|---|---|---|
|
List Groups XML and JSON Examples
XML | JSON | ||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
|
Anchor | ||||
---|---|---|---|---|
|
Modify a Group
Description | |
---|---|
URI | http://host_name/uc/resources/usergroup |
HTTP Method | PUT |
Description | Modifies the Group specified by the |
Example URI | http://localhost:8080/uc/resources/usergroup |
Consumes Content-Type | application/xml, application/json |
Produces Content-Type | n/a |
Example Request | |
Group Properties | See Group Properties. |
Group Member Properties | |
Group Permission Properties | |
Group Role Properties | |
Example Response |
|
Anchor | ||||
---|---|---|---|---|
|
Read a Group
Description | |
---|---|
URI | http://host_name/uc/resources/usergroup |
HTTP Method | GET |
Description | Retrieves information on a specific Group. |
URI Parameters | See Read a Group: URI Parameters, below. |
Example URI | |
Authentication | HTTP Basic |
Consumes Content-Type | n/a |
Produces Content-Type | application/xml, application/json |
Example Response |
|
Response Group Member Properties | |
Response Group Permission Properties | |
Response Group Role Properties |
Anchor | ||||
---|---|---|---|---|
|
Read a Group: URI Parameters
Parameter | Description | Specifications | Required | Mutually Exclusive With |
---|---|---|---|---|
| ID used within the Controller to identify this group. | String; URI parameter. | Y (unless |
|
| Name used within the Controller to identify this group. | String; URI parameter. | Y (unless |
|
Anchor | ||||
---|---|---|---|---|
|
Read a Group XML and JSON Examples
The retainSysIds property is specified as an attribute in the <userGroup> element of the XML response.
XML | JSON | ||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
|
Anchor | ||||
---|---|---|---|---|
|
...