Topology Exposure and Inventory API (v0.11.0)

Download OpenAPI specification: Download

License: Copyright (C) 2024 Ericsson, Modifications Copyright (C) 2024 OpenInfra Foundation Europe. All rights reserved.

Topology Exposure and Inventory data is the information that represents entities in a telecommunications network and the relationships between them that provide insight into a particular aspect of the network of importance to specific use cases. Topology and Inventory data can be derived from inventory, configuration, or other data.

Topology Exposure and Inventory supports several topology domains. A domain is a grouping of topology and inventory entities that handles topology and inventory data.

Entities are enabling the modelling and storage of complex network infrastructure and relationships.

A relationship is a bi-directional connection between two entities, one of which is the originating side (A-side) and the other is the terminating side (B-side). The order of the sides matters since it defines the relationship itself which must be unique.

Classifier (also known as tag or label) permits the association of a well defined user specified string with an entity or relationship.

Decorators are user-defined attributes (key-value pairs) which can be applied to topology entities and relationships.

Metadata provides additional information about entities and relationships within the database. The reliabilityIndicator is used to indicate the reliability status of the topology data within the network. The firstDiscovered timestamp is set for an entity and relationship instance when the instances are created for the first time in Topology & Inventory. The lastModified timestamp is set for updates to entities or relationships in Topology & Inventory, excluding updates to classifiers or decorators. reliabilityIndicator, firstDiscovered, and lastModified are implemented as name-value pairs within the metadata. They apply to every entity and relationship.

Topology groups provide the capability to create user-defined collections of topology entities and/or relationships of any type. Groups can be either static or dynamic based on how they are created.

Topology Exposure and Inventory API provides the capabilities to fetch topology data. Using the filtering options, it is possible to define more specific query requests.

Querying simple entities

The entityTypeName is used as the root of the queries (from here referred to as RootObject). Every other object, either in targetFilter or scopeFilter, has to relate to the RootObject. The queries are constructed starting from the RootObject and all other objects are joined to it. If there is no connection between the RootObject and the other object(s), the query is not constructed. The RootObject still can be retrieved and filtered using the /attributes.

Use casedomainNameentityTypeNametargetFilterscopeFilterQuery result
To return the ids for all instances of the entityTypeName used in the query.RANODUFunctionAll ids of every ODUFunction
To return all attributes of every instance of the entityTypeName used in the query.RANODUFunction/attributesAll ODUFunctions with every attribute
To return every instance of the entityTypeName used in the query, but only the attribute that was defined in the targetFilter parameter.
Note: The attribute must be a valid field of the object.
RANODUFunction/attributes(gNBId)All gNBIds of every ODUFunction
To return every instance of the entityTypeName used in the query, but only the attributes that were defined in the targetFilter parameter.
Note: The attributes must be separated by a comma "," when using parenthesis "()".
RANODUFunction/attributes(gNBId, gNBIdLength)All gNBIds and gNBIdLengths of every ODUFunction
To return the ids for all instances of the entityTypeName used in the query, that partially matches the given property in the scopeFilter parameter.RANODUFunction/sourceIds[contains (@item, 'SubNetwork=Europe')]Unique set of ids of ODUFunctions, where sourceIds contains SubNetwork=Ireland
To return the ids for all instances of the entityTypeName used in the query, that matches the given attributes in the scopeFilter parameter.
Note: The attributes must be separated by a AND or OR.
RANODUFunction/attributes [@gNBIdLength=1 and @gNBId=9]Unique set of ids of ODUFunctions, where the gNBIdLength equals 1 and the gNBId equals 9
To return the ids for all instances of the entityTypeName used in the query, that satisfies one of the conditions in the scopeFilter parameter. A condition is a complete unit of scopeFilter parameter surrounded by square brackets.
Note: Multiple conditions can be given in the scopeFilter separated by a semicolon ";" to represent AND, or a pipe symbol "|" to represent OR.
RANODUFunction/attributes [@gNBIdLength=2] | /sourceIds[contains (@item, 'SubNetwork=Europe')]Unique set of ids of ODUFunctions, where the gNBIdLength equals 2 or the sourceIds contains an item with "SubNetwork=Europe"
To return the metadata for all instances of the entityTypeName used in the query, that is firstDiscovered within the given timeframe in the scopeFilter parameter.
Note: The timestamps can be queried in any timezone.
RANODUFunction/metadata[@firstDiscovered>='2025-01-06T12:34:56.789+05:30' and @firstDiscovered<='2025-01-09T16:10:36.461565+05:30']Unique set of ids of ODUFunctions, where metadata contains firstDiscovered timestamp within the range '2025-01-06T12:34:56.789+05:30' and '2025-01-09T16:10:36.461565+05:30'

