Versions Compared

Key

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

Anchor
Top
Top

...

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


AttributesTypeDescription
descriptionStringThis is a description of the Endpoint.
connectionTypeString

This specifies the connection Type.

MANDATORY: "SSH" or "LOCALHOST"

isActiveBooleanThis is a Boolean that tracks whether or not the Endpoint is active. 
endpointAddressStringThis is a String associated with the address of the endpoint.
endpointPortString

This is a port associated with an SSH connection.

DEPENDENT: Mandatory when connectionType is "SSH", otherwise not used.

endpointIdLongThis is a number associated with the identification number of an existing Endpoint.
passwordString

This is a character sequence used to access the corresponding remote connection.

DEPENDENT: mandatory  Optional when connectionType is "SSH" otherwise not used.

endpointNameString

This is the unique name of the corresponding Endpoint.

UNIQUE

privateKeyString

This is a character sequence associated with the corresponding remote connection.

DEPENDENT: Mandatory Optional when connectionType is "SSH" otherwise not used.

osTypeString

This is a character sequence which corresponds to the operating system type used in the corresponding remote connection.

DEPENDENT: Mandatory when connectionType is "SSH" otherwise not used.

baseDirectoryString

This is a character sequence which corresponds to the base directory of the corresponding Endpoint.

MANDATORY

endpointSubgroupStringThis is a character sequence associated with this Endpoint's corresponding sub-group.
passphraseString

This is a character sequence associated with the correspond remote connection.

DEPENDENT: Mandatory Optional when connectionType is "SSH" otherwise not used.

javaPathString

This is a character sequence that specifies the java path of the corresponding Endpoint.

MANDATORY

runAsUserNameString

This is a character sequence that specifies the runAsUserName variable.

Dependent: Mandatory when connection Type is "SSH" otherwise not used.

Back to Top

...

GET (Using Query Parameters)

This GET service will return a list of Endpoints in the form of JSON objects based on the query parameters name, address, group and subgroup. Endpoints 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 Endpoints.

Info
titleAPI URL

http://host:port/flexdeploy/rest/v1/topology/endpoint?

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

endpointName={name}

endpointAddress={address}

endpointGroup={group}

endpointSubgroup={subgroup}

Examples:
To Specify the name parameter only:

http://host:port/flexdeploy/rest/v1/topology/endpoint?endpointName={name}

To Specify the name and group parameters:

http://host:port/flexdeploy/rest/v1/topology/endpoint?endpointName={name}&endpointGroup={group}

To Specify the name, address and group parameters:

http://host:port/flexdeploy/rest/v1/topology/endpoint?endpointName={name}&endpointAddress={address}&endpointGroup={group}

...

Back to Top


Anchor
PATCH
PATCH

PATCH

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


Info
titleAPI URL

http://host:port/flexdeploy/rest/v1/topology/endpoint/{Id}

...