Skip to content
SOL002-VNFFaultManagement-API.yaml 319 KiB
Newer Older
swagger: '2.0'
info:
  version: 1.1.1
  title: DRAFT - SOL002 - VNF Fault Management interface
  description: >
    DRAFT VNF Fault Management interface of ETSI NFV SOL002

    IMPORTANT: Please note that this file might be not aligned to the current
    version of the ETSI Group Specification it refers to. In case of
    discrepancies the published ETSI Group Specification takes precedence.


    Please report bugs to
    https://forge.etsi.org/bugzilla/buglist.cgi?component=Nfv-Openapis&list_id=61&product=NFV&resolution=---
  license:
    name: ETSI Forge copyright notice
    url: 'https://forge.etsi.org/etsi-forge-copyright-notice.txt'
externalDocs:
  description: ETSI GS NFV-SOL 002 V2.4.1
  url: >-
    http://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/002/02.04.01_60/gs_NFV-SOL002v020401p.pdf
basePath: /vnffm/v1
schemes:
  - http
  - https
consumes:
  - application/json
produces:
  - application/json
paths:
  /alarms:
    get:
      description: >
        The client can use this method to retrieve information about the alarm
        list.
      parameters:
        - name: Accept
          description: >
            Content-Types that are acceptable for the response. Reference: IETF
            RFC 7231
          in: header
          required: true
          type: string
        - name: Content-Type
          description: |
            The MIME type of the body of the request. Reference: IETF RFC 7231
          in: header
          required: true
          type: string
        - name: Authorization
          description: |
            The authorization token for the request. Reference: IETF RFC 7235
          in: header
          required: true
          type: string
      responses:
        '200':
          description: >
            The request has succeeded. The response body shall contain the list
            of related alarms.
          headers:
            Content-Type:
              description: >
                The MIME type of the body of the request. Reference: IETF RFC
                7231
              type: string
              maximum: 1
              minimum: 1
            WWW-Authenticate:
              description: >
                Challenge if the corresponding HTTP request has not provided
                authorization, or error details if the corresponding HTTP
                request has provided an invalid authorization token.
              type: string
              maximum: 1
              minimum: 0
          schema:
            description: |
              The alarm data type encapsulates information about an alarm.
            type: object
            required:
              - id
              - managedObjectId
              - rootCauseFaultyResource
              - alarmRaisedTime
              - ackState
              - perceivedSeverity
              - eventTime
              - eventType
              - probableCause
              - isRootCause
              - _links
            properties:
              id:
                description: |
                  An identifier with the intention of being globally unique.
                type: string
              managedObjectId:
                description: |
                  An identifier with the intention of being globally unique.
                type: string
              rootCauseFaultyResource:
                description: >
                  This type represents the faulty virtual resources that have a
                  negative impact on a VNF.
                type: object
                required:
                  - faultyResource
                  - faultyResourceType
                properties:
                  faultyResource:
                    required:
                      - vimConnectionId
                      - resourceId
                    type: object
                    description: >
                      This type represents the information that allows
                      addressing a virtualised resource that is used by a VNF
                      instance. Information about the resource is available from
                      the VIM.
                    properties:
                      vimConnectionId:
                        description: >
                          An identifier with the intention of being globally
                          unique.
                        type: string
                      resourceProviderId:
                        description: >
                          An identifier with the intention of being globally
                          unique.
                        type: string
                      resourceId:
                        description: >
                          An identifier maintained by the VIM or other resource
                          provider. It is expected to be unique within the VIM
                          instance.
                        type: string
                      vimLevelResourceType:
                        description: >
                          Type of the resource in the scope of the VIM or the
                          resource provider.
                        type: string
                  faultyResourceType:
                    description: >
                      The enumeration FaultyResourceType represents those types
                      of faulty resource.
                    type: string
                    enum:
                      - COMPUTE
                      - STORAGE
                      - NETWORK
              alarmRaisedTime:
                description: >
                  Date-time stamp.  Representation: String formatted according
                  to IETF RFC 3339.
                type: string
                format: date-time
              alarmChangedTime:
                description: >
                  Date-time stamp.  Representation: String formatted according
                  to IETF RFC 3339.
                type: string
                format: date-time
              alarmClearedTime:
                description: >
                  Date-time stamp.  Representation: String formatted according
                  to IETF RFC 3339.
                type: string
                format: date-time
              ackState:
                description: >
                  Acknowledgement state of the alarm.  Permitted values: *
                  UNACKNOWLEDGED * ACKNOWLEDGED.
                type: string
                enum:
                  - UNACKNOWLEDGED
                  - ACKNOWLEDGED
              perceivedSeverity:
                type: string
              eventTime:
                description: >
                  Date-time stamp.  Representation: String formatted according
                  to IETF RFC 3339.
                type: string
                format: date-time
              eventType:
                type: string
              faultType:
                description: |
                  Additional information to clarify the type of the fault.
                type: string
              probableCause:
                description: |
                  Information about the probable cause of the fault.
                type: string
              isRootCause:
                description: >
                  Attribute indicating if this fault is the root for other
                  correlated alarms. If TRUE, then the alarms listed in the
                  attribute CorrelatedAlarmId are caused by this fault.
Loading full blame...