Querying connected entities

The entityTypeName is used as the root of the queries.

Use casedomainNameentityTypeNametargetFilterscopeFilterQuery result
To return the ids for all instances of an entityTypeName related by an association.REL_OAM_RANENodeBFunction/managed-by-managedElementAll ENodeBFunction entities that are managed by any Managed Element.
To return the ids for all instances of an entityTypeName related by an association to another entity specified by its id.REL_OAM_RANENodeBFunction/managed-by-managedElement [@id = 'urn:3gpp:dn: ManagedElement=1']All ENodeBFunction entities that are managed by the Managed Element urn:3gpp:dn: ManagedElement=1.
To return the attributes for all instances of an entityTypeName related by one or more associations to other entities specified by their id.REL_OAM_RANENodeBFunction/attributes/attributes [@enbId=1] ; /managed-by-managedElement [@id='urn:3gpp:dn: ManagedElement=1'] | /managed-by-managedElement [@id='urn:3gpp:dn: ManagedElement=2'] ; /provided-euTranCell [@id='urn:3gpp:dn: ManagedElement=1, EUtranCell=2']All ENodeBFunction entities with enbId as 1, managed by the Managed Element urn:3gpp:dn: ManagedElement=1 or urn:3gpp:dn: ManagedElement=2, and provides EuTranCell urn:3gpp:dn: ManagedElement=1, EUtranCell=2.
To return the ids for all instances of an entityTypeName related by one or more associations to other entities whose attribute matches the given scopeFilter parameter.RANENodeBFunction/provided-euTranCell/attributes[@tac=1]All ENodeBFunction entities that provide an EUTranCell whose tac equals 1

Querying based on geographical location

The entityTypeName is used as the root of the queries. Use the "Well-known text" (WKT) representation of geometry to specify geometry objects.

Use casedomainNameentityTypeNametargetFilterscopeFilterQuery result
To return the ids for all instances of an entityTypeName where the given attribute is covered by the given polygon.EQUIPMENTAntennaModule/attributes[coveredBy(@geo-location, 'POLYGON ((-73.958444 40.800533, -73.981962 40.768558, -73.973207 40.765048, -73.949861 40.797024, -73.958444 40.800533))')]All AntennaModule entities covered by the given polygon.
To return the attributes for all instances of an entityTypeName where the given attribute is covered by the given collection of polygons.EQUIPMENTAntennaModule/attributes/attributes[coveredBy(@geo-location, 'MULTIPOLYGON (((40 40, 20 45, 45 30, 40 40)),((20 35, 10 30, 10 10, 30 5, 45 20, 20 35), (30 20, 20 15, 20 25, 30 20)))')]All AntennaModule entities covered by the given polygons.
To return the ids for all instances of an entityTypeName within the given distance in meters from a given attribute.EQUIPMENTAntennaModule/attributes[withinMeters(@geo-location, 'POINT(-73.958444 40.800533)', 500.5)]All AntennaModule entities within the given distance from the given point.
To return the attributes for all instances of an entityTypeName which has a connected entity whose given attribute is within a polygonRANNRCellDU/attributes/serving-antennaModule/attributes[coveredBy(@geo-location, 'POLYGON ((-73.958444 40.800533, -73.981962 40.768558, -73.973207 40.765048, -73.949861 40.797024, -73.958444 40.800533))')]All NRCellDU entities that have at least one connected AntennaModule with a geo-location attribute within the given polygon.

