...

Resource Types can be accessed through this API using GET, POST, PUT and PATCH. This service retrieves information about resource types.

Table of Contents

maxLevel	2

GET

GET by ID

This GET service will find a resource type with the given Id and return the JSON representation of the object.

Info

title	Base API URL for Resource Types REST API

http://host:port/flexdeploy/rest/v1/administration/resourcetypes

Table of Contents

maxLevel	2

...

/{Id}

Request

Parameter	Type	Required	Description
Id	URL	Yes	This is a URL parameter for the Id which is used to find and return a resource type

Response

Attributes	Type	Description
description	String	The description of the resource type.
resourceTypeId	Long	The unique Id of the resource type.
resourceTypeName	String	The unique name of the resource type.
isActive	Boolean	The boolean representing whether the resource type is active.

Back to Top

GET

GET by ID

This GET service will find a resource type with the given Id and return the JSON representation of the object.

Info

title	API URL

http://host:port/flexdeploy/rest/administration/resourcetypes/{Id}

Parameters

Parameter

Type

Required

Description

Id

URLYesThis is a URL parameter for the Id which is used to find and return a resource type

If isActive is updated to null it will default to true.

Response Codes

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

Example

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

...

When we run a GET request at the following URL

http://host:port/flexdeploy/rest/v1/administration/resourcetypesresourcetypes/10000

The GET request would return the following JSON rseource type object

Code Block

theme	Eclipse
title	Resource Type - 10000

{
    "resourceTypeName": "Oracle Forms and Reports Server",
    "resourceTypeId": 10000,
    "isActive": true,
    "description": null
}

Back to Top

GET (Using Query Parameters)

This GET service will return a list of resource types in the form of JSON objects based on a query parameter for the display name. Resource Types are only returned if they contain the specified parameter. If no query parameters are given this request will return the entire list of resource types.

Info

title	API URLs

http://host:port/flexdeploy/rest/v1/administration/resourcetypes?

Append the following character sequences to the above URL to specify Query parameters.

resourceTypeName={resourceTypeName}

Examples:

To return all of the resource types:

http://host:port/flexdeploy/rest/v1/administration/resourcetypes

To search by name only:

http://host:port/flexdeploy/rest/v1/administration/resourcetypes?resourceTypeName={resourceTypeName}

...

Tip
The query parameters are not case sensitive. Searching by name=EXAMPLE is the same as searching by name=example.

...

Request

Parameter	Type	Required	Description
resourceTypeName

URL

Query - String

No

This is a URL query parameter for the name which is used to search the resource types.

Contains ignore case type search.

Response

Attributes	Type	Description
description	String	The description of the resource type.
resourceTypeId	Long	The unique Id of the resource type.

Example

...

resourceTypeName	String	The unique name of the resource type.
isActive	Boolean	The boolean representing whether the resource type is active. If isActive is updated to null it will default to true.

Response Codes

HTTP Code	Description
200	Search successful and results returned
400	Bad request
401	Authentication failure
403	Authorization failure (no access to resource)
500	Unexpected internal server error

Example

If there are resource types in the database with the following attributes:

Code Block

theme	Eclipse
title	Resource Type

[
{
    "resourceTypeName": "Oracle Forms and Reports Server",
    "resourceTypeId": 24400,
    "isActive": true,
    "description": null
},
{
    "resourceTypeName": "EBS Forms Service",
    "resourceTypeId": 19182,
    "isActive": true,
    "description": null
}
]

...

http://host:port/flexdeploy/rest/v1/administration/resourcetypes?resourceTypeName=forms

The GET request would return the the following JSON resource type object

Code Block

theme	Eclipse
title	Resource Type

[
{
    "resourceTypeName": "Oracle Forms and Reports Server",
    "resourceTypeId": 24400,
    "isActive": true,
    "description": null
},
{
    "resourceTypeName": "EBS Forms Service",
    "resourceTypeId": 19182,
    "isActive": true,
    "description": null
}
]

Back to Top

POST

This POST service will create a new resource type with the same attributes as the given JSON object.

Info

title	API URL

http://host:port/flexdeploy/rest/v1/administration/resourcetypes

...

Request

