openapi: 3.2.0
info:
title: Open API Spec for Assurance Fabric Sites documentation Fabric Site Health Summaries API
description: "### OpenAPI specification defined for the purpose of providing visibility into the fabric sites and their health in Catalyst Center\n\n**Relevant Concepts**\n\n| Term | Description |\n| -- | -- |\n| `Fabric Site` | A fabric site is a logical subdivision of a larger network fabric, containing its own control plane nodes for management, border nodes for routing traffic between sites, and edge nodes that connect devices to the fabric. |\n| `Virtual Network` | A fabric virtual network is a logical network overlay created on top of a physical network fabric. This overlay network allows you to segment your network into isolated, secure, and policy-driven environments for different departments, applications, or security zones. |\n| `Transit Network` | A fabric transit site is a special type of fabric site that connects multiple other fabric sites within a single fabric domain. This applies only to SD-Access transit networks because health status is only monitored for these sites, not for IP transit sites|\n| `Fabric deployments` | There are 2 types of Fabric deployments, namely 'LISP' and 'EVPN'.| \n| `LISP-based deployments` | LISP based deployments accommodate the following fabric entities: 'Fabric sites', 'Virtual networks (L2/L3)', and 'Transit Networks'. L2 VN health is not applicable for LISP based deployments.|\n| `EVPN-based deployments` | EVPN based deployments support 'Fabric sites' and 'Virtual networks (L2/L3)' currently. Transit networks is not applicable for EVPN based deployments.| \n| `Overall Fabric Site Health` | The health status of the fabric is determined by examining the session status among the fabric sites. A valid Health score for Fabric entity ranges from 0-100 and is categorized as follows: Good (80-100), Fair (40-80), Poor (0-40), and No Health (--).|\n| `FabricSiteConnectivity Health` | Health of the connectivity with the fabric site. Health score ranges from 0 to 100.|\n| `Fabric Infrastructure Health` | Health of the devices that make up the fabric sitee. Health score ranges from 0 to 100.|\n| `FabricControlPlane Health` | Health of the control plane in the fabric site. Health score ranges from 0 to 100.|\n**API Support Documentation**\n\n**Views**\n\nSpecified 'views' (upto 3) can be requested for non-count APIs. Each view corresponds to different sets of data. \n\n'views' an optional parameter which can be passed to get one or more (upto 3 views) of the specific health data summaries associated with fabric sites.\n\n| View | Response Data |\n| --- | --- |\n| `fabricSiteInfo` | id, name, totalDeviceCount, associatedL2VnCount, associatedL3VnCount, networkProtocol | \n| `overallHealth` | id, name, goodHealthPercentage, goodHealthDeviceCount, totalHealthDeviceCount, poorHealthDeviceCount, fairHealthDeviceCount, connectivityGoodHealthPercentage, connectivityTotalHealthDeviceCount, connectivityGoodHealthDeviceCount, connectivityPoorHealthDeviceCount, connectivityFairHealthDeviceCount, infraGoodHealthPercentage, infraTotalHealthDeviceCount, infraGoodHealthDeviceCount, infraPoorHealthDeviceCount, infraFairHealthDeviceCount, controlPlaneGoodHealthPercentage, controlPlaneTotalHealthDeviceCount, controlPlaneGoodHealthDeviceCount, controlPlanePoorHealthDeviceCount, controlPlaneFairHealthDeviceCount | \n| `connectivityHealth` | id, name, connectivityGoodHealthPercentage, connectivityTotalHealthDeviceCount, connectivityGoodHealthDeviceCount, connectivityPoorHealthDeviceCount, connectivityFairHealthDeviceCount, bgpEvpnGoodHealthPercentage, bgpEvpnTotalHealthDeviceCount, bgpEvpnGoodHealthDeviceCount, bgpEvpnPoorHealthDeviceCount, bgpEvpnFairHealthDeviceCount, portChannelGoodHealthPercentage, portChannelTotalHealthDeviceCount, portChannelGoodHealthDeviceCount,portChannelPoorHealthDeviceCount, portChannelFairHealthDeviceCount, borderToControlPlaneGoodHealthPercentage, borderToControlPlaneTotalHealthDeviceCount, borderToControlPlaneGoodHealthDeviceCount,borderToControlPlanePoorHealthDeviceCount, borderToControlPlaneFairHealthDeviceCount, bgpPubsubSiteGoodHealthPercentage, bgpPubsubSiteTotalHealthDeviceCount, bgpPubsubSiteGoodHealthDeviceCount,bgpPubsubSitePoorHealthDeviceCount, bgpPubsubSiteFairHealthDeviceCount | \n| `infraHealth` | id, name,infraGoodHealthPercentage, infraTotalHealthDeviceCount, infraGoodHealthDeviceCount, infraPoorHealthDeviceCount, infraFairHealthDeviceCount, pubsubInfraVnGoodHealthPercentage, pubsubInfraVnTotalHealthDeviceCount, pubsubInfraVnGoodHealthDeviceCount, pubsubInfraVnPoorHealthDeviceCount, pubsubInfraVnFairHealthDeviceCount, ctsEnvDataDownloadGoodHealthPercentage, ctsEnvDataDownloadTotalHealthDeviceCount, ctsEnvDataDownloadGoodHealthDeviceCount, ctsEnvDataDownloadPoorHealthDeviceCount, ctsEnvDataDownloadFairHealthDeviceCount, aaaStatusGoodHealthPercentage, aaaStatusTotalHealthDeviceCount, aaaStatusGoodHealthDeviceCount,aaaStatusPoorHealthDeviceCount, aaaStatusFairHealthDeviceCount, bgpPeerInfraVnScoreGoodHealthPercentage, bgpPeerInfraVnTotalHealthDeviceCount, bgpPeerInfraVnGoodHealthDeviceCount, bgpPeerInfraVnPoorHealthDeviceCount, bgpPeerInfraVnFairHealthDeviceCount, peerScoreGoodHealthPercentage, peerScoreTotalHealthDeviceCount, peerScoreGoodHealthDeviceCount,peerScorePoorHealthDeviceCount, peerScoreFairHealthDeviceCount |\n| `controlPlaneHealth` | id, name, controlPlaneGoodHealthPercentage, controlPlaneTotalHealthDeviceCount, controlPlaneGoodHealthDeviceCount, controlPlanePoorHealthDeviceCount, controlPlaneFairHealthDeviceCount, lispSessionGoodHealthPercentage, lispSessionTotalHealthDeviceCount, lispSessionGoodHealthDeviceCount,lispSessionPoorHealthDeviceCount, lispSessionFairHealthDeviceCount, bgpBgpSiteGoodHealthPercentage, bgpBgpSiteTotalHealthDeviceCount, bgpBgpSiteGoodHealthDeviceCount,bgpBgpSitePoorHealthDeviceCount, bgpBgpSiteFairHealthDeviceCount|\n\n A maximum of 3 views can be queried at a time per request.\n \n When this query parameter is not added, the default summaries are: [`fabricSiteInfo`, `overallHealth`]\n \n **Examples**:\n\n Query Param:\n 1. view=overallHealth (single view requested)\n 2. view=fabricSiteInfo&view=overallHealth (multiple views requested)\n \n### **Attributes** ###\n\nSpecified 'attributes' can be requested for non-count APIs. Each attribute requested will be part of the API response.\n\n**Supported Attributes:**\n\n1.`id`, `name`, `associatedL2VnCount`, `associatedL3VnCount`, `networkProtocol`, `goodHealthPercentage`, `goodHealthDeviceCount`, `totalDeviceCount`,`poorHealthDeviceCount`,`fairHealthDeviceCount`, `totalHealthDeviceCount`, `connectivityGoodHealthPercentage`, `connectivityTotalHealthDeviceCount`, `connectivityGoodHealthDeviceCount`, `connectivityPoorHealthDeviceCount`, `connectivityFairHealthDeviceCount`, `infraGoodHealthPercentage`, `infraTotalHealthDeviceCount`, `infraGoodHealthDeviceCount`, `infraPoorHealthDeviceCount`, `infraFairHealthDeviceCount`, `controlPlaneGoodHealthPercentage`, `controlPlaneTotalHealthDeviceCount`, `controlPlaneGoodHealthDeviceCount`,`controlPlanePoorHealthDeviceCount`, `controlPlaneFairHealthDeviceCount`, `pubsubInfraVnGoodHealthPercentage`, `pubsubInfraVnTotalHealthDeviceCount`, `pubsubInfraVnGoodHealthDeviceCount`, `pubsubInfraVnPoorHealthDeviceCount`, `pubsubInfraVnFairHealthDeviceCount`, `bgpEvpnGoodHealthPercentage`, `bgpEvpnTotalHealthDeviceCount`, `bgpEvpnGoodHealthDeviceCount`,`bgpEvpnPoorHealthDeviceCount`, `bgpEvpnFairHealthDeviceCount`, `ctsEnvDataDownloadGoodHealthPercentage`, `ctsEnvDataDownloadTotalHealthDeviceCount`, `ctsEnvDataDownloadGoodHealthDeviceCount`, `ctsEnvDataDownloadPoorHealthDeviceCount`, `ctsEnvDataDownloadFairHealthDeviceCount`, `aaaStatusGoodHealthPercentage`, `aaaStatusTotalHealthDeviceCount`, `aaaStatusGoodHealthDeviceCount`, `aaaStatusPoorHealthDeviceCount`, `aaaStatusFairHealthDeviceCount`, `portChannelGoodHealthPercentage`, `portChannelTotalHealthDeviceCount`, `portChannelGoodHealthDeviceCount`, `portChannelPoorHealthDeviceCount`, `portChannelFairHealthDeviceCount`, `peerScoreGoodHealthPercentage`, `peerScoreTotalHealthDeviceCount`, `peerScoreGoodHealthDeviceCount`, `peerScorePoorHealthDeviceCount`, `peerScoreFairHealthDeviceCount`, `lispSessionGoodHealthPercentage`, `lispSessionTotalHealthDeviceCount`, `lispSessionGoodHealthDeviceCount`, `lispSessionPoorHealthDeviceCount`, `lispSessionFairHealthDeviceCount`, `borderToControlPlaneGoodHealthPercentage`, `borderToControlPlaneTotalHealthDeviceCount`, `borderToControlPlaneGoodHealthDeviceCount`, `borderToControlPlanePoorHealthDeviceCount`, `borderToControlPlaneFairHealthDeviceCount`, `bgpBgpSiteGoodHealthPercentage`, `bgpBgpSiteTotalHealthDeviceCount`, `bgpBgpSiteGoodHealthDeviceCount`, `bgpBgpSitePoorHealthDeviceCount`, `bgpBgpSiteFairHealthDeviceCount`, `bgpPubsubSiteGoodHealthPercentage`, `bgpPubsubSiteTotalHealthDeviceCount`, `bgpPubsubSiteGoodHealthDeviceCount`, `bgpPubsubSitePoorHealthDeviceCount`, `bgpPubsubSiteFairHealthDeviceCount`, `bgpPeerInfraVnScoreGoodHealthPercentage`, `bgpPeerInfraVnTotalHealthDeviceCount`, `bgpPeerInfraVnGoodHealthDeviceCount`, `bgpPeerInfraVnPoorHealthDeviceCount`, `bgpPeerInfraVnFairHealthDeviceCount`\nIf length of attribute list is too long, when using the query parameter for GET requests, please use `view` param instead.\n\n Examples:\n \n 1. query param:\n \n ?attribute=goodHealthPercentage (single attribute requested)\n \n ?attribute=pubsubInfraVnGoodHealthPercentage&attribute=goodHealthPercentage (multiple attributes requested)\n"
termsOfService: https://www.cisco.com/c/en/us/about/legal/cloud-and-software/end_user_license_agreement.html
contact:
name: Cisco TAC World Wide
url: https://www.cisco.com/c/en/us/support/web/tsd-cisco-worldwide-contacts.html
email: tac@cisco.com
license:
name: Apache 2.0
url: http://www.apache.org/licenses/LICENSE-2.0.html
version: 3.3.1
x-provenance:
method: harvested
authored_by: Cisco Catalyst Center
harvested_by: API Evangelist
harvested_on: '2026-08-19'
first_party: true
provider_published: true
source_host: developer.cisco.com
note: 27 Cisco-published OpenAPI 3.0 Assurance documents (185 operations). Ownership confirmed from the tac@cisco.com contact, the Cisco EULA terms-of-service URL and the Cisco Catalyst Center license block carried in each document.
x-evidence:
- type: source
url: https://developer.cisco.com/docs/catalyst-center/
- type: source
url: https://developer.cisco.com/dnacenter/
servers:
- url: https://developer.cisco.com/data/api/v1
tags:
- name: fabricSiteHealthSummaries
paths:
/fabricSiteHealthSummaries:
get:
tags:
- fabricSiteHealthSummaries
summary: Read list of Fabric Sites with their health summary
description: "Get a paginated list of Fabric sites Networks with health summary.\n\nThis API provides the latest health data until the given `endTime`. If data is not ready for the provided endTime, the request will fail with error code `400 Bad Request`, and the error message will indicate the recommended endTime to use to retrieve a complete data set. This behavior may occur if the provided endTime=currentTime, since we are not a real time system. When `endTime` is not provided, the API returns the latest data.\n\n "
operationId: readFabricSitesSummary
parameters:
- name: X-CALLER-ID
in: header
description: 'Caller ID is used to trace the origin of API calls and their associated queries executed on the database. It''s an optional header parameter that can be added to an API request.
'
required: false
schema:
type: string
default: unknown
example: ui:client360
- name: startTime
in: query
description: 'Start time from which API queries the data set related to the resource. It must be specified in UNIX epochtime in milliseconds. Value is inclusive.
'
schema:
type: integer
format: int64
example: 1705348800000
- name: endTime
in: query
description: 'End time to which API queries the data set related to the resource. It must be specified in UNIX epochtime in milliseconds. Value is inclusive.
'
required: false
schema:
type: integer
format: int64
example: 1705435200000
- name: limit
in: query
description: Maximum number of records to return
schema:
maximum: 500
minimum: 1
type: integer
default: 100
- name: offset
in: query
description: Specifies the starting point within all records returned by the API. It's one based offset. The starting value is 1.
schema:
minimum: 1
type: integer
default: 1
- name: sortBy
in: query
description: A field within the response to sort by.
schema:
type: string
- name: order
in: query
description: The sort order of the field ascending or descending.
schema:
type: string
default: asc
enum:
- asc
- desc
- name: siteHierarchy
in: query
description: 'The full hierarchical breakdown of the site tree starting from Global site name and ending with the specific site name. The Root site is named "Global" (Ex. `Global/AreaName/BuildingName/FloorName`)
This field supports wildcard asterisk (`*`) character search support. E.g. `*/San*, */San, /San*`
Examples:
`?siteHierarchy=Global/AreaName/BuildingName/FloorName` (single siteHierarchy requested)
`?siteHierarchy=Global/AreaName/BuildingName/FloorName&siteHierarchy=Global/AreaName2/BuildingName2/FloorName2` (multiple siteHierarchies requested)
'
required: false
style: form
explode: true
schema:
type: array
items:
type: string
- name: siteHierarchyId
in: query
description: 'The full hierarchy breakdown of the site tree in id form starting from Global site UUID and ending with the specific site UUID. (Ex. `globalUuid/areaUuid/buildingUuid/floorUuid`)
This field supports wildcard asterisk (`*`) character search support. E.g. `*uuid*, *uuid, uuid*`
Examples:
`?siteHierarchyId=globalUuid/areaUuid/buildingUuid/floorUuid `(single siteHierarchyId requested)
`?siteHierarchyId=globalUuid/areaUuid/buildingUuid/floorUuid&siteHierarchyId=globalUuid/areaUuid2/buildingUuid2/floorUuid2` (multiple siteHierarchyIds requested)
'
required: false
style: form
explode: true
schema:
type: array
items:
type: string
- name: id
in: query
description: 'The list of entity Uuids. (Ex."6bef213c-19ca-4170-8375-b694e251101c")
Examples: id=6bef213c-19ca-4170-8375-b694e251101c (single entity uuid requested)
id=6bef213c-19ca-4170-8375-b694e251101c&id=32219612-819e-4b5e-a96b-cf22aca13dd9&id=2541e9a7-b80d-4955-8aa2-79b233318ba0 (multiple entity uuid with ''&'' separator)
'
required: false
style: form
explode: true
schema:
type: array
items:
type: string
- name: attribute
in: query
description: "Supported Attributes:\n\n[id, name, associatedL2VnCount, associatedL3VnCount, networkProtocol, totalDeviceCount, goodHealthPercentage, goodHealthDeviceCount,poorHealthDeviceCount,fairHealthDeviceCount, totalHealthDeviceCount, connectivityGoodHealthPercentage, connectivityTotalHealthDeviceCount, connectivityGoodHealthDeviceCount, connectivityPoorHealthDeviceCount, connectivityFairHealthDeviceCount, infraGoodHealthPercentage, infraTotalHealthDeviceCount, infraGoodHealthDeviceCount, infraPoorHealthDeviceCount, infraFairHealthDeviceCount, controlPlaneGoodHealthPercentage, controlPlaneTotalHealthDeviceCount, controlPlaneGoodHealthDeviceCount,controlPlanePoorHealthDeviceCount, controlPlaneFairHealthDeviceCount, pubsubInfraVnGoodHealthPercentage, pubsubInfraVnTotalHealthDeviceCount, pubsubInfraVnGoodHealthDeviceCount, pubsubInfraVnPoorHealthDeviceCount, pubsubInfraVnFairHealthDeviceCount, bgpEvpnGoodHealthPercentage, bgpEvpnTotalHealthDeviceCount, bgpEvpnGoodHealthDeviceCount,bgpEvpnPoorHealthDeviceCount, bgpEvpnFairHealthDeviceCount, ctsEnvDataDownloadGoodHealthPercentage, ctsEnvDataDownloadTotalHealthDeviceCount, ctsEnvDataDownloadGoodHealthDeviceCount, ctsEnvDataDownloadPoorHealthDeviceCount, ctsEnvDataDownloadFairHealthDeviceCount, aaaStatusGoodHealthPercentage, aaaStatusTotalHealthDeviceCount, aaaStatusGoodHealthDeviceCount, aaaStatusPoorHealthDeviceCount, aaaStatusFairHealthDeviceCount, portChannelGoodHealthPercentage, portChannelTotalHealthDeviceCount, portChannelGoodHealthDeviceCount, portChannelPoorHealthDeviceCount, portChannelFairHealthDeviceCount, peerScoreGoodHealthPercentage, peerScoreTotalHealthDeviceCount, peerScoreGoodHealthDeviceCount, peerScorePoorHealthDeviceCount, peerScoreFairHealthDeviceCount, lispSessionGoodHealthPercentage, lispSessionTotalHealthDeviceCount, lispSessionGoodHealthDeviceCount, lispSessionPoorHealthDeviceCount, lispSessionFairHealthDeviceCount, borderToControlPlaneGoodHealthPercentage, borderToControlPlaneTotalHealthDeviceCount, borderToControlPlaneGoodHealthDeviceCount, borderToControlPlanePoorHealthDeviceCount, borderToControlPlaneFairHealthDeviceCount, bgpBgpSiteGoodHealthPercentage, bgpBgpSiteTotalHealthDeviceCount, bgpBgpSiteGoodHealthDeviceCount, bgpBgpSitePoorHealthDeviceCount, bgpBgpSiteFairHealthDeviceCount, bgpPubsubSiteGoodHealthPercentage, bgpPubsubSiteTotalHealthDeviceCount, bgpPubsubSiteGoodHealthDeviceCount, bgpPubsubSitePoorHealthDeviceCount, bgpPubsubSiteFairHealthDeviceCount, bgpPeerInfraVnScoreGoodHealthPercentage, bgpPeerInfraVnTotalHealthDeviceCount, bgpPeerInfraVnGoodHealthDeviceCount, bgpPeerInfraVnPoorHealthDeviceCount, bgpPeerInfraVnFairHealthDeviceCount]\n\nIf length of attribute list is too long, please use 'view' param instead.\n\nExamples:\n\nattribute=GoodHealthPercentage (single attribute requested)\n\nattribute=GoodHealthPercentage&attribute=connectivityGoodHealthPercentage (multiple attributes requested) \n"
required: false
style: form
explode: true
schema:
type: array
items:
type: string
- name: view
in: query
description: "The specific summary view being requested. This is an optional parameter which can be passed to get one or more(upto 3 views) of the specific health data summaries associated with sites.\n\n### Response data proviced by each view: \n\n1. **fabricSiteInfo**\n[id, name, totalDeviceCount, associatedL2VnCount, associatedL3VnCount, networkProtocol] \n\n2. **overallHealth** \n[id, name, goodHealthPercentage, goodHealthDeviceCount, totalHealthDeviceCount, poorHealthDeviceCount, fairHealthDeviceCount, connectivityGoodHealthPercentage, connectivityTotalHealthDeviceCount, connectivityGoodHealthDeviceCount, connectivityPoorHealthDeviceCount, connectivityFairHealthDeviceCount, infraGoodHealthPercentage, infraTotalHealthDeviceCount, infraGoodHealthDeviceCount, infraPoorHealthDeviceCount, infraFairHealthDeviceCount, controlPlaneGoodHealthPercentage, controlPlaneTotalHealthDeviceCount, controlPlaneGoodHealthDeviceCount, controlPlanePoorHealthDeviceCount, controlPlaneFairHealthDeviceCount] \n\n3. **connectivityHealth**\n[id, name, connectivityGoodHealthPercentage, connectivityTotalHealthDeviceCount, connectivityGoodHealthDeviceCount, connectivityPoorHealthDeviceCount, connectivityFairHealthDeviceCount, bgpEvpnGoodHealthPercentage, bgpEvpnTotalHealthDeviceCount, bgpEvpnGoodHealthDeviceCount, bgpEvpnPoorHealthDeviceCount, bgpEvpnFairHealthDeviceCount, portChannelGoodHealthPercentage, portChannelTotalHealthDeviceCount, portChannelGoodHealthDeviceCount,portChannelPoorHealthDeviceCount, portChannelFairHealthDeviceCount, borderToControlPlaneGoodHealthPercentage, borderToControlPlaneTotalHealthDeviceCount, borderToControlPlaneGoodHealthDeviceCount,borderToControlPlanePoorHealthDeviceCount, borderToControlPlaneFairHealthDeviceCount, bgpPubsubSiteGoodHealthPercentage, bgpPubsubSiteTotalHealthDeviceCount, bgpPubsubSiteGoodHealthDeviceCount,bgpPubsubSitePoorHealthDeviceCount, bgpPubsubSiteFairHealthDeviceCount] \n\n4. **infraHealth** \n[id, name,infraGoodHealthPercentage, infraTotalHealthDeviceCount, infraGoodHealthDeviceCount, infraPoorHealthDeviceCount, infraFairHealthDeviceCount, pubsubInfraVnGoodHealthPercentage, pubsubInfraVnTotalHealthDeviceCount, pubsubInfraVnGoodHealthDeviceCount, pubsubInfraVnPoorHealthDeviceCount, pubsubInfraVnFairHealthDeviceCount, ctsEnvDataDownloadGoodHealthPercentage, ctsEnvDataDownloadTotalHealthDeviceCount, ctsEnvDataDownloadGoodHealthDeviceCount, ctsEnvDataDownloadPoorHealthDeviceCount, ctsEnvDataDownloadFairHealthDeviceCount, aaaStatusGoodHealthPercentage, aaaStatusTotalHealthDeviceCount, aaaStatusGoodHealthDeviceCount,aaaStatusPoorHealthDeviceCount, aaaStatusFairHealthDeviceCount, bgpPeerInfraVnScoreGoodHealthPercentage, bgpPeerInfraVnTotalHealthDeviceCount, bgpPeerInfraVnGoodHealthDeviceCount, bgpPeerInfraVnPoorHealthDeviceCount, bgpPeerInfraVnFairHealthDeviceCount, peerScoreGoodHealthPercentage, peerScoreTotalHealthDeviceCount, peerScoreGoodHealthDeviceCount,peerScorePoorHealthDeviceCount, peerScoreFairHealthDeviceCount]\n\n5. **controlPlaneHealth** \n [id, name, controlPlaneGoodHealthPercentage, controlPlaneTotalHealthDeviceCount, controlPlaneGoodHealthDeviceCount, controlPlanePoorHealthDeviceCount, controlPlaneFairHealthDeviceCount, lispSessionGoodHealthPercentage, lispSessionTotalHealthDeviceCount, lispSessionGoodHealthDeviceCount,lispSessionPoorHealthDeviceCount, lispSessionFairHealthDeviceCount, bgpBgpSiteGoodHealthPercentage, bgpBgpSiteTotalHealthDeviceCount, bgpBgpSiteGoodHealthDeviceCount,bgpBgpSitePoorHealthDeviceCount, bgpBgpSiteFairHealthDeviceCount] \n\n\nA maximum of 3 views can be queried at a time per request. \n\nWhen this query parameter is not added, the default summaries are: [fabricSiteInfo, overallHealth]\n\n**Examples**:\n1. Query Param:\n view=overallHealth (single view requested)\n\n view=fabricSiteInfo&view=overallHealth (multiple views requested)\n"
required: false
style: form
explode: true
schema:
type: array
items:
type: string
responses:
'200':
$ref: '#/components/responses/FabricSitesSummariesResponse'
'400':
$ref: '#/components/responses/400'
'500':
$ref: '#/components/responses/500'
1XX:
$ref: '#/components/responses/1XX'
2XX:
$ref: '#/components/responses/2XX'
3XX:
$ref: '#/components/responses/3XX'
4XX:
$ref: '#/components/responses/4XX'
5XX:
$ref: '#/components/responses/5XX'
default:
$ref: '#/components/responses/defaultError'
/fabricSiteHealthSummaries/{id}:
get:
tags:
- fabricSiteHealthSummaries
summary: Read list of Fabric Sites with their health summary
description: "Get Fabric site health summary for a specific fabric site by providing the unique fabric site id in the url path.\nThis API provides the latest health data until the given `endTime`. If data is not ready for the provided endTime, the request will fail with error code `400 Bad Request`, and the error message will indicate the recommended endTime to use to retrieve a complete data set. This behavior may occur if the provided endTime=currentTime, since we are not a real time system. When `endTime` is not provided, the API returns the latest data.\n\n "
operationId: readFabricSitesSummaryById
parameters:
- name: id
in: path
description: unique fabric site id
required: true
schema:
type: string
- name: X-CALLER-ID
in: header
description: 'Caller ID is used to trace the origin of API calls and their associated queries executed on the database. It''s an optional header parameter that can be added to an API request.
'
required: false
schema:
type: string
default: unknown
example: ui:client360
- name: startTime
in: query
description: 'Start time from which API queries the data set related to the resource. It must be specified in UNIX epochtime in milliseconds. Value is inclusive.
'
schema:
type: integer
format: int64
example: 1705348800000
- name: endTime
in: query
description: 'End time to which API queries the data set related to the resource. It must be specified in UNIX epochtime in milliseconds. Value is inclusive.
'
required: false
schema:
type: integer
format: int64
example: 1705435200000
- name: attribute
in: query
description: "Supported Attributes:\n\n[id, name, associatedL2VnCount, associatedL3VnCount, networkProtocol, totalDeviceCount, goodHealthPercentage, goodHealthDeviceCount,poorHealthDeviceCount,fairHealthDeviceCount, totalHealthDeviceCount, connectivityGoodHealthPercentage, connectivityTotalHealthDeviceCount, connectivityGoodHealthDeviceCount, connectivityPoorHealthDeviceCount, connectivityFairHealthDeviceCount, infraGoodHealthPercentage, infraTotalHealthDeviceCount, infraGoodHealthDeviceCount, infraPoorHealthDeviceCount, infraFairHealthDeviceCount, controlPlaneGoodHealthPercentage, controlPlaneTotalHealthDeviceCount, controlPlaneGoodHealthDeviceCount,controlPlanePoorHealthDeviceCount, controlPlaneFairHealthDeviceCount, pubsubInfraVnGoodHealthPercentage, pubsubInfraVnTotalHealthDeviceCount, pubsubInfraVnGoodHealthDeviceCount, pubsubInfraVnPoorHealthDeviceCount, pubsubInfraVnFairHealthDeviceCount, bgpEvpnGoodHealthPercentage, bgpEvpnTotalHealthDeviceCount, bgpEvpnGoodHealthDeviceCount,bgpEvpnPoorHealthDeviceCount, bgpEvpnFairHealthDeviceCount, ctsEnvDataDownloadGoodHealthPercentage, ctsEnvDataDownloadTotalHealthDeviceCount, ctsEnvDataDownloadGoodHealthDeviceCount, ctsEnvDataDownloadPoorHealthDeviceCount, ctsEnvDataDownloadFairHealthDeviceCount, aaaStatusGoodHealthPercentage, aaaStatusTotalHealthDeviceCount, aaaStatusGoodHealthDeviceCount, aaaStatusPoorHealthDeviceCount, aaaStatusFairHealthDeviceCount, portChannelGoodHealthPercentage, portChannelTotalHealthDeviceCount, portChannelGoodHealthDeviceCount, portChannelPoorHealthDeviceCount, portChannelFairHealthDeviceCount, peerScoreGoodHealthPercentage, peerScoreTotalHealthDeviceCount, peerScoreGoodHealthDeviceCount, peerScorePoorHealthDeviceCount, peerScoreFairHealthDeviceCount, lispSessionGoodHealthPercentage, lispSessionTotalHealthDeviceCount, lispSessionGoodHealthDeviceCount, lispSessionPoorHealthDeviceCount, lispSessionFairHealthDeviceCount, borderToControlPlaneGoodHealthPercentage, borderToControlPlaneTotalHealthDeviceCount, borderToControlPlaneGoodHealthDeviceCount, borderToControlPlanePoorHealthDeviceCount, borderToControlPlaneFairHealthDeviceCount, bgpBgpSiteGoodHealthPercentage, bgpBgpSiteTotalHealthDeviceCount, bgpBgpSiteGoodHealthDeviceCount, bgpBgpSitePoorHealthDeviceCount, bgpBgpSiteFairHealthDeviceCount, bgpPubsubSiteGoodHealthPercentage, bgpPubsubSiteTotalHealthDeviceCount, bgpPubsubSiteGoodHealthDeviceCount, bgpPubsubSitePoorHealthDeviceCount, bgpPubsubSiteFairHealthDeviceCount, bgpPeerInfraVnScoreGoodHealthPercentage, bgpPeerInfraVnTotalHealthDeviceCount, bgpPeerInfraVnGoodHealthDeviceCount, bgpPeerInfraVnPoorHealthDeviceCount, bgpPeerInfraVnFairHealthDeviceCount]\n\nIf length of attribute list is too long, please use 'view' param instead.\n\nExamples:\n\nattribute=GoodHealthPercentage (single attribute requested)\n\nattribute=GoodHealthPercentage&attribute=connectivityGoodHealthPercentage (multiple attributes requested) \n"
required: false
style: form
explode: true
schema:
type: array
items:
type: string
- name: view
in: query
description: "The specific summary view being requested. This is an optional parameter which can be passed to get one or more(upto 3 views) of the specific health data summaries associated with sites.\n\n### Response data proviced by each view: \n\n1. **fabricSiteInfo**\n[id, name, totalDeviceCount, associatedL2VnCount, associatedL3VnCount, networkProtocol] \n\n2. **overallHealth** \n[id, name, goodHealthPercentage, goodHealthDeviceCount, totalHealthDeviceCount, poorHealthDeviceCount, fairHealthDeviceCount, connectivityGoodHealthPercentage, connectivityTotalHealthDeviceCount, connectivityGoodHealthDeviceCount, connectivityPoorHealthDeviceCount, connectivityFairHealthDeviceCount, infraGoodHealthPercentage, infraTotalHealthDeviceCount, infraGoodHealthDeviceCount, infraPoorHealthDeviceCount, infraFairHealthDeviceCount, controlPlaneGoodHealthPercentage, controlPlaneTotalHealthDeviceCount, controlPlaneGoodHealthDeviceCount, controlPlanePoorHealthDeviceCount, controlPlaneFairHealthDeviceCount] \n\n3. **connectivityHealth**\n[id, name, connectivityGoodHealthPercentage, connectivityTotalHealthDeviceCount, connectivityGoodHealthDeviceCount, connectivityPoorHealthDeviceCount, connectivityFairHealthDeviceCount, bgpEvpnGoodHealthPercentage, bgpEvpnTotalHealthDeviceCount, bgpEvpnGoodHealthDeviceCount, bgpEvpnPoorHealthDeviceCount, bgpEvpnFairHealthDeviceCount, portChannelGoodHealthPercentage, portChannelTotalHealthDeviceCount, portChannelGoodHealthDeviceCount,portChannelPoorHealthDeviceCount, portChannelFairHealthDeviceCount, borderToControlPlaneGoodHealthPercentage, borderToControlPlaneTotalHealthDeviceCount, borderToControlPlaneGoodHealthDeviceCount,borderToControlPlanePoorHealthDeviceCount, borderToControlPlaneFairHealthDeviceCount, bgpPubsubSiteGoodHealthPercentage, bgpPubsubSiteTotalHealthDeviceCount, bgpPubsubSiteGoodHealthDeviceCount,bgpPubsubSitePoorHealthDeviceCount, bgpPubsubSiteFairHealthDeviceCount] \n\n4. **infraHealth** \n[id, name,infraGoodHealthPercentage, infraTotalHealthDeviceCount, infraGoodHealthDeviceCount, infraPoorHealthDeviceCount, infraFairHealthDeviceCount, pubsubInfraVnGoodHealthPercentage, pubsubInfraVnTotalHealthDeviceCount, pubsubInfraVnGoodHealthDeviceCount, pubsubInfraVnPoorHealthDeviceCount, pubsubInfraVnFairHealthDeviceCount, ctsEnvDataDownloadGoodHealthPercentage, ctsEnvDataDownloadTotalHealthDeviceCount, ctsEnvDataDownloadGoodHealthDeviceCount, ctsEnvDataDownloadPoorHealthDeviceCount, ctsEnvDataDownloadFairHealthDeviceCount, aaaStatusGoodHealthPercentage, aaaStatusTotalHealthDeviceCount, aaaStatusGoodHealthDeviceCount,aaaStatusPoorHealthDeviceCount, aaaStatusFairHealthDeviceCount, bgpPeerInfraVnScoreGoodHealthPercentage, bgpPeerInfraVnTotalHealthDeviceCount, bgpPeerInfraVnGoodHealthDeviceCount, bgpPeerInfraVnPoorHealthDeviceCount, bgpPeerInfraVnFairHealthDeviceCount, peerScoreGoodHealthPercentage, peerScoreTotalHealthDeviceCount, peerScoreGoodHealthDeviceCount,peerScorePoorHealthDeviceCount, peerScoreFairHealthDeviceCount]\n\n5. **controlPlaneHealth** \n [id, name, controlPlaneGoodHealthPercentage, controlPlaneTotalHealthDeviceCount, controlPlaneGoodHealthDeviceCount, controlPlanePoorHealthDeviceCount, controlPlaneFairHealthDeviceCount, lispSessionGoodHealthPercentage, lispSessionTotalHealthDeviceCount, lispSessionGoodHealthDeviceCount,lispSessionPoorHealthDeviceCount, lispSessionFairHealthDeviceCount, bgpBgpSiteGoodHealthPercentage, bgpBgpSiteTotalHealthDeviceCount, bgpBgpSiteGoodHealthDeviceCount,bgpBgpSitePoorHealthDeviceCount, bgpBgpSiteFairHealthDeviceCount] \n\n\nA maximum of 3 views can be queried at a time per request. \n\nWhen this query parameter is not added, the default summaries are: [fabricSiteInfo, overallHealth]\n\n**Examples**:\n1. Query Param:\n view=overallHealth (single view requested)\n\n view=fabricSiteInfo&view=overallHealth (multiple views requested)\n"
required: false
style: form
explode: true
schema:
type: array
items:
type: string
responses:
'200':
$ref: '#/components/responses/FabricSiteSummaryResponse'
'400':
$ref: '#/components/responses/400'
'500':
$ref: '#/components/responses/500'
1XX:
# --- truncated at 32 KB (79 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/cisco-catalyst-center/refs/heads/main/openapi/cisco-catalyst-center-fabricsitehealthsummaries-api-openapi.yml