Querying entities for relationships

The entityTypeName is used as the root of the queries.

Use casedomainNameentityTypeNameentityIdtargetFilterscopeFilterQuery result
To return the relationships for a given entity specified by its id.RANODUFunctionurn:3gpp:dn: ManagedElement=1, ODUFunction=1All relations for the ODUFunction with id urn:3gpp:dn: ManagedElement=1, ODUFunction=1.
To return specific relationships for a given entity specified by its id.REL_OAM_RANODUFunctionurn:3gpp:dn: ManagedElement=1, ODUFunction=1/MANAGEDELEMENT _MANAGES _ODUFUNCTIONAll MANAGEDELEMENT _MANAGES _ODUFUNCTION relations for the ODUFunction with id urn:3gpp:dn: ManagedElement=1, ODUFunction=1.
To return specific relationships for an entity specified by its id to another entity using its id and association.REL_OAM_RANODUFunctionurn:3gpp:dn: ManagedElement=1, ODUFunction=1/managed-by-managedElement [@id = 'urn:3gpp:dn: ManagedElement=1']All MANAGEDELEMENT _MANAGES _ODUFUNCTION relations for the ODUFunction with id urn:3gpp:dn: ManagedElement=1, ODUFunction=1 where the managed element is urn:3gpp:dn: ManagedElement=1.

Querying on relationships

Here, the relationshipTypeName is used as the root of the queries.

Use casedomainNamerelationshipTypeNametargetFilterscopeFilterQuery result
To return all relationships for a specified relationship type.REL_OAM_RANMANAGEDELEMENT _MANAGES _ENODEBFUNCTIONAll MANAGEDELEMENT_MANAGES_ENODEBFUNCTION relationships.
To return all relationships for a specified relationship type with a specified association to an entity.REL_OAM_RANMANAGEDELEMENT _MANAGES _ENODEBFUNCTION/managed-by-managedElement [@id='urn:3gpp:dn: ManagedElement=1']All MANAGEDELEMENT_MANAGES_ENODEBFUNCTION relationships having an association managed-by-managedElement to ManagedElement urn:3gpp:dn: ManagedElement=1.

Querying on classifiers and decorators

The domainName is used as the root of the queries.

Use casedomainNametargetFilterscopeFilterQuery result
Return all related entity ids that are exactly matched with the specified classifier with given domain name.RAN/classifiers[@item = 'odu-function-model:Indoor']All the entity ids that are classified with "odu-function-model:Indoor" in RAN domain.
Return all related entity ids that are partially matched for the given classifier with given domain name.RAN/classifiers[contains(@item, 'Ind')]All the entity ids that are partially matched with "Ind" in RAN domain.
Return all related entity ids that are exactly matched with the key-value pair that specified decorators with given domain name.RAN/decorators[@odu-function-model:textdata = 'Stockholm']All the entity ids that are exactly matched with "odu-function-model:textdata = 'Stockholm'" in RAN domain.
Return all related entity ids that are exactly matched with key parameter where the value of the decorator is unknown with given domain name.RAN/decorators[contains(@odu-function-model:textdata, '')]All the entity ids that are exactly matched with "odu-function-model:textdata as key of the decorator in RAN domain.

The entityName is used as the root of the queries.

