OC/FCI/advertisement

GET

Returns the complete footprint and capabilities information structure the dCDN wants to expose to a given uCDN.

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:

No

Roles Required:

“admin” or “operations”

Permissions Required:

CDNI:READ

Response Type:

Array

Request Structure

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

Table 548 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)

Response Structure

capabilities:

An array of generic FCI base objects.

capability-type:

A string of the type of base object.

capability-value:

An array of the value for the base object.

footprints:

An array of footprints impacted by this generic base object.

Note

These are meant to be generic and therefore there is not much information in these documents. For further information please see RFC 8006, RFC 8007, RFC 8008, and the SVA documents titled Footprint and Capabilities Interface: Open Caching API, Open Caching API Implementation Guidelines, Configuration Interface: Part 1 Specification - Overview & Architecture, Configuration Interface: Part 2 Specification – CDNi Metadata Model Extensions, and Configuration Interface: Part 3 Specification – Publishing Layer APIs.

#1343 Example /OC/FCI/advertisement Response
{
    "capabilities": [
        {
            "capability-type": "FCI.CapacityLimits",
            "capability-value": [
                {
                    "limits": [
                        {
                            "id": "host_limit_requests_requests",
                            "scope": {
                                "type": "testScope",
                                "value": [
                                    "test.com"
                                ]
                            },
                            "limit-type": "requests",
                            "maximum-hard": 20,
                            "maximum-soft": 15,
                            "telemetry-source": {
                                "id": "request_metrics",
                                "metric": "requests"
                            }
                        },
                        {
                            "id": "total_limit_egress_capacity",
                            "limit-type": "egress",
                            "maximum-hard": 202020,
                            "maximum-soft": 500,
                            "telemetry-source": {
                                "id": "capacity_metrics",
                                "metric": "capacity"
                            }
                        }
                    ]
                }
            ],
            "footprints": [
                {
                    "footprint-type": "countrycode",
                    "footprint-value": [
                        "us"
                    ]
                }
            ]
        },
        {
            "capability-type": "FCI.Telemetry",
            "capability-value": {
                "sources": [
                    {
                        "id": "capacity_metrics",
                        "type": "generic",
                        "metrics": [
                            {
                                "name": "capacity",
                                "time-granularity": 0,
                                "data-percentile": 50,
                                "latency": 0
                            }
                        ],
                        "configuration": {
                            "url": "example.com/telemetry1"
                        }
                    }
                ]
            },
            "footprints": [
                {
                    "footprint-type": "countrycode",
                    "footprint-value": [
                        "us"
                    ]
                }
            ]
        }
    ]
}