@itentialopensource/adapter-nokia_nsp_network
Version:
This adapter integrates with system described as: networkSupervisionRestApis.
961 lines • 179 kB
YAML
openapi: 3.0.0
info:
title: Network Supervision REST APIs
description: "The Network Supervision application allows users to monitor the health of objects, such as NEs, card slots, cards, ports, links or link aggregation groups, using KPIs, and monitor the fault status of a network. <br /><br />The objects returned are coming from all deployed source systems.<br /><br /><p><b>Access Information</b></p><p>Prior to accessing the API services below, the API client must authenticate the NSP user via the NSP REST Gateway's authentication API service. The api-docs for the REST Gateway can be found with the NSP Product at: </p><p>https://<server>/rest-gateway/api-docs/ - where <server> is the hostname or IP address of the installed NSP server</p><p>or via the NSP DevPortal at: </p><p><a href='https://nsp.developer.nokia.com/api-documentation/'>https://nsp.developer.nokia.com/api-documentation/</a> - you will need to create an account on the NSP DevPortal to gain access to the api-docs</p>"
contact: {}
version: '1.0'
servers:
- url: https://147.75.202.66:8544/NetworkSupervision/rest/api
variables: {}
paths:
/v1/cardSlots:
get:
tags:
- cardSlots
summary: getCardSlotsUsingGET
description: "Returns a paged list of specific card slots. The size of each page is determined by the 'limit' query parameter. The list will contain the FDN of each resulting card slot. Each card slot contains a link to the installed card, if not empty. Not providing a filter will return all card slots.<br /><br /><strong>Filterable properties:</strong> <br /><strong>sourceType:</strong> The type of the source system. For example: <i>nfmp</i> <br /><strong>sourceSystem:</strong> The partial FDN identifying the source system. For example: <i>fdn:realm:sam</i> <br /><strong>name:</strong> The user friendly visible name <br /><strong>neName:</strong> The name of the Network Element containing the Card Slot <br /><strong>neId:</strong> The id of the Network Element containing the Card Slot<br /><strong>description:</strong> The detailed description of the Card Slot <br /><strong>positionId:</strong> The relative position of the Card Slot that determines the order in which to show it in the source system UI<br /><strong>position:</strong> A formatted name that describes the position of the Card Slot within the Network Element<br /><strong>adminState:</strong> The administrative state <br /><strong>operState:</strong> The operational state <br /><strong>standbyState:</strong> The standby state <br /><strong>availabilityStates:</strong> The availability state <br /><strong>stateReasons:</strong> A set of specific reasons why the Card Slot is in this state <br /><strong>objectDetails:</strong> Generic properties of the Card Slot <br /><strong>manufacturer:</strong> The vendor of the Card Slot <br /><strong>serialNumber:</strong> The serial number of the Card Slot provided by the manufacturer <br /><strong>partNumber:</strong> The part number of the Card Slot provided by the manufacturer <br /><strong>manufacturerAssemblyNumber:</strong> The assembly number of the Card Slot provided by the manufacturer <br /><strong>manufactureDate:</strong> The date of manufacture of the Card Slot <br /><strong>manufacturingDeviations:</strong> The manufacturing deviations of the Card Slot provided by the manufacturer <br /><strong>macAddress:</strong> The base MAC Address of the Card Slot <br /><strong>hwMacAddress:</strong> The Hardware MAC Address of the Card Slot <br /><strong>provisionedType:</strong> The type of Card provisioned in the Card Slot <br /><strong>actualType:</strong> The type of Card present in the Card Slot <br /><strong>holderState:</strong> The status of the Card Slot <br /><br />Examples:<br />Get all card slots: GET /v1/cardSlots<br />Get all card slots, using a comma-separated list of FDNs: GET /v1/cardSlots?fdns=fdn:model:equipment:EquipmentHolder:2127,fdn:model:equipment:EquipmentHolder:2128<br />Get all card slots, with filter by holderState: GET /v1/cardSlots?filter=holderState%3D'installedAndExpected'<br />Get all card slots, with filter by provisionedType: GET /v1/cardSlots?filter=NOT%20(provisionedType%20LIKE%20'%25IOM%25')<br />Get all card slots, with filter by combined criteria: GET /v1/cardSlots?filter=holderState%3D'installedAndExpected'%20AND%20NOT%20(provisionedType%20LIKE%20'%25IOM%25')"
operationId: getCardSlotsUsingGET
parameters:
- name: fdns
in: query
description: A comma-separated list of the Fully Distinguished Names of the NSP objects to query for.
style: form
explode: true
schema:
type: string
- name: filter
in: query
description: "The criteria to use for filtering. Filter parameter supports NBI standard query language. \n\nFor example, non-encoded filter string: ?filter=name='name' AND NOT (description LIKE '%description%')"
style: form
explode: true
schema:
type: string
- name: limit
in: query
description: 'The limit on the number of objects returned (max: 1000)'
style: form
explode: true
schema:
type: integer
format: int32
default: 300
- name: offset
in: query
description: 'Start row for paged data (max: total number of objects)'
style: form
explode: true
schema:
type: integer
format: int32
default: 0
responses:
'200':
description: OK - Request executed successfully
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/CardSlot'
description: ''
'400':
description: Bad Request - Malformed content or invalid parameter data provided
headers: {}
content: {}
'401':
description: Unauthorized - Authentication rejected
headers: {}
content: {}
'404':
description: Not Found - URL or resource does not exist
headers: {}
content: {}
'405':
description: Method Not Allowed - HTTP method not allowed for this endpoint
headers: {}
content: {}
'500':
description: Internal Server Error - Server error
headers: {}
content: {}
deprecated: false
security:
- RESTToken:
- global
/v1/cardSlots/{cardSlotFdn}:
get:
tags:
- cardSlots
summary: getCardSlotUsingGET
description: Returns detailed information for the specified card slot, which contains a link to the installed card, if not empty.<br /><br />Example:<br />GET /v1/cardSlots/fdn:model:equipment:EquipmentHolder:2127
operationId: getCardSlotUsingGET
parameters:
- name: cardSlotFdn
in: path
description: cardSlotFdn
required: true
style: simple
schema:
type: string
responses:
'200':
description: OK - Request executed successfully
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/CardSlot'
'400':
description: Bad Request - Malformed content or invalid parameter data provided
headers: {}
content: {}
'401':
description: Unauthorized - Authentication rejected
headers: {}
content: {}
'403':
description: Forbidden - No user access to the resource
headers: {}
content: {}
'404':
description: Not Found - URL or resource does not exist
headers: {}
content: {}
'405':
description: Method Not Allowed - HTTP method not allowed for this endpoint
headers: {}
content: {}
'422':
description: Unprocessable Entity - Invalid FDN provided
headers: {}
content: {}
'500':
description: Internal Server Error - Server error
headers: {}
content: {}
deprecated: false
security:
- RESTToken:
- global
/v1/cards:
get:
tags:
- cards
summary: getCardsUsingGET
description: "Returns a paged list of specific cards. The size of each page is determined by the 'limit' query parameter. The list will contain the FDN of each resulting card. Not providing a filter will return all cards.<br /><br /><strong>Filterable properties:</strong> <br /><strong>sourceType:</strong> The type of the source system. For example: <i>nfmp</i> <br /><strong>sourceSystem:</strong> The partial FDN identifying the source system. For example: <i>fdn:realm:sam</i> <br /><strong>name:</strong> The user friendly visible name <br /><strong>neName:</strong> The name of the Network Element containing the Card <br /><strong>neId:</strong> The id of the Network Element containing the Card <br /><strong>description:</strong> The detailed description of the Card <br /><strong>positionId:</strong> The relative position of the Card that determines the order in which to show it in the source system UI<br /><strong>position:</strong> A formatted name that describes the position of the Card within the Network Element<br /><strong>adminState:</strong> The administrative state <br /><strong>operState:</strong> The operational state <br /><strong>standbyState:</strong> The standby state <br /><strong>availabilityStates:</strong> The availability state <br /><strong>stateReasons:</strong> A set of specific reasons why the Card is in this state <br /><strong>objectDetails:</strong> Generic properties of the Card <br /><strong>manufacturer:</strong> The vendor of the Card <br /><strong>serialNumber:</strong> The serial number of the Card provided by the manufacturer <br /><strong>partNumber:</strong> The part number of the Card provided by the manufacturer <br /><strong>manufacturerAssemblyNumber:</strong> The assembly number of the Card provided by the manufacturer <br /><strong>manufactureDate:</strong> The date of manufacture of the Card <br /><strong>manufacturingDeviations:</strong> The manufacturing deviations of the Card provided by the manufacturer <br /><strong>macAddress:</strong> The base MAC Address of the Card <br /><strong>hwMacAddress:</strong> The Hardware MAC Address of the Card <br /><br />Examples:<br />Get all cards: GET /v1/cards<br />Get all cards, using a comma-separated list of FDNs: GET /v1/cards?fdns=fdn:model:equipment:Equipment:2184,fdn:model:equipment:Equipment:2186<br />Get all cards, with filter by manufacturerAssemblyNumber: GET /v1/cards?filter=manufacturerAssemblyNumber%20LIKE%20'%252345%25'<br />Get all cards, with filter by partNumber: GET /v1/cards?filter=partNumber%3D'c18e522906354010bb21e4b78b2ca014'<br />Get all cards, with filter by combined criteria: GET /v1/cards?filter=manufacturerAssemblyNumber%20LIKE%20'%252345%25'%20AND%20partNumber%3D'c18e522906354010bb21e4b78b2ca014'"
operationId: getCardsUsingGET
parameters:
- name: fdns
in: query
description: A comma-separated list of the Fully Distinguished Names of the NSP objects to query for.
style: form
explode: true
schema:
type: string
- name: filter
in: query
description: "The criteria to use for filtering. Filter parameter supports NBI standard query language. \n\nFor example, non-encoded filter string: ?filter=name='name' AND NOT (description LIKE '%description%')"
style: form
explode: true
schema:
type: string
- name: limit
in: query
description: 'The limit on the number of objects returned (max: 1000)'
style: form
explode: true
schema:
type: integer
format: int32
default: 300
- name: offset
in: query
description: 'Start row for paged data (max: total number of objects)'
style: form
explode: true
schema:
type: integer
format: int32
default: 0
responses:
'200':
description: OK - Request executed successfully
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Card'
description: ''
'400':
description: Bad Request - Malformed content or invalid parameter data provided
headers: {}
content: {}
'401':
description: Unauthorized - Authentication rejected
headers: {}
content: {}
'404':
description: Not Found - URL or resource does not exist
headers: {}
content: {}
'405':
description: Method Not Allowed - HTTP method not allowed for this endpoint
headers: {}
content: {}
'500':
description: Internal Server Error - Server error
headers: {}
content: {}
deprecated: false
security:
- RESTToken:
- global
/v1/cards/{cardFdn}:
get:
tags:
- cards
summary: getCardUsingGET
description: Returns detailed information for the specified card.<br /><br />Example:<br />GET /v1/cards/fdn:model:equipment:Equipment:2184
operationId: getCardUsingGET
parameters:
- name: cardFdn
in: path
description: cardFdn
required: true
style: simple
schema:
type: string
responses:
'200':
description: OK - Request executed successfully
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/Card'
'400':
description: Bad Request - Malformed content or invalid parameter data provided
headers: {}
content: {}
'401':
description: Unauthorized - Authentication rejected
headers: {}
content: {}
'403':
description: Forbidden - No user access to the resource
headers: {}
content: {}
'404':
description: Not Found - URL or resource does not exist
headers: {}
content: {}
'405':
description: Method Not Allowed - HTTP method not allowed for this endpoint
headers: {}
content: {}
'422':
description: Unprocessable Entity - Invalid FDN provided
headers: {}
content: {}
'500':
description: Internal Server Error - Server error
headers: {}
content: {}
deprecated: false
security:
- RESTToken:
- global
/v1/lags:
get:
tags:
- lags
summary: getLAGsUsingGET
description: "Returns a paged list of specific LAGs. The size of each page is determined by the 'limit' query parameter. The list will contain the FDN of each resulting LAG. Not providing a filter will return all LAGs.<br /><br /><strong>Filterable properties:</strong> <br /><strong>sourceType:</strong> The type of the source system. For example: <i>nfmp</i> <br /><strong>sourceSystem:</strong> The partial FDN identifying the source system. For example: <i>fdn:realm:sam</i> <br /><strong>name:</strong> The user friendly visible name <br /><strong>neName:</strong> The name of this LAG <br /><strong>neId:</strong> The id of this LAG<br /><strong>description:</strong> The detailed description of this LAG <br /><strong>configuredAddress:</strong> The MAC Address of this LAG <br /><strong>encapType:</strong> The encapsulation type of this LAG <br /><strong>operationalSpeedUnits:</strong> The units associated to the ‘operationalSpeed’ field value for this LAG<br /><strong>operationalSpeed:</strong> The total operational speed of this LAG, in units specified by the ‘operationalSpeedUnits’ field value<br /><strong>adminState:</strong> The administrative state <br /><strong>operState:</strong> The operational state <br /><strong>standbyState:</strong> The standby state <br /><strong>availabilityStates:</strong> The availability state <br /><strong>stateReasons:</strong> A set of specific reasons why the LAG is in this state <br /><strong>objectDetails:</strong> Generic properties of this LAG <br /><br />Examples:<br />Get all LAGs: GET /v1/lags<br />Get all LAGs, using a comma-separated list of FDNs: GET /v1/lags?fdns=fdn:model:equipment:LAG:12872,fdn:model:equipment:LAG:12873<br />Get all LAGs, with filter by configuredAddress: GET /v1/lags?filter=configuredAddress%20LIKE%20'C0-3E%25'<br />Get all LAGs, with filter by neId: GET /v1/lags?filter=neId%20LIKE%20'%25.85'<br />Get all LAGs, with filter by combined criteria: GET /v1/lags?filter=NOT%20(configuredAddress%20LIKE%20'C0-3E%25')%20AND%20neId%20LIKE%20'%25.85'"
operationId: getLAGsUsingGET
parameters:
- name: fdns
in: query
description: A comma-separated list of the Fully Distinguished Names of the NSP objects to query for.
style: form
explode: true
schema:
type: string
- name: filter
in: query
description: "The criteria to use for filtering. Filter parameter supports NBI standard query language. \n\nFor example, non-encoded filter string: ?filter=name='name' AND NOT (description LIKE '%description%')"
style: form
explode: true
schema:
type: string
- name: limit
in: query
description: 'The limit on the number of objects returned (max: 1000)'
style: form
explode: true
schema:
type: integer
format: int32
default: 300
- name: offset
in: query
description: 'Start row for paged data (max: total number of objects)'
style: form
explode: true
schema:
type: integer
format: int32
default: 0
responses:
'200':
description: OK - Request executed successfully
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/LAG'
description: ''
'400':
description: Bad Request - Malformed content or invalid parameter data provided
headers: {}
content: {}
'401':
description: Unauthorized - Authentication rejected
headers: {}
content: {}
'404':
description: Not Found - URL or resource does not exist
headers: {}
content: {}
'405':
description: Method Not Allowed - HTTP method not allowed for this endpoint
headers: {}
content: {}
'500':
description: Internal Server Error - Server error
headers: {}
content: {}
deprecated: false
security:
- RESTToken:
- global
/v1/lags/{lagFdn}:
get:
tags:
- lags
summary: getLAGUsingGET
description: Returns detailed information for the specified LAG.<br /><br />Example:<br />GET /v1/lags/fdn:model:equipment:LAG:12872
operationId: getLAGUsingGET
parameters:
- name: lagFdn
in: path
description: lagFdn
required: true
style: simple
schema:
type: string
responses:
'200':
description: OK - Request executed successfully
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/LAG'
'400':
description: Bad Request - Malformed content or invalid parameter data provided
headers: {}
content: {}
'401':
description: Unauthorized - Authentication rejected
headers: {}
content: {}
'403':
description: Forbidden - No user access to the resource
headers: {}
content: {}
'404':
description: Not Found - URL or resource does not exist
headers: {}
content: {}
'405':
description: Method Not Allowed - HTTP method not allowed for this endpoint
headers: {}
content: {}
'422':
description: Unprocessable Entity - Invalid FDN provided
headers: {}
content: {}
'500':
description: Internal Server Error - Server error
headers: {}
content: {}
deprecated: false
security:
- RESTToken:
- global
/v1/networkElements:
get:
tags:
- networkElements
summary: getNEsUsingGET
description: "Returns a paged list of specific network elements. The size of each page is determined by the 'limit' query parameter. The list will contain the FDN of each resulting network element. Not providing a filter will return all network elements.<br /><br /><strong>Filterable properties:</strong> <br /><strong>sourceType:</strong> The type of the source system. For example: <i>nfmp</i> <br /><strong>sourceSystem:</strong> The partial FDN identifying the source system. For example: <i>fdn:realm:sam</i> <br /><strong>name:</strong> The name of this Network Element, as defined by the source system <br /><strong>neName:</strong> The name of the Network Element which is unique within the source system<br /><strong>neId:</strong> The id of the Network Element <br /><strong>description:</strong> The detailed description of the Network Element <br /><strong>ipAddress:</strong> The management IP address of the Network Element <br /><strong>type:</strong> The type of the Network Element <br /><strong>product:</strong> The vendor product name of the Network Element <br /><strong>version:</strong> The version of the Network Element <br /><strong>resyncState:</strong> The resynchronization status of the Network Element <br /><strong>longitude:</strong> The longitude (in degrees) of the Network Element, if known. Min = -180, Max = 180 <br /><strong>latitude:</strong> The latitude (in degrees) of the Network Element, if known. Min = -90, Max = 90 <br /><strong>location:</strong> The location of the Network Element <br /><strong>topologyGroup:</strong> The Fully Distinguished Name of the topology group that the Network Element belongs to, if any <br /><strong>adminState:</strong> The administrative state <br /><strong>operState:</strong> The operational state <br /><strong>standbyState:</strong> The standby state <br /><strong>availabilityStates:</strong> The availability state <br /><strong>objectDetails:</strong> Generic properties of the Network Element <br /><strong>networkType:</strong> The type of network the Network Element is part of <br /><strong>communicationState:</strong> The communication status of the Network Element <br /><strong>communicationStateDetails:</strong> The reachability status of each supported management protocol of the Network Element <br /><strong>macAddress:</strong> The Mac address of the Network Element <br /><strong>clliCode:</strong> Common Language Location Identifier (CLLI) code value for the system <br /><br />Examples:<br />Get all network elements: GET /v1/networkElements<br />Get all network elements, using a comma-separated list of FDNs: GET /v1/networkElements?fdns=fdn:model:equipment:NetworkElement:2102,fdn:model:equipment:NetworkElement:2103<br />Get all network elements, with filter by managedState: GET /v1/networkElements?filter=managedState%3D'managed'<br />Get all network elements, with filter by product: GET /v1/networkElements?filter=product%20LIKE%20'7750%25'<br />Get all network elements, with filter by combined criteria: GET /v1/networkElements?filter=managedState%3D'managed'%20AND%20NOT%20(product%20LIKE%20'7750%25')"
operationId: getNEsUsingGET
parameters:
- name: fdns
in: query
description: A comma-separated list of the Fully Distinguished Names of the NSP objects to query for.
style: form
explode: true
schema:
type: string
- name: filter
in: query
description: "The criteria to use for filtering. Filter parameter supports NBI standard query language. \n\nFor example, non-encoded filter string: ?filter=name='name' AND NOT (description LIKE '%description%')"
style: form
explode: true
schema:
type: string
- name: limit
in: query
description: 'The limit on the number of objects returned (max: 1000)'
style: form
explode: true
schema:
type: integer
format: int32
default: 300
- name: offset
in: query
description: 'Start row for paged data (max: total number of objects)'
style: form
explode: true
schema:
type: integer
format: int32
default: 0
responses:
'200':
description: OK - Request executed successfully
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/NetworkElement'
description: ''
'400':
description: Bad Request - Malformed content or invalid parameter data provided
headers: {}
content: {}
'401':
description: Unauthorized - Authentication rejected
headers: {}
content: {}
'404':
description: Not Found - URL or resource does not exist
headers: {}
content: {}
'405':
description: Method Not Allowed - HTTP method not allowed for this endpoint
headers: {}
content: {}
'500':
description: Internal Server Error - Server error
headers: {}
content: {}
deprecated: false
security:
- RESTToken:
- global
/v1/networkElements/{networkElementFdn}:
get:
tags:
- networkElements
summary: getNEUsingGET
description: Returns detailed information for the specified network element.<br /><br />Example:<br />GET /v1/networkElements/fdn:model:equipment:NetworkElement:2102
operationId: getNEUsingGET
parameters:
- name: networkElementFdn
in: path
description: networkElementFdn
required: true
style: simple
schema:
type: string
responses:
'200':
description: OK - Request executed successfully
headers: {}
content:
application/json:
schema:
$ref: '#/components/schemas/NetworkElement'
'400':
description: Bad Request - Malformed content or invalid parameter data provided
headers: {}
content: {}
'401':
description: Unauthorized - Authentication rejected
headers: {}
content: {}
'403':
description: Forbidden - No user access to the resource
headers: {}
content: {}
'404':
description: Not Found - URL or resource does not exist
headers: {}
content: {}
'405':
description: Method Not Allowed - HTTP method not allowed for this endpoint
headers: {}
content: {}
'422':
description: Unprocessable Entity - Invalid FDN provided
headers: {}
content: {}
'500':
description: Internal Server Error - Server error
headers: {}
content: {}
deprecated: false
security:
- RESTToken:
- global
/v1/networkElements/{networkElementFdn}/lags:
get:
tags:
- networkElements
summary: getNELAGsUsingGET
description: 'Returns a list of specific LAGs. The list will contain the FDN of each resulting LAG. Not providing a filter will return all LAGs.<br /><br /><strong>Filterable properties:</strong> <br /><strong>sourceType:</strong> The type of the source system. For example: <i>nfmp</i> <br /><strong>sourceSystem:</strong> The partial FDN identifying the source system. For example: <i>fdn:realm:sam</i> <br /><strong>name:</strong> The name of the LAG, as defined by the source system <br /><strong>neName:</strong> The name of the LAG which is unique within the source system<br /><strong>neId:</strong> The id of the LAG <br /><strong>description:</strong> The detailed description of the LAG <br /><strong>configuredAddress:</strong> The MAC Address of the LAG <br /><strong>encapType:</strong> The encapsulation type of the LAG <br /><strong>operationalSpeedUnits:</strong> The units associated to the ‘operationalSpeed’ field value for the LAG<br /><strong>operationalSpeed:</strong> The total operational speed of the LAG, in units specified by the ‘operationalSpeedUnits’ field value<br /><strong>adminState:</strong> The administrative state <br /><strong>operState:</strong> The operational state <br /><strong>standbyState:</strong> The standby state <br /><strong>availabilityStates:</strong> The availability state <br /><strong>objectDetails:</strong> Generic properties of the LAG <br /><br />Examples:<br />'
operationId: getNELAGsUsingGET
parameters:
- name: filter
in: query
description: "The criteria to use for filtering. Filter parameter supports NBI standard query language. \n\nFor example, non-encoded filter string: ?filter=name='name' AND NOT (description LIKE '%description%')"
style: form
explode: true
schema:
type: string
- name: networkElementFdn
in: path
description: networkElementFdn
required: true
style: simple
schema:
type: string
responses:
'200':
description: OK - Request executed successfully
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/LAG'
description: ''
'400':
description: Bad Request - Malformed content or invalid parameter data provided
headers: {}
content: {}
'401':
description: Unauthorized - Authentication rejected
headers: {}
content: {}
'403':
description: Forbidden - No user access to the resource
headers: {}
content: {}
'404':
description: Not Found - URL or resource does not exist
headers: {}
content: {}
'405':
description: Method Not Allowed - HTTP method not allowed for this endpoint
headers: {}
content: {}
'422':
description: Unprocessable Entity - Invalid FDN provided
headers: {}
content: {}
'500':
description: Internal Server Error - Server error
headers: {}
content: {}
deprecated: false
security:
- RESTToken:
- global
/v1/networkElements/{networkElementFdn}/lags/{lagFdn}/lagMembers:
get:
tags:
- networkElements
summary: getLagMembersUsingGET
description: Returns a list of specific LAG members. The list will contain the FDN of each resulting LAG member. Not providing a filter will return all LAG members.<br /><br />Examples:<br />
operationId: getLagMembersUsingGET
parameters:
- name: filter
in: query
description: "The criteria to use for filtering. Filter parameter supports NBI standard query language. \n\nFor example, non-encoded filter string: ?filter=name='name' AND NOT (description LIKE '%description%')"
style: form
explode: true
schema:
type: string
- name: lagFdn
in: path
description: lagFdn
required: true
style: simple
schema:
type: string
- name: networkElementFdn
in: path
description: networkElementFdn
required: true
style: simple
schema:
type: string
responses:
'200':
description: OK - Request executed successfully
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/LAGMemberDetails'
description: ''
'400':
description: Bad Request - Malformed content or invalid parameter data provided
headers: {}
content: {}
'401':
description: Unauthorized - Authentication rejected
headers: {}
content: {}
'403':
description: Forbidden - No user access to the resource
headers: {}
content: {}
'404':
description: Not Found - URL or resource does not exist
headers: {}
content: {}
'405':
description: Method Not Allowed - HTTP method not allowed for this endpoint
headers: {}
content: {}
'422':
description: Unprocessable Entity - Invalid FDN provided
headers: {}
content: {}
'500':
description: Internal Server Error - Server error
headers: {}
content: {}
deprecated: false
security:
- RESTToken:
- global
/v1/networkElements/{networkElementFdn}/radioEquipment:
get:
tags:
- networkElements
summary: getNERadioEquipmentsUsingGET
description: 'Returns a list of specific radio equipments. The list will contain the FDN of each resulting Radio Equipment. Not providing a filter will return all Radio Equipments.<br /><br /><strong>Filterable properties:</strong> <br /><strong>sourceType:</strong> The type of the source system. For example: <i>nfmp</i> <br /><strong>sourceSystem:</strong> The partial FDN identifying the source system. For example: <i>fdn:realm:sam</i> <br /><strong>name:</strong> The name of the radio equipment, as defined by the source system <br /><strong>neName:</strong> The name of the radio equipment which is unique within the source system<br /><strong>neId:</strong> The id of the radio equipment <br /><strong>description:</strong> The detailed description of the radio equipment <br /><strong>ipAddress:</strong> The management IP address of the radio equipment <br /><strong>product:</strong> The vendor product name of the radio equipment <br /><strong>version:</strong> The version of this radio equipment <br /><strong>longitude:</strong> The longitude (in degrees) of the radio equipment, if known. Min = -180, Max = 180 <br /><strong>latitude:</strong> The latitude (in degrees) of the radio equipment, if known. Min = -90, Max = 90 <br /><strong>location:</strong> The location of the radio equipment <br /><strong>adminState:</strong> The administrative state <br /><strong>operState:</strong> The operational state <br /><strong>standbyState:</strong> The standby state <br /><strong>communicationState:</strong> The communication status of the radio equipment <br /><strong>availabilityStates:</strong> The availability state <br /><strong>objectDetails:</strong> Generic properties of the radio equipment <br /><strong>macAddress:</strong> The Mac address of the radio equipment <br /><strong>clliCode:</strong> Common Language Location Identifier (CLLI) code value for the system <br /><br />Examples:<br />'
operationId: getNERadioEquipmentsUsingGET
parameters:
- name: filter
in: query
description: "The criteria to use for filtering. Filter parameter supports NBI standard query language. \n\nFor example, non-encoded filter string: ?filter=name='name' AND NOT (description LIKE '%description%')"
style: form
explode: true
schema:
type: string
- name: networkElementFdn
in: path
description: networkElementFdn
required: true
style: simple
schema:
type: string
responses:
'200':
description: OK - Request executed successfully
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/RadioEquipment'
description: ''
'400':
description: Bad Request - Malformed content or invalid parameter data provided
headers: {}
content: {}
'401':
description: Unauthorized - Authentication rejected
headers: {}
content: {}
'403':
description: Forbidden - No user access to the resource
headers: {}
content: {}
'404':
description: Not Found - URL or resource does not exist
headers: {}
content: {}
'405':
description: Method Not Allowed - HTTP method not allowed for this endpoint
headers: {}
content: {}
'422':
description: Unprocessable Entity - Invalid FDN provided
headers: {}
content: {}
'500':
description: Internal Server Error - Server error
headers: {}
content: {}
deprecated: false
security:
- RESTToken:
- global
/v1/networkElements/{networkElementFdn}/radioEquipment/{radioEquipmentFdn}/lags:
get:
tags:
- networkElements
summary: getRadioEquipmentLagsUsingGET
description: 'Returns a list of specific LAGs on a radio equipment linked to a network element. The list will contain the FDN of each resulting LAG. Not providing a filter will return all LAGs.<br /><br /><strong>Filterable properties:</strong> <br /><strong>sourceType:</strong> The type of the source system. For example: <i>nfmp</i> <br /><strong>sourceSystem:</strong> The partial FDN identifying the source system. For example: <i>fdn:realm:sam</i> <br /><strong>name:</strong> The user friendly visible name <br /><strong>neName:</strong> The name of the LAG <br /><strong>neId:</strong> The id of the LAG<br /><strong>description:</strong> The detailed description of the LAG <br /><strong>configuredAddress:</strong> The MAC Address of the LAG <br /><strong>encapType:</strong> The encapsulation type of the LAG <br /><strong>operationalSpeedUnits:</strong> The units associated to the ‘operationalSpeed’ field value for the LAG<br /><strong>operationalSpeed:</strong> The total operational speed of the LAG, in units specified by the ‘operationalSpeedUnits’ field value<br /><strong>adminState:</strong> The administrative state <br /><strong>operState:</strong> The operational state <br /><strong>standbyState:</strong> The standby state <br /><strong>availabilityStates:</strong> The availability state <br /><strong>stateReasons:</strong> A set of specific reasons why the LAG is in this state <br /><strong>objectDetails:</strong> Generic properties of the LAG <br /><br />Examples:<br />'
operationId: getRadioEquipmentLagsUsingGET
parameters:
- name: filter
in: query
description: "The criteria to use for filtering. Filter parameter supports NBI standard query language. \n\nFor example, non-encoded filter string: ?filter=name='name' AND NOT (description LIKE '%description%')"
style: form
explode: true
schema:
type: string
- name: networkElementFdn
in: path
description: networkElementFdn
required: true
style: simple
schema:
type: string
- name: radioEquipmentFdn
in: path
description: radioEquipmentFdn
required: true
style: simple
schema:
type: string
responses:
'200':
description: OK - Request executed successfully
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/LAG'
description: ''
'400':
description: Bad Request - Malformed content or invalid parameter data provided
headers: {}
content: {}
'401':
description: Unauthorized - Authentication rejected
headers: {}
content: {}
'403':
description: Forbidden - No user access to the resource
headers: {}
content: {}
'404':
description: Not Found - URL or resource does not exist
headers: {}
content: {}
'405':
description: Method Not Allowed - HTTP method not allowed for this endpoint
headers: {}
content: {}
'422':
description: Unprocessable Entity - Invalid FDN provided
headers: {}
content: {}
'500':
description: Internal Server Error - Server error
headers: {}
content: {}
deprecated: false
security:
- RESTToken:
- global
/v1/networkElements/{networkElementFdn}/radioEquipment/{radioEquipmentFdn}/lags/{lagFdn}/lagMembers:
get:
tags:
- networkElements
summary: getRadioEquipmentLagMembersUsingGET
description: Returns a list of specific LAG members a radio equipment LAG. The list will contain the FDN of each resulting LAG member. Not providing a filter will return all LAG members.<br /><br />Examples:<br />
operationId: getRadioEquipmentLagMembersUsingGET
parameters:
- name: filter
in: query
description: "The criteria to use for filtering. Filter parameter supports NBI standard query language. \n\nFor example, non-encoded filter string: ?filter=name='name' AND NOT (description LIKE '%description%')"
style: form
explode: true
schema:
type: string
- name: lagFdn
in: path
description: lagFdn
required: true
style: simple
schema:
type: string
- name: networkElementFdn
in: path
description: networkElementFdn
required: true
style: simple
schema:
type: string
- name: radioEquipmentFdn
in: path
description: radioEquipmentFdn
required: true
style: simple
schema:
type: string
responses:
'200':
description: OK - Request executed successfully
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/LAGMemberDetails'
description: ''
'400':
description: Bad Request - Malformed content or invalid parameter data provided
headers: {}
content: {}
'401':
description: Unauthorized - Authentication rejected
headers: {}
content: {}
'403':
description: Forbidden - No user access to the resource
headers: {}
content: {}
'404':
description: Not Found - URL or resource does not exist
headers: {}
content: {}
'405':
description: Method Not Allowed - HTTP method not allowed for this endpoint
headers: {}
content: {}
'422':
description: Unprocessable Entity - Invalid FDN provided
headers: {}
content: {}
'500':
description: Internal Server Error - Server error
headers: {}
content: {}
deprecated: false
security:
- RESTToken:
- global
/v1/networkElements/{networkElementFdn}/radioEquipment/{radioEquipmentFdn}/shelves:
get:
tags:
- networkElements
summary: getRadioEquipmentShelvesUsingGET
description: 'Returns a list of specific shelves on a radio equipment linked to a network element. The list will contain the FDN of each resulting shelf. Not providing a filter will return all shelves.<br /><br /><strong>Filterable properties:</strong> <br /><strong>sourceType:</strong> The type of the source system. For example: <i>nfmp</i> <br /><strong>sourceSystem:</strong> The partial FDN identifying the source system. For example: <i>fdn:realm:sam</i> <br /><strong>name:</strong> The user friendly visible name <br /><strong>neName:</strong> The name of the radio equipment containing the Shelf <br /><strong>neId:</strong> The id of the radio equipment containing the Shelf <br /><strong>description:</strong> The detailed description of the Shelf <br /><strong>positionId:</strong> The relative position of the Shelf that determines the order in which to show it in the source system UI<br /><strong>position:</strong> A formatted name that describes the position of the Shelf within the radio equipment<br /><strong>adminState:</strong> The administrative state <br /><strong>operState:</strong> The operational state <br /><strong>standbyState:</strong> The standby state <br /><strong>availabilityStates:</strong> The availability state <br /><strong>stateReasons:</strong> A set of specific reasons why the Shelf is in this state <br /><strong>objectDetails:</strong> Generic properties of this Shelf <br /><strong>manufacturer:</strong> The vendor of the Shelf <br /><strong>serialNumber:</strong> The serial number of the Shelf provided by the manufacturer <br /><strong>partNumber:</strong> The part number of the Shelf provided by the manufacturer <br /><strong>manufacturerAssemblyNumber:</strong> The assembly number of the Shelf provided by the manufacturer <br /><strong>manufactureDate:</strong> The date of manufacture of the Shelf <br /><strong>manufacturingDeviations:</strong> The manufacturing deviations of the Shelf provided by the manufacturer <br /><strong>macAddress:</strong> The base MAC Address of the Shelf <br /><strong>hwMacAddress:</strong> The Hardware MAC Address of the Shelf <br /><br />Examples:<br />'
operationId: getRadioEquipmentShelvesUsingGET
parameters:
- name: filter
in: query
description: "The criteria to use for filtering. Filter parameter supports NBI standard query language. \n\nFor example, non-encoded filter string: ?filter=name='name' AND NOT (description LIKE '%description%')"
style: form
explode: true
schema:
type: string
- name: networkElementFdn
in: path
description: networkElementFdn
required: true
style: simple
schema:
type: string
- name: radioEquipmentFdn
in: path
description: radioEquipmentFdn
required: true
style: simple
schema:
type: string
responses:
'200':
description: OK - Request executed successfully
headers: {}
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/Shelf'
description: ''
'400':
description: Bad Request - Malformed content or invalid parameter data provided
headers: {}
content: {}
'401':
description: Unauthorized - Authentication rejected
headers: {}
content: {}
'403':
description: Forbidden - No user access to the resource
headers: {}
content: {}
'404':
description: Not Found - URL or resource does not exist
headers: {}
content: {}
'405':
description: Method Not Allowed - HTTP method not allowed for this endpoint
headers: {}
content: {}
'422':
description: Unprocessable Entity - Invalid FDN provided
headers: {}
content: {}
'500':
description: Internal Server Error - Server error
headers: {}
content: {}
deprecated: false
security:
- RESTToken:
- global
/v1/networkElements/{networkElementFdn}/radioEquipment/{radioEquipmentFdn}/shelves/{shelfFdn}/cards:
get:
tags:
- networkElements
summary: getRadioEquipmentShelfCardsUsingGET
description: 'Returns a list of specific cards on a radio equipment shelf. The list will contain the FDN of each resulting card. Not providing a filter will re