Konnect Service Catalog

ScorecardCriteriaWithEvaluation

object
idstring(uuid)required

Example:5c1121f9-3f3a-47c7-9bb6-c81a51128714

namestringrequired

Override display name for the criteria, for greater contextual clarity within a given scorecard.

Example:Time to restore service is less than 6 hours over the last 3 months.

scorecard_idstring(uuid)required

Example:f3704e4c-104d-4f21-998a-20d4364c893f

integrationstringrequired

The integration name when it provides the criteria template. Otherwise null.

enabledbooleanrequired

Whether the criteria is enabled for the given scorecard.

Example:true

template_namestringrequired

Reference to the unique name of the criteria template.

Example:time_to_merge

template_parametersobjectrequired

Input parameters for the given criteria template.
The available parameters, and its schema, are found on the criteria template definition via
the schema property. Criteria template definitions are determined by the /v1/criteria-templates
endpoint.

Example:{"measure":"median","threshold":{"unit":"hours","value":6},"window":{"unit":"months","value":3}}

* Additional properties are allowed.
section_namestringrequired

Organizational section name for the criteria within the scorecard.

>= 1 characters<= 120 characters

Example:Documentation

created_atstring(date-time)requiredread-only

An ISO-8601 timestamp representation of entity creation date.

Example:2022-11-04T20:10:06.927Z

updated_atstring(date-time)requiredread-only

An ISO-8601 timestamp representation of entity update date.

Example:2022-11-04T20:10:06.927Z

evaluationobjectrequired
Show Child Parameters
Example

ScorecardCriteriaEvaluation

object
passing_services_countnumberrequired

Number of targeted Services passing the criteria.

Example:3

Example

CriteriaTemplateName

string

Reference to the unique name of the criteria template.

Example

CriteriaParameters

object

Input parameters for the given criteria template.
The available parameters, and its schema, are found on the criteria template definition via
the schema property. Criteria template definitions are determined by the /v1/criteria-templates
endpoint.

* Additional properties are allowed.
Example

ScorecardService

object

Service object that includes its evaluation result for the given scorecard criteria.

idstring(uuid)requiredread-only

The service ID.

Example:7f9fd312-a987-4628-b4c5-bb4f4fddd5f7

namestringrequired

The machine name of the Service that uniquely identifies it within the catalog.

Match pattern:^[0-9a-z.-]+$

>= 1 characters<= 120 characters

Example:user-svc

display_namestringrequired

The display name of the Service.

>= 1 characters<= 120 characters

Example:User Service

descriptionstringrequired

Optionally provide a description of the Service.

<= 2048 characters

custom_fieldsobjectrequired

Map of customizable, catalog-defined fields providing information about a service.

Example:{"owner":"John Appleseed","dashboard":{"name":"On-Call Dashboard","link":"https://my-dashboard-svc.io/dashboards/1"}}

labelsobjectrequired

Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types.

Keys must be of length 1-63 characters, and cannot start with “kong”, “konnect”, “mesh”, “kic”, or “_”.

Example:{"env":"test"}

created_atstring(date-time)requiredread-only

An ISO-8601 timestamp representation of entity creation date.

Example:2022-11-04T20:10:06.927Z

updated_atstring(date-time)requiredread-only

An ISO-8601 timestamp representation of entity update date.

Example:2022-11-04T20:10:06.927Z

scoreobject

Evaluation for a scorecard criteria relative to the given service service.
Has a null value when the criteria has not yet been evaluated for the service.

Show Child Parameters
Example