Table of Contents

...

To start TEIV navigate to the 'docker-compose' directory in the 'teiv' repo and run 'docker-compose up'. This will bring up 3 Kafka containers, Zookeeper, PostgreSQL using PostGIS, TEIV Exposure, and TEIV Ingestion. The TEIV Ingestion and an optional kafka-producer service that will populate the database automatically, allowing you to query the database straight away.

If the kafka-producer isn't needed you can comment it out in the docker-compose.yml file. If commented out database won't be populated with any topology data, but the 'cloudEventProducer.sh' script in 'docker-compose/cloudEventProducer' can be used to populate the database with sample data that will enable querying of the database.

...

language	text
title	Example Data
linenumbers	true
collapse	true

...

Sample data can be found at docker-compose/cloudEventProducer/events

Sample API calls

To get a list of all API calls and details go to TEIV API docu mentation.

To get a list of supported domains click here.

Postman collection

Collection: Query TEIV.postman_collection.json

Environment: TEIV.postman_environment.json

Retrieving and using topology modules

Topology & Inventory provides APIs to enable users to query module data that can be used to understand the existing topology and inventory model, parse the modules, and understand what objects are supported over the R1 interface, so adequate queries can be made on topology and inventory data.

The API endpoints returning lists support pagination. The default value for number of items returned is 500, which is also the upper limit.

Sample request to fetch a list of all domains in TEIV:

Code Block

language	xml

GET https://<host>/topology-inventory/<API_VERSION>/domains

Response:

Code Block

title	GET domains Response
linenumbers	true
collapse	true

{
    "items": [
         {
"fdn": "ManagedElement=NR01",           "cmIdname": {"CLOUD",
            "cmHandleentityTypes": "9D2C7AA8AECF0B5FDE21FDBD2B93EEAG",{
              "resourceIdentifier  "href": "/domains/CLOUD/o-ran-smo-ComTop:ManagedElement[@id=NR01]"
   entity-types"
      }         }
  },
   }     ],     "o-ran-smo-teiv-ran:GNBDUFunction"relationshipTypes": {
