Page Comparison

Table of Contents

...

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

...

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/entities/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:o-ran:smo-teiv-equipment:1"
                },
                {
                    "id": "urn:o-ran:smo-teiv-equipment: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-ran:smo-teiv-equipment: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": {
                "mechanicalAntennaBearing": 50,
                "mechanicalAntennaTilt": 10,
                "positionWithinSector": "Unknown",
                "fdn": "Unknown",
                "geo-location": null,
                "antennaModelNumber": "1",
                "totalTilt": 14,
                "antennaBeamWidth": null,
                "cmId": {
                    "cmHandle": "9D2C7AA8AECF0B5FDE21FDBD2B93EEAG",
                    "resourceIdentifier": "Unknown"
                },
                "electricalAntennaTilt": 2
            },
            "id": "urn:o-ran:smo-teiv-equipment:1",
            "sourceIds": []
        }
    ]
}

...

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

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

...

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"
            }
        },
        {
            "name": "PHYSICALNF_INSTALLED_AT_SITE",
            "relationships": {
                "href": "/domains/EQUIPMENT/relationship-types/PHYSICALNF_INSTALLED_AT_SITE/relationships"
            }
        }
    ],
    "self": {
        "href": "/domains/EQUIPMENT/relationship-types?offset=0&limit=500"
    },
    "first": {
        "href": "/domains/EQUIPMENT/relationship-types?offset=0&limit=500"
    },
    "prev": {
        "href": "/domains/EQUIPMENT/relationship-types?offset=0&limit=500"
    },
    "next": {
        "href": "/domains/EQUIPMENT/relationship-types?offset=0&limit=500"
    },
    "last": {
        "href": "/domains/EQUIPMENT/relationship-types?offset=0&limit=500"
    },
    "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-ran:smo-teiv-equipment:1",
                    "aSide": "urn:o-ran:smo-teiv-equipment:1",
                    "id": "urn:o-ran:smo-teiv-equipment:1"
                },
                {
                    "bSide": "urn:o-ran:smo-teiv-equipment:2",
                    "aSide": "urn:o-ran:smo-teiv-equipment:2",
                    "id": "urn:o-ran:smo-teiv-equipment:2"
                }
            ]
        }
    ],
    "self": {
        "href": "/domains/EQUIPMENT/relationship-types/ANTENNAMODULE_INSTALLED_AT_SITE/relationships?offset=0&limit=500"
    },
    "first": {
        "href": "/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"
    },
    "last": {
        "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 https://<host>/topology-inventory/<API_VERSION>/domains/EQUIPMENT/relationship-types/ANTENNAMODULE_INSTALLED_AT_SITE/relationships/urn:o-ran:smo-teiv-equipment: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": [
        {
            "bSide": "urn:o-ran:smo-teiv-equipment:1",
            "aSide": "urn:o-ran:smo-teiv-equipment:1",
            "id": "urn:o-ran:smo-teiv-equipment:1",
            "sourceIds": []
        }
    ]
}

...

Versions Compared

Old Version 6

New Version 7

Key

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 ANTENNAMODULE_INSTALLED_AT_SITE relationships from EQUIPMENT:

Sample request to fetch ANTENNAMODULE_INSTALLED_AT_SITE relationship from EQUIPMENT by id: