Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Anchor
Top
Top

...

Info
titleBase URL for Group REST API

http://host:port/flexdeploy/rest/administration/security/group

Table of Contents
maxLevel12

Each function returns a JSON group object. The group object has these attributes:

AttributesTypeDescription
descriptionStringThe description of the group.
isFDAdminBooleanThe boolean representing whether the group is a Flex Deploy Administrator.
groupIdLongThe unique Id of the group.
groupNameStringThe unique name of the group.
isActiveBooleanThe boolean representing whether the group is active.
globalPermissionsList<GlobalPermissionPojo>The list of global permissions associated with the group
deploymentPermissionsList<DeploymentPermissionPojo>The list of deployment permissions associated with the group

Additionally, each GlobalPermissionPojo in the list of globalpermissions contains these attributes

AttributesTypeDescription
objectTypeStringThe object type of the global permission
actionTypeStringThe action type of the global permission

Additionally, each DeploymenPermissionPojo in the list of deploymentPermissions contains these attributes

AttributesTypeDescription
environmentIdsList<Long>The list of environment Ids associated with the deployment permissions

...

GET

There are two implementations of GET. One will find a group with the given Id and return the JSON representation of the group . The other will find a list of groups matching the parameters supplied to it.

...

GET (Using Query Parameters)

This GET service will return a list of groups in the form of JSON objects based on the query parameters group name. Groups are only returned if they match all of the specified query parameters. If no query parameters are given this request will return the entire list of groups.

Info
titleAPI URLs

http://host:port/flexdeploy/rest/administration/security/group?

Append the following character sequences to the above URL to specify Query parameters.
Use '&' between successive query parameters: 

groupname={groupname}

Examples:
To search by group name:

http://host:port/flexdeploy/rest/topology/administration/security/group?groupname=read

...

Info
titleAPI URL

http://host:port/flexdeploy/rest/administration/security/group

Parameters

AttributesTypeRequiredDescription
descriptionStringNoThe description of the group.
isFDAdminBooleanNoThe boolean representing whether the group is a Flex Deploy Administrator.
groupIdLongNoThe unique Id of the group.
groupNameStringYesThe unique name of the group.
isActiveBooleanNoThe boolean representing whether the group is active.
globalPermissionsList<GlobalPermissionPojo>NoThe list of global permissions associated with the group
deploymentPermissionsList<DeploymentPermissionPojo>NoThe list of deployment permissions associated with the group

Example

If the POST request receives the following JSON group object,

...

Info
titleAPI URL

http://host:port/flexdeploy/administration/security/group/{Id}

Parameters

AttributesTypeRequiredDescription
descriptionStringNoThe description of the group.
isFDAdminBooleanNoThe boolean representing whether the group is a Flex Deploy Administrator.
groupIdLongNoThe unique Id of the group.
groupNameStringYesThe unique name of the group.
isActiveBooleanNoThe boolean representing whether the group is active.
globalPermissionsList<GlobalPermissionPojo>NoThe list of global permissions associated with the group
deploymentPermissionsList<DeploymentPermissionPojo>NoThe list of deployment permissions associated with the group

Example

If we had a group in our database with an Id of 10000 and had the following attributes

...

Back to Top

...

PATCH

This PATCH service will update an existing group with the information passed through a JSON object. If an attribute of the JSON is null it will not be updated in the group.

Info
titleAPI URL

http://host:port/flexdeploy/administration/security/group/{Id}

Parameters

AttributesTypeRequiredDescription
descriptionStringNoThe description of the group.
isFDAdminBooleanNoThe boolean representing whether the group is a Flex Deploy Administrator.
groupIdLongNoThe unique Id of the group.
groupNameStringNoThe unique name of the group.
isActiveBooleanNoThe boolean representing whether the group is active.
globalPermissionsList<GlobalPermissionPojo>NoThe list of global permissions associated with the group
deploymentPermissionsList<DeploymentPermissionPojo>NoThe list of deployment permissions associated with the group

Example

If we had a group in our database with an Id of 10000 and had the following attributes

...