federations/{{ID}}/federation_resolvers

GET

Retrieves federation resolvers assigned to a federation.

Auth. Required:

Yes

Roles Required:

None

Response Type:

Array

Request Structure

Table 180 Request Path Parameters

Name

Description

ID

The integral, unique identifier for the federation for which resolvers will be retrieved

#381 Request Example
GET /api/3.0/federations/1/federation_resolvers HTTP/1.1
Host: trafficops.infra.ciab.test
User-Agent: curl/7.62.0
Accept: */*
Cookie: mojolicious=...

Response Structure

id:

The integral, unique identifier of this federation resolver

ipAddress:

The IP address of the federation resolver - may be IPv4 or IPv6

type:

The type of resolver - one of:

RESOLVE4

This resolver is for IPv4 addresses (and ipAddress is IPv4)

RESOLVE6

This resolver is for IPv6 addresses (and ipAddress is IPv6)

#382 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: Wed, 05 Dec 2018 00:49:50 GMT
X-Server-Name: traffic_ops_golang/
set-cookie: mojolicious=...; expires=Wed, 05 Dec 2018 04:49:50 GMT; path=/; HttpOnly
vary: Accept-Encoding
whole-content-sha512: csC18kE3YjiILHP1wmJg7V4h/XWY8HUMKyPuZWnde2g7HJ4gTY51HfjCSqhyKvIJQ8Rl7uEqshF3Ey6xIMOX4A==
content-length: 63

{ "response": [
    {
        "ipAddress": "0.0.0.0",
        "type": "RESOLVE4",
        "id": 1
    }
]}

POST

Assigns one or more resolvers to a federation.

Auth. Required:

Yes

Roles Required:

“admin”

Response Type:

Object

Request Structure

Table 181 Request Path Parameters

Name

Description

ID

The integral, unique identifier for the federation for which resolvers will be retrieved

fedResolverIds:

An array of integral, unique identifiers for federation resolvers

replace:

An optional boolean (default: false) which, if true, will cause any conflicting assignments already in place to be overridden by this request

Note

If replace is not given (and/or not true), then any conflicts with existing assignments will cause the entire operation to fail.

#383 Request Example
POST /api/3.0/federations/1/federation_resolvers HTTP/1.1
Host: trafficops.infra.ciab.test
User-Agent: curl/7.62.0
Accept: */*
Cookie: mojolicious=...
Content-Length: 41
Content-Type: application/json

{
    "fedResolverIds": [1],
    "replace": true
}

Response Structure

fedResolverIds:

An array of integral, unique identifiers for federation resolvers

replace:

An optionally-present boolean (default: false) which, if true, any conflicting assignments already in place were overridden by this request

#384 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: Wed, 05 Dec 2018 00:47:47 GMT
X-Server-Name: traffic_ops_golang/
set-cookie: mojolicious=...; expires=Wed, 05 Dec 2018 04:47:47 GMT; path=/; HttpOnly
vary: Accept-Encoding
whole-content-sha512: +JDcRByS3HO6pMg3Gzkvn0w7/v5oRul9e+RxyFIOKJKNHOkZILyQBS+PJpxDeCgwI19+0poW5dyHPPR9SwbNCA==
content-length: 148

{ "alerts": [
    {
        "level": "success",
        "text": "1 resolver(s) were assigned to the test.quest. federation"
    }
],
"response": {
    "replace": true,
    "fedResolverIds": [
        1
    ]
}}