Versions Compared

Key

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

Available from 5.6.0.1

...

Request

Parameter
Required
Type
Description
IdYesURLURL parameter for the Id which is used to find and return a Resource Type

Response Codes

HTTP Code
Description
200Resource Type was found and returned
400Bad request
401Authentication failure
403Authorization failure (no access to resource)
404Resource Type not found
500Unexpected internal server error

Example

If we a Resource Type in our database with an Id of 20408 and the following attributes

When we run a GET request at the following URL

http://host:port/flexdeploy/rest/v2/administration/resourcetype/2040520408

The GET request would return the following JSON Resource Type object

Code Block
themeEclipse
titleResource type GET Return JSON
{
    "description": "Postman test data1",
    "ownerType": "Workflow",
    "resourceTypeName": "Postman Resource Type Test REST 1",
    "isActive": true,
    "createdOn": 1629882360332,
    "versionNumber": 1,
    "createdBy": "fdadmin",
    "resourceTypeId": 20408,
    "updatedBy": "fdadmin",
    "updatedOn": 1629882360332
}

GET by Query Parameters

...

Info
titleAPI URL

http://host:port/flexdeploy/rest/v2/administration/resourcetype?

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

resourceTypeId={resourceTypeId}

resourceTypeName={resourceTypeName}

isActive={isActive}

ownerType={ownerType}

Examples:
To Specify the code parameter only:

http://host:port/flexdeploy/rest/v2/administration/resourcetype?resourceTypeId={resourceTypeId}

To Specify the code and group code parameters:

http://host:port/flexdeploy/rest/v2/resourcetype?resourceTypeId={resourceTypeId}&resourceTypeName={resourceTypeName}

To Specify the name, group code, and sub group code parameters:

http://host:port/flexdeploy/rest/v2/resourcetype?resourceTypeId={resourceTypeId}&resourceTypeName={resourceTypeName}&ownerType={ownerType}


Tip

The query parameters are not case sensitive. Searching by resourceTypeName=NAME is the same as searching by resourceTypeName=name.

...

Output when querying by isActive through http://host:port/flexdeploy/rest/v2/administration/resourcetype?isActive=false

Code Block
titleSample JSON Output
[
    {
        "description": "Postman test data 1 updated",
        "ownerType": null,
        "resourceTypeName": "Postman Resource Type Test REST 1 updated1",
        "isActive": false,
        "createdOn": 1629882360332,
        "versionNumber": 1,
        "createdBy": "fdadmin",
        "resourceTypeId": 20408,
        "updatedBy": "fdadmin",
        "updatedOn": 1629883055449
    }
]

...

Info
titleAPI URL

http://host:port/flexdeploy/rest/v2/administration/security/resourcetype

Request

Attributes
Type
Required
Description
resourceTypeNameStringYesName of Resource Type
isActiveBooleanNo

Whether or not this Resource Type is active.

descriptionStringNo

Description of the Resource Type.

ownerTypeStringNo
Owner Type value of the Resource Type.

...

Code Block
titleSample JSON Input
{
    "description": "Postman test data1",
    "ownerType": "Workflow",
    "isActive": true,
    "resourceTypeName": "Postman Resource Type Test REST 1",
}

the following Resource Type will be created in the database. Notice the updated Resource Type Id field.

...

Info
titleAPI URL

http://host:port/flexdeploy/rest/v2/administration/resourcetype/{Id}

Request

Attributes
Type
Required
Description
IdURLYesURL parameter for the Id which is used to find and update a Resource Type.
resourceTypeNameStringYesName of Resource Type.
isActiveBooleanNo

Whether or not this Resource Type is active.

Defaults to true if nothing is passed.

ownerTypeStringNo

Owner Type value of the Resource Type.

Response Codes

HTTP Code
Description
200Resource Type was found and updated
400Bad request
401Authentication failure
403Authorization failure (no access to resource)
404Resource Type not found
500Unexpected internal server error

Example

If we had an Resource Type in our database with an Id of 20408 and had the following attributes

Code Block
titleCurrent Resource Type
{
    "description": "Postman test data1",
    "ownerType": "Workflow",
    "resourceTypeName": "Postman Resource Type Test REST 1",
    "isActive": true,
    "createdOn": 1629882360332,
    "versionNumber": 1,
    "createdBy": "fdadmin",
    "resourceTypeId": 20408,
    "updatedBy": "fdadmin",
    "updatedOn": 1629882360332
}

When we run a PUT request at the following URL

http://host:port/flexdeploy/rest/v2/administration/resourcetype/20408

And the PUT request receives the following JSON Resource Type object,

Code Block
titleSample JSON Input
{
    "description": "Postman test data 1 updated",
	"ownerType": "",
	"isActive":false,
	"resourceTypeName": "Postman Resource Type Test REST 1 updated"
}

The PUT request would then update the Resource Type with Id 20408 and return the following JSON Resource Type object.

Code Block
titleSample JSON Output
{
    "description": "Postman test data 1 updated",
    "ownerType": "",
    "resourceTypeName": "Postman Resource Type Test REST 1 updated",
    "isActive": false,
    "createdOn": 1629882360332,
    "versionNumber": 2,
    "createdBy": "fdadmin",
    "resourceTypeId": 20408,
    "updatedBy": "fdadmin",
    "updatedOn": 1629882746226
}

PATCH

...