Attributes	Type	Required	Description
description	String	No	The description of the resource type.
resourceTypeId	Long	No	The unique Id of the resource type.
resourceTypeName	String	Yes	The unique name of the resource type.
isActive	Boolean	No	The boolean representing whether the resource type is active. If isActive is set to null it will default to true.

Response

Attributes	Type	Description
description	String	The description of the resource type.
resourceTypeId	Long	The unique Id of the resource type.
resourceTypeName	String	The unique name of the resource type.
isActive	Boolean	The boolean representing whether the resource type is active. If isActive is updated to null it will default to true.

Response Codes

HTTP Code	Description
201	Resource type created
400	Bad request
401	Authentication failure
403	Authorization failure (no access to resource)
500	Unexpected internal server error

Example

If the POST request receives the following JSON resource type object,

...

Code Block

theme	Eclipse
title	Resource Type - 10000

{
    "resourceTypeName": "Oracle Forms and Reports Server",
    "resourceTypeId": 24400,
    "isActive": true,
    "description": null
}

Back to Top

PUT

This PUT service will update all attributes of a resource type with the given Id based on the attributes of a JSON object parameters.

Info

title	API URL

http://host:port/flexdeploy/rest/v1/administration/resourcetypes/{Id}

...

Request

Attributes	Type	Required	Description
description	String	No	The description of the resource type.
resourceTyped	Long	No	The unique Id of the resource type.
resourceTypeName	String	Yes	The unique name of the resource type.
isActive	Boolean	No	The boolean representing whether the resource type is active. If isActive is updated to null it will default to true.

Response

Attributes	Type	Description
description	String	The description of the resource type.
resourceTypeId	Long	The unique Id of the resource type.
resourceTypeName	String	The unique name of the resource type.
isActive	Boolean	The boolean representing whether the resource type is active. If isActive is updated to null it will default to true.

Response Codes

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

Example

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

...

http://host:port/flexdeploy/rest/v1/administration/resourcetypes/10000

...

The PUT request would then update the resource type with Id 10000 and return the the following JSON resource type object

Code Block

theme	Eclipse
title	Resource Type - 10000

{
    "resourceTypeName": "Oracle Forms and Reports Server Updated",
    "resourceTypeId": 10000,
    "isActive": false,
    "description": "Updated Resource type"
}

...

PATCH

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

Info

title	API URL

http://host:port/flexdeploy/rest/v1/administration/resourcetypes/{Id}

...

Request

Attributes	Type	Required	Description
description	String	No	The description of the resource type.
resourceTypeId	Long	No	The unique Id of the resource type.
resourceTypeName	String	No	The unique name of the resource type.
isActive	Boolean	No	The boolean representing whether the resource type is active.

Response

Attributes	Type	Description
description	String	The description of the resource type.
resourceTypeId	Long	The unique Id of the resource type.
resourceTypeName	String	The unique name of the resource type.
isActive	Boolean	The boolean representing whether the resource type is active. If isActive is updated to null it will default to true.

Response Codes

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

Example

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

...

http://host:port/flexdeploy/rest/v1/administration/resourcetypes/10000

...

Code Block

theme	Eclipse
title	Resource Type - 10000

{
    "resourceTypeName": "Oracle Forms and Reports Server Patched",
    "resourceTypeId": 10000,
    "isActive": true,
    "description": null
}

...

Versions Compared

Old Version 14

New Version Current

Key

GET

GET by ID

Request

Response

GET

GET by ID

Parameters

Response Codes

Example

GET (Using Query Parameters)

Append the following character sequences to the above URL to specify Query parameters.

Examples:

To return all of the resource types:

To search by name only:

Request

Response

Example

Response Codes

Example

POST

Request

Response

Response Codes

Example

PUT

Request

Response

Response Codes

Example

PATCH

Request

Response

Response Codes

Example

Page Comparison

Versions Compared

Old Version 14

New Version Current

Key

GET

GET by ID

Request

Response

GET

GET by ID

Parameters

Response Codes

Example

GET (Using Query Parameters)

Append the following character sequences to the above URL to specify Query parameters.

Examples:

To return all of the resource types:

To search by name only:

Request

Response

Example

Response Codes

Example

POST

Request

Response

Response Codes

Example

PUT

Request

Response

Response Codes

Example

PATCH

Request

Response

Response Codes

Example