/instance/list

Follow

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

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

message

string

error message

instance_list_response

Property

Type

Description

instances

array of instance

list of instances

instance

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

error

object of type error_response

error response

successful

boolean

always false

error_response

Property

Type

Description

message

string

error message

{
    "error": {
        "message": "string"
    },
    "successful": false
}
Have more questions? Submit a request

Comments