Skip to content

Latest commit

 

History

History
91 lines (75 loc) · 3.74 KB

servers_hostname_update.rst

File metadata and controls

91 lines (75 loc) · 3.74 KB
Raw

servers/{{HostName-Or-ID}}/update

POST

Queue or dequeue updates and revalidation updates for a specific server.

Auth. Required

Yes

Roles Required

"admin" or "operations"

Response Type

undefined

Request Structure

Request Path Parameters
Name Description

HostName-OR-ID

 The hostName or integral, unique identifier of the server on which updates are being queued or dequeued
Request Query Parameters
Name Required Description
updated (Deprecated) no The value to set for the queue update flag on this server. May be 'true' or 'false'.
reval_updated (Deprecated) no The value to set for the queue update flag on this server. May be 'true' or 'false'.

3.1

The boolean values above have resulted in an unintended race condition. These fields are removed in APIv4 and replaced.

POST /api/3.0/servers/my-edge/update?updated=true&reval_updated=false 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
Access-Control-Allow-Methods: POST,GET,OPTIONS,PUT,DELETE
Access-Control-Allow-Origin: *
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Content-Type: application/json
Date: Mon, 10 Dec 2018 18:20:04 GMT
X-Server-Name: traffic_ops_golang/
Set-Cookie: mojolicious=...; Path=/; Expires=Mon, 18 Nov 2019 17:40:54 GMT; Max-Age=3600; HttpOnly
Vary: Accept-Encoding
Whole-Content-Sha512: 9Mmo9hIFZyF5gAvfdJD//VH9eNgiHVLinXt88H0GlJSHhwND8gMxaFyC+f9XZfiNAoGd1MKi1934ZJGmaIR6qQ==
Content-Length: 49

{
    "alerts" :
        [
            {
                "text" : "successfully set server 'my-edge' updated=true reval_updated=false",
                "level" : "success"
            }
        ]
}