/api/v1/fleetInstances/{id} (GET)

Returns information about a specific Fleet Service Point that has been registered based on the ID of the Fleet Service Point.

Request: GET https://us.fleet.bluec.at/user/api/v1/fleetInstances/{id}
Authorization: Bearer token

Path parameter

Name	Description	Type	Required/Optional
id	The Fleet Service Point ID	Integer	Required

Successful response

200 OK
{
    "applications": [
        {
            "id": "12345678-ab12-3c4d-e5fa-593bb8bd604c",
            "name": "dns-resolver-service",
            "status": "HEALTHY",
            "version": "3.5.4"
        }
    ],
    "connectionStatus": "CONNECTED",
    "errorConditions": [],
    "httpProxySettings": {
        "host": "",
        "port": "",
        "scheme": "https",
        "user": ""
    },
    "id": "test_fsp_1-a9kf321st-abc2bcnab5pq",
    "lastSeen": 1660667769314,
    "name": "test_fsp_1",
    "nodes": [
        {
            "addresses": [
                {
                    "ipAddress": "1.2.3.4",
                    "type": "primary"
                }
             ],
             "dnsServers": [
                 "1.2.3.10",
                 "1.2.3.11",
                 "1.2.3.12"
             ],
             "hostname": "testfsp1",
             "ipv4CIDRAddress": "1.2.3.22/24",
             "ipv4GatewayAddress": "1.2.3.1",
             "ipv6CIDRAddress": "",
             "ipv6GatewayAddress": "",
             "name": "testfsp1.testlab.net"
        }
    ],
    "status": "HEALTHY",
    "updateStatus": "OK",
    "version": "4.1.1"
}

Where the fields represent the following:

id—the unique ID of the Fleet Service Point
name—the name of the Fleet Service Point
description—the description of the Fleet Service Point
status—the status of the Fleet Service Point. The status can be one of the following:
- WAITING_FOR_PROVISIONING
- HEALTHY
- UNHEALTHY
- EXPIRED
lastSeen—a timestamp representing the last time the management layer received a status update from the Fleet Service Point. If no timestamp is recorded, the value of this field is 0. The format of the field in a Unix timestamp in milliseconds elapsed since January 1, 1970 (UTC).
connectionStatus—the connection status of the Fleet Service Point. The value can be one of the following:
- CONNECTED
- NOT_CONNECTED
version—the version of the Fleet Service Point software that is currently running on the Fleet Service Point.
targetVersion—the version of the Fleet Service Point software to which the Fleet Service Point is to be updated.
updateStatus—the last reported status of the Fleet Service Point update. The status can be one of the following:
- OK
- UPDATE_QUEUED
- UPDATE_RUNNING
- UPDATE_FAILED
errorConditions—a list of error conditions if the Fleet Service Point is not healthy
nodes—nodes that are part of the Fleet Service Point. The nodes section includes the following information:
- id—the unique ID of the node
- name—the name of the node
- hostname—the hostname of the node
- ipv4CIDRAddress—the IPv4 CIDR address of the Fleet Service Point node
- ipv4GatewayAddress—the IPv4 gateway address of the Fleet Service Point node
- ipv6CIDRAddress—the IPv6 CIDR address of the Fleet Service Point node
- ipv6GatewayAddress—the IPv6 gateway address of the Fleet Service Point node
- dnsServers—a list of DNS servers used by the Fleet Service Point
- addresses—a list of IP addresses. The list of IP addresses includes the following information:
  - type—the type of IP address. The type can be one of the following:
    - PRIMARY
    - ANYCAST
    - ALIAS
  - ipAddress—the IPv4 or IPv6 address
  - isUseByAppId—the ID of the application using the Anycast IP address. This field is only included if the type is ANYCAST.
  - isUp—indicates whether the Anycast IP address is up. This field is only included if the type is ANYCAST.
applications—the applications deployed to the Fleet Service Point. The applications field includes the following information:
- id—the unique ID of application
- name—the name of the application
- version—the version of the application
- status—the status of the application. The status can be one of the following:
  - HEALTHY
  - UNHEALTHY
  - DEPLOYING
  - DEPLOY_FAILED
  - DELETED
- errorConditions—a list of error conditions if the application is not healthy
- targetVersion—the version of the application software to which the application is to be updated
- updateStatus—the last reported status of the application update. The status can be one of the following:
  - UPDATE_QUEUED
  - UPDATE_IN_PROGRESS
  - DELETE_QUEUED
  - DELETE_IN_PROGRESS
httpProxySettings—the HTTP proxy settings configured for the Fleet Service Point. The HTTP proxy settings include the following information:
- host—the HTTP proxy hostname
- scheme—the HTTP proxy URL scheme. The default value is HTTP
- port—the HTTP proxy port
- user—the HTTP proxy username used for authentication
anycastIPAddress—a list of Anycast IP addresses. The list includes the following information:
- ipAddress—the IPv4 or IPv6 address
- isUseByAppId—the ID of the application using the Anycast IP address
- isUp—indicates whether the Anycast IP address is up

Possible error codes

401 Unauthorized
500 Internal Server Error

/api/v1/fleetInstances/{id} (GET) - BlueCat DNS Edge

DNS Edge User Guide (Fleet Service Point)