deliveryservices/{{ID}}/servers/eligible

Caution

This endpoint may not work as advertised, and its use is therefore discouraged!

GET

Retrieves properties of Edge-tier cache servers eligible for assignment to a particular Delivery Service. Eligibility is determined based on the following properties:

Auth. Required:

Yes

Roles Required:

None

Permissions Required:

DELIVERY-SERVICE:READ, SERVER:READ, CACHE-GROUP:READ, TYPE:READ, CDN:READ

Response Type:

Array

Request Structure

Table 505 Request Path Parameters

Name

Description

ID

The integral, unique identifier of the Delivery service for which servers will be displayed

Response Structure

cachegroup:

A string which is the Name of the Cache Group to which the server belongs

cachegroupId:

An integer that is the ID of the Cache Group to which the server belongs

cdnId:

An integral, unique identifier the CDN to which the server belongs

cdnName:

The name of the CDN to which the server belongs

domainName:

The domain name part of the FQDN of the server

guid:

Optionally represents an identifier used to uniquely identify the server

hostName:

The (short) hostname of the server

httpsPort:

The port on which the server listens for incoming HTTPS requests - 443 in most cases

id:

An integral, unique identifier for the server

iloIpAddress:

The IPv4 address of the lights-out-management port[1]

iloIpGateway:

The IPv4 gateway address of the lights-out-management port[1]

iloIpNetmask:

The IPv4 subnet mask of the lights-out-management port[1]

iloPassword:

The password of the of the lights-out-management user - displays as ****** unless the requesting user has the ‘admin’ role)[1]

iloUsername:

The user name for lights-out-management[1]

interfaces:

An array of interface and IP address information

max_bandwidth:

The maximum allowed bandwidth for this interface to be considered “healthy” by Traffic Monitor. This has no effect if monitor is not true. Values are in kb/s. The value null means “no limit”.

monitor:

A boolean indicating if Traffic Monitor should monitor this interface

mtu:

The MTU to configure for interfaceName

name:

The network interface name used by the server.

ipAddresses:

An array of the IP address information for the interface

address:

The IPv4 or IPv6 address and subnet mask of the server - applicable for the interface name

gateway:

The IPv4 or IPv6 gateway address of the server - applicable for the interface name

service_address:

A boolean determining if content will be routed to the IP address

lastUpdated:

The time and date at which this server was last updated, in RFC 3339 format

Changed in version 5.0: Prior to version 5.0 of the API, this field was in Traffic Ops’s Custom Date/Time Format.

mgmtIpAddress:

The IPv4 address of the server’s management port

mgmtIpGateway:

The IPv4 gateway of the server’s management port

mgmtIpNetmask:

The IPv4 subnet mask of the server’s management port

offlineReason:

A user-entered reason why the server is in ADMIN_DOWN or OFFLINE status (will be empty if not offline)

physLocation:

The name of the Physical Location at which the server resides

physLocationId:

An integral, unique identifier for the Physical Location at which the server resides

profile:

The Name of the Profile assigned to this server

profileDesc:

A Description of the Profile assigned to this server

profileId:

The ID of the Profile assigned to this server

rack:

A string indicating “rack” location

routerHostName:

The human-readable name of the router

routerPortName:

The human-readable name of the router port

status:

The Status of the server

See also

Health Protocol

statusId:

An integral, unique identifier for the status of the server

See also

Health Protocol

tcpPort:

The default port on which the main application listens for incoming TCP connections - 80 in most cases

type:

The name of the Type of this server

typeId:

An integral, unique identifier for the Type of this server

updPending:

true if the server has updates pending, false otherwise

#1246 Response Example
{ "response": [
    {
        "cachegroup": "CDN_in_a_Box_Edge",
        "cachegroupId": 7,
        "cdnId": 2,
        "cdnName": "CDN-in-a-Box",
        "domainName": "infra.ciab.test",
        "guid": null,
        "hostName": "edge",
        "httpsPort": 443,
        "id": 10,
        "iloIpAddress": "",
        "iloIpGateway": "",
        "iloIpNetmask": "",
        "iloPassword": "",
        "iloUsername": "",
        "lastUpdated": "2018-10-30T15:18:14.952814+05:30",
        "mgmtIpAddress": "",
        "mgmtIpGateway": "",
        "mgmtIpNetmask": "",
        "offlineReason": "",
        "physLocation": "Apachecon North America 2018",
        "physLocationId": 1,
        "profile": "ATS_EDGE_TIER_CACHE",
        "profileDesc": "Edge Cache - Apache Traffic Server",
        "profileId": 9,
        "rack": "",
        "routerHostName": "",
        "routerPortName": "",
        "status": "REPORTED",
        "statusId": 3,
        "tcpPort": 80,
        "type": "EDGE",
        "typeId": 11,
        "updPending": false,
        "interfaces": [{
            "ipAddresses": [
                {
                    "address": "172.16.239.100",
                    "gateway": "172.16.239.1",
                    "service_address": true
                },
                {
                    "address": "fc01:9400:1000:8::100",
                    "gateway": "fc01:9400:1000:8::1",
                    "service_address": true
                }
            ],
            "max_bandwidth": 0,
            "monitor": true,
            "mtu": 1500,
            "name": "eth0"
        }]
    }
]}