[       {         "idhref": "urn:3gpp:dn:ManagedElement=NR01,GNBDUFunction=1",/domains/CLOUD/relationship-types"
        "attributes": {   }
       "gNBDUId": 1},
        {
 "gNBId": 1,           "gNBIdLengthname": 23"EQUIPMENT",
            "dUpLMNIdentityTypes": {
                "mcchref": 353,"/domains/EQUIPMENT/entity-types"
            "mnc": 87},
            },
"relationshipTypes": {
         "fdn": "ManagedElement=NR01,GNBDUFunction=1",
          "cmIdhref": {"/domains/EQUIPMENT/relationship-types"
            "cmHandle": "9D2C7AA8AECF0B5FDE21FDBD2B93EEAG",}
        },
    "resourceIdentifier": "/o-ran-smo-ComTop:ManagedElement[@id=NR01]/o-ran-smo-GNBDU:GNBDUFunction[@id=1]"    {
      }         }"name": "OAM",
       }
    ],     "o-ran-smo-teiv-ran:NRSectorCarrierentityTypes": [
      {
        "id": "urn:3gpp:dn:ManagedElement=NR01,GNBDUFunction=1,NRSectorCarrier=1",
        "attributes": {
          "arfcnDL": 4000,
          "arfcnUL": 40000,
          "frequencyDL": 4,
          "frequencyUL": 40,
          "fdn": "ManagedElement=NR01,GNBDUFunction=1,NRSectorCarrier=1",
          "cmId": {
            "cmHandle": "9D2C7AA8AECF0B5FDE21FDBD2B93EEAG",
            "resourceIdentifier": "/o-ran-smo-ComTop:ManagedElement[@id=NR01]/o-ran-smo-GNBDU:GNBDUFunction[@id=1]/o-ran-smo-GNBDU:NRSectorCarrier[@id=1]"
          }
        }
      },
      {
        "id": "urn:3gpp:dn:ManagedElement=NR01,GNBDUFunction=1,NRSectorCarrier=2",
        "attributes": {
          "arfcnDL": 5000,
          "arfcnUL": 50000,
          "frequencyDL": 5,
          "frequencyUL": 50,
          "fdn": "ManagedElement=NR01,GNBDUFunction=1,NRSectorCarrier=2",
          "cmId": {
            "cmHandle": "9D2C7AA8AECF0B5FDE21FDBD2B93EEAG",
            "resourceIdentifier": "/o-ran-smo-ComTop:ManagedElement[@id=NR01]/o-ran-smo-GNBDU:GNBDUFunction[@id=1]/o-ran-smo-GNBDU:NRSectorCarrier[@id=2]"
          }
        }
      },
      {
        "id": "urn:3gpp:dn:ManagedElement=NR01,GNBDUFunction=1,NRSectorCarrier=3",
        "attributes": {
          "arfcnDL": 6000,
          "arfcnUL": 60000,
          "frequencyDL": 6,
          "frequencyUL": 60,
          "fdn": "ManagedElement=NR01,GNBDUFunction=1,NRSectorCarrier=3",
          "cmId": {
            "cmHandle": "9D2C7AA8AECF0B5FDE21FDBD2B93EEAG",
            "resourceIdentifier": "/o-ran-smo-ComTop:ManagedElement[@id=NR01]/o-ran-smo-GNBDU:GNBDUFunction[@id=1]/o-ran-smo-GNBDU:NRSectorCarrier[@id=3]"
          }
        }
      }
    ],
    "o-ran-smo-teiv-ran:NRCellDU": [
      {
        "id": "urn:3gpp:dn:ManagedElement=NR01,GNBDUFunction=1,NRCellDU=1",
        "attributes": {
          "cellLocalId": 1,
          "nRTAC": 40,
          "nRPCI": 400,
          "nCI": 24577,
          "fdn": "ManagedElement=NR01,GNBDUFunction=1,NRCellDU=1",
          "cmId": {
            "cmHandle": "9D2C7AA8AECF0B5FDE21FDBD2B93EEAG",
            "resourceIdentifier": "/o-ran-smo-ComTop:ManagedElement[@id=NR01]/o-ran-smo-GNBDU:GNBDUFunction[@id=1]/o-ran-smo-GNBDU:NRCellDU[@id=1]"
          }
        }
      },
      {
        "id": "urn:3gpp:dn:ManagedElement=NR01,GNBDUFunction=1,NRCellDU=2",
        "attributes": {
          "cellLocalId": 2,
          "nRTAC": 50,
          "nRPCI": 500,
          "nCI": 24578,
          "fdn": "ManagedElement=NR01,GNBDUFunction=1,NRCellDU=2",
          "cmId": {
            "cmHandle": "9D2C7AA8AECF0B5FDE21FDBD2B93EEAG",
            "resourceIdentifier": "/o-ran-smo-ComTop:ManagedElement[@id=NR01]/o-ran-smo-GNBDU:GNBDUFunction[@id=1]/o-ran-smo-GNBDU:NRCellDU[@id=2]"
          }
        }
      }
    ],
    "o-ran-smo-teiv-ran:AntennaCapability": [
      {
        "id": "urn:3gpp:dn:ManagedElement=NR01,NodeSupport=1,SectorEquipmentFunction=1",
        "attributes": {
          "eUtranFqBands": "[1,2,3]",
          "geranFqBands": "[10,11,12]",
          "nRFqBands": "[100,101,102]",
          "fdn": "ManagedElement=NR01,NodeSupport=1,SectorEquipmentFunction=1",
          "cmId": {
            "cmHandle": "9D2C7AA8AECF0B5FDE21FDBD2B93EEAG",
            "resourceIdentifier": "/o-ran-smo-ComTop:ManagedElement[@id=NR01]/o-ran-smo-ComTop:NodeSupport[@id=1]/o-ran-smo-RmeSectorEquipmentFunction:SectorEquipmentFunction[@id=1]"
          }
        }
      },
      {
        "id": "urn:3gpp:dn:ManagedElement=NR01,NodeSupport=1,SectorEquipmentFunction=2",
        "attributes": {
          "eUtranFqBands": "[4,5,6]",
          "geranFqBands": "[13,14,15]",
          "nRFqBands": "[103,104,105]",
          "fdn": "ManagedElement=NR01,NodeSupport=1,SectorEquipmentFunction=2",
          "cmId": {
            "cmHandle": "9D2C7AA8AECF0B5FDE21FDBD2B93EEAG",
            "resourceIdentifier": "/o-ran-smo-ComTop:ManagedElement[@id=NR01]/o-ran-smo-ComTop:NodeSupport[@id=1]/o-ran-smo-RmeSectorEquipmentFunction:SectorEquipmentFunction[@id=2]"
          }
        }
      }
    ],
    "o-ran-smo-teiv-equipment:AntennaModule": [
      {
        "id": "urn:o-ran:smo-teiv-equipment:1",
        "attributes": {
          "antennaModelNumber": "1",
          "mechanicalAntennaBearing": 50,
          "mechanicalAntennaTilt": 10,
          "positionWithinSector": "Unknown",
          "totalTilt": 14,
          "electricalAntennaTilt": 2,
          "fdn": "Unknown",
          "cmId": {
            "cmHandle": "9D2C7AA8AECF0B5FDE21FDBD2B93EEAG",
            "resourceIdentifier": "Unknown"
          }
        }
      },
      {
        "id": "urn:o-ran:smo-teiv-equipment:2",
        "attributes": {
          "antennaModelNumber": "2",
          "mechanicalAntennaBearing": 45,
          "mechanicalAntennaTilt": 12,
          "positionWithinSector": "Unknown",
          "totalTilt": 15,
          "electricalAntennaTilt": 1,
          "fdn": "Unknown",
          "cmId": {
            "cmHandle": "9D2C7AA8AECF0B5FDE21FDBD2B93EEAG",
            "resourceIdentifier": "Unknown"
          }
        }
      }
    ],
    "o-ran-smo-teiv-equipment:Site": [
      {
        "id": "urn:o-ran:smo-teiv-equipment:1",
        "attributes": {
          "name": "Site-1",
          "geo-location": {
            "latitude": 41.73297,
            "longitude": -78.007696
          },
          "cmId": {
            "cmHandle": "9D2C7AA8AECF0B5FDE21FDBD2B93EEAG",
            "resourceIdentifier": "Unknown"
          }
        }
      },
      {
        "id": "urn:o-ran:smo-teiv-equipment:2",
        "attributes": {
          "name": "Site-2",
          "geo-location": {
            "latitude": 46.73297,
            "longitude": -76.007696
          },
          "cmId": {
            "cmHandle": "9D2C7AA8AECF0B5FDE21FDBD2B93EEAG",
            "resourceIdentifier": "Unknown"
          }
        }
      }
    ],
    "o-ran-smo-teiv-ran:Sector": [
      {
        "id": "urn:o-ran:smo-teiv-ran:1",
        "attributes": {
          "sectorId": 1,
          "azimuth": 75.345,
          "geo-location": {
            "latitude": 40.73297,
            "longitude": -74.007696
          }
        }
      },
      {
        "id": "urn:o-ran:smo-teiv-ran:2",
        "attributes": {
          "sectorId": 2,
          "azimuth": 90.8967,
          "geo-location": {
            "latitude": 41.73297,
            "longitude": -73.007696
          }
        }
      }
    ],
    "o-ran-smo-teiv-cloud:CloudifiedNF": [
      {
        "id": "urn:o-ran:smo-teiv-cloud:1",
        "attributes": {
          "name": "CloudifiedNF-1"
        }
      }
    ],
    "o-ran-smo-teiv-cloud:NFDeployment": [
      {
        "id": "urn:o-ran:smo-teiv-cloud:1",
        "attributes": {
          "name": "NFDeployment-1"
        }
      }
    ]
  },
  "relationships": {
    "o-ran-smo-teiv-oam-to-ran:MANAGEDELEMENT_MANAGES_GNBDUFUNCTION": [
      {
        "id": "urn:o-ran:smo-teiv-oam-to-logical:1",
        "aSide": "urn:3gpp:dn:ManagedElement=NR01",
        "bSide": "urn:3gpp:dn:ManagedElement=NR01,GNBDUFunction=1"
      }
    ],
    "o-ran-smo-teiv-ran:GNBDUFUNCTION_PROVIDES_NRSECTORCARRIER": [
      {
        "id": "urn:o-ran:smo-teiv-ran:1",
        "aSide": "urn:3gpp:dn:ManagedElement=NR01,GNBDUFunction=1",
        "bSide": "urn:3gpp:dn:ManagedElement=NR01,GNBDUFunction=1,NRSectorCarrier=1"
      },
      {
        "id": "urn:o-ran:smo-teiv-ran:2",
        "aSide": "urn:3gpp:dn:ManagedElement=NR01,GNBDUFunction=1",
        "bSide": "urn:3gpp:dn:ManagedElement=NR01,GNBDUFunction=1,NRSectorCarrier=2"
      },
      {
        "id": "urn:o-ran:smo-teiv-ran:3",
        "aSide": "urn:3gpp:dn:ManagedElement=NR01,GNBDUFunction=1",
        "bSide": "urn:3gpp:dn:ManagedElement=NR01,GNBDUFunction=1,NRSectorCarrier=3"
      }
    ],
    "o-ran-smo-teiv-ran:GNBDUFUNCTION_PROVIDES_NRCELLDU": [
      {
        "id": "urn:o-ran:smo-teiv-ran:1",
        "aSide": "urn:3gpp:dn:ManagedElement=NR01,GNBDUFunction=1",
        "bSide": "urn:3gpp:dn:ManagedElement=NR01,GNBDUFunction=1,NRCellDU=1"
      },
      {
        "id": "urn:o-ran:smo-teiv-ran:2",
        "aSide": "urn:3gpp:dn:ManagedElement=NR01,GNBDUFunction=1",
        "bSide": "urn:3gpp:dn:ManagedElement=NR01,GNBDUFunction=1,NRCellDU=2"
      }
    ],
    "o-ran-smo-teiv-ran:NRCELLDU_USES_NRSECTORCARRIER": [
      {
        "id": "urn:o-ran:smo-teiv-ran:1",
        "aSide": "urn:3gpp:dn:ManagedElement=NR01,GNBDUFunction=1,NRCellDU=1",
        "bSide": "urn:3gpp:dn:ManagedElement=NR01,GNBDUFunction=1,NRSectorCarrier=1"
      },
      {
        "id": "urn:o-ran:smo-teiv-ran:2",
        "aSide": "urn:3gpp:dn:ManagedElement=NR01,GNBDUFunction=1,NRCellDU=2",
        "bSide": "urn:3gpp:dn:ManagedElement=NR01,GNBDUFunction=1,NRSectorCarrier=2"
      },
      {
        "id": "urn:o-ran:smo-teiv-ran:3",
        "aSide": "urn:3gpp:dn:ManagedElement=NR01,GNBDUFunction=1,NRCellDU=2",
        "bSide": "urn:3gpp:dn:ManagedElement=NR01,GNBDUFunction=1,NRSectorCarrier=3"
      }
    ],
    "o-ran-smo-teiv-ran:NRSECTORCARRIER_USES_ANTENNACAPABILITY": [
      {
        "id": "urn:o-ran:smo-teiv-ran:1",
        "aSide": "urn:3gpp:dn:ManagedElement=NR01,GNBDUFunction=1,NRSectorCarrier=1",
        "bSide": "urn:3gpp:dn:ManagedElement=NR01,NodeSupport=1,SectorEquipmentFunction=1"
      },
      {
        "id": "urn:o-ran:smo-teiv-ran:2",
        "aSide": "urn:3gpp:dn:ManagedElement=NR01,GNBDUFunction=1,NRSectorCarrier=2",
        "bSide": "urn:3gpp:dn:ManagedElement=NR01,NodeSupport=1,SectorEquipmentFunction=2"
      },
      {
        "id": "urn:o-ran:smo-teiv-ran:3",
        "aSide": "urn:3gpp:dn:ManagedElement=NR01,GNBDUFunction=1,NRSectorCarrier=3",
        "bSide": "urn:3gpp:dn:ManagedElement=NR01,NodeSupport=1,SectorEquipmentFunction=2"
      }
    ],
    "o-ran-smo-teiv-equipment-to-ran:ANTENNAMODULE_SERVES_ANTENNACAPABILITY": [
      {
        "id": "urn:o-ran:smo-teiv-equipment-to-ran:1",
        "aSide": "urn:o-ran:smo-teiv-equipment:1",
        "bSide": "urn:3gpp:dn:ManagedElement=NR01,NodeSupport=1,SectorEquipmentFunction=1"
      },
      {
        "id": "urn:o-ran:smo-teiv-equipment-to-ran:2",
        "aSide": "urn:o-ran:smo-teiv-equipment:2",
        "bSide": "urn:3gpp:dn:ManagedElement=NR01,NodeSupport=1,SectorEquipmentFunction=2"
      }
    ],
    "o-ran-smo-teiv-equipment:ANTENNAMODULE_INSTALLED_AT_SITE": [
      {
        "id": "urn:o-ran:smo-teiv-equipment:1",
        "aSide": "urn:o-ran:smo-teiv-equipment:1",
        "bSide": "urn:o-ran:smo-teiv-equipment:1"
      },
      {
        "id": "urn:o-ran:smo-teiv-equipment:2",
        "aSide": "urn:o-ran:smo-teiv-equipment:2",
        "bSide": "urn:o-ran:smo-teiv-equipment:2"
      }
    ],
    "o-ran-smo-teiv-equipment-to-ran:SECTOR_GROUPS_NRCELLDU": [
      {
        "id": "urn:o-ran:smo-teiv-equipment-to-ran:1",
        "aSide": "urn:o-ran:smo-teiv-ran:1",
        "bSide": "urn:3gpp:dn:ManagedElement=NR01,GNBDUFunction=1,NRCellDU=1"
      },
      {
        "id": "urn:o-ran:smo-teiv-equipment-to-ran:2",
        "aSide": "urn:o-ran:smo-teiv-ran:2",
        "bSide": "urn:3gpp:dn:ManagedElement=NR01,GNBDUFunction=1,NRCellDU=2"
      },
      {
        "id": "urn:o-ran:smo-teiv-equipment-to-ran:3",
        "aSide": "urn:o-ran:smo-teiv-ran:2",
        "bSide": "urn:3gpp:dn:ManagedElement=NR01,GNBDUFunction=1,NRCellDU=3"
      }
    ],
    "o-ran-smo-teiv-oam-to-cloud:NFDEPLOYMENT_SERVES_MANAGEDELEMENT": [
      {
        "id": "urn:o-ran:smo-teiv-oam-to-cloud:1",
        "aSide": "urn:o-ran:smo-teiv-cloud:1",
        "bSide": "urn:3gpp:dn:ManagedElement=NR01"
      }
    ],
    "o-ran-smo-teiv-oam-to-cloud:MANAGEDELEMENT_DEPLOYED_AS_CLOUDIFIEDNF": [
      {
        "id": "urn:o-ran:smo-teiv-oam-to-cloud:1",
        "aSide": "urn:3gpp:dn:ManagedElement=NR01",
        "bSide": "urn:o-ran:smo-teiv-cloud:1"
      }
    ],
    "o-ran-smo-teiv-cloud:CLOUDIFIEDNF_COMPRISES_NFDEPLOYMENT": [
      {
        "id": "urn:o-ran:smo-teiv-cloud:1",
        "aSide": "urn:o-ran:smo-teiv-cloud:1",
        "bSide": "urn:o-ran:smo-teiv-cloud:1"
      }
    ],
    "o-ran-smo-teiv-cloud-to-ran:NFDEPLOYMENT_SERVES_GNBDUFUNCTION": [
      {
        "id": "urn:o-ran:smo-teiv-cloud-to-ran:1",
        "aSide": "urn:o-ran:smo-teiv-cloud:1",
        "bSide": "urn:3gpp:dn:ManagedElement=NR01,GNBDUFunction=1"
      }
    ]
  }
}

