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 363 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.

#859 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"
                    ]
                }
            ]
        }
    ]
}