servers/{{ID}}
PUT
Allow user to edit a server.
- Auth. Required
Yes
- Roles Required
“admin” or “operations”
- Response Type
Object
Request Structure
Name |
Description |
---|---|
ID |
The integral, unique identifier of a server |
- cachegroupId
An integer that is the ID of the Cache Group to which the server shall belong
- cdnId
The integral, unique identifier of the CDN to which the server shall belong
- domainName
The domain part of the server’s FQDN
- hostName
The (short) hostname of the server
- httpsPort
An optional port number on which the server listens for incoming HTTPS connections/requests
- iloIpAddress
An optional IPv4 address of the server’s ILO service1
- iloIpGateway
An optional IPv4 gateway address of the server’s ILO service1
- iloIpNetmask
An optional IPv4 subnet mask of the server’s ILO service1
- iloPassword
An optional string containing the password of the of the server’s ILO service user1 - displays as simply
******
if the currently logged-in user does not have the ‘admin’ or ‘operations’ Role(s) <Role>- iloUsername
An optional string containing the user name for the server’s ILO service1
- interfaceMtu
The MTU configured on
interfaceName
Note
In virtually all cases this ought to be 1500. Further note that the only acceptable values are 1500 and 9000.
- interfaceName
The name of the primary network interface used by the server
- ip6Address
An optional IPv6 address and subnet mask of
interfaceName
- ip6IsService
An optional boolean value which if
true
indicates that the IPv6 address will be used for routing content. Defaults totrue
.- ip6Gateway
An optional IPv6 address of the gateway used by
interfaceName
- ipAddress
The IPv4 address of
interfaceName
- ipIsService
An optional boolean value which if
true
indicates that the IPv4 address will be used for routing content. Defaults totrue
.- ipGateway
The IPv4 address of the gateway used by
interfaceName
- ipNetmask
The IPv4 subnet mask used by
interfaceName
- mgmtIpAddress
An optional IPv4 address of some network interface on the server used for ‘management’
- mgmtIpGateway
An optional IPv4 address of a gateway used by some network interface on the server used for ‘management’
- mgmtIpNetmask
An optional IPv4 subnet mask used by some network interface on the server used for ‘management’
- physLocationId
An integral, unique identifier for the physical location where the server resides
- profileId
- revalPending
A boolean value which, if
true
indicates that this server has pending content invalidation/revalidation- rack
An optional string indicating “server rack” location
- routerHostName
An optional string containing the human-readable name of the router responsible for reaching this server
- routerPortName
An optional string containing the human-readable name of the port used by the router responsible for reaching this server
- statusId
The integral, unique identifier of the status of this server
See also
- tcpPort
An optional port number on which this server listens for incoming TCP connections
Note
This is typically thought of as synonymous with “HTTP port”, as the port specified by
httpsPort
may also be used for incoming TCP connections.- typeId
The integral, unique identifier of the ‘type’ of this server
- updPending
A boolean value which, if
true
, indicates that the server has updates of some kind pending, typically to be acted upon by Traffic Ops ORT- xmppId
A system-generated UUID used to generate a server hashId for use in Traffic Router’s consistent hashing algorithm. This value is set when a server is created and cannot be changed afterwards.
- xmppPasswd
An optional password used in XMPP communications with the server
PUT /api/2.0/servers/13 HTTP/1.1
Host: trafficops.infra.ciab.test
User-Agent: curl/7.47.0
Accept: */*
Cookie: mojolicious=...
Content-Length: 599
Content-Type: application/json
{
"cachegroupId": 6,
"cdnId": 2,
"domainName": "infra.ciab.test",
"hostName": "quest",
"httpsPort": 443,
"iloIpAddress": "",
"iloIpGateway": "",
"iloIpNetmask": "",
"iloPassword": "",
"iloUsername": "",
"interfaceMtu": 1500,
"interfaceName": "eth0",
"ip6Address": "::1",
"ip6Gateway": "::2",
"ipAddress": "0.0.0.1",
"ipGateway": "0.0.0.2",
"ipNetmask": "255.255.255.0",
"mgmtIpAddress": "",
"mgmtIpGateway": "",
"mgmtIpNetmask": "",
"offlineReason": "",
"physLocationId": 1,
"profileId": 10,
"routerHostName": "",
"routerPortName": "",
"statusId": 3,
"tcpPort": 80,
"typeId": 12,
"updPending": true,
"ipIsService": true,
"ip6IsService": true
}
Response Structure
- cachegroup
A string that 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
The integral, unique identifier of the CDN to which the server belongs
- cdnName
Name of the CDN to which the server belongs
- domainName
The domain part of the server’s FQDN
- guid
An identifier used to uniquely identify the server
Note
This is a legacy key which only still exists for compatibility reasons - it should always be
null
- hostName
The (short) hostname of the server
- httpsPort
The port on which the server listens for incoming HTTPS connections/requests
- id
An integral, unique identifier for this server
- iloIpAddress
The IPv4 address of the server’s Integrated Lights-Out (ILO) service1
- iloIpGateway
The IPv4 gateway address of the server’s ILO service1
- iloIpNetmask
The IPv4 subnet mask of the server’s ILO service1
- iloPassword
The password of the of the server’s ILO service user1 - displays as simply
******
if the currently logged-in user does not have the ‘admin’ or ‘operations’ role(s)- iloUsername
The user name for the server’s ILO service1
- interfaceMtu
The Maximum Transmission Unit (MTU) to configured on
interfaceName
- interfaceName
The name of the primary network interface used by the server
- ip6Address
The IPv6 address and subnet mask of
interfaceName
- ip6IsService
A boolean value which if
true
indicates that the IPv6 address will be used for routing content.- ip6Gateway
The IPv6 address of the gateway used by
interfaceName
- ipAddress
The IPv4 address of
interfaceName
- ipIsService
A boolean value which if
true
indicates that the IPv4 address will be used for routing content.- ipGateway
The IPv4 address of the gateway used by
interfaceName
- ipNetmask
The IPv4 subnet mask used by
interfaceName
- lastUpdated
The date and time at which this server description was last modified
- mgmtIpAddress
The IPv4 address of some network interface on the server used for ‘management’
- mgmtIpGateway
The IPv4 address of a gateway used by some network interface on the server used for ‘management’
- mgmtIpNetmask
The IPv4 subnet mask used by some network interface on the server used for ‘management’
- offlineReason
A user-entered reason why the server is in ADMIN_DOWN or OFFLINE status
- physLocation
The name of the physical location where the server resides
- physLocationId
An integral, unique identifier for the physical location where the server resides
- profile
- profileDesc
A Description of the Profile used by this server
- profileId
- revalPending
A boolean value which, if
true
indicates that this server has pending content invalidation/revalidation- rack
A string indicating “server rack” location
- routerHostName
The human-readable name of the router responsible for reaching this server
- routerPortName
The human-readable name of the port used by the router responsible for reaching this server
- status
The status of the server
See also
- statusId
The integral, unique identifier of the status of this server
See also
- tcpPort
The port on which this server listens for incoming TCP connections
Note
This is typically thought of as synonymous with “HTTP port”, as the port specified by
httpsPort
may also be used for incoming TCP connections.- type
The name of the ‘type’ of this server
- typeId
The integral, unique identifier of the ‘type’ of this server
- updPending
A boolean value which, if
true
, indicates that the server has updates of some kind pending, typically to be acted upon by Traffic Ops ORT- xmppId
A system-generated UUID used to generate a server hashId for use in Traffic Router’s consistent hashing algorithm. This value is set when a server is created and cannot be changed afterwards.
- xmppPasswd
The password used in XMPP communications with the server
HTTP/1.1 200 OK
Access-Control-Allow-Credentials: true
Access-Control-Allow-Headers: Origin, X-Requested-With, Content-Type, Accept, Set-Cookie, Cookie
Access-Control-Allow-Methods: POST,GET,OPTIONS,PUT,DELETE
Access-Control-Allow-Origin: *
Content-Type: application/json
Set-Cookie: mojolicious=...; Path=/; Expires=Mon, 18 Nov 2019 17:40:54 GMT; Max-Age=3600; HttpOnly
Whole-Content-Sha512: 9lGAMCCC9I/bOpuBSyf3ACffjHeRuXCTuxrA/oU78uYzW5FeFTq5PHSSnsnqKG5E0vWg0Rko0CwguGeNc9IT0w==
X-Server-Name: traffic_ops_golang/
Date: Mon, 10 Dec 2018 17:58:57 GMT
Content-Length: 848
{ "alerts": [
{
"text": "server was updated.",
"level": "success"
}
],
"response": {
"cachegroup": null,
"cachegroupId": 6,
"cdnId": 2,
"cdnName": null,
"domainName": "infra.ciab.test",
"guid": null,
"hostName": "quest",
"httpsPort": 443,
"id": 13,
"iloIpAddress": "",
"iloIpGateway": "",
"iloIpNetmask": "",
"iloPassword": "",
"iloUsername": "",
"interfaceMtu": 1500,
"interfaceName": "eth0",
"ip6Address": "::1",
"ip6Gateway": "::2",
"ipAddress": "0.0.0.1",
"ipGateway": "0.0.0.2",
"ipNetmask": "255.255.255.0",
"lastUpdated": "2018-12-10 17:58:57+00",
"mgmtIpAddress": "",
"mgmtIpGateway": "",
"mgmtIpNetmask": "",
"offlineReason": "",
"physLocation": null,
"physLocationId": 1,
"profile": null,
"profileDesc": null,
"profileId": 10,
"rack": null,
"revalPending": null,
"routerHostName": "",
"routerPortName": "",
"status": null,
"statusId": 3,
"tcpPort": 80,
"type": "",
"typeId": 12,
"updPending": true,
"xmppId": null,
"xmppPasswd": null,
"ipIsService": true,
"ip6IsService": true
}}
DELETE
Allow user to delete server through api.
- Auth. Required
Yes
- Roles Required
“admin” or “operations”
- Response Type
undefined
Request Structure
Name |
Description |
---|---|
ID |
The integral, unique identifier of a server |
DELETE /api/2.0/servers/13 HTTP/1.1
Host: trafficops.infra.ciab.test
User-Agent: curl/7.47.0
Accept: */*
Cookie: mojolicious=...
Response Structure
HTTP/1.1 200 OK
Access-Control-Allow-Credentials: true
Access-Control-Allow-Headers: Origin, X-Requested-With, Content-Type, Accept, Set-Cookie, Cookie
Access-Control-Allow-Methods: POST,GET,OPTIONS,PUT,DELETE
Access-Control-Allow-Origin: *
Content-Type: application/json
Set-Cookie: mojolicious=...; Path=/; Expires=Mon, 18 Nov 2019 17:40:54 GMT; Max-Age=3600; HttpOnly
Whole-Content-Sha512: JZdjKJYWN9w9NF6VE/rVkGUqecycKB2ABkkI4LNDmgpJLwu53bRHAA+4uWrow0zuba/4MSEhHKshutziypSxPg==
X-Server-Name: traffic_ops_golang/
Date: Mon, 10 Dec 2018 18:23:21 GMT
Content-Length: 61
{ "alerts": [
{
"text": "server was deleted.",
"level": "success"
}
]}