cdns/{{ID}}

PUT

Allows a user to edit a specific CDN

Auth. Required:

Yes

Roles Required:

“admin” or “operations”

Permissions Required:

CDN:UPDATE, CDN:READ

Response Type:

Object

Request Structure

Table 460 Request Path Parameters

Name

Description

ID

Integral, unique identifier for the CDN to update

dnssecEnabled:

If true, this CDN will use DNSSEC, if false it will not

domainName:

The top-level domain (TLD) belonging to the CDN

name:

Name of the new CDN

ttlOverride:

A TTL value, in seconds, that, if set, overrides all set TTL values on Delivery Services in this CDN. If this is not present in the request, it will be treated as though it were null.

#1157 Request Example
PUT /api/5.0/cdns/3 HTTP/1.1
Host: trafficops.infra.ciab.test
User-Agent: curl/7.47.0
Accept: */*
Cookie: mojolicious=...
Content-Length: 63
Content-Type: application/json

{"name": "quest", "domainName": "test", "dnssecEnabled": false, "ttlOverride": 60}

Response Structure

dnssecEnabled:

true if the CDN uses DNSSEC, false otherwise

domainName:

The top-level domain (TLD) assigned to the newly created CDN

id:

An integral, unique identifier for the newly created CDN

lastUpdated:

Date and time when the CDN was last modified 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.

name:

The newly created CDN’s name

ttlOverride:

A TTL value, in seconds, that, if set, overrides all set TTL values on Delivery Services in this CDN

#1158 Response Example
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: sI1hzBwG+/VAzoFY20kqGFA2RgrUOThtMeeJqk0ZxH3TRxTWuA8BetACct/XICC3n7hPDLlRVpwckEyBdyJkXg==
X-Server-Name: traffic_ops_golang/
Date: Wed, 14 Nov 2018 20:54:33 GMT
Content-Length: 174

{ "alerts": [
    {
        "text": "cdn was updated.",
        "level": "success"
    }
],
"response": {
    "dnssecEnabled": false,
    "domainName": "test",
    "id": 4,
    "lastUpdated": "2018-11-14T20:54:33Z",
    "name": "quest",
    "ttlOverride": 60
}}

DELETE

Allows a user to delete a specific CDN

Auth. Required:

Yes

Roles Required:

“admin” or “operations”

Permissions Required:

CDN:DELETE, CDN:READ

Response Type:

undefined

Request Structure

Table 461 Request Path Parameters

Name

Description

ID

The integral, unique identifier of the CDN to delete

Response Structure

#1159 Response Example
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: Zy4cJN6BEct4ltFLN4e296mM8XnzOs0EQ3/jp4TA3L+g8qtkI0WrL+ThcFq4xbJPU+KHVDSi+b0JBav3xsYPqQ==
X-Server-Name: traffic_ops_golang/
Date: Wed, 14 Nov 2018 20:51:23 GMT
Content-Length: 58

{ "alerts": [
    {
        "text": "cdn was deleted.",
        "level": "success"
    }
]}