List Service Instances
GET/registry-svc/instances
Retrieves a list of all instances or filters them by specific criteria (e.g., host, IP).
Request
Query Parameters
Scheme to filter by
IP to filter by
Deployment ID to filter by
Host to filter by
IP to filter by
Id to filter by
Responses
- 200
- 400
- 500
OK
- application/json
- Schema
- Example (from schema)
Schema
Array [
]
instances
object[]
The ID of the deployment that this instance is an instance of.
Details
Host of the instance address. Required if URL is not provided
Required: ID of the instance
IP of the instance address. Optional: to register by IP instead of host
Last time the instance gave a sign of life
URL of the Singulatron daemon
Path of the instance address. Optional (e.g., "/api")
Port of the instance address. Required if URL is not provided
Scheme of the instance address. Required if URL is not provided.
Possible values: [Unknown
, Healthy
, Degraded
, Unreachable
, Error
]
Full address URL of the instance.
{
"instances": [
{
"deploymentId": "depl_deBUCtJirc",
"details": "Instance is healthy",
"host": "myserver.com",
"id": "inst_di9riJEvH2",
"ip": "8.8.8.8",
"lastHeartbeat": "string",
"nodeUrl": "https://myserver.com:58231",
"path": "/your-svc",
"port": 8080,
"scheme": "https",
"status": "Unknown",
"url": "https://myserver.com:5981"
}
]
}
Invalid filters
- application/json
- Schema
- Example (from schema)
Schema
{
"error": "string"
}
Internal Server Error
- application/json
- Schema
- Example (from schema)
Schema
{
"error": "string"
}