Sample API calls

To get a list of all API calls and details go to TEIV API docu mentation.

To get a list of supported domains click here.

Postman collection

Collection: Query TEIV.postman_collection.json

Environment: TEIV.postman_environment.json

Retrieving and using topology modules

Topology & Inventory provides APIs to enable users to query module data that can be used to understand the existing topology and inventory model, parse the modules, and understand what objects are supported over the R1 interface, so adequate queries can be made on topology and inventory data.

The API endpoints returning lists support pagination. The default value for number of items returned is 500, which is also the upper limit.

Sample request to fetch a list of all domains in TEIV:

Code Block

language	xml

GET https://<host>/topology-inventory/<API_VERSION>/domains

Response:

Code Block

title	GET domains Response
linenumbers	true
collapse	true

{
    "items": [        "href": "/domains/OAM/entity-types"
            },
            "relationshipTypes": {
                "href": "/domains/OAM/relationship-types"
            }
        },
        {
            "name": "CLOUDRAN",
            "entityTypes": {
                "href": "/domains/CLOUDRAN/entity-types"
            },
            "relationshipTypes": {
                "href": "/domains/CLOUDRAN/relationship-types"
            }
        },
        {
            "name": "REL_CLOUD_TO_RAN",
            "entityTypes": {
                "href": "/domains/REL_CLOUD_TO_RAN/entity-types"
            },
            "relationshipTypes": {
                "href": "/domains/REL_CLOUD_TO_RAN/relationship-types"
            }
        },
        {
            "name": "REL_EQUIPMENT_RAN",
            "entityTypes": {
                "href": "/domains/REL_EQUIPMENT_RAN/entity-types"
            },
            "relationshipTypes": {
                "href": "/domains/REL_EQUIPMENT_RAN/relationship-types"
            }
        },
        {
            "name": "EQUIPMENTREL_TOOAM_RANCLOUD",
            "entityTypes": {
                "href": "/domains/EQUIPMENTREL_TOOAM_RANCLOUD/entity-types"
            },
            "relationshipTypes": {
                "href": "/domains/EQUIPMENTREL_TOOAM_RANCLOUD/relationship-types"
            }
        },
        {
            "name": "REL_OAM_RAN",
            "entityTypes": {
                "href": "/domains/REL_OAM_RAN/entity-types"
            },
            "relationshipTypes": {
                "href": "/domains/REL_OAM_RAN/relationship-types"
            }
        },
        {
            "name": "OAM_TO_CLOUDTEIV",
            "entityTypes": {
                "href": "/domains/OAM_TO_CLOUDTEIV/entity-types"
            },
            "relationshipTypes": {
                "href": "/domains/OAM_TO_CLOUDTEIV/relationship-types"
            }
        }
    ],
    "self": {
  {      "href": "/domains?offset=0&limit=500"
    },
    "namefirst": {
     "OAM_TO_RAN",
     "href": "/domains?offset=0&limit=500"
    },
    "entityTypesprev": {
     
          "href": "/domains/OAM_TO_RAN/entity-types"?offset=0&limit=500"
    },
    "next": {
      },  "href": "/domains?offset=0&limit=500"
    },
    "relationshipTypeslast": {
        "href": "/domains?offset=0&limit=500"
    },
    "hreftotalCount": "/domains/OAM_TO_RAN/relationship-types"
 9
}

...

Sample request to fetch a list of all modules in TEIV:

Code Block

language	xml

GET https://<host>/topology-inventory/<API_VERSION>/schemas

Response:

Code Block

language	text
title	GET schemas Response
linenumbers	true
collapse	true

