Versions Compared

Key

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

Anchor
Top
Top

...

Below is the list of possible global permissions

Object TypeAction Type
PROJECTPAGEVIEW
APPROVALREAD, UPDATE
WINDOWREAD, UPDATE
NOTIFICATIONREAD, UPDATE, DELETE
WORKFLOWREAD, UPDATE
REPORTREAD
ENVINSTANCEREAD, UPDATE
ENVIRONMENTREAD, UPDATE
INSTANCEREAD, UPDATE
ENDPOINTREAD, UPDATE
SCHEDULEDTASKREAD, UPDATE
PLUGINREAD, UPLOAD
PROPERTYSETREAD
DEFAULTSREAD, UPDATE
FLEXFIELDSREAD, UPDATE
TEMPLATEREAD, UPDATE
USERREAD
GROUPREAD
TESTTOOLREAD, UPDATE
TESTTYPEREAD, UPDATE
ISSUETRACKINGSYSTEMREAD, UPDATE
CHANGEMANAGEMENTSYSTEMREAD, UPDATE
RELEASEREAD, UPDATE, CREATESNAPSHOT, CONFIGUREPROJECTLIST, CONFIGUREPIPLINE, CONFIGURECMS, MANAGELIFECYCLE, GRANTPERMISSIONS
PIPELINEREAD, UPDATE

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

AttributesTypeDescription
environmentIdsenvironmentsList<Long>The list of environment Ids associated with the deployment permissions
allEnvironmentsBooleanThe boolean representing whether the group is able to deploy all environments or not. If allEnvironments is updated to null it will default to false.

...

Code Block
themeEclipse
titleGroup - 10000
{
   "description": "test",
   "isFlexDeployAdministrator": false,
   "groupId": 10000,
   "groupName": "test",
   "isActive": true,
   "globalPermissions": [   {
      "objectType": "WORKFLOW",
      "actionType": "READ"
   }],
   "deploymentPermissions": {"environmentIdsenvironments":    [
      18605,
      20610
   ],
	"allEnvironments":false
}
}

...

Code Block
themeEclipse
titleGroup - 10000
{
   "description": "test",
   "isFlexDeployAdministrator": false,
   "groupId": 10000,
   "groupName": "test",
   "isActive": true,
   "globalPermissions": [   {
      "objectType": "WORKFLOW",
      "actionType": "READ"
   }],
   "deploymentPermissions": {"environmentIdsenvironments":    [
      18605,
      20610
   ],
	"allEnvironments":false
}
}

...

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

...

Code Block
themeEclipse
titleGroup - 10000
{
   "description": "test",
   "isFlexDeployAdministrator": false,
   "groupId": 10000,
   "groupName": "test",
   "isActive": true,
   "globalPermissions": [   {
      "objectType": "WORKFLOW",
      "actionType": "READ"
   }],
   "deploymentPermissions": {"environmentIdsenvironments":    [
      18605,
      20610
   ],
	"allEnvironments":false
}
}

...

Code Block
themeEclipse
titleGroup - 10000
[
{
   "description": "test",
   "isFlexDeployAdministrator": false,
   "groupId": 10000,
   "groupName": "test",
   "isActive": true,
   "globalPermissions": [   {
      "objectType": "WORKFLOW",
      "actionType": "READ"
   }],
   "deploymentPermissions": {"environmentIdsenvironments":    [
      18605,
      20610
   ],
	"allEnvironments":false
}
}
]

...

Code Block
themeEclipse
titleGroup - 10000
{
   "description": "This is a simple group with no permissions.",
   "groupName": "Simple Group",
   "isActive": true,
   "isFlexDeployAdministrator": false,
   "deploymentPermissions": {"environmentIdsenvironments": [],
   "allEnvironments":false
	},
   "globalPermissions":    [
            {
         "actionType": "UPDATE",
         "objectType": "APPROVAL"
      },
            {
         "actionType": "READ",
         "objectType": "NOTIFICATION"
      },
            {
         "actionType": "READ",
         "objectType": "SCHEDULEDTASK"
      },
            {
         "actionType": "READ",
         "objectType": "WORKFLOW"
      }
   ]
}