Use caseentityNamerelationshipTypeNametargetFilterscopeFilterQuery result
Return all related entity ids and classifiers.NRCellDU/classifiersAll NRCellDU ids and classifiers.
Return all related entity ids and decorators.NRCellDU/decoratorsAll NRCellDU ids and decorators.
Return all related entity ids that are exact match for the given classifiers and decorators.NRCellDU/classifiers[@item = 'odu-function-model:Indoor']; /decorators [@odu-function-model:textdata = 'Stockholm']All NRCellDU ids where key of the decorator is "odu-function-model:textdata" and the value of the decorator is 'Stockholm'" and where classifier exactly contains "odu-function-model:Indoor".
Return all related entity ids and classifiers that are partially matched for the given classifier.NRCellDU/classifiers/classifiers[contains(@item, 'Ind')]All NRCellDU ids and classifiers partially contains the text "Ind".
Return all related entity ids and decorators where key is a exact match and value is partially match.NRCellDU/decorators/decorators[contains(@odu-function-model:textdata, 'Stoc')]All NRCellDU ids and where key of the decorator is "odu-function-model:textdata" and the value of the decorator partially contains 'Stoc'.
Return all related entity ids, decorators and classifiers where key of the decorator is a exact match and value partially matches, and classifiers partially contains from the given parameters.NRCellDU/classifiers; /decorators/classifiers[contains(@item, 'Ind')]; /decorators[contains(@odu-function-model:textdata, 'Stoc')]All NRCellDU ids and decorators where key of the decorator is "odu-function-model:textdata" and the value of the decorator partially contains 'Stoc' and classifiers partially contains the text "Ind".

The relationshipTypeName is used as the root of the queries.

Use caseentityNamerelationshipTypeNametargetFilterscopeFilterQuery result
Return all related relationship ids and classifiers.MANAGEDELEMENT _MANAGES _ENODEBFUNCTION/classifiersAll MANAGEDELEMENT _MANAGES _ENODEBFUNCTION ids and classifiers.
Return all related relationship ids and decorators.MANAGEDELEMENT _MANAGES _ENODEBFUNCTION/decoratorsAll MANAGEDELEMENT _MANAGES _ENODEBFUNCTION ids and decorators.
Return all related relationship ids that are exact match for the given classifier and decorators.MANAGEDELEMENT _MANAGES _ENODEBFUNCTION/classifiers[@item = 'odu-function-model:Indoor']; /decorators [@odu-function-model:textdata = 'Stockholm']All MANAGEDELEMENT _MANAGES _ENODEBFUNCTION ids and decorators where key of the decorator is "odu-function-model:textdata" and the value of the decorator is 'Stockholm'" and classifiers exactly contains "odu-function-model:Indoor".
Return all related relationship ids and classifiers that are partially matched for the given classifier.MANAGEDELEMENT _MANAGES _ENODEBFUNCTION/classifiers/classifiers[contains(@item, 'Ind')]All MANAGEDELEMENT _MANAGES _ENODEBFUNCTION and classifiers partially contains the text "Ind".
Return all related relationship ids and decorators where key is a exact match and value is partially match.MANAGEDELEMENT _MANAGES _ENODEBFUNCTION/decorators/decorators[contains(@odu-function-model:textdata, 'Stock')]All MANAGEDELEMENT _MANAGES _ENODEBFUNCTION and where key of the decorator is "odu-function-model:textdata" and the value of the decorator partially contains 'Stock'.
Return all related relationship ids,decorators and classifiers where key of the decorator is a exact match and value partially matches, and classifiers partially contains from the given parameters.MANAGEDELEMENT _MANAGES _ENODEBFUNCTION/classifiers; /decorators/classifiers[contains(@item, 'Ind')]; /decorators[contains(@odu-function-model:textdata, 'Stock')]All MANAGEDELEMENT _MANAGES _ENODEBFUNCTION ids and decorators where key of the decorator is "odu-function-model:textdata" and the value of the decorator partially contains 'Stock' and classifiers partially contains the text "Ind".

Entities and relationships

Provides the capability to retrieve topology and inventory entities and relationships.

Get all the available topology domains.