{
           }
        },"items": [
         {
            "name": "RAN_3gpp-common-yang-extensions",
            "entityTypesdomain": {
"",
               "hrefrevision": "/domains/RAN/entity-types"
            }2019-06-23",
            "relationshipTypescontent": {
                "href": "/domains/RAN/relationship-typesschemas/_3gpp-common-yang-extensions/content"
            }
        },
        {
            "name": "TEIV_3gpp-common-yang-types",
            "entityTypesdomain": {
                "href": "/domains/TEIV/entity-types" "",
            } "revision": "2022-07-26",
            "relationshipTypescontent": {
                "href": "/domains/TEIV/relationshipschemas/_3gpp-common-yang-types/content"
            }
        },
      ],  {
  "self": {         "hrefname": "/domains?offset=0&limit=500"
    }ietf-geo-location",
    "first": {         "hrefdomain": "/domains?offset=0&limit=500"
    },
    "prev": {
        "hrefrevision": "/domains?offset=0&limit=500"2022-02-11",
      },      "nextcontent": {
          "href": "/domains?offset=0&limit=500"      "href":  },"/schemas/ietf-geo-location/content"
     "last": {      }
  "href": "/domains?offset=0&limit=500"     },
    "totalCount":  9 }

Sample request to fetch a list of all modules in TEIV:

Code Block

language	xml

GET https://<host>/topology-inventory/<API_VERSION>/schemas

Response:

Code Block

language	text
title	GET schemas Response
linenumbers	true
collapse	true

{
    "items": [         {"name": "ietf-inet-types",
            "domain": []"",
            "namerevision": "o-ran-smo-teiv-common-yang-extensions2013-07-15",
            "content": {
                "href": "/schemas/oietf-ran-smo-teiv-common-yang-extensionsinet-types/content"
            },
            "revision": "2024-05-02"
        },
        {
            "domainname": ["ietf-yang-types",
                "OAM_TO_CLOUD"
            ]"domain": "",
            "namerevision": "o2013-ran-smo-teiv-oam-to-cloud07-15",
            "content": {
                "href": "/schemas/oietf-ran-smo-teiv-oam-to-cloudyang-types/content"
            },
        },
       "revision": "2024-05-02" {
        },         {"name": "o-ran-smo-teiv-cloud",
            "domain": []"CLOUD",
            "namerevision": "o2024-ran-smo-teiv-common-yang-types05-02",
            "content": {
                "href": "/schemas/o-ran-smo-teiv-common-yang-typescloud/content"
            },
        },
   "revision": "2024-05-02"    {
    },         {"name": "o-ran-smo-teiv-common-yang-extensions",
            "domain": ["",
            "revision": "2024-05-24",
    "OAM"        "content": {
   ],             "namehref": "/schemas/o-ran-smo-teiv-oam",
 common-yang-extensions/content"
            }
        },
 "content": {       {
            "hrefname": "/schemas/o-ran-smo-teiv-oam/content"-common-yang-types",
            }"domain": "",
            "revision": "2024-05-0224",
        },    "content": {
   {             "domainhref": [ "/schemas/o-ran-smo-teiv-common-yang-types/content"
            }
    "OAM_TO_RAN"    },
        ],{
            "name": "o-ran-smo-teiv-oam-to-ranequipment",
            "contentdomain": {
   "EQUIPMENT",
            "hrefrevision": "/schemas/o-ran-smo-teiv-oam-to-ran/content"2024-05-24",
            },"content": {
                "revisionhref": "2024-05-02/schemas/o-ran-smo-teiv-equipment/content"
        },    }
    {        },
    "domain": [   {
            "name": "RAN"o-ran-smo-teiv-oam",
            ]"domain": "OAM",
            "namerevision": "o2024-ran-smo-teiv-ran05-24",
            "content": {
                "href": "/schemas/o-ran-smo-teiv-ranoam/content"
            },
        },
   "revision": "2024-05-02"    {
    },         {"name": "o-ran-smo-teiv-ran",
            "domain": "RAN",
[            "revision": "2024-05-24",
    "EQUIPMENT"        "content": {
   ],             "namehref": "/schemas/o-ran-smo-teiv-equipment",ran/content"
            }
         "content": {},
        {
            "hrefname": "/schemas/o-ran-smo-teiv-equipment/content"rel-cloud-ran",
            }"domain": "REL_CLOUD_RAN",
            "revision": "2024-05-02",
        },    "content": {
   {             "domainhref": [ "/schemas/o-ran-smo-teiv-rel-cloud-ran/content"
            }
    "CLOUD_TO_RAN"    },
        ],{
            "name": "o-ran-smo-teiv-cloudrel-toequipment-ran",
            "contentdomain": {"REL_EQUIPMENT_RAN",
                "hrefrevision": "/schemas/o-ran-smo-teiv-cloud-to-ran/content"2024-05-24",
            "content": {
   },             "revisionhref": "2024-05-02/schemas/o-ran-smo-teiv-rel-equipment-ran/content"
        },    }
    {    },
        "domain":{
[                 "CLOUD""name": "o-ran-smo-teiv-rel-oam-cloud",
             ]"domain": "REL_OAM_CLOUD",
            "namerevision": "o2024-ran-smo-teiv-cloud05-02",
            "content": {
                "href": "/schemas/o-ran-smo-teiv-rel-oam-cloud/content"
            },
            "revision": "2024-05-02"
        },
        {
            "domainname": ["o-ran-smo-teiv-rel-oam-ran",
                "EQUIPMENT_TO_RAN"
            ]"domain": "REL_OAM_RAN",
            "namerevision": "o-ran-smo-teiv-equipment-to-ran2024-05-24",
            "content": {
                "href": "/schemas/o-ran-smo-teiv-equipmentrel-tooam-ran/content"
            },
            "revision": "2024-05-02"
        }
    ],
    "self": {
        "href": "/schemas?offset=0&limit=500"
    },
    "first": {
        "href": "/schemas?offset=0&limit=500"
    },
    "prev": {
        "href": "/schemas?offset=0&limit=500"
    },
    "next": {
        "href": "/schemas?offset=0&limit=500"
    },
    "last": {
        "href": "/schemas?offset=0&limit=500"
    },
    "totalCount": 1015
}

...

Sample request to fetch a list of all modules related to the CLOUD domain:

To get a list of all modules for a specific domain, use a domain query parameter. The query parameter is case sensitive.

Note: - Partial matches are also supported in the query parameter using ’.*’ as a wild card. - If the specified domain does not exist, an empty list is returned.

Code Block

language	xml

GET https://<host>/topology-inventory/<API_VERSION>/schemas?domain=.*CLOUD.*

...

Code Block

language	text
title	GET CLOUD Schema Response
linenumbers	true
collapse	true

{
    "items": [
        {
            "domainname": ["o-ran-smo-teiv-cloud",
                "OAM_TO_CLOUD"
            ]"domain": "CLOUD",
            "namerevision": "o2024-ran-smo-teiv-oam-to-cloud05-02",
            "content": {
                "href": "/schemas/o-ran-smo-teiv-oam-to-cloud/content"
            },
            "revision": "2024-05-02"
   
    },        }
{        },
    "domain": [   {
             "CLOUD_TO_RAN""name": "o-ran-smo-teiv-rel-cloud-ran",
             ]"domain": "REL_CLOUD_RAN",
            "namerevision": "o2024-ran-smo-teiv-cloud-to-ran05-02",
            "content": {
                "href": "/schemas/o-ran-smo-teiv-rel-cloud-to-ran/content"
            },
 
          "revision": "2024-05-02"
        },
        {
            "domainname": ["o-ran-smo-teiv-rel-oam-cloud",
                "CLOUD"
            ]"domain": "REL_OAM_CLOUD",
            "namerevision": "o-ran-smo-teiv-cloud"2024-05-02",
            "content": {
                "href": "/schemas/o-ran-smo-teiv-rel-oam-cloud/content"
            },
            "revision": "2024-05-02"
        }
    ],
    "self": {
        "href": "/schemas?offset=0&limit=500&domain=.*CLOUD.*"
    },
    "first": {
        "href": "/schemas?offset=0&limit=500&domain=.*CLOUD.*"
    },
    "prev": {
        "href": "/schemas?offset=0&limit=500&domain=.*CLOUD.*"
    },
    "next": {
        "href": "/schemas?offset=0&limit=500&domain=.*CLOUD.*"
    },
    "last": {
        "href": "/schemas?offset=0&limit=500&domain=.*CLOUD.*"
    },
    "totalCount": 3
}

