profiles/{{ID}}/parameters
GET
Retrieves all Parameters assigned to the Profile.
- Auth. Required:
Yes
- Roles Required:
None
- Permissions Required:
PROFILE:READ, PARAMETER:READ
- Response Type:
Array
Request Structure
Name |
Description |
---|---|
ID |
The ID of the Profile for which Parameters will be listed |
GET /api/4.0/parameters/profile/GLOBAL HTTP/1.1
Host: trafficops.infra.ciab.test
User-Agent: curl/7.47.0
Accept: */*
Cookie: mojolicious=...
Response Structure
- configFile:
The Parameter’s Config File
- id:
- lastUpdated:
The date and time at which this Parameter was last updated, in Traffic Ops’s Custom Date/Time Format
- name:
- profiles:
- secure:
A boolean value that describes whether or not the Parameter is Secure
- value:
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: NudgZXUNyKNpmSFf856KEjyy+Pin/bFhG9NoRBDAxYbRKt2T5fF5Ze7sUNZfFI5n/ZZsgbx6Tsgtfd7oM6j+eg==
X-Server-Name: traffic_ops_golang/
Date: Wed, 05 Dec 2018 21:08:56 GMT
Content-Length: 542
{ "response": [
{
"configFile": "global",
"id": 4,
"lastUpdated": "2018-12-05 17:50:49+00",
"name": "tm.instance_name",
"secure": false,
"value": "Traffic Ops CDN"
},
{
"configFile": "global",
"id": 5,
"lastUpdated": "2018-12-05 17:50:49+00",
"name": "tm.toolname",
"secure": false,
"value": "Traffic Ops"
},
{
"configFile": "regex_revalidate.config",
"id": 7,
"lastUpdated": "2018-12-05 17:50:49+00",
"name": "maxRevalDurationDays",
"secure": false,
"value": "90"
}
]}
POST
Associates Parameters to a Profile. If the Parameter does not exist, creates it and associates it to the Profile. If the Parameter already exists, associates it to the Profile. If the Parameter is already associated with the Profile, keep the association.
- Auth. Required:
Yes
- Roles Required:
“admin” or “operations”
- Permissions Required:
PROFILE:UPDATE, PROFILE:READ, PARAMETER:READ
- Response Type:
Object
Request Structure
Name |
Description |
---|---|
ID |
The ID of the Profile to which Parameters will be assigned |
This endpoint accepts two formats for the request payload:
- Single Object Format
- Parameter Array Format
For making multiple assignments of Parameters to Profiles simultaneously
Warning
Most API endpoints dealing with Parameters treat Secure as a boolean value, whereas this endpoint takes the legacy approach of treating it as an integer. Be careful when passing data back and forth, as boolean values will not be accepted by this endpoint!
Single Parameter Format
- configFile:
The Parameter’s Config File
- name:
- secure:
A boolean value that describes whether or not the Parameter is Secure
- value:
POST /api/4.0/profiles/18/parameters HTTP/1.1
Host: trafficops.infra.ciab.test
User-Agent: curl/7.47.0
Accept: */*
Cookie: mojolicious=...
Content-Length: 99
Content-Type: application/json
{
"name": "test",
"configFile": "quest",
"value": "A test parameter for API examples",
"secure": 0
}
Parameter Array Format
- configFile:
The Parameter’s Config File
- name:
- secure:
A boolean value that describes whether or not the Parameter is Secure
- value:
POST /api/4.0/profiles/18/parameters HTTP/1.1
Host: trafficops.infra.ciab.test
User-Agent: curl/7.47.0
Accept: */*
Cookie: mojolicious=...
Content-Length: 212
Content-Type: application/json
[{
"name": "test",
"configFile": "quest",
"value": "A test parameter for API examples",
"secure": 0
},
{
"name": "foo",
"configFile": "bar",
"value": "Another test parameter for API examples",
"secure": 0
}]
Response Structure
- parameters:
An array of objects representing the Parameters which have been assigned
- profileId:
The ID of the Profile to which the Parameter(s) have been assigned
- profileName:
Name of the Profile to which the Parameter(s) have been assigned
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: R2QUyCaNvKvVv/PNVNmEd/ma5h/iP1fMJlqhv+x2jE/zNpHJ1KVXt6s3btB8nnHv6IDF/gt5kIzQ0mbW5U8bpg==
X-Server-Name: traffic_ops_golang/
Date: Mon, 10 Dec 2018 14:45:28 GMT
Content-Length: 253
{ "alerts": [
{
"text": "Assign parameters successfully to profile test",
"level": "success"
}
],
"response": {
"parameters": [
{
"configFile": "quest",
"name": "test",
"secure": 0,
"value": "A test parameter for API examples",
"id": 126
}
],
"profileId": 18,
"profileName": "test"
}}
Note
The format of the request does not affect the format of the response. parameters
will be an array either way.