Gets all :term:`Parameters` configured in Traffic Ops
Auth. Required: | Yes |
Roles Required: | None |
Permissions Required: | PARAMETER:READ |
Response Type: | Array |
Request Query Parameters
Name |
Required |
Description |
configFile |
no |
Filter :term:`Parameters` by :ref:`parameter-config-file` |
id |
no |
Filters :term:`Parameters` by :ref:`parameter-id` |
name |
no |
Filter :term:`Parameters` by :ref:`parameter-name` |
value |
no |
Filter :term:`Parameters` by :ref:`parameter-value` |
orderby |
no |
Choose the ordering of the results - must be the name of one of the fields of the objects in the response
array |
sortOrder |
no |
Changes the order of sorting. Either ascending (default or "asc") or descending ("desc") |
limit |
no |
Choose the maximum number of results to return |
offset |
no |
The number of results to skip before beginning to return results. Must use in conjunction with limit. |
page |
no |
Return the nth page of results, where "n" is the value of this parameter, pages are limit long
and the first page is 1. If offset was defined, this query parameter has no effect. limit must be
defined to make use of page . |
GET /api/4.0/parameters?configFile=records.config&name=location HTTP/1.1
Host: trafficops.infra.ciab.test
User-Agent: curl/7.47.0
Accept: */*
Cookie: mojolicious=...
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: UFO3/jcBFmFZM7CsrsIwTfPc5v8gUiXqJm6BNp1boPb4EQBnWNXZh/DbBwhMAOJoeqDImoDlrLnrVjQGO4AooA==
X-Server-Name: traffic_ops_golang/
Date: Wed, 05 Dec 2018 18:23:39 GMT
Content-Length: 212
{ "response": [
{
"configFile": "records.config",
"id": 29,
"lastUpdated": "2018-12-05 17:51:02+00",
"name": "location",
"profiles": [
"ATS_EDGE_TIER_CACHE",
"ATS_MID_TIER_CACHE"
],
"secure": false,
"value": "/etc/trafficserver/"
}
]}
Creates one or more new :term:`Parameters`.
Auth. Required: | Yes |
Roles Required: | "admin" or "operations" |
Permissions Required: | PARAMETER:CREATE, PARAMETER:READ |
Response Type: | Array |
The request body may be in one of two formats, a single :term:`Parameter` object or an array of :term:`Parameter` objects. Each :term:`Parameter` object shall have the following keys:
POST /api/4.0/parameters HTTP/1.1
Host: trafficops.infra.ciab.test
User-Agent: curl/7.47.0
Accept: */*
Cookie: mojolicious=...
Content-Length: 84
Content-Type: application/json
{
"name": "test",
"value": "quest",
"configFile": "records.config",
"secure": false
}
POST /api/4.0/parameters HTTP/1.1
Host: trafficops.infra.ciab.test
User-Agent: curl/7.47.0
Accept: */*
Cookie: mojolicious=...
Content-Length: 180
Content-Type: application/json
[{
"name": "test",
"value": "quest",
"configFile": "records.config",
"secure": false
},
{
"name": "foo",
"value": "bar",
"configFile": "records.config",
"secure": false
}]
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: eQrl48zWids0kDpfCYmmtYMpegjnFxfOVvlBYxxLSfp7P7p6oWX4uiC+/Cfh2X9i3G+MQ36eH95gukJqOBOGbQ==
X-Server-Name: traffic_ops_golang/
Date: Wed, 05 Dec 2018 19:18:21 GMT
Content-Length: 212
{ "alerts": [
{
"text": "param was created.",
"level": "success"
}
],
"response": {
"configFile": "records.config",
"id": 124,
"lastUpdated": "2018-12-05 19:18:21+00",
"name": "test",
"profiles": null,
"secure": false,
"value": "quest"
}}