OC/CI/configuration

PUT

Triggers an asynchronous task to update the configuration for the uCDN by adding the request to a queue to be reviewed later. This returns a 202 Accepted status and an endpoint to be used for status updates.

Note

Users with the ICDN:UCDN-OVERRIDE permission will need to provide a “ucdn” query parameter to bypass the need for uCDN information in the JWT and allow them to view all CDNi information.

Auth. Required:

Yes

Roles Required:

“admin” or “operations”

Permissions Required:

CDNI:UPDATE

Response Type:

Object

Request Structure

This requires authorization using a JWT provided by the dCDN to identify the uCDN. This token must include the following claims:

Table 543 Required JWT claims

Name

Description

iss

Issuer claim as a string key for the uCDN

aud

Audience claim as a string key for the dCDN

exp

Expiration claim as the expiration date as a Unix epoch timestamp (in seconds)

type:

A string of the type of metadata to follow. See RFC 8006 for possible values. Only a selection of these are supported.

host:

A string of the domain that the requested updates will change.

metadata:

An array of generic metadata objects that conform to RFC 8006.

generic-metadata-type:

A string of the type of metadata to follow conforming to RFC 8006.

generic-metadata-value:

An array of generic metadata value objects conforming to RFC 8006 and SVA specifications.

#1336 Example /OC/CI/configuration Request
PUT /api/5.0/oc/ci/configuration HTTP/1.1
Host: trafficops.infra.ciab.test
User-Agent: curl/7.47.0
Accept: */*
Cookie: mojolicious=...
Content-Length: 181
Content-Type: application/json

{
    "type": "MI.HostMetadata",
    "host": "example.com",
    "metadata": [
        {
            "generic-metadata-type": "MI.RequestedCapacityLimits",
            "generic-metadata-value": {
                "requested-limits": [
                    {
                        "limit-type": "egress",
                        "limit-value": 20000,
                        "footprints": [
                            {
                                "footprint-type": "ipv4cidr",
                                "footprint-value": [
                                    "127.0.0.1",
                                    "127.0.0.2"
                                ]
                            }
                        ]
                    }
                ]
            }
        }
    ]
}

Response Structure

#1337 Response Example
HTTP/1.1 202 Accepted
Content-Type: application/json

{ "alerts": [
    {
        "text": "CDNi configuration update request received. Status updates can be found here: /api/5.0/async_status/1",
        "level": "success"
    }
]}