openapi: 3.0.1
info:
title: Fault Supervision MnS
- version: 16.4.0
+ version: 16.6.0
description: >-
OAS 3.0.1 definition of the Fault Supervision MnS
© 2020, 3GPP Organizational Partners (ARIB, ATIS, CCSA, ETSI, TSDSI, TTA, TTC).
All rights reserved.
externalDocs:
- description: 3GPP TS 28.532 V16.4.0; Generic management services
+ description: 3GPP TS 28.532; Generic management services
url: http://www.3gpp.org/ftp/Specs/archive/28_series/28.532/
servers:
- - url: '{MnSRoot}/FaultSupervisionMnS/{version}'
+ - url: '{MnSRoot}/FaultSupervisionMnS/{MnSversion}'
variables:
MnSRoot:
description: See subclause 4.4.3 of TS 32.158
default: http://example.com/3GPPManagement
- version:
- description: Versi on number of the OpenAPI definition
+ MnSversion:
+ description: Version number of the OpenAPI definition
default: XXX
paths:
/alarms:
in: query
required: false
schema:
- $ref: '#/components/schemas/Dn'
+ $ref: 'comDefs.yaml#/components/schemas/Dn'
- name: filter
in: query
required: false
schema:
- $ref: '#/components/schemas/Filter'
+ $ref: 'comDefs.yaml#/components/schemas/Filter'
responses:
'200':
description: >-
- type: object
properties:
lastNotificationHeader:
- $ref: '#/components/schemas/NotificationHeader'
+ $ref: 'comDefs.yaml#/components/schemas/NotificationHeader'
- $ref: '#/components/schemas/AlarmRecord'
- type: object
properties:
content:
application/json:
schema:
- $ref: '#/components/schemas/ErrorResponse'
+ $ref: 'comDefs.yaml#/components/schemas/ErrorResponse'
patch:
summary: 'Clear, acknowledge or unacknowledge multiple alarms'
description: >-
content:
application/json:
schema:
- $ref: '#/components/schemas/ErrorResponse'
+ $ref: 'comDefs.yaml#/components/schemas/ErrorResponse'
/alarms/{alarmId}:
patch:
summary: 'Clear, acknowledge or unacknowledge a single alarm'
content:
application/json:
schema:
- $ref: '#/components/schemas/ErrorResponse'
+ $ref: 'comDefs.yaml#/components/schemas/ErrorResponse'
/alarms/{alarmId}/comments:
post:
summary: Add a comment to a single alarm
content:
application/json:
schema:
- $ref: '#/components/schemas/ErrorResponse'
+ $ref: 'comDefs.yaml#/components/schemas/ErrorResponse'
/subscriptions:
post:
content:
application/json:
schema:
- $ref: '#/components/schemas/ErrorResponse'
+ $ref: 'comDefs.yaml#/components/schemas/ErrorResponse'
callbacks:
notifyNewAlarm:
'{request.body#/consumerReference}':
content:
application/json:
schema:
- $ref: '#/components/schemas/ErrorResponse'
+ $ref: 'comDefs.yaml#/components/schemas/ErrorResponse'
notifyClearedAlarm:
'{request.body#/consumerReference}':
post:
content:
application/json:
schema:
- $ref: '#/components/schemas/ErrorResponse'
+ $ref: 'comDefs.yaml#/components/schemas/ErrorResponse'
notifyChangedAlarm:
'{request.body#/consumerReference}':
post:
content:
application/json:
schema:
- $ref: '#/components/schemas/ErrorResponse'
+ $ref: 'comDefs.yaml#/components/schemas/ErrorResponse'
notifyChangedAlarmGeneral:
'{request.body#/consumerReference}':
post:
content:
application/json:
schema:
- $ref: '#/components/schemas/ErrorResponse'
+ $ref: 'comDefs.yaml#/components/schemas/ErrorResponse'
notifyCorrelatedNotificationChanged:
'{request.body#/consumerReference}':
post:
content:
application/json:
schema:
- $ref: '#/components/schemas/ErrorResponse'
+ $ref: 'comDefs.yaml#/components/schemas/ErrorResponse'
notifyAckStateChanged:
'{request.body#/consumerReference}':
post:
content:
application/json:
schema:
- $ref: '#/components/schemas/ErrorResponse'
+ $ref: 'comDefs.yaml#/components/schemas/ErrorResponse'
notifyComments:
'{request.body#/consumerReference}':
post:
content:
application/json:
schema:
- $ref: '#/components/schemas/ErrorResponse'
+ $ref: 'comDefs.yaml#/components/schemas/ErrorResponse'
notifyPotentialFaultyAlarmList:
'{request.body#/consumerReference}':
post:
content:
application/json:
schema:
- $ref: '#/components/schemas/ErrorResponse'
+ $ref: 'comDefs.yaml#/components/schemas/ErrorResponse'
notifyAlarmListRebuilt:
'{request.body#/consumerReference}':
post:
content:
application/json:
schema:
- $ref: '#/components/schemas/ErrorResponse'
+ $ref: 'comDefs.yaml#/components/schemas/ErrorResponse'
/subscriptions/{subscriptionId}:
delete:
summary: Delete a subscription
content:
application/json:
schema:
- $ref: '#/components/schemas/ErrorResponse'
+ $ref: 'comDefs.yaml#/components/schemas/ErrorResponse'
components:
schemas:
-
- #---- Definitions to be moved to comDefs.yaml --------------------------------------#
-
- Long:
- type: string
- format: long
- Float:
- type: string
- format: float
- DateTime:
- type: string
- format: date-Time
-
- Dn:
- type: string
- Uri:
- type: string
-
- AttributeNameValuePairSet:
- type: object
- minProperties: 1
- AttributeValueChangeSet:
- description: >-
- The key in this map is the attribute name. The value of each key is an array.
- When only one item is present in the array, it carries the new attribute
- value. If two items are present, then the first item carries the old value
- and the second item the new value. The items can be of any type including null.
- type: object
- additionalProperties:
- type: array
- minItems: 1
- maxItems: 2
- items:
- nullable: true
-
- Filter:
- type: string
- SystemDN:
- type: string
-
- NotificationId:
- type: integer
- NotificationHeader:
- description: >-
- Header used for all notification types
- type: object
- required:
- - href
- - notificationId
- - notificationType
- - eventTime
- - systemDN
- properties:
- uri:
- $ref: '#/components/schemas/Uri'
- notificationId:
- $ref: '#/components/schemas/NotificationId'
- notificationType:
- oneOf:
- - $ref: '#/components/schemas/AlarmNotificationTypes'
- #- $ref: 'faultMnS.yaml#/components/schemas/AlarmNotificationTypes'
- #- $ref: 'provMnS.yaml#/components/schemas/CmNotificationTypes'
- # more to be added
- eventTime:
- $ref: '#/components/schemas/DateTime'
- systemDN:
- $ref: '#/components/schemas/SystemDN'
-
- ErrorResponse:
- description: >-
- Default schema for the response message body in case the request is not
- successful.
- type: object
- properties:
- error:
- type: object
- properties:
- errorInfo:
- type: string
-
- #---- End of definitions to be moved to comDefs.yaml -------------------------------#
#---- Definition of AlarmRecord ----------------------------------------------------#
high:
oneOf:
- type: integer
- - $ref: '#/components/schemas/Float'
+ - $ref: 'comDefs.yaml#/components/schemas/Float'
low:
- $ref: '#/components/schemas/Float'
+ $ref: 'comDefs.yaml#/components/schemas/Float'
ThresholdLevelInd:
- type: object
- required:
- - up
- properties:
- up:
- $ref: '#/components/schemas/ThresholdHysteresis'
- low:
- $ref: '#/components/schemas/ThresholdHysteresis'
+ oneOf:
+ - type: object
+ properties:
+ up:
+ $ref: '#/components/schemas/ThresholdHysteresis'
+ - type: object
+ properties:
+ down:
+ $ref: '#/components/schemas/ThresholdHysteresis'
ThresholdInfo:
type: object
- required:
- - observedMeasurement
- - observedValue
properties:
observedMeasurement:
type: string
observedValue:
oneOf:
- type: integer
- - $ref: '#/components/schemas/Float'
- thresholdLevelInd:
+ - $ref: 'comDefs.yaml#/components/schemas/Float'
+ thresholdLevel:
$ref: '#/components/schemas/ThresholdLevelInd'
armTime:
- $ref: '#/components/schemas/DateTime'
+ $ref: 'comDefs.yaml#/components/schemas/DateTime'
+ required:
+ - observedMeasurement
+ - observedValue
CorrelatedNotification:
type: object
- required:
- - source
- - notificationId
properties:
sourceObjectInstance:
- $ref: '#/components/schemas/Dn'
+ $ref: 'comDefs.yaml#/components/schemas/Dn'
notificationIds:
type: array
items:
- $ref: '#/components/schemas/NotificationId'
+ $ref: 'comDefs.yaml#/components/schemas/NotificationId'
+ required:
+ - sourceObjectInstance
+ - notificationIds
CorrelatedNotifications:
type: array
items:
# alarmId:
# $ref: '#/components/schemas/AlarmId'
objectInstance:
- $ref: '#/components/schemas/Dn'
+ $ref: 'comDefs.yaml#/components/schemas/Dn'
notificationId:
- $ref: '#/components/schemas/NotificationId'
+ $ref: 'comDefs.yaml#/components/schemas/NotificationId'
alarmRaisedTime:
- $ref: '#/components/schemas/DateTime'
+ $ref: 'comDefs.yaml#/components/schemas/DateTime'
alarmChangedTime:
- $ref: '#/components/schemas/DateTime'
+ $ref: 'comDefs.yaml#/components/schemas/DateTime'
alarmClearedTime:
- $ref: '#/components/schemas/DateTime'
+ $ref: 'comDefs.yaml#/components/schemas/DateTime'
alarmType:
$ref: '#/components/schemas/AlarmType'
probableCause:
backedUpStatus:
type: boolean
backUpObject:
- $ref: '#/components/schemas/Dn'
+ $ref: 'comDefs.yaml#/components/schemas/Dn'
trendIndication:
$ref: '#/components/schemas/TrendIndication'
thresholdinfo:
correlatedNotifications:
$ref: '#/components/schemas/CorrelatedNotifications'
stateChangeDefinition:
- $ref: '#/components/schemas/AttributeValueChangeSet'
+ $ref: 'comDefs.yaml#/components/schemas/AttributeValueChangeSet'
monitoredAttributes:
- $ref: '#/components/schemas/AttributeNameValuePairSet'
+ $ref: 'comDefs.yaml#/components/schemas/AttributeNameValuePairSet'
proposedRepairActions:
type: string
additionalText:
type: string
additionalInformation:
- $ref: '#/components/schemas/AttributeNameValuePairSet'
+ $ref: 'comDefs.yaml#/components/schemas/AttributeNameValuePairSet'
rootCauseIndicator:
type: boolean
ackTime:
- $ref: '#/components/schemas/DateTime'
+ $ref: 'comDefs.yaml#/components/schemas/DateTime'
ackUserId:
type: string
ackSystemId:
NotifyNewAlarm:
allOf:
- - $ref: '#/components/schemas/NotificationHeader'
+ - $ref: 'comDefs.yaml#/components/schemas/NotificationHeader'
- type: object
required:
- alarmId
backedUpStatus:
type: boolean
backUpObject:
- $ref: '#/components/schemas/Dn'
+ $ref: 'comDefs.yaml#/components/schemas/Dn'
trendIndication:
$ref: '#/components/schemas/TrendIndication'
thresholdInfo:
correlatedNotifications:
$ref: '#/components/schemas/CorrelatedNotifications'
stateChangeDefinition:
- $ref: '#/components/schemas/AttributeValueChangeSet'
+ $ref: 'comDefs.yaml#/components/schemas/AttributeValueChangeSet'
monitoredAttributes:
- $ref: '#/components/schemas/AttributeNameValuePairSet'
+ $ref: 'comDefs.yaml#/components/schemas/AttributeNameValuePairSet'
proposedRepairActions:
type: string
additionalText:
type: string
additionalInformation:
- $ref: '#/components/schemas/AttributeNameValuePairSet'
+ $ref: 'comDefs.yaml#/components/schemas/AttributeNameValuePairSet'
rootCauseIndicator:
type: boolean
NotifyNewSecAlarm:
allOf:
- - $ref: '#/components/schemas/NotificationHeader'
+ - $ref: 'comDefs.yaml#/components/schemas/NotificationHeader'
- type: object
required:
- alarmId
additionalText:
type: string
additionalInformation:
- $ref: '#/components/schemas/AttributeNameValuePairSet'
+ $ref: 'comDefs.yaml#/components/schemas/AttributeNameValuePairSet'
rootCauseIndicator:
type: boolean
serviceUser:
type: string
NotifyClearedAlarm:
allOf:
- - $ref: '#/components/schemas/NotificationHeader'
+ - $ref: 'comDefs.yaml#/components/schemas/NotificationHeader'
- type: object
required:
- alarmId
type: string
NotifyChangedAlarm:
allOf:
- - $ref: '#/components/schemas/NotificationHeader'
+ - $ref: 'comDefs.yaml#/components/schemas/NotificationHeader'
- type: object
required:
- alarmId
$ref: '#/components/schemas/PerceivedSeverity'
NotifyChangedAlarmGeneral:
allOf:
- - $ref: '#/components/schemas/NotificationHeader'
+ - $ref: 'comDefs.yaml#/components/schemas/NotificationHeader'
- type: object
required:
- alarmId
- alarmType
- - probableCause
- - perceivedSeverity
- - changedAlarmAttributes
properties:
alarmId:
$ref: '#/components/schemas/AlarmId'
backedUpStatus:
type: boolean
backUpObject:
- $ref: '#/components/schemas/Dn'
+ $ref: 'comDefs.yaml#/components/schemas/Dn'
trendIndication:
$ref: '#/components/schemas/TrendIndication'
thresholdInfo:
$ref: '#/components/schemas/ThresholdInfo'
stateChangeDefinition:
- $ref: '#/components/schemas/AttributeValueChangeSet'
+ $ref: 'comDefs.yaml#/components/schemas/AttributeValueChangeSet'
monitoredAttributes:
- $ref: '#/components/schemas/AttributeNameValuePairSet'
+ $ref: 'comDefs.yaml#/components/schemas/AttributeNameValuePairSet'
proposedRepairActions:
type: string
additionalText:
type: string
additionalInformation:
- $ref: '#/components/schemas/AttributeNameValuePairSet'
+ $ref: 'comDefs.yaml#/components/schemas/AttributeNameValuePairSet'
rootCauseIndicator:
type: boolean
changedAlarmAttributes:
- $ref: '#/components/schemas/AttributeNameValuePairSet'
+ $ref: 'comDefs.yaml#/components/schemas/AttributeNameValuePairSet'
NotifyChangedSecAlarmGeneral:
allOf:
- - $ref: '#/components/schemas/NotificationHeader'
+ - $ref: 'comDefs.yaml#/components/schemas/NotificationHeader'
- type: object
required:
- alarmId
- alarmType
- - probableCause
- - perceivedSeverity
- serviceUser
- serviceProvider
- securityAlarmDetector
- - changedAlarmAttributes
properties:
alarmId:
$ref: '#/components/schemas/AlarmId'
additionalText:
type: string
additionalInformation:
- $ref: '#/components/schemas/AttributeNameValuePairSet'
+ $ref: 'comDefs.yaml#/components/schemas/AttributeNameValuePairSet'
rootCauseIndicator:
type: boolean
serviceUser:
securityAlarmDetector:
type: string
changedAlarmAttributes:
- $ref: '#/components/schemas/AttributeNameValuePairSet'
+ $ref: 'comDefs.yaml#/components/schemas/AttributeNameValuePairSet'
NotifyCorrelatedNotificationChanged:
allOf:
- - $ref: '#/components/schemas/NotificationHeader'
+ - $ref: 'comDefs.yaml#/components/schemas/NotificationHeader'
- type: object
required:
- alarmId
type: boolean
NotifyAckStateChanged:
allOf:
- - $ref: '#/components/schemas/NotificationHeader'
+ - $ref: 'comDefs.yaml#/components/schemas/NotificationHeader'
- type: object
required:
- alarmId
type: string
NotifyComments:
allOf:
- - $ref: '#/components/schemas/NotificationHeader'
+ - $ref: 'comDefs.yaml#/components/schemas/NotificationHeader'
- type: object
required:
- alarmId
$ref: '#/components/schemas/Comments'
NotifyPotentialFaultyAlarmList:
allOf:
- - $ref: '#/components/schemas/NotificationHeader'
+ - $ref: 'comDefs.yaml#/components/schemas/NotificationHeader'
- type: object
required:
- reason
type: string
NotifyAlarmListRebuilt:
allOf:
- - $ref: '#/components/schemas/NotificationHeader'
+ - $ref: 'comDefs.yaml#/components/schemas/NotificationHeader'
- type: object
required:
- reason
type: object
properties:
commentTime:
- $ref: '#/components/schemas/DateTime'
+ $ref: 'comDefs.yaml#/components/schemas/DateTime'
commentUserId:
type: string
commentSystemId:
type: object
properties:
consumerReference:
- $ref: '#/components/schemas/Uri'
+ $ref: 'comDefs.yaml#/components/schemas/Uri'
timeTick:
- $ref: '#/components/schemas/Long'
+ type: integer
filter:
- $ref: '#/components/schemas/Filter'
+ $ref: 'comDefs.yaml#/components/schemas/Filter'