...

Sample request to fetch the module data for the o-ran-smo-teiv-oam module:

To get a specific module, supply a module name in the path parameter.

Code Block

language	xml

GET https://<host>/topology-inventory/<API_VERSION>/schemas/o-ran-smo-teiv-oam/content

...

Code Block

language	xml

GET https://<host>/topology-inventory/<API_VERSION>/domains/EQUIPMENT/entity-types

Response:

Code Block

language	text
title	GET domain entity types Response
linenumbers	true
collapse	true

{
    "items": [
        {
            "name": "AntennaModule",
            "entities": {
                "href": "/domains/EQUIPMENT/entity-types/AntennaModule/entities"
            }
        },
        {
            "name": "PhysicalNF",
            "entities": {
                "href": "/domains/EQUIPMENT/entity-types/PhysicalNF/entities"
            }
        },
        {
            "name": "Site",
            "entities": {
                "href": "/domains/EQUIPMENT/entity-types/Site/entities"
            }
        }
    ],
    "self": {
        "href": "/domains/EQUIPMENT/entity-types?offset=0&limit=500"
    },
    "first": {
        "href": "/domains/EQUIPMENT/entity-types?offset=0&limit=500"
    },
    "prev": {
        "href": "/domains/EQUIPMENT/entity-types?offset=0&limit=500"
    },
    "next": {
        "href": "/domains/EQUIPMENT/entity-types?offset=0&limit=500"
    },
    "last": {
        "href": "/domains/EQUIPMENT/entity-types?offset=0&limit=500"
    },
    "totalCount": 3
}

...

Code Block

language	xml

GET https://<host>/topology-inventory/<API_VERSION>/domains/EQUIPMENT/entity-types/AntennaModule/entities

Response:

Code Block

language	text
title	GET entities from domain Response
linenumbers	true
collapse	true

{
    "items": [
        {
            "o-ran-smo-teiv-equipment:AntennaModule": [: [
                {
                    "id": "urn:oran:smo:teiv:AntennaModule=1"
                }
    {        ]
        },
    "id": "urn:o-ran:smo-teiv-equipment:1"   {
             },"o-ran-smo-teiv-equipment:AntennaModule": [
                {
                    "id": "urn:o-ranoran:smo-:teiv-equipment:AntennaModule=2"
                }
            ]
        }
    ],
    "self": {
        "href": "/domains/EQUIPMENT/entity-types/AntennaModule/entities?offset=0&limit=500"
    },
    "first": {
        "href": "/domains/EQUIPMENT/entity-types/AntennaModule/entities?offset=0&limit=500"
    },
    "prev": {
        "href": "/domains/EQUIPMENT/entity-types/AntennaModule/entities?offset=0&limit=500"
    },
    "next": {
        "href": "/domains/EQUIPMENT/entity-types/AntennaModule/entities?offset=0&limit=500"
    },
    "last": {
        "href": "/domains/EQUIPMENT/entity-types/AntennaModule/entities?offset=0&limit=500"
    },
    "totalCount": 2
}

...

Code Block

language	xml

GET https://<host>/topology-inventory/<API_VERSION>/domains/EQUIPMENT/entity-types/AntennaModule/entities/urn:o-ranoran:smo-:teiv-equipment:AntennaModule=1

Response:

Code Block

language	text
title	GET entity from domain by id Response
linenumbers	true
collapse	true

{
    "o-ran-smo-teiv-equipment:AntennaModule": [
        {
            "decorators": {},
            "classifiers": [],
            "attributes": {
                "mechanicalAntennaBearingmechanicalAntennaTilt": 5010,
                "mechanicalAntennaTiltmechanicalAntennaBearing": 1050,
                "positionWithinSector": "Unknown",
                "fdngeo-location": "Unknown", {
                    "geo-locationheight": null,
      3000,
         "antennaModelNumber": "1",                 "totalTilt"latitude": 1441.73297,
                "antennaBeamWidth": null,   "longitude": -73.007696
            "cmId": {    },
                "cmHandleantennaModelNumber": "9D2C7AA8AECF0B5FDE21FDBD2B93EEAG1",
                "totalTilt": 14,
  "resourceIdentifier": "Unknown"             "antennaBeamWidth": [
  },                 "electricalAntennaTilt": 2 35,
            },        23,
    "id": "urn:o-ran:smo-teiv-equipment:1",             "sourceIds": [] 21
       }     ] }

Sample request to fetch all relationships from a specific AntennaModule from EQUIPMENT by id:

Code Block

language	xml

GET https://<host>/topology-inventory/<API_VERSION>/domains/EQUIPMENT/entity-types/AntennaModule/entities/urn:o-ran:smo-teiv-equipment:1/relationships

Response:

Code Block

language	text
title	GET entity relationships from domain by id Response
linenumbers	true
collapse	true

{   ],
                "itemselectricalAntennaTilt": 2
 [           {},
            "id": "o-ran-smo-teiv-equipment:ANTENNAMODULE_INSTALLED_AT_SITE": [urn:oran:smo:teiv:AntennaModule=1",
            "sourceIds": [
        {        "urn:3gpp:dn:ManagedElement=NR01,Equipment=1,AntennaUnitGroup=1,AntennaUnit=1",
            "bSide":    "urn:o-ran:smo-teiv-equipment:3gpp:dn:ManagedElement=NR01,Equipment=1,AntennaUnitGroup=1,AntennaUnit=1,AntennaSubunit=1",

                   "aSide": "urn:o-ran:smo-teiv-equipment:1",3gpp:dn:ManagedElement=NR01,Equipment=1,AntennaUnitGroup=1,AntennaNearUnit=1,RetSubUnit=1"
            ]
        }
     "id": "urn:o-ran:smo-teiv-equipment:1"
                }]
}

...

Sample request to fetch all relationships from a specific AntennaModule from EQUIPMENT by id:

Code Block

language	xml

GET https://<host>/topology-inventory/<API_VERSION>/domains/EQUIPMENT/entity-types/AntennaModule/entities/urn:oran:smo:teiv:AntennaModule=1/relationships

Response:

Code Block

language	text
title	GET entity relationships from domain by id Response
linenumbers	true
collapse	true

{
            ]
    "items": [
   },         {
            "o-ran-smo-teiv-equipment-to-ran:ANTENNAMODULE_SERVESINSTALLED_AT_ANTENNACAPABILITYSITE": [
                {
                    "bSide": "urn:oran:3gppsmo:dn:ManagedElement=NR01,NodeSupportteiv:Site=1,SectorEquipmentFunction=1",
                    "aSide": "urn:o-ranoran:smo-:teiv-equipment:AntennaModule=1",
                    "id": "urn:o-ranoran:smo-teiv-equipment-to-ran::teiv:ANTENNAMODULE_INSTALLED_AT_SITE=1"
                }
            ]
        }
    ],
    "self": {
        "href": "/domains/EQUIPMENT/entity-types/AntennaModule/entities/urn:o-ranoran:smo-:teiv-equipment:AntennaModule=1/relationships?offset=0&limit=500"
    },
    "first": {
        "href": "/domains/EQUIPMENT/entity-types/AntennaModule/entities/urn:o-ranoran:smo-:teiv-equipment:AntennaModule=1/relationships?offset=0&limit=500"
    },
    "prev": {
        "href": "/domains/EQUIPMENT/entity-types/AntennaModule/entities/urn:o-ranoran:smo-:teiv-equipment:AntennaModule=1/relationships?offset=0&limit=500"
    },
    "next": {
        "href": "/domains/EQUIPMENT/entity-types/AntennaModule/entities/urn:o-ranoran:smo-:teiv-equipment:AntennaModule=1/relationships?offset=0&limit=500"
    },
    "last": {
        "href": "/domains/EQUIPMENT/entity-types/AntennaModule/entities/urn:o-ranoran:smo-:teiv-equipment:AntennaModule=1/relationships?offset=0&limit=500"
    },
    "totalCount": 21
}

