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”

Permissions Required:

SERVER:UPDATE, SERVER:READ

Response Type:

undefined

Request Structure

Table 403 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

Table 404 Request Query Parameters

Name

Required

Description

updated

no

The value to set for the queue update flag on this server. May be ‘true’ or ‘false’.

reval_updated

no

The value to set for the reval update flag on this server. May be ‘true’ or ‘false’.

config_apply_time

no

The value to set for when a queue update is applied for this server. Must be a valid RFC333Nano timestamp.

revalidate_apply_time

no

The value to set for when a reval update is applied for this server. Must be a valid RFC333Nano timestamp.

Note

While none of the timestamps is required individually, at least one must be sent to the API.

#986 Request Example
POST /api/4.0/servers/my-edge/update?config_apply_time=2022-01-31T12%3A00%3A00.123456-07%3A00&revalidate_apply_time=2022-01-31T12%3A00%3A00.123456-07%3A00 HTTP/1.1
Host: trafficops.infra.ciab.test
User-Agent: curl/7.47.0
Accept: */*
Cookie: mojolicious=...

Response Structure

#987 Response Example
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' config_apply_time=2022-01-31T12:00:00.123456-07:00 revalidate_apply_time=2022-01-31T12:00:00.123456-07:00",
                "level" : "success"
            }
        ]
}