/instance/list

List linked instances

Request

HTTP Method: POST
Content Type: application/json

Parameters

None.

{ "params": {} }

Response

HTTP Status: 200

Content Type: application/json

Response

Property

Type

Description

Property

Type

Description

error

object of type error_response

error response

result

object of type instance_list_response

instance/list response

successful

boolean

response with error or not

error_response

Property

Type

Description

Property

Type

Description

message

string

error message

instance_list_response

Property

Type

Description

Property

Type

Description

instances

array of instance

list of instances

instance

Property

Type

Description

Property

Type

Description

authentication_type

string

authentication type (possible values: 'SQL' and 'WIN')

host

string

host running instance

instance_name

string

name of instance

last_attempt_time

string(date-time)

last connection attempt time in UTC

port

integer

port number of instance

reason

string

reason for unconnected instance

state

string

instance running state (possible values: 'Unknown', 'Connected', 'Disconnected' and 'Disabled')

total_attempts

integer

total connection attempts

username

string

user name for authentication to instance

{ "error": { "message": "string" }, "result": { "instances": [ { "authentication_type": "SQL", "host": "string", "instance_name": "string", "last_attempt_time": "2024-07-31T13:57:42.000123456Z", "port": 123, "reason": "string", "state": "Unknown", "total_attempts": 123, "username": "string" } ] }, "successful": true }

HTTP Status: 400

Content Type: application/json

Response

Property

Type

Description

Property

Type

Description

error

object of type error_response

error response

successful

boolean

always false

error_response

Property

Type

Description

Property

Type

Description

message

string

error message

{ "error": { "message": "string" }, "successful": false }