Get all the available topology domains.

Parameters
query Parameters ?
offset
< anything >

Pagination offset.

limit
< anything >

Result limiter.

header Parameters ?
Accept
object Required

Responses

200 OK

400 Bad Request

401 Unauthorized

403 Forbidden

500 Internal Server Error

get
/domains

Server URL

http://undefined/domains

Get all the available topology entity types in domain name.

Get all the available topology entity types in domain name.

Parameters
path Parameters ?
domainName
object Required

domain name

query Parameters ?
offset
< anything >

Pagination offset.

limit
< anything >

Result limiter.

header Parameters ?
Accept
object Required

Responses

200 OK

400 Bad Request

401 Unauthorized

403 Forbidden

500 Internal Server Error

get
/domains/{domainName}/entity-types

Server URL

http://undefined/domains/{domainName}/entity-types

Get all topology entities of a specific entity type.

Get all topology entities of a specific entity type.

Parameters
path Parameters ?
domainName
object Required

domain name

entityTypeName
object Required
query Parameters ?
targetFilter
< anything >

Use targetFilter to specify what needs to be returned in the REST response.

scopeFilter
< anything >

ScopeFilter is used to specify the conditions to be applied.

offset
< anything >

Pagination offset.

limit
< anything >

Result limiter.

header Parameters ?
Accept
object Required

Responses

200 OK

400 Bad Request

401 Unauthorized

403 Forbidden

500 Internal Server Error

get
/domains/{domainName}/entity-types/{entityTypeName}/entities

Server URL

http://undefined/domains/{domainName}/entity-types/{entityTypeName}/entities

Get topology for entity type name with specified id. Specified id represents the entity instance.

Get topology for entity type name with specified id. Specified id represents the entity instance.

Parameters
path Parameters ?
domainName
object Required

domain name

entityTypeName
object Required
entityId
object Required
header Parameters ?
Accept
object Required

Responses

200 OK

400 Bad Request

401 Unauthorized

403 Forbidden

404 Not Found

500 Internal Server Error

get
/domains/{domainName}/entity-types/{entityTypeName}/entities/{entityId}

Server URL

http://undefined/domains/{domainName}/entity-types/{entityTypeName}/entities/{entityId}

Get all relationships for entity type name with specified id. Specified id represents the entity instance.

Get all relationships for entity type name with specified id. Specified id represents the entity instance.

Parameters
path Parameters ?
domainName
object Required

domain name

entityTypeName
object Required
entityId
object Required
query Parameters ?
targetFilter
< anything >

Use targetFilter to specify what needs to be returned in the REST response.

scopeFilter
< anything >

ScopeFilter is used to specify the conditions to be applied.

offset
< anything >

Pagination offset.

limit
< anything >

Result limiter.

header Parameters ?
Accept
object Required

Responses

200 OK

400 Bad Request

401 Unauthorized

403 Forbidden

404 Not Found

500 Internal Server Error

get
/domains/{domainName}/entity-types/{entityTypeName}/entities/{entityId}/relationships

Server URL

http://undefined/domains/{domainName}/entity-types/{entityTypeName}/entities/{entityId}/relationships

Get all the available topology relationship types.

Get all the available topology relationship types in a specified domain.

Parameters
path Parameters ?
domainName
object Required

domain name

query Parameters ?
offset
< anything >

Pagination offset.

limit
< anything >

Result limiter.

header Parameters ?
Accept
object Required

Responses

200 OK

400 Bad Request

401 Unauthorized

403 Forbidden

500 Internal Server Error

get
/domains/{domainName}/relationship-types

Server URL

http://undefined/domains/{domainName}/relationship-types

Get topology relationships of a specific relationship type name.

Get topology relationships of a specific relationship type name.

Parameters
path Parameters ?
domainName
object Required

domain name

relationshipTypeName
object Required
query Parameters ?
targetFilter
< anything >

