parameters/{{ID}}

PUT

Replaces a Parameter.

Auth. Required:

Yes

Roles Required:

“admin” or “operations”

Permissions Required:

PARAMETER:UPDATE, PARAMETER:READ

Response Type:

Object

Request Structure

Table 553 Request Path Parameters

Name	Description
ID	The ID of the Parameter which will be deleted

configFile:

The Parameter’s Config File

name:

Name of the Parameter

secure:

A boolean value that describes whether or not the Parameter is Secure

value:

The Parameter’s Value

#1362 Request Example

PUT /api/5.0/parameters/124 HTTP/1.1
Host: trafficops.infra.ciab.test
User-Agent: curl/7.47.0
Accept: */*
Cookie: mojolicious=...
Content-Length: 81
Content-Type: application/json

{
    "name": "foo",
    "value": "bar",
    "configFile": "records.config",
    "secure": false
}

Response Structure

configFile:

The Parameter’s Config File

id:

The Parameter’s ID

lastUpdated:

The date and time at which this Parameter 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.

name:

Name of the Parameter

profiles:

An array of Profile Names that use this Parameter

secure:

A boolean value that describes whether or not the Parameter is Secure

value:

The Parameter’s Value

#1363 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: DMxS2gKceFVKRtezON/vsnrC+zI8onASSHaGv5i3wwvUvyt9KEe72gxQd6ZgVcSq3K8ZpkH6g3UI/WtEfdp5vA==
X-Server-Name: traffic_ops_golang/
Date: Wed, 05 Dec 2018 20:21:07 GMT
Content-Length: 209

{ "alerts": [
    {
        "text": "param was updated.",
        "level": "success"
    }
],
"response": {
    "configFile": "records.config",
    "id": 125,
    "lastUpdated": "2018-12-05T20:21:07.563406+05:30",
    "name": "foo",
    "profiles": null,
    "secure": false,
    "value": "bar"
}}

DELETE

Deletes the specified Parameter. If, however, the Parameter is associated with one or more Profiles, deletion will fail.

Auth. Required:

Yes

Roles Required:

“admin” or “operations”

Permissions Required:

PARAMETER:DELETE, PARAMETER:READ

Response TYpe:

undefined

Request Structure

Table 554 Request Path Parameters

Name	Description
ID	The ID of the Parameter which will be deleted

#1364 Request Example

DELETE /api/5.0/parameters/124 HTTP/1.1
Host: trafficops.infra.ciab.test
User-Agent: curl/7.47.0
Accept: */*
Cookie: mojolicious=...

Response Structure

#1365 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: hJjQq2Seg7sqWt+jKgp6gwRxUtoVU34PFoc9wEaweXdaIBTn/BscoUuyw2/n+V8GZPqpeQcihZE50/0oQhdtHw==
X-Server-Name: traffic_ops_golang/
Date: Wed, 05 Dec 2018 19:20:30 GMT
Content-Length: 60

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