/
/instance/show

/instance/show

Show details for an instance

Request

HTTP Method: POST
Content Type: application/json

Parameters

Property

Type

Description

Required

Property

Type

Description

Required

host

string

host of instance to show

required

instance

string

name of instance to show

port

integer

port of instance to show (non-negative)

{ "params": { "host": "string", "instance": "string", "port": 123 } }

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

SQL Server instance details

successful

boolean

response with error or not

error_response

Property

Type

Description

Property

Type

Description

message

string

error message

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": { "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 }