...

Sample request to fetch all relationship types in EQUIPMENT:

Code Block

language	xml

GET https://<host>/topology-inventory/<API_VERSION>/domains/EQUIPMENT/relationship-types

Response:

Code Block

language	text
title	GET all domain relationship types Response
linenumbers	true
collapse	true

{
    "items": [
        {
            "name": "ANTENNAMODULE_INSTALLED_AT_SITE",
            "relationships": {
                "href": "/domains/EQUIPMENT/relationship-types/ANTENNAMODULE_INSTALLED_AT_SITE/relationships"
            }
        }
    ],
    "self": {
        "href": "/domains/EQUIPMENT/relationship-types?offset=0&limit=500"
    },
    "first": {
        "href": "/domains/EQUIPMENT/relationship-types?offset=0&limit=500"
    },
 "name   "prev": {
        "href": "PHYSICALNF_INSTALLED_AT_SITE",
   /domains/EQUIPMENT/relationship-types?offset=0&limit=500"
    },
    "next": {
        "relationshipshref": { "/domains/EQUIPMENT/relationship-types?offset=0&limit=500"
    },
    "last": {
        "href": "/domains/EQUIPMENT/relationship-types/PHYSICALNF_INSTALLED_AT_SITE/relationships?offset=0&limit=500"
    },
    "totalCount": 1
 }}

...

Sample request to fetch ANTENNAMODULE_INSTALLED_AT_SITE relationships from EQUIPMENT:

Code Block

language	xml

GET https://<host>/topology-inventory/<API_VERSION>/domains/EQUIPMENT/relationship-types/ANTENNAMODULE_INSTALLED_AT_SITE/relationships

Response:

Code Block

language	text
title	GET specific relationships from domain Response
linenumbers	true
collapse	true

{
    "items":  [
 }     ],  {
  "self": {         "href": "/domains/EQUIPMENT/relationship-types?offset=0&limit=500"o-ran-smo-teiv-equipment:ANTENNAMODULE_INSTALLED_AT_SITE": [
    },     "first": {      {
  "href": "/domains/EQUIPMENT/relationship-types?offset=0&limit=500"     },     "prev": {         "hrefbSide": "/domains/EQUIPMENT/relationship-types?offset=0&limit=500"urn:oran:smo:teiv:Site=1",
     },     "next": {         "hrefaSide": "/domains/EQUIPMENT/relationship-types?offset=0&limit=500"urn:oran:smo:teiv:AntennaModule=1",
     },     "last": {         "hrefid": "/domains/EQUIPMENT/relationship-types?offset=0&limit=500urn:oran:smo:teiv:ANTENNAMODULE_INSTALLED_AT_SITE=1"
    },          "totalCount": 2
}

Sample request to fetch ANTENNAMODULE_INSTALLED_AT_SITE relationships from EQUIPMENT:

Code Block

language	xml

GET https://<host>/topology-inventory/<API_VERSION>/domains/EQUIPMENT/relationship-types/ANTENNAMODULE_INSTALLED_AT_SITE/relationships

Response:

Code Block

language	text
title	GET specific relationships from domain Response
linenumbers	true
collapse	true

{ }
            ]
       "items": [ },
        {
            "o-ran-smo-teiv-equipment:ANTENNAMODULE_INSTALLED_AT_SITE": [
                {
                    "bSide": "urn:o-ranoran:smo-:teiv-equipment:1Site=2",
                    "aSide": "urn:o-ranoran:smo-:teiv-equipment:1AntennaModule=2",
                    "id": "urn:o-ranoran:smo-:teiv-equipment:1:ANTENNAMODULE_INSTALLED_AT_SITE=2"
                },
            ]
   {     }
      ],
        "bSideself": "urn:o-ran:smo-teiv-equipment:2",
 {
                  "aSide"href": "urn:o-ran:smo-teiv-equipment:2",/domains/EQUIPMENT/relationship-types/ANTENNAMODULE_INSTALLED_AT_SITE/relationships?offset=0&limit=500"
    },
    "first": {
         "idhref": "urn:o-ran:smo-teiv-equipment:2"
  /domains/EQUIPMENT/relationship-types/ANTENNAMODULE_INSTALLED_AT_SITE/relationships?offset=0&limit=500"
    },
    "prev": {
        }
"href": "/domains/EQUIPMENT/relationship-types/ANTENNAMODULE_INSTALLED_AT_SITE/relationships?offset=0&limit=500"
    },
    "next": {
]         }"href": "/domains/EQUIPMENT/relationship-types/ANTENNAMODULE_INSTALLED_AT_SITE/relationships?offset=0&limit=500"
    ]},
    "selflast": {
        "href": "/domains/EQUIPMENT/relationship-types/ANTENNAMODULE_INSTALLED_AT_SITE/relationships?offset=0&limit=500"
    },
    "totalCount": 2
}

...

Sample request to fetch ANTENNAMODULE_INSTALLED_AT_SITE relationship from EQUIPMENT by id:

Code Block

language	xml

GET "first": {https://<host>/topology-inventory/<API_VERSION>/domains/EQUIPMENT/relationship-types/ANTENNAMODULE_INSTALLED_AT_SITE/relationships/urn:oran:smo:teiv:ANTENNAMODULE_INSTALLED_AT_SITE=1

Response:

Code Block

language	text
title	GET a specific relationship from domain by id Response
linenumbers	true
collapse	true

{
    "o-ran-smo-teiv-equipment:ANTENNAMODULE_INSTALLED_AT_SITE": [
        {
 "href": "/domains/EQUIPMENT/relationship-types/ANTENNAMODULE_INSTALLED_AT_SITE/relationships?offset=0&limit=500"     },     "prevdecorators": {},
            "hrefbSide": "/domains/EQUIPMENT/relationship-types/ANTENNAMODULE_INSTALLED_AT_SITE/relationships?offset=0&limit=500"
    }urn:oran:smo:teiv:Site=1",
    "next": {         "hrefaSide": "/domains/EQUIPMENT/relationship-types/ANTENNAMODULE_INSTALLED_AT_SITE/relationships?offset=0&limit=500"urn:oran:smo:teiv:AntennaModule=1",
       },     "lastclassifiers": [],
   {         "hrefid": "/domains/EQUIPMENT/relationship-types/urn:oran:smo:teiv:ANTENNAMODULE_INSTALLED_AT_SITE/relationships?offset=0&limit=500"=1",
    },        "totalCountsourceIds": 2
}

...

 []
        }
    ]
}

...

Querying entities and relationships:

Use the targetFilter parameter to narrow down the fields to return. To filter the results which match a given criteria, use the scopeFilter. Think of it as an SQL statement, where the targetFilter is the SELECT, and the scopeFilter is the WHERE tag.

Supported filter options

Sample request to query AntennaModule entities and attributes from EQUIPMENT:

Code Block

language	xml

GET https://<host>/topology-inventory/<API_VERSION>/domains/EQUIPMENT/relationship-types/ANTENNAMODULE_INSTALLED_AT_SITE/relationships/urn:o-ran:smo-teiv-equipment:1/entities?targetFilter=/AntennaModule/attributes
or
GET https://<host>/topology-inventory/<API_VERSION>/domains/EQUIPMENT/entity-types/AntennaModule/entities?targetFilter=/attributes

Response:

Code Block

language	text
title	GET a specific relationship from domain by id domain entities and attributes Response
linenumbers	true
collapse	true