...

Code Block
themeEclipse
titleGroup - 10000
{
   "description": "This is a simple group with permissions.",
   "groupId": 10000,
   "groupName": "Simple Group",
   "isActive": true,
   "isFlexDeployAdministrator": false,
   "deploymentPermissions": {"environmentIdsenvironments": [],
   "allEnvironments":false
  	},
   "globalPermissions":    [
            {
         "actionType": "UPDATE",
         "objectType": "APPROVAL"
      },
            {
         "actionType": "READ",
         "objectType": "NOTIFICATION"
      },
            {
         "actionType": "READ",
         "objectType": "SCHEDULEDTASK"
      },
            {
         "actionType": "READ",
         "objectType": "WORKFLOW"
      }
   ]
}

...

Code Block
themeEclipse
titleGroup - 10000
{
   "description": "This is a simple group with no permissions.",
   "groupName": "Simple Group",
   "isActive": true,
   "isFlexDeployAdministrator": false,
   "deploymentPermissions": {"environmentIdsenvironments": [],
   "allEnvironments":false
	},
   "globalPermissions":    [
            {
         "actionType": "UPDATE",
         "objectType": "APPROVAL"
      },
            {
         "actionType": "READ",
         "objectType": "NOTIFICATION"
      },
            {
         "actionType": "READ",
         "objectType": "SCHEDULEDTASK"
      },
            {
         "actionType": "READ",
         "objectType": "WORKFLOW"
      }
   ]
}

...

Code Block
themeEclipse
titleEnvironment PUT Receive JSON
{
   "description": "This is an updated group.",
   "groupName": "Simple Group Put",
   "isActive": true,
   "isFlexDeployAdministrator": false,
   "deploymentPermissions": {"environmentIdsenvironments": [11001],
   "allEnvironments":false
	},
   "globalPermissions":    [
            {
         "actionType": "UPDATE",
         "objectType": "APPROVAL"
      },
            {
         "actionType": "READ",
         "objectType": "NOTIFICATION"
      }
   ]
}

...

Code Block
themeEclipse
titleGroup - 10000
{
   "description": "This is an updated group.",
   "groupName": "Simple Group Put",
   "isActive": true,
   "isFlexDeployAdministrator": false,
   "deploymentPermissions": {"environmentIdsenvironments": [11001],
   "allEnvironments":false
	},
   "globalPermissions":    [
            {
         "actionType": "UPDATE",
         "objectType": "APPROVAL"
      },
            {
         "actionType": "READ",
         "objectType": "NOTIFICATION"
      }
   ]
}

...

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}

...

Code Block
themeEclipse
titleGroup - 10000
{
   "description": "This is a simple group with no permissions.",
   "groupName": "Simple Group",
   "isActive": true,
   "isFlexDeployAdministrator": false,
   "deploymentPermissions": {"environmentIdsenvironments": [],
   "allEnvironments":false
	},
   "globalPermissions":    [
            {
         "actionType": "UPDATE",
         "objectType": "APPROVAL"
      },
            {
         "actionType": "READ",
         "objectType": "NOTIFICATION"
      },
            {
         "actionType": "READ",
         "objectType": "SCHEDULEDTASK"
      },
            {
         "actionType": "READ",
         "objectType": "WORKFLOW"
      }
   ]
}

...

Code Block
themeEclipse
titleGroup - 10000
{
   "description": "This is an patched group.",
   "groupName": "Simple Group Patch",
   "isActive": true,
   "isFlexDeployAdministrator": false,
   "deploymentPermissions": {"environmentIdsenvironments": [],
   "deployAllEnvironments":false
	},
   "globalPermissions":    [
            {
         "actionType": "UPDATE",
         "objectType": "APPROVAL"
      },
            {
         "actionType": "READ",
         "objectType": "NOTIFICATION"
      },
            {
         "actionType": "READ",
         "objectType": "SCHEDULEDTASK"
      },
            {
         "actionType": "READ",
         "objectType": "WORKFLOW"
      }
   ]
}

...