Use targetFilter to specify what needs to be returned in the REST response.

scopeFilter
< anything >

ScopeFilter is used to specify the conditions to be applied.

offset
< anything >

Pagination offset.

limit
< anything >

Result limiter.

header Parameters ?
Accept
object Required

Responses

200 OK

400 Bad Request

401 Unauthorized

403 Forbidden

500 Internal Server Error

get
/domains/{domainName}/relationship-types/{relationshipTypeName}/relationships

Server URL

http://undefined/domains/{domainName}/relationship-types/{relationshipTypeName}/relationships

Get relationship with specified id. Specified id represents the relationship instance.

Get relationship with specified id. Specified id represents the relationship instance.

Parameters
path Parameters ?
domainName
object Required

domain name

relationshipTypeName
object Required
relationshipId
object Required
header Parameters ?
Accept
object Required

Responses

200 OK

400 Bad Request

401 Unauthorized

403 Forbidden

404 Not Found

500 Internal Server Error

get
/domains/{domainName}/relationship-types/{relationshipTypeName}/relationships/{relationshipId}

Server URL

http://undefined/domains/{domainName}/relationship-types/{relationshipTypeName}/relationships/{relationshipId}

Get entities by domain

Get topology entities by domain, using a specified targetFilter as a query parameter.

Parameters
path Parameters ?
domainName
object Required

domain name

query Parameters ?
targetFilter
< anything >

Use targetFilter to specify what needs to be returned in the REST response.

scopeFilter
< anything >

ScopeFilter is used to specify the conditions to be applied.

offset
< anything >

Pagination offset.

limit
< anything >

Result limiter.

header Parameters ?
Accept
object Required

Responses

200 OK

400 Bad Request

401 Unauthorized

403 Forbidden

500 Internal Server Error

get
/domains/{domainName}/entities

Server URL

http://undefined/domains/{domainName}/entities

Schemas

Schemas are defined in YANG modeling language. A group of Yang schemas makes the topology and inventory model, which represents topology and inventory entities, their attributes, and their relationships. For more information on YANG modelling language, see IETF Documentation.

Create a new schema.

Create a new schema. The request body contains the schema in YANG format.

Parameters
header Parameters ?
Accept
object Required
Content-Type
object Required

Responses

201 Created without response body

400 Bad Request

401 Unauthorized

403 Forbidden

409 Conflict

500 Internal Server Error

post
/schemas

Server URL

http://undefined/schemas

Get a list of all schemas.

Get a list of all schemas.

Parameters
query Parameters ?
domain
< anything >
offset
< anything >

Pagination offset.

limit
< anything >

Result limiter.

header Parameters ?
Accept
object Required

Responses

200 OK

400 Bad Request

401 Unauthorized

403 Forbidden

500 Internal Server Error

get
/schemas

Server URL

http://undefined/schemas

Get the model schema.

Get the model schema by name.

Parameters
path Parameters ?
schemaName
object Required
header Parameters ?
Accept
object Required

Responses

200 OK

400 Bad Request

401 Unauthorized

403 Forbidden

404 Not Found

500 Internal Server Error

get
/schemas/{schemaName}/content

Server URL

http://undefined/schemas/{schemaName}/content

Delete a schema.

Delete a schema.

Parameters
path Parameters ?
schemaName
object Required
header Parameters ?
Accept
object Required

Responses

204 No Content

400 Bad Request

401 Unauthorized

403 Forbidden

500 Internal Server Error

delete
/schemas/{schemaName}

Server URL

http://undefined/schemas/{schemaName}

Classifiers

Provides the capability to update or remove user-defined keywords or tags on entities and relationships.

Update entities and/or relationships with classifier(s).

Update entities and/or relationships with classifier(s). The sum of the given entityIds and relationshipIds cannot exceed 100 by default.

Parameters
header Parameters ?
Accept
object Required
Content-Type
object Required

Responses

204 No Content