{
    "items": [
        {
            "o-ran-smo-teiv-equipment:ANTENNAMODULE_INSTALLED_AT_SITEAntennaModule": [
                {
                    "bSideattributes": "urn:o-ran:smo-teiv-equipment:1", {
                        "aSidemechanicalAntennaTilt": "urn:o-ran:smo-teiv-equipment:1",
10,
           "id": "urn:o-ran:smo-teiv-equipment:1",             "sourceIdsmechanicalAntennaBearing": [] 50,
               }     ]
}

Querying entities and relationships:

Use the targetFilter parameter to narrow down the fields to return. To filter the results which match a given criteria, use the scopeFilter. Think of it as an SQL statement, where the targetFilter is the SELECT, and the scopeFilter is the WHERE tag.

Supported filter options

Sample request to query AntennaModule entities and attributes from EQUIPMENT:

Code Block

language	xml

GET https://<host>/topology-inventory/<API_VERSION>/domains/EQUIPMENT/entities?targetFilter=/AntennaModule/attributes
or
GET https://<host>/topology-inventory/<API_VERSION>/domains/EQUIPMENT/entity-types/AntennaModule/entities?targetFilter=/attributes

Response:

Code Block

language	text
title	GET domain entities and attributes Response
linenumbers	true
collapse	true

{    "positionWithinSector": "Unknown",
                        "geo-location": {
                            "itemsheight": [
3000,
       {             "o-ran-smo-teiv-equipment:AntennaModule": [        "latitude": 41.73297,
       {                     "attributeslongitude": {-73.007696
                        "mechanicalAntennaBearing": 45},
                        "mechanicalAntennaTiltantennaModelNumber": 12"1",
                        "positionWithinSectortotalTilt": "Unknown"14,
                        "fdnantennaBeamWidth": "Unknown",[
                           "geo-location": null, 35,
                          "antennaModelNumber": "2"  23,
                        "totalTilt": 15,
    21
                       "antennaBeamWidth": null],
                        "cmIdelectricalAntennaTilt": {2
                    },
                    "cmHandleid": "urn: "9D2C7AA8AECF0B5FDE21FDBD2B93EEAG",oran:smo:teiv:AntennaModule=1"
                }
            ]
 "resourceIdentifier": "Unknown"      },
        {
         },   "o-ran-smo-teiv-equipment:AntennaModule": [
                {
   "electricalAntennaTilt": 1                "attributes": {
   },                     "idmechanicalAntennaTilt": "urn:o-ran:smo-teiv-equipment:2"12,
                },        "mechanicalAntennaBearing": 45,
       {                     "attributespositionWithinSector": {"Unknown",
                        "mechanicalAntennaBearinggeo-location": 50, {
                            "mechanicalAntennaTiltheight": 102500,
                            "positionWithinSectorlatitude": "Unknown"43.75443,
                            "fdnlongitude": "Unknown",-71.096454
                        "geo-location": null},
                        "antennaModelNumber": "12",
                        "totalTilt": 1415,
                        "antennaBeamWidth": null,: [
                          "cmId": { 45,
                           "cmHandle": "9D2C7AA8AECF0B5FDE21FDBD2B93EEAG" 32,
                            "resourceIdentifier": "Unknown"21
                         }],
                        "electricalAntennaTilt": 21
                    },
                    "id": "urn:o-ranoran:smo-:teiv-equipment:1AntennaModule=2"
                }
            ]
        }
    ],
    "self": {
        "href": "/domains/EQUIPMENT/entities?offset=0&limit=500&targetFilter=/AntennaModule/attributes"
    },
    "first": {
        "href": "/domains/EQUIPMENT/entities?offset=0&limit=500&targetFilter=/AntennaModule/attributes"
    },
    "prev": {
        "href": "/domains/EQUIPMENT/entities?offset=0&limit=500&targetFilter=/AntennaModule/attributes"
    },
    "next": {
        "href": "/domains/EQUIPMENT/entities?offset=0&limit=500&targetFilter=/AntennaModule/attributes"
    },
    "last": {
        "href": "/domains/EQUIPMENT/entities?offset=0&limit=500&targetFilter=/AntennaModule/attributes"
    },
    "totalCount": 2
}

...

Code Block

language	xml

GET https://<host>/topology-inventory/<API_VERSION>/domains/CLOUD/entities?targetFilter=/CloudifiedNF/attributes(name)
or
GET https://<host>/topology-inventory/<API_VERSION>/domains/CLOUD/entities?targetFilter=/CloudifiedNF/attributes/name
or
GET https://<host>/topology-inventory/<API_VERSION>/domains/CLOUD/entity-types/CloudifiedNF/entities?targetFilter=/attributes(name)

Response:

Code Block

language	text
title	GET get domain entities and specific attributes Response
linenumbers	true
collapse	true

{
    "items": [
        {
            "o-ran-smo-teiv-cloud:CloudifiedNF": [
                {
                    "attributes": {
                        "name": "CloudifiedNF-1"
                    },
                    "id": "urn:o-ranoran:smo-:teiv-cloud:CloudifiedNF:1"
                }
            ]
        }
    ],
    "self": {
        "href": "/domains/CLOUD/entity-types/CloudifiedNF/entities?offset=0&limit=500&targetFilter=/CloudifiedNF/attributes(name)"
    },
    "first": {
        "href": "/domains/CLOUD/entity-types/CloudifiedNF/entities?offset=0&limit=500&targetFilter=/CloudifiedNF/attributes(name)"
    },
    "prev": {
        "href": "/domains/CLOUD/entity-types/CloudifiedNF/entities?offset=0&limit=500&targetFilter=/CloudifiedNF/attributes(name)"
    },
    "next": {
        "href": "/domains/CLOUD/entity-types/CloudifiedNF/entities?offset=0&limit=500&targetFilter=/CloudifiedNF/attributes(name)"
    },
    "last": {
        "href": "/domains/CLOUD/entity-types/CloudifiedNF/entities?offset=0&limit=500&targetFilter=/CloudifiedNF/attributes(name)"
    },
    "totalCount": 1
}

...

Code Block

language	xml

GET https://<host>/topology-inventory/<API_VERSION>/domains/RAN/entities?targetFilter=/GNBDUFunction/attributes(gNBId, gNBIdLength)
or
GET https://<host>/topology-inventory/<API_VERSION>/domains/RAN/entity-types/GNBDUFunction/entities?targetFilter=/attributes(gNBId, gNBIdLength)

Response:

Code Block

language	text
title	GET domain entities and multiple attributes Response
linenumbers	true
collapse	true

{
    "items": [
        {
            "o-ran-smo-teiv-ran:GNBDUFunction": [
                {
                    "attributes": {
                        "gNBId": 1,
                        "gNBIdLength": 23
                    },
                    "id": "urn:3gpp:dn:ManagedElement=NR01,GNBDUFunction=1"
                }
            ]
        }
    ],
    "self": {
        "href": "/domains/RAN/entity-types/GNBDUFunction/entities?offset=0&limit=500&targetFilter=/GNBDUFunction/attributes(gNBId, gNBIdLength)"
    },
    "first": {
        "href": "/domains/RAN/entity-types/GNBDUFunction/entities?offset=0&limit=500&targetFilter==/GNBDUFunction/attributes(gNBId, gNBIdLength)"
    },
    "prev": {
        "href": "/domains/RAN/entity-types/GNBDUFunction/entities?offset=0&limit=500&targetFilter=/GNBDUFunction/attributes(gNBId, gNBIdLength)"
    },
    "next": {
        "href": "/domains/RAN/entity-types/GNBDUFunction/entities?offset=0&limit=500&targetFilter=/GNBDUFunction/attributes(gNBId, gNBIdLength)"
    },
    "last": {
        "href": "/domains/RAN/entity-types/GNBDUFunction/entities?offset=0&limit=500&targetFilter=/GNBDUFunction/attributes(gNBId, gNBIdLength)"
    },
    "totalCount": 1
}

...

Code Block

language	xml

GET https://<host>/topology-inventory/<API_VERSION>/domains/RAN/entities?targetFilter=/GNBDUFunction;/NRSectorCarrier;/NRCellDU

Response:

Code Block

language	text
title	GET multiple different domain entities Response
linenumbers	true
collapse	true

{
    "items": [
        {
            "o-ran-smo-teiv-ran:NRSectorCarrierGNBDUFunction": [
                {
                    "id": "urn:3gpp:dn:ManagedElement=NR01,GNBDUFunction=1,NRSectorCarrier=1""
                }
            ]
        },
        {
            "o-ran-smo-teiv-ran:NRCellDU": [
                {
                    "id": "urn:3gpp:dn:ManagedElement=NR01,GNBDUFunction=1,NRSectorCarrier=2"NRCellDU=1"
                }
            ]
        },
        {
             },"o-ran-smo-teiv-ran:NRCellDU": [
                {
                    "id": "urn:3gpp:dn:ManagedElement=NR01,GNBDUFunction=1,NRSectorCarrierNRCellDU=32"
                }
            ]
        },
        {
            "o-ran-smo-teiv-ran:GNBDUFunctionNRSectorCarrier": [
                {
                    "id": "urn:3gpp:dn:ManagedElement=NR01,GNBDUFunction=1,NRSectorCarrier=1"
                }
            ]
        },
        {
            "o-ran-smo-teiv-ran:NRCellDUNRSectorCarrier": [
                {
                    "id": "urn:3gpp:dn:ManagedElement=NR01,GNBDUFunction=1,NRCellDUNRSectorCarrier=12"
                },
            ]
   {     },
        {
      "id": "urn:3gpp:dn:ManagedElement=NR01,GNBDUFunction=1,NRCellDU=2"     "o-ran-smo-teiv-ran:NRSectorCarrier": [
          },                 {
                    "id": "urn:3gpp:dn:ManagedElement=NR01,GNBDUFunction=1,NRCellDUNRSectorCarrier=3"
                }
            ]
        }
    ],
    "self": {
        "href": "/domains/RAN/entities?offset=0&limit=500&targetFilter=/GNBDUFunction;/NRSectorCarrier;/NRCellDU"
    },
    "first": {
        "href": "/domains/RAN/entities?offset=0&limit=500&targetFilter=/GNBDUFunction;/NRSectorCarrier;/NRCellDU"
    },
    "prev": {
        "href": "/domains/RAN/entities?offset=0&limit=500&targetFilter=/GNBDUFunction;/NRSectorCarrier;/NRCellDU"
    },
    "next": {
        "href": "/domains/RAN/entities?offset=0&limit=500&targetFilter=/GNBDUFunction;/NRSectorCarrier;/NRCellDU"
    },
    "last": {
        "href": "/domains/RAN/entities?offset=0&limit=500&targetFilter=/GNBDUFunction;/NRSectorCarrier;/NRCellDU"
    },
    "totalCount": 76
}

...

Sample request to query RAN GNBDUFunction filtered by gNBIdLength=23 and gNBId=1:

Code Block

language	xml

GET https://<host>/topology-inventory/<API_VERSION>/domains/RAN/entities?targetFilter=/GNBDUFunction&scopeFilter=%2FGNBDUFunction%2Fattributes%5B%40gNBIdLength=23 and %40gNBId=1%5D
or
GET https://<host>/topology-inventory/<API_VERSION>/domains/RAN/entity-types/GNBDUFunction/entities?scopeFilter=%2FGNBDUFunction%2Fattributes%5B%40gNBIdLength=23 and %40gNBId=1%5D

Response:

Code Block

language	text
title	GET domain entities filtered by specific attributes Response
linenumbers	true
collapse	true

{
    "items": [
        {
            "o-ran-smo-teiv-ran:GNBDUFunction": [
                {
                    "id": "urn:3gpp:dn:ManagedElement=NR01,GNBDUFunction=1"
                }
            ]
        }
    ],
    "self": {
        "href": "/domains/RAN/entities?offset=0&limit=500&scopeFilter=/GNBDUFunction/attributes[@gNBIdLength=23 and @gNBId=1]&targetFilter=/GNBDUFunction"
    },
    "first": {
        "href": "/domains/RAN/entities?offset=0&limit=500&scopeFilter=/GNBDUFunction/attributes[@gNBIdLength=23 and @gNBId=1]&targetFilter=/GNBDUFunction"
    },
    "prev": {
        "href": "/domains/RAN/entities?offset=0&limit=500&scopeFilter=/GNBDUFunction/attributes[@gNBIdLength=23 and @gNBId=1]&targetFilter=/GNBDUFunction"
    },
    "next": {
        "href": "/domains/RAN/entities?offset=0&limit=500&scopeFilter=/GNBDUFunction/attributes[@gNBIdLength=23 and @gNBId=1]&targetFilter=/GNBDUFunction"
    },
    "last": {
        "href": "/domains/RAN/entities?offset=0&limit=500&scopeFilter=/GNBDUFunction/attributes[@gNBIdLength=23 and @gNBId=1]&targetFilter=/GNBDUFunction"
    },
    "totalCount": 1
}

...

Versions Compared

Old Version 10

New Version 11

Key

Sample API calls

Postman collection

Retrieving and using topology modules

Sample request to fetch a list of all domains in TEIV:

Sample API calls

Postman collection

Retrieving and using topology modules

Sample request to fetch a list of all domains in TEIV:

Sample request to fetch a list of all modules in TEIV:

Sample request to fetch a list of all modules in TEIV:

Sample request to fetch a list of all modules related to the CLOUD domain:

Sample request to fetch the module data for the o-ran-smo-teiv-oam module:

Sample request to fetch all relationships from a specific AntennaModule from EQUIPMENT by id:

Sample request to fetch all relationships from a specific AntennaModule from EQUIPMENT by id:

Sample request to fetch all relationship types in EQUIPMENT:

Sample request to fetch ANTENNAMODULE_INSTALLED_AT_SITE relationships from EQUIPMENT:

Sample request to fetch ANTENNAMODULE_INSTALLED_AT_SITE relationships from EQUIPMENT:

Sample request to fetch ANTENNAMODULE_INSTALLED_AT_SITE relationship from EQUIPMENT by id:

Querying entities and relationships:

Sample request to query AntennaModule entities and attributes from EQUIPMENT:

Querying entities and relationships:

Sample request to query AntennaModule entities and attributes from EQUIPMENT:

Sample request to query RAN GNBDUFunction filtered by gNBIdLength=23 and gNBId=1:

Page Comparison

Versions Compared

Old Version 10

New Version 11

Key

Sample API calls

Postman collection

Retrieving and using topology modules

Sample request to fetch a list of all domains in TEIV:

Sample API calls

Postman collection

Retrieving and using topology modules

Sample request to fetch a list of all domains in TEIV:

Sample request to fetch a list of all modules in TEIV:

Sample request to fetch a list of all modules in TEIV:

Sample request to fetch a list of all modules related to the CLOUD domain:

Sample request to fetch the module data for the o-ran-smo-teiv-oam module:

Sample request to fetch all relationships from a specific AntennaModule from EQUIPMENT by id:

Sample request to fetch all relationships from a specific AntennaModule from EQUIPMENT by id:

Sample request to fetch all relationship types in EQUIPMENT:

Sample request to fetch ANTENNAMODULE_INSTALLED_AT_SITE relationships from EQUIPMENT:

Sample request to fetch ANTENNAMODULE_INSTALLED_AT_SITE relationships from EQUIPMENT:

Sample request to fetch ANTENNAMODULE_INSTALLED_AT_SITE relationship from EQUIPMENT by id:

Querying entities and relationships:

Sample request to query AntennaModule entities and attributes from EQUIPMENT:

Querying entities and relationships:

Sample request to query AntennaModule entities and attributes from EQUIPMENT:

Sample request to query RAN GNBDUFunction filtered by gNBIdLength=23 and gNBId=1: