Property Key Definition API v2

Owned by Perepa Sai Sri Mukhi
Last updated: Sept 08, 2021
4 min read

Property Key Definitions can be accessed through this API using service: GET. This service allow for the retrieval of Property Key Definitions.

Authentication - Use Basic Authentication for this API.

GET

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

GET by ID

This GET service will find a Property Key Definitions with the given Id and return the JSON representation of the object.

API URL

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

Request

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

Response Codes

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

Example

If we have a Property Key Definition in our database with an Id of 11652 and the following attributes

When we run a GET request at the following URL

http://host:port/flexdeploy/rest/v2/administration/propertykeydefinition/11652

The GET request would return the following JSON Property Key Definition object

Property Key Definition GET Return JSON
{
    "length": null,
    "defaultValue": null,
    "displayName": "AWS Secret Key",
    "minValue": null,
    "maxValue": null,
    "isRequired": true,
    "description": "The secret key associated with your AWS account and endpoint.",
    "versionNumber": 1,
    "isActive": true,
    "createdOn": "2021-01-28T04:00:28.543+0000",
    "createdBy": "autoupload",
    "isCustom": false,
    "isMultiselect": false,
    "updatedOn": "2021-01-28T04:00:30.015+0000",
    "sortNumber": 2200,
    "isEncrypted": true,
    "updatedBy": "autoupload",
    "propertyDefinitionId": 11652,
    "propertyKeyName": "FDAWS_SECRET_KEY",
    "isAllowsVariant": false,
    "isDefaultExpression": false,
    "displayColumns": null,
    "validator1": null,
    "validator2": null,
    "validator4": null,
    "validator3": null,
    "validator5": null,
    "displayRows": null,
    "propertyScope": "ENVINST",
    "listData": null,
    "propertyKeyDatatype": "String",
    "propertyKeySubDatatype": null
}

GET by Query Parameters

This GET service will return a list of Property Key Definitions in the form of JSON objects based on the query parameters propertyDefinitionId,  propertyKeyName, displayName, propertyScope, description, isCustom, isMultiSelect, isAllowsVariant,  isDefaultExpression and isActive. Property Key Definitions 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 Property Key Definitions. The propertyKeyName parameter returns Property Key Definitions that contain the specified parameter. The other parameters must be equal to the Property Key Definitions.

API URL

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

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

propertyDefinitionId={propertyDefinitionId}

propertyKeyName={propertyKeyName}

isActive={isActive}

displayName={displayName}

propertyScope={propertyScope}

isCustom={isCustom}

description={description}

isAllowsVariant={isAllowsVariant}

isMultiSelect={isMultiSelect}

isDefaultExpression={isDefaultExpression}


Examples:
To Specify the code parameter only:

http://host:port/flexdeploy/rest/v2/administration/propertykeydefinition?propertyDefinitionId={propertyDefinitionId}

To Specify the code and group code parameters:

http://host:port/flexdeploy/rest/v2/administration/propertykeydefinition?propertyDefinitionId={propertyDefinitionId}&propertyKeyName={propertyKeyName}

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

http://host:port/flexdeploy/rest/v2/administration/propertykeydefinition?propertyDefinitionId={propertyDefinitionId}&propertyKeyName={propertyKeyName}&description={description}

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

Request

Parameter
Required
Type
Description
propertyDefinitionIdNoQuery - Long

This is a URL query parameter for the Property Definition Id which is used to search the Property Key Definitions.

Equals search

propertyKeyNameNoQuery - String

This is a URL query parameter for the Property Key Name which is used to search the Property Key Definitions.

Like ignore case search

descriptionNoQuery - String

This is a URL query parameter for the Description which is used to search the Property Key Definitions.

Equals ignore case search

displayNameNoQuery - String

This is a URL query parameter for the Display Name which is used to search the Property Key Definitions.

Equals search

isActiveNoQuery - Boolean

This is a URL query parameter for the Is Active which is used to search the Property Key Definitions.

Equals search

isCustomNoQuery - Boolean

This is a URL query parameter for the Is Custom which is used to search the Property Key Definitions.

Equals search

isAllowsVariantNoQuery - Boolean

This is a URL query parameter for the Is Allows Variant which is used to search the Property Key Definitions.

Equals search

isMultiSelectNoQuery - Boolean

This is a URL query parameter for the Is Multi Select which is used to search the Property Key Definitions.

Equals search

isDefaultExpressionNoQuery - Boolean

This is a URL query parameter for the Is Default Expression which is used to search the Property Key Definitions.

Equals search

propertyScopeNoQuery - String

This is a URL query parameter for the Property Scope which is used to search the Property Key Definitions.

Like ignore case search

Response Codes

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

Example

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

Sample JSON Output
[
    {
        "length": null,
        "defaultValue": null,
        "displayName": "Jira Port",
        "minValue": null,
        "maxValue": null,
        "isRequired": false,
        "description": "Jira Port",
        "versionNumber": 1,
        "isActive": false,
        "createdOn": "2021-01-22T04:54:46.538+0000",
        "createdBy": "autoupload",
        "isCustom": false,
        "isMultiselect": false,
        "updatedOn": "2021-01-22T04:54:46.591+0000",
        "sortNumber": 10,
        "isEncrypted": false,
        "updatedBy": "autoupload",
        "propertyDefinitionId": 10058,
        "propertyKeyName": "JIRA_PORT",
        "isAllowsVariant": false,
        "isDefaultExpression": false,
        "displayColumns": null,
        "validator1": null,
        "validator2": null,
        "validator4": null,
        "validator3": null,
        "validator5": null,
        "displayRows": null,
        "propertyScope": "INST",
        "listData": null,
        "propertyKeyDatatype": "Integer",
        "propertyKeySubDatatype": null
    }
]
The following macros are not currently supported in the footer:
  • style