{ "openapi": "3.0.0", "info": { "title": "CISCO-UBE-MIB MIB API", "version": "1.0.0", "description": "This MIB describes objects used for managing Cisco\n Unified Border Element (CUBE).\n \n The Cisco Unified Border Element (CUBE) is a Cisco \n IOS Session Border Controller (SBC) that interconnects\n independent voice over IP (VoIP) and video over IP \n networks for data, voice, and video transport\n\nāš ļø **IMPORTANT - MIB DATA ACCESS**:\nThis YANG model exists for SMIv2-to-YANG translation purposes, but MIB data on IOS-XE devices is primarily accessed via **SNMP protocol**, not RESTCONF.\n\n**RESTCONF Limitation**: Many MIB paths may return 404 errors via RESTCONF `/data` endpoints because the device exposes MIB data through SNMP, not the YANG datastore.\n\n**Recommended Access Methods**:\n- Use SNMP (v2c/v3) to query MIB data directly\n- Use NETCONF `` operations for devices supporting YANG-modeled MIB access\n- Check device capabilities: some newer IOS-XE versions may support limited RESTCONF access to specific MIBs\n\n**YANG Model Purpose**: These YANG models define the structure of SNMP MIBs in YANG format for tooling compatibility, but do not guarantee RESTCONF data availability.\n\n\n**šŸ“Š YANG Tree:** [View CISCO-UBE-MIB structure](https://jeremycohoe.github.io/cisco-ios-xe-openapi-swagger/yang-trees/CISCO-UBE-MIB.html)", "contact": { "name": "Cisco DevNet", "url": "https://developer.cisco.com" }, "x-yang-module": "CISCO-UBE-MIB", "x-model-type": "mib" }, "servers": [ { "url": "https://{device}/restconf", "description": "RESTCONF server", "variables": { "device": { "default": "10.1.1.1", "description": "Device hostname or IP address" } } } ], "paths": { "/data/CISCO-UBE-MIB:ciscoUbeMIBObjects": { "get": { "summary": "Get ciscoUbeMIBObjects data", "description": "Retrieve ciscoUbeMIBObjects operational data from MIB", "tags": [ "CISCO-UBE-MIB" ], "responses": { "200": { "description": "Success", "content": { "application/yang-data+json": { "schema": { "type": "object", "description": "This object represents, whether the Cisco\n Unified Border Element (CUBE) is enabled \n on the device or not.\n \n The value 'true' means that the CUBE feature \n is enabled on the device.\n \n The value 'false' means that the CUBE feature \n is disabled.", "properties": { "cubeEnabled": { "type": "boolean", "description": "This object represents, whether the Cisco\n Unified Border Element (CUBE) is enabled \n on the device or not.\n \n The value 'true' means that the CUBE feature \n is enabled on the device.\n \n The value 'false' means that the CUBE feature \n is disabled." }, "cubeVersion": { "type": "string", "description": "This object represents the version of Cisco\n Unified Border Element on the device.", "x-yang-type": "snmp-framework:SnmpAdminString" }, "cubeTotalSessionAllowed": { "type": "integer", "description": "This object provides the total number of CUBE\n session allowed on the device. The value zero \n means no sessions are allowed with CUBE.", "minimum": 0, "maximum": 4294967295 } } }, "example": { "CISCO-UBE-MIB:ciscoUbeMIBObjects": { "cubeEnabled": true, "cubeVersion": "example-string", "cubeTotalSessionAllowed": 0 } } } } }, "403": { "description": "Forbidden ā€” insufficient access rights (NACM)", "content": { "application/yang-data+json": { "schema": { "$ref": "#/components/schemas/restconf-error" } } } } }, "operationId": "get-ciscoUbeMIBObjects", "parameters": [ { "name": "Accept", "in": "header", "required": false, "description": "RESTCONF response media type (RFC 8040)", "schema": { "type": "string", "default": "application/yang-data+json", "enum": [ "application/yang-data+json", "application/yang-data+xml" ] } }, { "name": "depth", "in": "query", "required": false, "description": "Limit the depth of returned sub-tree data (RFC 8040 Section 4.8.2). Use 'unbounded' for full depth.", "schema": { "type": "string", "default": "unbounded" } }, { "name": "fields", "in": "query", "required": false, "description": "Select specific fields to return (RFC 8040 Section 4.8.3). Example: fields=name;status", "schema": { "type": "string" } }, { "name": "content", "in": "query", "required": false, "description": "Filter by config state: 'config' (config true only), 'nonconfig' (config false only), or 'all'.", "schema": { "type": "string", "enum": [ "config", "nonconfig", "all" ], "default": "all" } } ] }, "x-yang-path": "/ciscoUbeMIBObjects", "x-restconf-kind": "container" } }, "components": { "schemas": { "CISCO-UBE-MIB_CISCO-UBE-MIB": { "type": "object", "description": "This object represents, whether the Cisco\n Unified Border Element (CUBE) is enabled \n on the device or not.\n \n The value 'true' means that the CUBE feature \n is enabled on the device.\n \n The value 'false' means that the CUBE feature \n is disabled.", "properties": { "ciscoUbeMIBObjects": { "type": "object", "description": "This object represents, whether the Cisco\n Unified Border Element (CUBE) is enabled \n on the device or not.\n \n The value 'true' means that the CUBE feature \n is enabled on the device.\n \n The value 'false' means that the CUBE feature \n is disabled.", "properties": { "cubeEnabled": { "type": "boolean", "description": "This object represents, whether the Cisco\n Unified Border Element (CUBE) is enabled \n on the device or not.\n \n The value 'true' means that the CUBE feature \n is enabled on the device.\n \n The value 'false' means that the CUBE feature \n is disabled.", "readOnly": true }, "cubeVersion": { "type": "string", "description": "This object represents the version of Cisco\n Unified Border Element on the device.", "x-yang-type": "snmp-framework:SnmpAdminString", "readOnly": true }, "cubeTotalSessionAllowed": { "type": "integer", "description": "This object provides the total number of CUBE\n session allowed on the device. The value zero \n means no sessions are allowed with CUBE.", "minimum": 0, "maximum": 4294967295, "readOnly": true } }, "readOnly": true } } }, "restconf-error": { "type": "object", "description": "Standard RESTCONF error response (RFC 8040 Section 7.1)", "properties": { "ietf-restconf:errors": { "type": "object", "properties": { "error": { "type": "array", "items": { "type": "object", "properties": { "error-type": { "type": "string", "enum": [ "transport", "rpc", "protocol", "application" ], "description": "Layer where the error occurred" }, "error-tag": { "type": "string", "description": "Enumerated error tag (e.g. invalid-value, data-missing, access-denied)" }, "error-severity": { "type": "string", "enum": [ "error", "warning" ], "description": "Error severity" }, "error-app-tag": { "type": "string", "description": "Application-specific error tag" }, "error-path": { "type": "string", "description": "YANG instance-identifier of the error node" }, "error-message": { "type": "string", "description": "Human-readable error description" } }, "required": [ "error-type", "error-tag" ] } } } } }, "example": { "ietf-restconf:errors": { "error": [ { "error-type": "protocol", "error-tag": "invalid-value", "error-severity": "error", "error-message": "Invalid input parameter" } ] } } } }, "securitySchemes": { "basicAuth": { "type": "http", "scheme": "basic" } } }, "security": [ { "basicAuth": [] } ], "tags": [ { "name": "CISCO-UBE-MIB", "description": "MIB operations for CISCO-UBE-MIB" } ], "externalDocs": { "description": "Cisco SNMP Object Navigator", "url": "https://snmp.cloudapps.cisco.com/Support/IOS/do/BrowseMIB.do" } }