400 Bad Request

401 Unauthorized

403 Forbidden

409 Conflict

500 Internal Server Error

post
/classifiers

Server URL

http://undefined/classifiers

Decorators

Provides the capability to update or remove user-defined values on entities and relationships.

Update entities and/or relationships with decorator(s).

Update entities and/or relationships with decorator(s). The sum of the given entityIds and relationshipIds cannot exceed 100 by default.

Parameters
header Parameters ?
Accept
object Required
Content-Type
object Required

Responses

204 No Content

400 Bad Request

401 Unauthorized

403 Forbidden

409 Conflict

500 Internal Server Error

post
/decorators

Server URL

http://undefined/decorators

Groups

Provides the capability to group topology entities and/or relationships of any type. Groups can be created in static or dynamic way. Static groups: Group members are defined statically upon group creation. It can include a maximum of 10,000 members. Dynamic groups: Group members are dynamically selected based on the defined resource query.

Create a new group.

Create a group of entities and/or relationships in a static or dynamic way.

Parameters
header Parameters ?
Accept
object Required
Content-Type
object Required

Responses

201 Created

400 Bad Request

500 Internal Server Error

post
/groups

Server URL

http://undefined/groups

Get all groups.

Get all groups.

Parameters
query Parameters ?
offset
< anything >

Pagination offset.

limit
< anything >

Result limiter.

name
< anything >

Group name. If not specified, returns all the groups.

header Parameters ?
Accept
object Required

Responses

200 OK

400 Bad Request

500 Internal Server Error

get
/groups

Server URL

http://undefined/groups

Get a group with specified id.

Get a group with specified id.

Parameters
path Parameters ?
groupId
object Required
header Parameters ?
Accept
object Required

Responses

200 OK

400 Bad Request

404 Not Found

500 Internal Server Error

get
/groups/{groupId}

Server URL

http://undefined/groups/{groupId}

Delete a group with specified id.

Delete a group with specified id.

Parameters
path Parameters ?
groupId
object Required

Responses

204 No Content

400 Bad Request

404 Not Found

500 Internal Server Error

delete
/groups/{groupId}

Server URL

http://undefined/groups/{groupId}

Update the name of a group.

Update the name of a group.

Parameters
path Parameters ?
groupId
object Required
header Parameters ?
Content-Type
object Required

Responses

204 No Content

400 Bad Request

404 Not Found

500 Internal Server Error

put
/groups/{groupId}/name

Server URL

http://undefined/groups/{groupId}/name

Get the members of a group with specified id.

Get the members of a group with specified id.

Parameters
path Parameters ?
groupId
object Required
query Parameters ?
offset
< anything >

Pagination offset.

limit
< anything >

Result limiter.

header Parameters ?
Accept
object Required

Responses

200 OK

400 Bad Request

404 Not Found

500 Internal Server Error

get
/groups/{groupId}/members

Server URL

http://undefined/groups/{groupId}/members

Get the provided members of a static group with specified id.

Get the provided members of a static group with specified id.

Parameters
path Parameters ?
groupId
object Required
query Parameters ?
status
< anything >

Status can be present (or) not-present (or) invalid. If not specified, returns all members of the group.

offset
< anything >

Pagination offset.

limit
< anything >

Result limiter.

header Parameters ?
Accept
object Required

Responses

200 OK

400 Bad Request

404 Not Found

500 Internal Server Error

get
/groups/{groupId}/provided-members

Server URL

http://undefined/groups/{groupId}/provided-members

Merge or remove members of a static group.

Merge or remove members in an existing topology group. This operation is applicable for static group only.

Parameters
path Parameters ?
groupId
object Required
header Parameters ?
Accept
object Required
Content-Type
object Required

Responses

204 No Content

400 Bad Request

500 Internal Server Error

post
/groups/{groupId}/provided-members-operations

Server URL

http://undefined/groups/{groupId}/provided-members-operations