swagger: '2.0'
info:
  version: 1.0.0
  title: SOL005 - NS Fault Management Interface
  description: >
    SOL005 - NS Fault Management Interface IMPORTANT: Please note that this file
    might be not aligned to the current version of the ETSI Group Specification
    it refers to and has not been approved by the ETSI NFV ISG. 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
  license:
    name: ETSI Forge copyright notice
    url: 'https://forge.etsi.org/etsi-forge-copyright-notice.txt'
  contact:
    name: NFV-SOL WG
externalDocs:
  description: ETSI GS NFV-SOL 005 V2.4.1
  url: >-
    http://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/005/02.04.01_60/gs_NFV-SOL005v020401p.pdf
basePath: /nsfm/v1
schemes:
  - https
consumes:
  - application/json
produces:
  - application/json
paths:
  /alarms:
    get:
      summary: Query alarms related to NS instances.
      description: >
        Get Alarm List.

        The client can use this method to retrieve information about the alarm
        list.
      parameters:
        - name: filter
          in: query
          required: false
          type: string
          description: >
            Attribute-based filtering parameters according to clause 4.3.2. The
            NFVO shall support receiving filtering parameters as part of the URI
            query string. The OSS/BSS may supply filtering parameters. The
            following attribute names shall be supported in attribute-based 
            filtering parameters: - id             - nsInstanceId             -
            rootCauseFaultyComponent.faultyNestedNsInstanceId             -
            rootCauseFaultyComponent.faultyNsVirtualLinkInstanceId             -
            rootCauseFaultyComponent.faultyVnfInstanceId            -
            rootCauseFaultyResource.faultyResourceType             -
            eventType             - perceivedSeverity - probableCause
        - name: Accept
          description: >
            Content-Types that are acceptable for the response. 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: false
          type: string
        - name: Version
          description: |
            Version of the API requested to use when responding to this request.
          in: header
          required: true
          type: string
      responses:
        '200':
          description: >
            200 OK

            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 response.
              type: string
              maximum: 1
              minimum: 1
            WWW-Authenticate:
              type: string
              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.
              maximum: 1
              minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              type: string
              maximum: 1
              minimum: 1
          schema:
            type: array
            items:
              properties:
                Alarm:
                  description: >
                    The alarm data type encapsulates information about an alarm.
                    It shall comply with the provisions defined in Table
                    8.5.2.4-1
                  type: object
                  required:
                    - id
                    - managedObjectId
                    - alarmRaisedTime
                    - rootCauseFaultyComponent
                    - 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
                    rootCauseFaultyComponent:
                      description: >
                        This type represents the faulty component that has a
                        negative impact on an NS.  It shall comply with the
                        provisions defined in Table 8.5.3.4-1.
                      type: object
                      properties:
                        faultyNestedNsInstanceId:
                          description: >
                            An identifier with the intention of being globally
                            unique.
                          type: string
                        faultyResourceType:
                          description: >
                            An identifier with the intention of being globally
                            unique.
                          type: string
                        faultyNsVirtualLinkInstanceId:
                          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 NS.
                      type: object
                      required:
                        - faultyResource
                        - faultyResourceType
                      properties:
                        faultyResource:
                          required:
                            - resourceId
                          type: object
                          description: >
                            This type represents the information that allows
                            addressing a virtualised resource that is used by a
                            VNF instance or by an NS instance. Information about
                            the resource is available from the VIM. The
                            ResourceHandle type shall comply with the provisions
                            defined in Table 6.5.3.54-1..
                          properties:
                            vimId:
                              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. Acceptable values are: -
                            COMPUTE - Virtual compute resource. - STORAGE -
                            Virtual storage resource. - NETWORK - Virtual
                            network 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: >
                        Acknowledgment state of the alarm. Permitted values:
                        UNACKNOWLEDGED ACKNOWLEDGED
                      type: string
                      enum:
                        - UNACKNOWLEDGED
                        - ACKNOWLEDGED
                    perceivedSeverity:
                      description: >
                        Indicates the relative level of urgency for operator
                        attention. * CRITICAL: The Critical severity level
                        indicates that a service
                          affecting condition has occurred and an immediate corrective action
                          is required. Such a severity can be reported, for example, when a
                          managed object becomes totally out of service and its capability needs
                          to be restored (ITU-T Recommendation X.733).
                        * MAJOR: The Major severity level indicates that a
                        service affecting
                          condition has developed and an urgent corrective action is required.
                          Such a severity can be reported, for example, when there is a severe
                          degradation in the capability of the managed object and its full
                          capability needs to be restored (ITU-T Recommendation X.733).
                        * MINOR: The Minor severity level indicates the
                        existence of a
                          non-service affecting fault condition and that corrective action
                          should be taken in order to prevent a more serious (for example,
                          service affecting) fault. Such a severity can be reported, for
                          example, when the detected alarm condition is not currently degrading
                          the capacity of the managed object (ITU-T Recommendation X.733).
                        * WARNING: The Warning severity level indicates the
                        detection of a
                          potential or impending service affecting fault, before any significant
                          effects have been felt. Action should be taken to further diagnose (if
                          necessary) and correct the problem in order to prevent it from
                          becoming a more serious service affecting fault (ITU-T Recommendation
                          X.733).
                        * INDETERMINATE: The Indeterminate severity level
                        indicates that the
                          severity level cannot be determined (ITU-T Recommendation X.733).
                        * CLEARED: The Cleared severity level indicates the
                        clearing of one or
                          more previously reported alarms. This alarm clears all alarms for this
                          managed object that have the same Alarm type, Probable cause and
                          Specific problems (if given) (ITU-T Recommendation X.733).
                      type: string
                      enum:
                        - CRITICAL
                        - MAJOR
                        - MINOR
                        - WARNING
                        - INDETERMINATE
                        - CLEARED
                    eventTime:
                      description: >
                        Date-time stamp. Representation: String formatted
                        according to IETF RFC 3339.
                      type: string
                      format: date-time
                    eventType:
                      description: >
                        The enumeration EventType represents those types of
                        events that trigger an alarm. - COMMUNICATIONS_ALARM: An
                        alarm of this type is associated with the
                          procedure and/or process required conveying information from one point
                          to another (ITU-T Recommendation X.733).
                        - PROCESSING_ERROR_ALARM: An alarm of this type is
                        associated with a
                          software or processing fault (ITU-T Recommendation X.733).
                        - ENVIRONMENTAL_ALARM: An alarm of this type is
                        associated with a
                          condition related to an enclosure in which the equipment resides
                          (ITU-T Recommendation X.733).
                        - QOS_ALARM: An alarm of this type is associated with
                        degradation in the
                          quality of a service (ITU-T Recommendation X.733).
                        - EQUIPMENT_ALARM: An alarm of this type is associated
                        with an equipment
                          fault (ITU-T Recommendation X.733).
                      type: string
                      enum:
                        - COMMUNICATIONS_ALARM
                        - PROCESSING_ERROR_ALARM
                        - ENVIRONMENTAL_ALARM
                        - QOS_ALARM
                        - EQUIPMENT_ALARM
                    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.
                      type: boolean
                    correlatedAlarmIds:
                      description: >
                        List of identifiers of other alarms correlated to this
                        fault.
                      type: array
                      items:
                        description: >
                          An identifier with the intention of being globally
                          unique.
                        type: string
                    faultDetails:
                      description: |
                        Provides additional information about the fault..
                      type: string
                    _links:
                      description: |
                        Links for this resource.
                      type: object
                      required:
                        - self
                      properties:
                        self:
                          description: |
                            This type represents a link to a resource.
                          type: object
                          required:
                            - href
                          properties:
                            href:
                              description: |
                                URI of the referenced resource.
                              type: string
                              format: url
        '400':
          description: >
            Bad Request

            Error: Invalid attribute-based filtering parameters. The response
            body shall contain a ProblemDetails structure, in which the "detail"
            attribute should convey more information about the error.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              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 definition of the general "ProblemDetails" data structure from
              IETF RFC 7807 [19] is reproduced in this structure. Compared to
              the general framework defined in IETF RFC 7807 [19], the "status"
              and "detail" attributes are mandated to be included by the present
              document, to ensure that the response contains additional textual
              information about an error. IETF RFC 7807 [19] foresees
              extensibility of the "ProblemDetails" type. It is possible that
              particular APIs in the present document, or particular
              implementations, define extensions to define additional attributes
              that provide more information about the error. The description
              column only provides some explanation of the meaning to Facilitate
              understanding of the design. For a full description, see IETF RFC
              7807 [19].
            type: object
            required:
              - statussss
              - detail
            properties:
              type:
                description: >
                  A URI reference according to IETF RFC 3986 [5] that identifies
                  the problem type. It is encouraged that the URI provides
                  human-readable documentation for the problem (e.g. using HTML)
                  when dereferenced. When this member is not present, its value
                  is assumed to be "about:blank".
                type: string
                format: URI
              title:
                description: >
                  A short, human-readable summary of the problem type. It should
                  not change from occurrence to occurrence of the problem,
                  except for purposes of localization. If type is given and
                  other than "about:blank", this attribute shall also be
                  provided. A short, human-readable summary of the problem
                  type.  It SHOULD NOT change from occurrence to occurrence of
                  the problem, except for purposes of localization (e.g., using
                  proactive content negotiation; see [RFC7231], Section 3.4).
                type: string
              status:
                description: >
                  The HTTP status code for this occurrence of the problem. The
                  HTTP status code ([RFC7231], Section 6) generated by the
                  origin server for this occurrence of the problem.
                type: integer
              detail:
                description: >
                  A human-readable explanation specific to this occurrence of
                  the problem.
                type: string
              instance:
                description: >
                  A URI reference that identifies the specific occurrence of the
                  problem. It may yield further information if dereferenced.
                type: string
                format: URI
        '401':
          description: >
            Unauthorized. If the request contains no access token even though
            one is required, or if the request contains an authorization token
            that is invalid (e.g. expired or revoked), the API producer should
            respond with this response. The details of the error shall be
            returned in the WWW-Authenticate HTTP header, as defined in IETF RFC
            6750 and IETF RFC 7235. The ProblemDetails structure may be
            provided.
          headers:
            Content-Type:
              type: string
              description: The MIME type of the body of the response.
            WWW-Authenticate:
              type: string
              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.
          schema:
            description: >
              The definition of the general "ProblemDetails" data structure from
              IETF RFC 7807 [19] is reproduced in this structure. Compared to
              the general framework defined in IETF RFC 7807 [19], the "status"
              and "detail" attributes are mandated to be included by the present
              document, to ensure that the response contains additional textual
              information about an error. IETF RFC 7807 [19] foresees
              extensibility of the "ProblemDetails" type. It is possible that
              particular APIs in the present document, or particular
              implementations, define extensions to define additional attributes
              that provide more information about the error. The description
              column only provides some explanation of the meaning to Facilitate
              understanding of the design. For a full description, see IETF RFC
              7807 [19].
            type: object
            required:
              - statussss
              - detail
            properties:
              type:
                description: >
                  A URI reference according to IETF RFC 3986 [5] that identifies
                  the problem type. It is encouraged that the URI provides
                  human-readable documentation for the problem (e.g. using HTML)
                  when dereferenced. When this member is not present, its value
                  is assumed to be "about:blank".
                type: string
                format: URI
              title:
                description: >
                  A short, human-readable summary of the problem type. It should
                  not change from occurrence to occurrence of the problem,
                  except for purposes of localization. If type is given and
                  other than "about:blank", this attribute shall also be
                  provided. A short, human-readable summary of the problem
                  type.  It SHOULD NOT change from occurrence to occurrence of
                  the problem, except for purposes of localization (e.g., using
                  proactive content negotiation; see [RFC7231], Section 3.4).
                type: string
              status:
                description: >
                  The HTTP status code for this occurrence of the problem. The
                  HTTP status code ([RFC7231], Section 6) generated by the
                  origin server for this occurrence of the problem.
                type: integer
              detail:
                description: >
                  A human-readable explanation specific to this occurrence of
                  the problem.
                type: string
              instance:
                description: >
                  A URI reference that identifies the specific occurrence of the
                  problem. It may yield further information if dereferenced.
                type: string
                format: URI
        '403':
          description: >
            Forbidden If the API consumer is not allowed to perform a particular
            request to a particular resource, the API producer shall respond
            with this response code. The "ProblemDetails" structure shall be
            provided. It should include in the "detail" attribute information
            about the source of the problem, and may indicate how to solve it.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              type: string
              maximum: 1
              minimum: 1
          schema:
            description: >
              The definition of the general "ProblemDetails" data structure from
              IETF RFC 7807 [19] is reproduced in this structure. Compared to
              the general framework defined in IETF RFC 7807 [19], the "status"
              and "detail" attributes are mandated to be included by the present
              document, to ensure that the response contains additional textual
              information about an error. IETF RFC 7807 [19] foresees
              extensibility of the "ProblemDetails" type. It is possible that
              particular APIs in the present document, or particular
              implementations, define extensions to define additional attributes
              that provide more information about the error. The description
              column only provides some explanation of the meaning to Facilitate
              understanding of the design. For a full description, see IETF RFC
              7807 [19].
            type: object
            required:
              - statussss
              - detail
            properties:
              type:
                description: >
                  A URI reference according to IETF RFC 3986 [5] that identifies
                  the problem type. It is encouraged that the URI provides
                  human-readable documentation for the problem (e.g. using HTML)
                  when dereferenced. When this member is not present, its value
                  is assumed to be "about:blank".
                type: string
                format: URI
              title:
                description: >
                  A short, human-readable summary of the problem type. It should
                  not change from occurrence to occurrence of the problem,
                  except for purposes of localization. If type is given and
                  other than "about:blank", this attribute shall also be
                  provided. A short, human-readable summary of the problem
                  type.  It SHOULD NOT change from occurrence to occurrence of
                  the problem, except for purposes of localization (e.g., using
                  proactive content negotiation; see [RFC7231], Section 3.4).
                type: string
              status:
                description: >
                  The HTTP status code for this occurrence of the problem. The
                  HTTP status code ([RFC7231], Section 6) generated by the
                  origin server for this occurrence of the problem.
                type: integer
              detail:
                description: >
                  A human-readable explanation specific to this occurrence of
                  the problem.
                type: string
              instance:
                description: >
                  A URI reference that identifies the specific occurrence of the
                  problem. It may yield further information if dereferenced.
                type: string
                format: URI
        '405':
          description: >
            Method Not Allowed If a particular HTTP method is not supported for
            a particular resource, the API producer shall respond with this
            response code. The "ProblemDetails" structure may be omitted in that
            case.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              type: string
              maximum: 1
              minimum: 1
          schema:
            description: >
              The definition of the general "ProblemDetails" data structure from
              IETF RFC 7807 [19] is reproduced in this structure. Compared to
              the general framework defined in IETF RFC 7807 [19], the "status"
              and "detail" attributes are mandated to be included by the present
              document, to ensure that the response contains additional textual
              information about an error. IETF RFC 7807 [19] foresees
              extensibility of the "ProblemDetails" type. It is possible that
              particular APIs in the present document, or particular
              implementations, define extensions to define additional attributes
              that provide more information about the error. The description
              column only provides some explanation of the meaning to Facilitate
              understanding of the design. For a full description, see IETF RFC
              7807 [19].
            type: object
            required:
              - statussss
              - detail
            properties:
              type:
                description: >
                  A URI reference according to IETF RFC 3986 [5] that identifies
                  the problem type. It is encouraged that the URI provides
                  human-readable documentation for the problem (e.g. using HTML)
                  when dereferenced. When this member is not present, its value
                  is assumed to be "about:blank".
                type: string
                format: URI
              title:
                description: >
                  A short, human-readable summary of the problem type. It should
                  not change from occurrence to occurrence of the problem,
                  except for purposes of localization. If type is given and
                  other than "about:blank", this attribute shall also be
                  provided. A short, human-readable summary of the problem
                  type.  It SHOULD NOT change from occurrence to occurrence of
                  the problem, except for purposes of localization (e.g., using
                  proactive content negotiation; see [RFC7231], Section 3.4).
                type: string
              status:
                description: >
                  The HTTP status code for this occurrence of the problem. The
                  HTTP status code ([RFC7231], Section 6) generated by the
                  origin server for this occurrence of the problem.
                type: integer
              detail:
                description: >
                  A human-readable explanation specific to this occurrence of
                  the problem.
                type: string
              instance:
                description: >
                  A URI reference that identifies the specific occurrence of the
                  problem. It may yield further information if dereferenced.
                type: string
                format: URI
        '406':
          description: >
            If the "Accept" header does not contain at least one name of a
            content type for which the NFVO can provide a representation of the
            NSD, the NFVO shall respond with this response code. The
            "ProblemDetails" structure may be included with the "detail"
            attribute providing more information about the error.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              type: string
              maximum: 1
              minimum: 1
          schema:
            description: >
              The definition of the general "ProblemDetails" data structure from
              IETF RFC 7807 [19] is reproduced in this structure. Compared to
              the general framework defined in IETF RFC 7807 [19], the "status"
              and "detail" attributes are mandated to be included by the present
              document, to ensure that the response contains additional textual
              information about an error. IETF RFC 7807 [19] foresees
              extensibility of the "ProblemDetails" type. It is possible that
              particular APIs in the present document, or particular
              implementations, define extensions to define additional attributes
              that provide more information about the error. The description
              column only provides some explanation of the meaning to Facilitate
              understanding of the design. For a full description, see IETF RFC
              7807 [19].
            type: object
            required:
              - statussss
              - detail
            properties:
              type:
                description: >
                  A URI reference according to IETF RFC 3986 [5] that identifies
                  the problem type. It is encouraged that the URI provides
                  human-readable documentation for the problem (e.g. using HTML)
                  when dereferenced. When this member is not present, its value
                  is assumed to be "about:blank".
                type: string
                format: URI
              title:
                description: >
                  A short, human-readable summary of the problem type. It should
                  not change from occurrence to occurrence of the problem,
                  except for purposes of localization. If type is given and
                  other than "about:blank", this attribute shall also be
                  provided. A short, human-readable summary of the problem
                  type.  It SHOULD NOT change from occurrence to occurrence of
                  the problem, except for purposes of localization (e.g., using
                  proactive content negotiation; see [RFC7231], Section 3.4).
                type: string
              status:
                description: >
                  The HTTP status code for this occurrence of the problem. The
                  HTTP status code ([RFC7231], Section 6) generated by the
                  origin server for this occurrence of the problem.
                type: integer
              detail:
                description: >
                  A human-readable explanation specific to this occurrence of
                  the problem.
                type: string
              instance:
                description: >
                  A URI reference that identifies the specific occurrence of the
                  problem. It may yield further information if dereferenced.
                type: string
                format: URI
        '500':
          description: >
            Internal Server Error If there is an application error not related
            to the client's input that cannot be easily mapped to any other HTTP
            response code ("catch all error"), the API producer shall respond
            withthis response code. The ProblemDetails structure shall be
            provided, and shall include in the "detail" attribute more
            information about the source of the problem.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              type: string
              maximum: 1
              minimum: 1
          schema:
            description: >
              The definition of the general "ProblemDetails" data structure from
              IETF RFC 7807 [19] is reproduced in this structure. Compared to
              the general framework defined in IETF RFC 7807 [19], the "status"
              and "detail" attributes are mandated to be included by the present
              document, to ensure that the response contains additional textual
              information about an error. IETF RFC 7807 [19] foresees
              extensibility of the "ProblemDetails" type. It is possible that
              particular APIs in the present document, or particular
              implementations, define extensions to define additional attributes
              that provide more information about the error. The description
              column only provides some explanation of the meaning to Facilitate
              understanding of the design. For a full description, see IETF RFC
              7807 [19].
            type: object
            required:
              - statussss
              - detail
            properties:
              type:
                description: >
                  A URI reference according to IETF RFC 3986 [5] that identifies
                  the problem type. It is encouraged that the URI provides
                  human-readable documentation for the problem (e.g. using HTML)
                  when dereferenced. When this member is not present, its value
                  is assumed to be "about:blank".
                type: string
                format: URI
              title:
                description: >
                  A short, human-readable summary of the problem type. It should
                  not change from occurrence to occurrence of the problem,
                  except for purposes of localization. If type is given and
                  other than "about:blank", this attribute shall also be
                  provided. A short, human-readable summary of the problem
                  type.  It SHOULD NOT change from occurrence to occurrence of
                  the problem, except for purposes of localization (e.g., using
                  proactive content negotiation; see [RFC7231], Section 3.4).
                type: string
              status:
                description: >
                  The HTTP status code for this occurrence of the problem. The
                  HTTP status code ([RFC7231], Section 6) generated by the
                  origin server for this occurrence of the problem.
                type: integer
              detail:
                description: >
                  A human-readable explanation specific to this occurrence of
                  the problem.
                type: string
              instance:
                description: >
                  A URI reference that identifies the specific occurrence of the
                  problem. It may yield further information if dereferenced.
                type: string
                format: URI
        '503':
          description: >
            Service Unavailable If the API producer encounters an internal
            overload situation of itself or of a system it relies on, it should
            respond with this response code, following the provisions in IETF
            RFC 7231 [13] for the use of the Retry-After HTTP header and for the
            alternative to refuse the connection. The "ProblemDetails" structure
            may be omitted.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              type: string
              maximum: 1
              minimum: 1
          schema:
            description: >
              The definition of the general "ProblemDetails" data structure from
              IETF RFC 7807 [19] is reproduced in this structure. Compared to
              the general framework defined in IETF RFC 7807 [19], the "status"
              and "detail" attributes are mandated to be included by the present
              document, to ensure that the response contains additional textual
              information about an error. IETF RFC 7807 [19] foresees
              extensibility of the "ProblemDetails" type. It is possible that
              particular APIs in the present document, or particular
              implementations, define extensions to define additional attributes
              that provide more information about the error. The description
              column only provides some explanation of the meaning to Facilitate
              understanding of the design. For a full description, see IETF RFC
              7807 [19].
            type: object
            required:
              - statussss
              - detail
            properties:
              type:
                description: >
                  A URI reference according to IETF RFC 3986 [5] that identifies
                  the problem type. It is encouraged that the URI provides
                  human-readable documentation for the problem (e.g. using HTML)
                  when dereferenced. When this member is not present, its value
                  is assumed to be "about:blank".
                type: string
                format: URI
              title:
                description: >
                  A short, human-readable summary of the problem type. It should
                  not change from occurrence to occurrence of the problem,
                  except for purposes of localization. If type is given and
                  other than "about:blank", this attribute shall also be
                  provided. A short, human-readable summary of the problem
                  type.  It SHOULD NOT change from occurrence to occurrence of
                  the problem, except for purposes of localization (e.g., using
                  proactive content negotiation; see [RFC7231], Section 3.4).
                type: string
              status:
                description: >
                  The HTTP status code for this occurrence of the problem. The
                  HTTP status code ([RFC7231], Section 6) generated by the
                  origin server for this occurrence of the problem.
                type: integer
              detail:
                description: >
                  A human-readable explanation specific to this occurrence of
                  the problem.
                type: string
              instance:
                description: >
                  A URI reference that identifies the specific occurrence of the
                  problem. It may yield further information if dereferenced.
                type: string
                format: URI
  '/alarms/{alarmId}':
    parameters:
      - name: alarmId
        description: >
          Identifier of the alarm. This identifier can be retrieved from the
          "id" attribute of the "alarm" attribute in the AlarmNotification or
          AlarmClearedNotification.  It can also be retrieved from the "id"
          attribute of the applicable array element in the payload body of the
          response to a GET request to the "Alarms" resource.
        in: path
        type: string
        required: true
    get:
      summary: Read individual alarm.
      description: |
        The client can use this method to read an individual alarm.
      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: false
          type: string
        - name: Version
          description: |
            Version of the API requested to use when responding to this request.
          in: header
          required: true
          type: string
      responses:
        '200':
          description: >
            200 OK

            Information about an individual alarm was read successfully. The
            response body shall contain a representation of the individual
            alarm.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              type: string
              maximum: 1
              minimum: 1
            WWW-Authenticate:
              type: string
              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.
              maximum: 1
              minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              type: string
              maximum: 1
              minimum: 1
          schema:
            properties:
              Alarm:
                description: >
                  The alarm data type encapsulates information about an alarm.
                  It shall comply with the provisions defined in Table 8.5.2.4-1
                type: object
                required:
                  - id
                  - managedObjectId
                  - alarmRaisedTime
                  - rootCauseFaultyComponent
                  - 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
                  rootCauseFaultyComponent:
                    description: >
                      This type represents the faulty component that has a
                      negative impact on an NS.  It shall comply with the
                      provisions defined in Table 8.5.3.4-1.
                    type: object
                    properties:
                      faultyNestedNsInstanceId:
                        description: >
                          An identifier with the intention of being globally
                          unique.
                        type: string
                      faultyResourceType:
                        description: >
                          An identifier with the intention of being globally
                          unique.
                        type: string
                      faultyNsVirtualLinkInstanceId:
                        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 NS.
                    type: object
                    required:
                      - faultyResource
                      - faultyResourceType
                    properties:
                      faultyResource:
                        required:
                          - resourceId
                        type: object
                        description: >
                          This type represents the information that allows
                          addressing a virtualised resource that is used by a
                          VNF instance or by an NS instance. Information about
                          the resource is available from the VIM. The
                          ResourceHandle type shall comply with the provisions
                          defined in Table 6.5.3.54-1..
                        properties:
                          vimId:
                            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. Acceptable values are: -
                          COMPUTE - Virtual compute resource. - STORAGE -
                          Virtual storage resource. - NETWORK - Virtual network
                          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: >
                      Acknowledgment state of the alarm. Permitted values:
                      UNACKNOWLEDGED ACKNOWLEDGED
                    type: string
                    enum:
                      - UNACKNOWLEDGED
                      - ACKNOWLEDGED
                  perceivedSeverity:
                    description: >
                      Indicates the relative level of urgency for operator
                      attention. * CRITICAL: The Critical severity level
                      indicates that a service
                        affecting condition has occurred and an immediate corrective action
                        is required. Such a severity can be reported, for example, when a
                        managed object becomes totally out of service and its capability needs
                        to be restored (ITU-T Recommendation X.733).
                      * MAJOR: The Major severity level indicates that a service
                      affecting
                        condition has developed and an urgent corrective action is required.
                        Such a severity can be reported, for example, when there is a severe
                        degradation in the capability of the managed object and its full
                        capability needs to be restored (ITU-T Recommendation X.733).
                      * MINOR: The Minor severity level indicates the existence
                      of a
                        non-service affecting fault condition and that corrective action
                        should be taken in order to prevent a more serious (for example,
                        service affecting) fault. Such a severity can be reported, for
                        example, when the detected alarm condition is not currently degrading
                        the capacity of the managed object (ITU-T Recommendation X.733).
                      * WARNING: The Warning severity level indicates the
                      detection of a
                        potential or impending service affecting fault, before any significant
                        effects have been felt. Action should be taken to further diagnose (if
                        necessary) and correct the problem in order to prevent it from
                        becoming a more serious service affecting fault (ITU-T Recommendation
                        X.733).
                      * INDETERMINATE: The Indeterminate severity level
                      indicates that the
                        severity level cannot be determined (ITU-T Recommendation X.733).
                      * CLEARED: The Cleared severity level indicates the
                      clearing of one or
                        more previously reported alarms. This alarm clears all alarms for this
                        managed object that have the same Alarm type, Probable cause and
                        Specific problems (if given) (ITU-T Recommendation X.733).
                    type: string
                    enum:
                      - CRITICAL
                      - MAJOR
                      - MINOR
                      - WARNING
                      - INDETERMINATE
                      - CLEARED
                  eventTime:
                    description: >
                      Date-time stamp. Representation: String formatted
                      according to IETF RFC 3339.
                    type: string
                    format: date-time
                  eventType:
                    description: >
                      The enumeration EventType represents those types of events
                      that trigger an alarm. - COMMUNICATIONS_ALARM: An alarm of
                      this type is associated with the
                        procedure and/or process required conveying information from one point
                        to another (ITU-T Recommendation X.733).
                      - PROCESSING_ERROR_ALARM: An alarm of this type is
                      associated with a
                        software or processing fault (ITU-T Recommendation X.733).
                      - ENVIRONMENTAL_ALARM: An alarm of this type is associated
                      with a
                        condition related to an enclosure in which the equipment resides
                        (ITU-T Recommendation X.733).
                      - QOS_ALARM: An alarm of this type is associated with
                      degradation in the
                        quality of a service (ITU-T Recommendation X.733).
                      - EQUIPMENT_ALARM: An alarm of this type is associated
                      with an equipment
                        fault (ITU-T Recommendation X.733).
                    type: string
                    enum:
                      - COMMUNICATIONS_ALARM
                      - PROCESSING_ERROR_ALARM
                      - ENVIRONMENTAL_ALARM
                      - QOS_ALARM
                      - EQUIPMENT_ALARM
                  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.
                    type: boolean
                  correlatedAlarmIds:
                    description: >
                      List of identifiers of other alarms correlated to this
                      fault.
                    type: array
                    items:
                      description: >
                        An identifier with the intention of being globally
                        unique.
                      type: string
                  faultDetails:
                    description: |
                      Provides additional information about the fault..
                    type: string
                  _links:
                    description: |
                      Links for this resource.
                    type: object
                    required:
                      - self
                    properties:
                      self:
                        description: |
                          This type represents a link to a resource.
                        type: object
                        required:
                          - href
                        properties:
                          href:
                            description: |
                              URI of the referenced resource.
                            type: string
                            format: url
        '400':
          description: >
            Bad Request

            Error: Invalid attribute-based filtering parameters. The response
            body shall contain a ProblemDetails structure, in which the "detail"
            attribute should convey more information about the error.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              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 definition of the general "ProblemDetails" data structure from
              IETF RFC 7807 [19] is reproduced in this structure. Compared to
              the general framework defined in IETF RFC 7807 [19], the "status"
              and "detail" attributes are mandated to be included by the present
              document, to ensure that the response contains additional textual
              information about an error. IETF RFC 7807 [19] foresees
              extensibility of the "ProblemDetails" type. It is possible that
              particular APIs in the present document, or particular
              implementations, define extensions to define additional attributes
              that provide more information about the error. The description
              column only provides some explanation of the meaning to Facilitate
              understanding of the design. For a full description, see IETF RFC
              7807 [19].
            type: object
            required:
              - statussss
              - detail
            properties:
              type:
                description: >
                  A URI reference according to IETF RFC 3986 [5] that identifies
                  the problem type. It is encouraged that the URI provides
                  human-readable documentation for the problem (e.g. using HTML)
                  when dereferenced. When this member is not present, its value
                  is assumed to be "about:blank".
                type: string
                format: URI
              title:
                description: >
                  A short, human-readable summary of the problem type. It should
                  not change from occurrence to occurrence of the problem,
                  except for purposes of localization. If type is given and
                  other than "about:blank", this attribute shall also be
                  provided. A short, human-readable summary of the problem
                  type.  It SHOULD NOT change from occurrence to occurrence of
                  the problem, except for purposes of localization (e.g., using
                  proactive content negotiation; see [RFC7231], Section 3.4).
                type: string
              status:
                description: >
                  The HTTP status code for this occurrence of the problem. The
                  HTTP status code ([RFC7231], Section 6) generated by the
                  origin server for this occurrence of the problem.
                type: integer
              detail:
                description: >
                  A human-readable explanation specific to this occurrence of
                  the problem.
                type: string
              instance:
                description: >
                  A URI reference that identifies the specific occurrence of the
                  problem. It may yield further information if dereferenced.
                type: string
                format: URI
        '401':
          description: >
            Unauthorized. If the request contains no access token even though
            one is required, or if the request contains an authorization token
            that is invalid (e.g. expired or revoked), the API producer should
            respond with this response. The details of the error shall be
            returned in the WWW-Authenticate HTTP header, as defined in IETF RFC
            6750 and IETF RFC 7235. The ProblemDetails structure may be
            provided.
          headers:
            Content-Type:
              type: string
              description: The MIME type of the body of the response.
            WWW-Authenticate:
              type: string
              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.
          schema:
            description: >
              The definition of the general "ProblemDetails" data structure from
              IETF RFC 7807 [19] is reproduced in this structure. Compared to
              the general framework defined in IETF RFC 7807 [19], the "status"
              and "detail" attributes are mandated to be included by the present
              document, to ensure that the response contains additional textual
              information about an error. IETF RFC 7807 [19] foresees
              extensibility of the "ProblemDetails" type. It is possible that
              particular APIs in the present document, or particular
              implementations, define extensions to define additional attributes
              that provide more information about the error. The description
              column only provides some explanation of the meaning to Facilitate
              understanding of the design. For a full description, see IETF RFC
              7807 [19].
            type: object
            required:
              - statussss
              - detail
            properties:
              type:
                description: >
                  A URI reference according to IETF RFC 3986 [5] that identifies
                  the problem type. It is encouraged that the URI provides
                  human-readable documentation for the problem (e.g. using HTML)
                  when dereferenced. When this member is not present, its value
                  is assumed to be "about:blank".
                type: string
                format: URI
              title:
                description: >
                  A short, human-readable summary of the problem type. It should
                  not change from occurrence to occurrence of the problem,
                  except for purposes of localization. If type is given and
                  other than "about:blank", this attribute shall also be
                  provided. A short, human-readable summary of the problem
                  type.  It SHOULD NOT change from occurrence to occurrence of
                  the problem, except for purposes of localization (e.g., using
                  proactive content negotiation; see [RFC7231], Section 3.4).
                type: string
              status:
                description: >
                  The HTTP status code for this occurrence of the problem. The
                  HTTP status code ([RFC7231], Section 6) generated by the
                  origin server for this occurrence of the problem.
                type: integer
              detail:
                description: >
                  A human-readable explanation specific to this occurrence of
                  the problem.
                type: string
              instance:
                description: >
                  A URI reference that identifies the specific occurrence of the
                  problem. It may yield further information if dereferenced.
                type: string
                format: URI
        '403':
          description: >
            Forbidden If the API consumer is not allowed to perform a particular
            request to a particular resource, the API producer shall respond
            with this response code. The "ProblemDetails" structure shall be
            provided. It should include in the "detail" attribute information
            about the source of the problem, and may indicate how to solve it.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              type: string
              maximum: 1
              minimum: 1
          schema:
            description: >
              The definition of the general "ProblemDetails" data structure from
              IETF RFC 7807 [19] is reproduced in this structure. Compared to
              the general framework defined in IETF RFC 7807 [19], the "status"
              and "detail" attributes are mandated to be included by the present
              document, to ensure that the response contains additional textual
              information about an error. IETF RFC 7807 [19] foresees
              extensibility of the "ProblemDetails" type. It is possible that
              particular APIs in the present document, or particular
              implementations, define extensions to define additional attributes
              that provide more information about the error. The description
              column only provides some explanation of the meaning to Facilitate
              understanding of the design. For a full description, see IETF RFC
              7807 [19].
            type: object
            required:
              - statussss
              - detail
            properties:
              type:
                description: >
                  A URI reference according to IETF RFC 3986 [5] that identifies
                  the problem type. It is encouraged that the URI provides
                  human-readable documentation for the problem (e.g. using HTML)
                  when dereferenced. When this member is not present, its value
                  is assumed to be "about:blank".
                type: string
                format: URI
              title:
                description: >
                  A short, human-readable summary of the problem type. It should
                  not change from occurrence to occurrence of the problem,
                  except for purposes of localization. If type is given and
                  other than "about:blank", this attribute shall also be
                  provided. A short, human-readable summary of the problem
                  type.  It SHOULD NOT change from occurrence to occurrence of
                  the problem, except for purposes of localization (e.g., using
                  proactive content negotiation; see [RFC7231], Section 3.4).
                type: string
              status:
                description: >
                  The HTTP status code for this occurrence of the problem. The
                  HTTP status code ([RFC7231], Section 6) generated by the
                  origin server for this occurrence of the problem.
                type: integer
              detail:
                description: >
                  A human-readable explanation specific to this occurrence of
                  the problem.
                type: string
              instance:
                description: >
                  A URI reference that identifies the specific occurrence of the
                  problem. It may yield further information if dereferenced.
                type: string
                format: URI
        '405':
          description: >
            Method Not Allowed If a particular HTTP method is not supported for
            a particular resource, the API producer shall respond with this
            response code. The "ProblemDetails" structure may be omitted in that
            case.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              type: string
              maximum: 1
              minimum: 1
          schema:
            description: >
              The definition of the general "ProblemDetails" data structure from
              IETF RFC 7807 [19] is reproduced in this structure. Compared to
              the general framework defined in IETF RFC 7807 [19], the "status"
              and "detail" attributes are mandated to be included by the present
              document, to ensure that the response contains additional textual
              information about an error. IETF RFC 7807 [19] foresees
              extensibility of the "ProblemDetails" type. It is possible that
              particular APIs in the present document, or particular
              implementations, define extensions to define additional attributes
              that provide more information about the error. The description
              column only provides some explanation of the meaning to Facilitate
              understanding of the design. For a full description, see IETF RFC
              7807 [19].
            type: object
            required:
              - statussss
              - detail
            properties:
              type:
                description: >
                  A URI reference according to IETF RFC 3986 [5] that identifies
                  the problem type. It is encouraged that the URI provides
                  human-readable documentation for the problem (e.g. using HTML)
                  when dereferenced. When this member is not present, its value
                  is assumed to be "about:blank".
                type: string
                format: URI
              title:
                description: >
                  A short, human-readable summary of the problem type. It should
                  not change from occurrence to occurrence of the problem,
                  except for purposes of localization. If type is given and
                  other than "about:blank", this attribute shall also be
                  provided. A short, human-readable summary of the problem
                  type.  It SHOULD NOT change from occurrence to occurrence of
                  the problem, except for purposes of localization (e.g., using
                  proactive content negotiation; see [RFC7231], Section 3.4).
                type: string
              status:
                description: >
                  The HTTP status code for this occurrence of the problem. The
                  HTTP status code ([RFC7231], Section 6) generated by the
                  origin server for this occurrence of the problem.
                type: integer
              detail:
                description: >
                  A human-readable explanation specific to this occurrence of
                  the problem.
                type: string
              instance:
                description: >
                  A URI reference that identifies the specific occurrence of the
                  problem. It may yield further information if dereferenced.
                type: string
                format: URI
        '406':
          description: >
            If the "Accept" header does not contain at least one name of a
            content type for which the NFVO can provide a representation of the
            NSD, the NFVO shall respond with this response code. The
            "ProblemDetails" structure may be included with the "detail"
            attribute providing more information about the error.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              type: string
              maximum: 1
              minimum: 1
          schema:
            description: >
              The definition of the general "ProblemDetails" data structure from
              IETF RFC 7807 [19] is reproduced in this structure. Compared to
              the general framework defined in IETF RFC 7807 [19], the "status"
              and "detail" attributes are mandated to be included by the present
              document, to ensure that the response contains additional textual
              information about an error. IETF RFC 7807 [19] foresees
              extensibility of the "ProblemDetails" type. It is possible that
              particular APIs in the present document, or particular
              implementations, define extensions to define additional attributes
              that provide more information about the error. The description
              column only provides some explanation of the meaning to Facilitate
              understanding of the design. For a full description, see IETF RFC
              7807 [19].
            type: object
            required:
              - statussss
              - detail
            properties:
              type:
                description: >
                  A URI reference according to IETF RFC 3986 [5] that identifies
                  the problem type. It is encouraged that the URI provides
                  human-readable documentation for the problem (e.g. using HTML)
                  when dereferenced. When this member is not present, its value
                  is assumed to be "about:blank".
                type: string
                format: URI
              title:
                description: >
                  A short, human-readable summary of the problem type. It should
                  not change from occurrence to occurrence of the problem,
                  except for purposes of localization. If type is given and
                  other than "about:blank", this attribute shall also be
                  provided. A short, human-readable summary of the problem
                  type.  It SHOULD NOT change from occurrence to occurrence of
                  the problem, except for purposes of localization (e.g., using
                  proactive content negotiation; see [RFC7231], Section 3.4).
                type: string
              status:
                description: >
                  The HTTP status code for this occurrence of the problem. The
                  HTTP status code ([RFC7231], Section 6) generated by the
                  origin server for this occurrence of the problem.
                type: integer
              detail:
                description: >
                  A human-readable explanation specific to this occurrence of
                  the problem.
                type: string
              instance:
                description: >
                  A URI reference that identifies the specific occurrence of the
                  problem. It may yield further information if dereferenced.
                type: string
                format: URI
        '500':
          description: >
            Internal Server Error If there is an application error not related
            to the client's input that cannot be easily mapped to any other HTTP
            response code ("catch all error"), the API producer shall respond
            withthis response code. The ProblemDetails structure shall be
            provided, and shall include in the "detail" attribute more
            information about the source of the problem.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              type: string
              maximum: 1
              minimum: 1
          schema:
            description: >
              The definition of the general "ProblemDetails" data structure from
              IETF RFC 7807 [19] is reproduced in this structure. Compared to
              the general framework defined in IETF RFC 7807 [19], the "status"
              and "detail" attributes are mandated to be included by the present
              document, to ensure that the response contains additional textual
              information about an error. IETF RFC 7807 [19] foresees
              extensibility of the "ProblemDetails" type. It is possible that
              particular APIs in the present document, or particular
              implementations, define extensions to define additional attributes
              that provide more information about the error. The description
              column only provides some explanation of the meaning to Facilitate
              understanding of the design. For a full description, see IETF RFC
              7807 [19].
            type: object
            required:
              - statussss
              - detail
            properties:
              type:
                description: >
                  A URI reference according to IETF RFC 3986 [5] that identifies
                  the problem type. It is encouraged that the URI provides
                  human-readable documentation for the problem (e.g. using HTML)
                  when dereferenced. When this member is not present, its value
                  is assumed to be "about:blank".
                type: string
                format: URI
              title:
                description: >
                  A short, human-readable summary of the problem type. It should
                  not change from occurrence to occurrence of the problem,
                  except for purposes of localization. If type is given and
                  other than "about:blank", this attribute shall also be
                  provided. A short, human-readable summary of the problem
                  type.  It SHOULD NOT change from occurrence to occurrence of
                  the problem, except for purposes of localization (e.g., using
                  proactive content negotiation; see [RFC7231], Section 3.4).
                type: string
              status:
                description: >
                  The HTTP status code for this occurrence of the problem. The
                  HTTP status code ([RFC7231], Section 6) generated by the
                  origin server for this occurrence of the problem.
                type: integer
              detail:
                description: >
                  A human-readable explanation specific to this occurrence of
                  the problem.
                type: string
              instance:
                description: >
                  A URI reference that identifies the specific occurrence of the
                  problem. It may yield further information if dereferenced.
                type: string
                format: URI
        '503':
          description: >
            Service Unavailable If the API producer encounters an internal
            overload situation of itself or of a system it relies on, it should
            respond with this response code, following the provisions in IETF
            RFC 7231 [13] for the use of the Retry-After HTTP header and for the
            alternative to refuse the connection. The "ProblemDetails" structure
            may be omitted.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              type: string
              maximum: 1
              minimum: 1
          schema:
            description: >
              The definition of the general "ProblemDetails" data structure from
              IETF RFC 7807 [19] is reproduced in this structure. Compared to
              the general framework defined in IETF RFC 7807 [19], the "status"
              and "detail" attributes are mandated to be included by the present
              document, to ensure that the response contains additional textual
              information about an error. IETF RFC 7807 [19] foresees
              extensibility of the "ProblemDetails" type. It is possible that
              particular APIs in the present document, or particular
              implementations, define extensions to define additional attributes
              that provide more information about the error. The description
              column only provides some explanation of the meaning to Facilitate
              understanding of the design. For a full description, see IETF RFC
              7807 [19].
            type: object
            required:
              - statussss
              - detail
            properties:
              type:
                description: >
                  A URI reference according to IETF RFC 3986 [5] that identifies
                  the problem type. It is encouraged that the URI provides
                  human-readable documentation for the problem (e.g. using HTML)
                  when dereferenced. When this member is not present, its value
                  is assumed to be "about:blank".
                type: string
                format: URI
              title:
                description: >
                  A short, human-readable summary of the problem type. It should
                  not change from occurrence to occurrence of the problem,
                  except for purposes of localization. If type is given and
                  other than "about:blank", this attribute shall also be
                  provided. A short, human-readable summary of the problem
                  type.  It SHOULD NOT change from occurrence to occurrence of
                  the problem, except for purposes of localization (e.g., using
                  proactive content negotiation; see [RFC7231], Section 3.4).
                type: string
              status:
                description: >
                  The HTTP status code for this occurrence of the problem. The
                  HTTP status code ([RFC7231], Section 6) generated by the
                  origin server for this occurrence of the problem.
                type: integer
              detail:
                description: >
                  A human-readable explanation specific to this occurrence of
                  the problem.
                type: string
              instance:
                description: >
                  A URI reference that identifies the specific occurrence of the
                  problem. It may yield further information if dereferenced.
                type: string
                format: URI
    patch:
      summary: Acknowledge individual alarm.
      description: |
        Acknowledge Alarm
        This method modifies an individual alarm resource.
      parameters:
        - name: body
          in: body
          required: true
          schema:
            type: object
            required:
              - AlarmModifications
            properties:
              AlarmModifications:
                description: >
                  This type represents attribute modifications for an
                  "Individual alarm" resource, i.e. modifications to a resource
                  representation based on the "Alarm" data type. The attributes
                  of "Alarm" that can be modified according to the provisions in
                  clause 8.5.2.4 are included in the "AlarmModifications" data
                  type. The "AlarmModifications" data type shall comply with the
                  provisions defined in Table 8.5.2.8-1.
                type: object
                required:
                  - ackState
                properties:
                  ackState:
                    description: >
                      New value of the "ackState" attribute in "Alarm".
                      Permitted values: - ACKNOWLEDGED
                    type: string
                    enum:
                      - ACKNOWLEDGED
            description: >
              The parameter for the alarm modification, as defined in clause
              8.5.2.8.
        - name: Accept
          description: >
            Content-Types that are acceptable for the response. 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: false
          type: string
        - name: Content-Type
          description: >
            The Content-Type header shall be set to
            "application/merge-patch+json" according to IETF RFC 7396.
          in: header
          required: true
          type: string
          enum:
            - application/merge-patch+json
        - name: Version
          description: |
            Version of the API requested to use when responding to this request.
          in: header
          required: true
          type: string
      responses:
        '200':
          description: >
            200 OK

            The request was accepted and completed. The response body shall
            contain attribute modifications for an 'Individual alarm' resource
            (see clause 8.5.2.4).
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              type: string
              maximum: 1
              minimum: 1
            WWW-Authenticate:
              type: string
              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.
              maximum: 1
              minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              type: string
              maximum: 1
              minimum: 1
          schema:
            properties:
              AlarmModifications:
                description: >
                  This type represents attribute modifications for an
                  "Individual alarm" resource, i.e. modifications to a resource
                  representation based on the "Alarm" data type. The attributes
                  of "Alarm" that can be modified according to the provisions in
                  clause 8.5.2.4 are included in the "AlarmModifications" data
                  type. The "AlarmModifications" data type shall comply with the
                  provisions defined in Table 8.5.2.8-1.
                type: object
                required:
                  - ackState
                properties:
                  ackState:
                    description: >
                      New value of the "ackState" attribute in "Alarm".
                      Permitted values: - ACKNOWLEDGED
                    type: string
                    enum:
                      - ACKNOWLEDGED
        '400':
          description: >
            Bad Request

            Error: Invalid attribute-based filtering parameters. The response
            body shall contain a ProblemDetails structure, in which the "detail"
            attribute should convey more information about the error.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              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 definition of the general "ProblemDetails" data structure from
              IETF RFC 7807 [19] is reproduced in this structure. Compared to
              the general framework defined in IETF RFC 7807 [19], the "status"
              and "detail" attributes are mandated to be included by the present
              document, to ensure that the response contains additional textual
              information about an error. IETF RFC 7807 [19] foresees
              extensibility of the "ProblemDetails" type. It is possible that
              particular APIs in the present document, or particular
              implementations, define extensions to define additional attributes
              that provide more information about the error. The description
              column only provides some explanation of the meaning to Facilitate
              understanding of the design. For a full description, see IETF RFC
              7807 [19].
            type: object
            required:
              - statussss
              - detail
            properties:
              type:
                description: >
                  A URI reference according to IETF RFC 3986 [5] that identifies
                  the problem type. It is encouraged that the URI provides
                  human-readable documentation for the problem (e.g. using HTML)
                  when dereferenced. When this member is not present, its value
                  is assumed to be "about:blank".
                type: string
                format: URI
              title:
                description: >
                  A short, human-readable summary of the problem type. It should
                  not change from occurrence to occurrence of the problem,
                  except for purposes of localization. If type is given and
                  other than "about:blank", this attribute shall also be
                  provided. A short, human-readable summary of the problem
                  type.  It SHOULD NOT change from occurrence to occurrence of
                  the problem, except for purposes of localization (e.g., using
                  proactive content negotiation; see [RFC7231], Section 3.4).
                type: string
              status:
                description: >
                  The HTTP status code for this occurrence of the problem. The
                  HTTP status code ([RFC7231], Section 6) generated by the
                  origin server for this occurrence of the problem.
                type: integer
              detail:
                description: >
                  A human-readable explanation specific to this occurrence of
                  the problem.
                type: string
              instance:
                description: >
                  A URI reference that identifies the specific occurrence of the
                  problem. It may yield further information if dereferenced.
                type: string
                format: URI
        '401':
          description: >
            Unauthorized. If the request contains no access token even though
            one is required, or if the request contains an authorization token
            that is invalid (e.g. expired or revoked), the API producer should
            respond with this response. The details of the error shall be
            returned in the WWW-Authenticate HTTP header, as defined in IETF RFC
            6750 and IETF RFC 7235. The ProblemDetails structure may be
            provided.
          headers:
            Content-Type:
              type: string
              description: The MIME type of the body of the response.
            WWW-Authenticate:
              type: string
              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.
          schema:
            description: >
              The definition of the general "ProblemDetails" data structure from
              IETF RFC 7807 [19] is reproduced in this structure. Compared to
              the general framework defined in IETF RFC 7807 [19], the "status"
              and "detail" attributes are mandated to be included by the present
              document, to ensure that the response contains additional textual
              information about an error. IETF RFC 7807 [19] foresees
              extensibility of the "ProblemDetails" type. It is possible that
              particular APIs in the present document, or particular
              implementations, define extensions to define additional attributes
              that provide more information about the error. The description
              column only provides some explanation of the meaning to Facilitate
              understanding of the design. For a full description, see IETF RFC
              7807 [19].
            type: object
            required:
              - statussss
              - detail
            properties:
              type:
                description: >
                  A URI reference according to IETF RFC 3986 [5] that identifies
                  the problem type. It is encouraged that the URI provides
                  human-readable documentation for the problem (e.g. using HTML)
                  when dereferenced. When this member is not present, its value
                  is assumed to be "about:blank".
                type: string
                format: URI
              title:
                description: >
                  A short, human-readable summary of the problem type. It should
                  not change from occurrence to occurrence of the problem,
                  except for purposes of localization. If type is given and
                  other than "about:blank", this attribute shall also be
                  provided. A short, human-readable summary of the problem
                  type.  It SHOULD NOT change from occurrence to occurrence of
                  the problem, except for purposes of localization (e.g., using
                  proactive content negotiation; see [RFC7231], Section 3.4).
                type: string
              status:
                description: >
                  The HTTP status code for this occurrence of the problem. The
                  HTTP status code ([RFC7231], Section 6) generated by the
                  origin server for this occurrence of the problem.
                type: integer
              detail:
                description: >
                  A human-readable explanation specific to this occurrence of
                  the problem.
                type: string
              instance:
                description: >
                  A URI reference that identifies the specific occurrence of the
                  problem. It may yield further information if dereferenced.
                type: string
                format: URI
        '403':
          description: >
            Forbidden If the API consumer is not allowed to perform a particular
            request to a particular resource, the API producer shall respond
            with this response code. The "ProblemDetails" structure shall be
            provided. It should include in the "detail" attribute information
            about the source of the problem, and may indicate how to solve it.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              type: string
              maximum: 1
              minimum: 1
          schema:
            description: >
              The definition of the general "ProblemDetails" data structure from
              IETF RFC 7807 [19] is reproduced in this structure. Compared to
              the general framework defined in IETF RFC 7807 [19], the "status"
              and "detail" attributes are mandated to be included by the present
              document, to ensure that the response contains additional textual
              information about an error. IETF RFC 7807 [19] foresees
              extensibility of the "ProblemDetails" type. It is possible that
              particular APIs in the present document, or particular
              implementations, define extensions to define additional attributes
              that provide more information about the error. The description
              column only provides some explanation of the meaning to Facilitate
              understanding of the design. For a full description, see IETF RFC
              7807 [19].
            type: object
            required:
              - statussss
              - detail
            properties:
              type:
                description: >
                  A URI reference according to IETF RFC 3986 [5] that identifies
                  the problem type. It is encouraged that the URI provides
                  human-readable documentation for the problem (e.g. using HTML)
                  when dereferenced. When this member is not present, its value
                  is assumed to be "about:blank".
                type: string
                format: URI
              title:
                description: >
                  A short, human-readable summary of the problem type. It should
                  not change from occurrence to occurrence of the problem,
                  except for purposes of localization. If type is given and
                  other than "about:blank", this attribute shall also be
                  provided. A short, human-readable summary of the problem
                  type.  It SHOULD NOT change from occurrence to occurrence of
                  the problem, except for purposes of localization (e.g., using
                  proactive content negotiation; see [RFC7231], Section 3.4).
                type: string
              status:
                description: >
                  The HTTP status code for this occurrence of the problem. The
                  HTTP status code ([RFC7231], Section 6) generated by the
                  origin server for this occurrence of the problem.
                type: integer
              detail:
                description: >
                  A human-readable explanation specific to this occurrence of
                  the problem.
                type: string
              instance:
                description: >
                  A URI reference that identifies the specific occurrence of the
                  problem. It may yield further information if dereferenced.
                type: string
                format: URI
        '405':
          description: >
            Method Not Allowed If a particular HTTP method is not supported for
            a particular resource, the API producer shall respond with this
            response code. The "ProblemDetails" structure may be omitted in that
            case.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              type: string
              maximum: 1
              minimum: 1
          schema:
            description: >
              The definition of the general "ProblemDetails" data structure from
              IETF RFC 7807 [19] is reproduced in this structure. Compared to
              the general framework defined in IETF RFC 7807 [19], the "status"
              and "detail" attributes are mandated to be included by the present
              document, to ensure that the response contains additional textual
              information about an error. IETF RFC 7807 [19] foresees
              extensibility of the "ProblemDetails" type. It is possible that
              particular APIs in the present document, or particular
              implementations, define extensions to define additional attributes
              that provide more information about the error. The description
              column only provides some explanation of the meaning to Facilitate
              understanding of the design. For a full description, see IETF RFC
              7807 [19].
            type: object
            required:
              - statussss
              - detail
            properties:
              type:
                description: >
                  A URI reference according to IETF RFC 3986 [5] that identifies
                  the problem type. It is encouraged that the URI provides
                  human-readable documentation for the problem (e.g. using HTML)
                  when dereferenced. When this member is not present, its value
                  is assumed to be "about:blank".
                type: string
                format: URI
              title:
                description: >
                  A short, human-readable summary of the problem type. It should
                  not change from occurrence to occurrence of the problem,
                  except for purposes of localization. If type is given and
                  other than "about:blank", this attribute shall also be
                  provided. A short, human-readable summary of the problem
                  type.  It SHOULD NOT change from occurrence to occurrence of
                  the problem, except for purposes of localization (e.g., using
                  proactive content negotiation; see [RFC7231], Section 3.4).
                type: string
              status:
                description: >
                  The HTTP status code for this occurrence of the problem. The
                  HTTP status code ([RFC7231], Section 6) generated by the
                  origin server for this occurrence of the problem.
                type: integer
              detail:
                description: >
                  A human-readable explanation specific to this occurrence of
                  the problem.
                type: string
              instance:
                description: >
                  A URI reference that identifies the specific occurrence of the
                  problem. It may yield further information if dereferenced.
                type: string
                format: URI
        '406':
          description: >
            If the "Accept" header does not contain at least one name of a
            content type for which the NFVO can provide a representation of the
            NSD, the NFVO shall respond with this response code. The
            "ProblemDetails" structure may be included with the "detail"
            attribute providing more information about the error.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              type: string
              maximum: 1
              minimum: 1
          schema:
            description: >
              The definition of the general "ProblemDetails" data structure from
              IETF RFC 7807 [19] is reproduced in this structure. Compared to
              the general framework defined in IETF RFC 7807 [19], the "status"
              and "detail" attributes are mandated to be included by the present
              document, to ensure that the response contains additional textual
              information about an error. IETF RFC 7807 [19] foresees
              extensibility of the "ProblemDetails" type. It is possible that
              particular APIs in the present document, or particular
              implementations, define extensions to define additional attributes
              that provide more information about the error. The description
              column only provides some explanation of the meaning to Facilitate
              understanding of the design. For a full description, see IETF RFC
              7807 [19].
            type: object
            required:
              - statussss
              - detail
            properties:
              type:
                description: >
                  A URI reference according to IETF RFC 3986 [5] that identifies
                  the problem type. It is encouraged that the URI provides
                  human-readable documentation for the problem (e.g. using HTML)
                  when dereferenced. When this member is not present, its value
                  is assumed to be "about:blank".
                type: string
                format: URI
              title:
                description: >
                  A short, human-readable summary of the problem type. It should
                  not change from occurrence to occurrence of the problem,
                  except for purposes of localization. If type is given and
                  other than "about:blank", this attribute shall also be
                  provided. A short, human-readable summary of the problem
                  type.  It SHOULD NOT change from occurrence to occurrence of
                  the problem, except for purposes of localization (e.g., using
                  proactive content negotiation; see [RFC7231], Section 3.4).
                type: string
              status:
                description: >
                  The HTTP status code for this occurrence of the problem. The
                  HTTP status code ([RFC7231], Section 6) generated by the
                  origin server for this occurrence of the problem.
                type: integer
              detail:
                description: >
                  A human-readable explanation specific to this occurrence of
                  the problem.
                type: string
              instance:
                description: >
                  A URI reference that identifies the specific occurrence of the
                  problem. It may yield further information if dereferenced.
                type: string
                format: URI
        '409':
          description: >
            Conflict

            Error: The operation cannot be executed currently, due to a conflict
            with the state of the "Individual alarm" resource. Typically, this
            is due to the fact that the alarm is already in the state that is
            requested to be set (such as trying to acknowledge an
            already-acknowledged alarm). The response body shall contain a
            ProblemDetails structure, in which the "detail" attribute shall
            convey more information about the error.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              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 definition of the general "ProblemDetails" data structure from
              IETF RFC 7807 [19] is reproduced in this structure. Compared to
              the general framework defined in IETF RFC 7807 [19], the "status"
              and "detail" attributes are mandated to be included by the present
              document, to ensure that the response contains additional textual
              information about an error. IETF RFC 7807 [19] foresees
              extensibility of the "ProblemDetails" type. It is possible that
              particular APIs in the present document, or particular
              implementations, define extensions to define additional attributes
              that provide more information about the error. The description
              column only provides some explanation of the meaning to Facilitate
              understanding of the design. For a full description, see IETF RFC
              7807 [19].
            type: object
            required:
              - statussss
              - detail
            properties:
              type:
                description: >
                  A URI reference according to IETF RFC 3986 [5] that identifies
                  the problem type. It is encouraged that the URI provides
                  human-readable documentation for the problem (e.g. using HTML)
                  when dereferenced. When this member is not present, its value
                  is assumed to be "about:blank".
                type: string
                format: URI
              title:
                description: >
                  A short, human-readable summary of the problem type. It should
                  not change from occurrence to occurrence of the problem,
                  except for purposes of localization. If type is given and
                  other than "about:blank", this attribute shall also be
                  provided. A short, human-readable summary of the problem
                  type.  It SHOULD NOT change from occurrence to occurrence of
                  the problem, except for purposes of localization (e.g., using
                  proactive content negotiation; see [RFC7231], Section 3.4).
                type: string
              status:
                description: >
                  The HTTP status code for this occurrence of the problem. The
                  HTTP status code ([RFC7231], Section 6) generated by the
                  origin server for this occurrence of the problem.
                type: integer
              detail:
                description: >
                  A human-readable explanation specific to this occurrence of
                  the problem.
                type: string
              instance:
                description: >
                  A URI reference that identifies the specific occurrence of the
                  problem. It may yield further information if dereferenced.
                type: string
                format: URI
        '412':
          description: >
            Precondition Failed.

            Error: A precondition given in an HTTP request header is not
            fulfilled. Typically, this is due to an ETag mismatch, indicating
            that the resource was modified by another entity. The response body
            should contain a ProblemDetails structure, in which the "detail"
            attribute should convey more information about the error.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              type: string
              maximum: 1
              minimum: 1
          schema:
            description: >
              The definition of the general "ProblemDetails" data structure from
              IETF RFC 7807 [19] is reproduced in this structure. Compared to
              the general framework defined in IETF RFC 7807 [19], the "status"
              and "detail" attributes are mandated to be included by the present
              document, to ensure that the response contains additional textual
              information about an error. IETF RFC 7807 [19] foresees
              extensibility of the "ProblemDetails" type. It is possible that
              particular APIs in the present document, or particular
              implementations, define extensions to define additional attributes
              that provide more information about the error. The description
              column only provides some explanation of the meaning to Facilitate
              understanding of the design. For a full description, see IETF RFC
              7807 [19].
            type: object
            required:
              - statussss
              - detail
            properties:
              type:
                description: >
                  A URI reference according to IETF RFC 3986 [5] that identifies
                  the problem type. It is encouraged that the URI provides
                  human-readable documentation for the problem (e.g. using HTML)
                  when dereferenced. When this member is not present, its value
                  is assumed to be "about:blank".
                type: string
                format: URI
              title:
                description: >
                  A short, human-readable summary of the problem type. It should
                  not change from occurrence to occurrence of the problem,
                  except for purposes of localization. If type is given and
                  other than "about:blank", this attribute shall also be
                  provided. A short, human-readable summary of the problem
                  type.  It SHOULD NOT change from occurrence to occurrence of
                  the problem, except for purposes of localization (e.g., using
                  proactive content negotiation; see [RFC7231], Section 3.4).
                type: string
              status:
                description: >
                  The HTTP status code for this occurrence of the problem. The
                  HTTP status code ([RFC7231], Section 6) generated by the
                  origin server for this occurrence of the problem.
                type: integer
              detail:
                description: >
                  A human-readable explanation specific to this occurrence of
                  the problem.
                type: string
              instance:
                description: >
                  A URI reference that identifies the specific occurrence of the
                  problem. It may yield further information if dereferenced.
                type: string
                format: URI
        '500':
          description: >
            Internal Server Error If there is an application error not related
            to the client's input that cannot be easily mapped to any other HTTP
            response code ("catch all error"), the API producer shall respond
            withthis response code. The ProblemDetails structure shall be
            provided, and shall include in the "detail" attribute more
            information about the source of the problem.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              type: string
              maximum: 1
              minimum: 1
          schema:
            description: >
              The definition of the general "ProblemDetails" data structure from
              IETF RFC 7807 [19] is reproduced in this structure. Compared to
              the general framework defined in IETF RFC 7807 [19], the "status"
              and "detail" attributes are mandated to be included by the present
              document, to ensure that the response contains additional textual
              information about an error. IETF RFC 7807 [19] foresees
              extensibility of the "ProblemDetails" type. It is possible that
              particular APIs in the present document, or particular
              implementations, define extensions to define additional attributes
              that provide more information about the error. The description
              column only provides some explanation of the meaning to Facilitate
              understanding of the design. For a full description, see IETF RFC
              7807 [19].
            type: object
            required:
              - statussss
              - detail
            properties:
              type:
                description: >
                  A URI reference according to IETF RFC 3986 [5] that identifies
                  the problem type. It is encouraged that the URI provides
                  human-readable documentation for the problem (e.g. using HTML)
                  when dereferenced. When this member is not present, its value
                  is assumed to be "about:blank".
                type: string
                format: URI
              title:
                description: >
                  A short, human-readable summary of the problem type. It should
                  not change from occurrence to occurrence of the problem,
                  except for purposes of localization. If type is given and
                  other than "about:blank", this attribute shall also be
                  provided. A short, human-readable summary of the problem
                  type.  It SHOULD NOT change from occurrence to occurrence of
                  the problem, except for purposes of localization (e.g., using
                  proactive content negotiation; see [RFC7231], Section 3.4).
                type: string
              status:
                description: >
                  The HTTP status code for this occurrence of the problem. The
                  HTTP status code ([RFC7231], Section 6) generated by the
                  origin server for this occurrence of the problem.
                type: integer
              detail:
                description: >
                  A human-readable explanation specific to this occurrence of
                  the problem.
                type: string
              instance:
                description: >
                  A URI reference that identifies the specific occurrence of the
                  problem. It may yield further information if dereferenced.
                type: string
                format: URI
        '503':
          description: >
            Service Unavailable If the API producer encounters an internal
            overload situation of itself or of a system it relies on, it should
            respond with this response code, following the provisions in IETF
            RFC 7231 [13] for the use of the Retry-After HTTP header and for the
            alternative to refuse the connection. The "ProblemDetails" structure
            may be omitted.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              type: string
              maximum: 1
              minimum: 1
          schema:
            description: >
              The definition of the general "ProblemDetails" data structure from
              IETF RFC 7807 [19] is reproduced in this structure. Compared to
              the general framework defined in IETF RFC 7807 [19], the "status"
              and "detail" attributes are mandated to be included by the present
              document, to ensure that the response contains additional textual
              information about an error. IETF RFC 7807 [19] foresees
              extensibility of the "ProblemDetails" type. It is possible that
              particular APIs in the present document, or particular
              implementations, define extensions to define additional attributes
              that provide more information about the error. The description
              column only provides some explanation of the meaning to Facilitate
              understanding of the design. For a full description, see IETF RFC
              7807 [19].
            type: object
            required:
              - statussss
              - detail
            properties:
              type:
                description: >
                  A URI reference according to IETF RFC 3986 [5] that identifies
                  the problem type. It is encouraged that the URI provides
                  human-readable documentation for the problem (e.g. using HTML)
                  when dereferenced. When this member is not present, its value
                  is assumed to be "about:blank".
                type: string
                format: URI
              title:
                description: >
                  A short, human-readable summary of the problem type. It should
                  not change from occurrence to occurrence of the problem,
                  except for purposes of localization. If type is given and
                  other than "about:blank", this attribute shall also be
                  provided. A short, human-readable summary of the problem
                  type.  It SHOULD NOT change from occurrence to occurrence of
                  the problem, except for purposes of localization (e.g., using
                  proactive content negotiation; see [RFC7231], Section 3.4).
                type: string
              status:
                description: >
                  The HTTP status code for this occurrence of the problem. The
                  HTTP status code ([RFC7231], Section 6) generated by the
                  origin server for this occurrence of the problem.
                type: integer
              detail:
                description: >
                  A human-readable explanation specific to this occurrence of
                  the problem.
                type: string
              instance:
                description: >
                  A URI reference that identifies the specific occurrence of the
                  problem. It may yield further information if dereferenced.
                type: string
                format: URI
  /subscriptions:
    post:
      summary: Subscribe to alarms related to NSs.
      description: >
        The POST method creates a new subscription. This method shall follow the
        provisions specified in the Tables 8.4.4.3.1-1 and 8.4.4.3.1-2 for URI
        query parameters, request and response data structures, and response
        codes. Creation of two subscription resources with the same callbackURI
        and the same filter can result in performance degradation and will
        provide duplicates of notifications to the OSS, and might make sense
        only in very rare use cases. Consequently, the NFVO may either allow
        creating a subscription resource if another subscription resource with
        the same filter and callbackUri already exists (in which case it shall
        return the "201 Created" response code), or may decide to not create a
        duplicate subscription resource (in which case it shall return a "303
        See Other" response code referencing the existing subscription resource
        with the same filter and callbackUri).
      parameters:
        - name: Accept
          description: >
            Content-Types that are acceptable for the response. 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: false
          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: Version
          description: |
            Version of the API requested to use when responding to this request.
          in: header
          required: true
          type: string
        - name: body
          in: body
          required: true
          schema:
            type: object
            required:
              - FmSubscriptionRequest
            properties:
              FmSubscriptionRequest:
                description: >
                  This type represents a subscription request related to
                  notifications about VNF faults.
                type: object
                required:
                  - callbackUri
                properties:
                  filter:
                    description: >
                      This type represents a subscription filter related to
                      notifications about NS faults.  It shall comply with the
                      provisions defined in Table 8.5.3.2-1. At a particular
                      nesting level in the filter structure, the following
                      applies:  All attributes shall match in order for the
                      filter to match (logical "and" between different filter
                      attributes).  If an attribute is an array, the attribute
                      shall match if at least one of the values in the array
                      matches (logical "or" between the values of one filter
                      attribute)..
                    type: object
                    properties:
                      nsInstanceSubscriptionFilter:
                        required:
                          - nsdIds
                          - vnfdIds
                          - pnfdIds
                          - nsInstanceIds
                        type: object
                        description: >
                          This type represents subscription filter criteria to
                          match NS instances. It shall comply with the
                          provisions defined in Table 4.4.1.5-1.
                        properties:
                          nsdIds:
                            description: >
                              If present, match NS instances that were created
                              based on a NSD identified by one of the nsdId
                              values listed in this attribute.
                            type: array
                            items:
                              description: >
                                An identifier with the intention of being
                                globally unique.
                              type: string
                          vnfdIds:
                            description: >
                              If present, match NS instances that contain VNF
                              instances that were created based on a VNFD
                              identified by one of the vnfdId values listed in
                              this attribute.
                            type: array
                            items:
                              description: >
                                An identifier with the intention of being
                                globally unique.
                              type: string
                          pnfdIds:
                            description: >
                              If present, match NS instances that contain PNFs
                              that are represented by a PNFD identified by one
                              of the pnfdId values listed in this attribute.
                            type: array
                            items:
                              description: >
                                An identifier with the intention of being
                                globally unique.
                              type: string
                          nsInstanceIds:
                            description: >
                              If present, match NS instances with an instance
                              dentifier listed in this attribute.
                            type: array
                            items:
                              description: >
                                An identifier with the intention of being
                                globally unique.
                              type: string
                          nsInstanceNames:
                            description: >
                              If present, match NS instances with a NS Instance
                              Name listed in this attribute.
                            type: array
                            items:
                              description: |
                                This type represents stack of string values
                              type: string
                      notificationTypes:
                        description: >
                          Match particular notification types. Permitted values:
                          - AlarmNotification - AlarmClearedNotification -
                          AlarmListRebuiltNotification.
                        type: array
                        items:
                          type: string
                          enum:
                            - AlarmNotification
                            - AlarmClearedNotification
                            - AlarmListRebuiltNotification
                      faultyResourceTypes:
                        description: >
                          Match alarms related to NSs with a faulty resource
                          type listed in this attribute.
                        type: array
                        items:
                          description: >
                            The enumeration FaultyResourceType represents those
                            types of faulty resource. Acceptable values are: -
                            COMPUTE - Virtual compute resource. - STORAGE -
                            Virtual storage resource. - NETWORK - Virtual
                            network resource.
                          type: string
                          enum:
                            - COMPUTE
                            - STORAGE
                            - NETWORK
                      perceivedSeverities:
                        description: >
                          Match VNF alarms with a perceived severity listed in
                          this attribute.
                        type: array
                        items:
                          description: >
                            Indicates the relative level of urgency for operator
                            attention. * CRITICAL: The Critical severity level
                            indicates that a service
                              affecting condition has occurred and an immediate corrective action
                              is required. Such a severity can be reported, for example, when a
                              managed object becomes totally out of service and its capability needs
                              to be restored (ITU-T Recommendation X.733).
                            * MAJOR: The Major severity level indicates that a
                            service affecting
                              condition has developed and an urgent corrective action is required.
                              Such a severity can be reported, for example, when there is a severe
                              degradation in the capability of the managed object and its full
                              capability needs to be restored (ITU-T Recommendation X.733).
                            * MINOR: The Minor severity level indicates the
                            existence of a
                              non-service affecting fault condition and that corrective action
                              should be taken in order to prevent a more serious (for example,
                              service affecting) fault. Such a severity can be reported, for
                              example, when the detected alarm condition is not currently degrading
                              the capacity of the managed object (ITU-T Recommendation X.733).
                            * WARNING: The Warning severity level indicates the
                            detection of a
                              potential or impending service affecting fault, before any significant
                              effects have been felt. Action should be taken to further diagnose (if
                              necessary) and correct the problem in order to prevent it from
                              becoming a more serious service affecting fault (ITU-T Recommendation
                              X.733).
                            * INDETERMINATE: The Indeterminate severity level
                            indicates that the
                              severity level cannot be determined (ITU-T Recommendation X.733).
                            * CLEARED: The Cleared severity level indicates the
                            clearing of one or
                              more previously reported alarms. This alarm clears all alarms for this
                              managed object that have the same Alarm type, Probable cause and
                              Specific problems (if given) (ITU-T Recommendation X.733).
                          type: string
                          enum:
                            - CRITICAL
                            - MAJOR
                            - MINOR
                            - WARNING
                            - INDETERMINATE
                            - CLEARED
                      eventTypes:
                        description: >
                          Match VNF alarms with an event type listed in this
                          attribute.
                        type: array
                        items:
                          description: >
                            The enumeration EventType represents those types of
                            events that trigger an alarm. -
                            COMMUNICATIONS_ALARM: An alarm of this type is
                            associated with the
                              procedure and/or process required conveying information from one point
                              to another (ITU-T Recommendation X.733).
                            - PROCESSING_ERROR_ALARM: An alarm of this type is
                            associated with a
                              software or processing fault (ITU-T Recommendation X.733).
                            - ENVIRONMENTAL_ALARM: An alarm of this type is
                            associated with a
                              condition related to an enclosure in which the equipment resides
                              (ITU-T Recommendation X.733).
                            - QOS_ALARM: An alarm of this type is associated
                            with degradation in the
                              quality of a service (ITU-T Recommendation X.733).
                            - EQUIPMENT_ALARM: An alarm of this type is
                            associated with an equipment
                              fault (ITU-T Recommendation X.733).
                          type: string
                          enum:
                            - COMMUNICATIONS_ALARM
                            - PROCESSING_ERROR_ALARM
                            - ENVIRONMENTAL_ALARM
                            - QOS_ALARM
                            - EQUIPMENT_ALARM
                      probableCauses:
                        description: >
                          Match VNF alarms with a probable cause listed in this
                          attribute.
                        type: array
                        items:
                          type: string
                  callbackUri:
                    description: |
                      The URI of the endpoint to send the notification to.
                    type: string
                    format: url
                  authentication:
                    description: >
                      Authentication parameters to conFigure the use of
                      Authorization when sendingnotifications corresponding to
                      this subscription, as defined in clause 4.5.3.4. This
                      attribute shall only be present if the subscriber requires
                      authorization of notifications.
                    type: object
                    required:
                      - authType
                    properties:
                      authType:
                        description: >
                          Defines the types of Authentication / Authorization
                          which the API consumer is willing to accept when
                          receiving a notification. Permitted values: * BASIC:
                          In every HTTP request to the notification endpoint,
                          use
                            HTTP Basic authentication with the client credentials.
                          * OAUTH2_CLIENT_CREDENTIALS: In every HTTP request to
                          the
                            notification endpoint, use an OAuth 2.0 Bearer token, obtained
                            using the client credentials grant type.
                          * TLS_CERT: Every HTTP request to the notification
                          endpoint is sent
                            over a mutually authenticated TLS session, i.e. not only the
                            server is authenticated, but also the client is authenticated
                            during the TLS tunnel setup.
                        type: array
                        items:
                          type: string
                          enum:
                            - BASIC
                            - OAUTH2_CLIENT_CREDENTIALS
                            - TLS_CERT
                      paramsBasic:
                        description: >
                          Parameters for authentication/authorization using
                          BASIC. Shall be present if authType is "BASIC" and the
                          contained information has not been provisioned out of
                          band. Shall be absent otherwise.
                        type: object
                        properties:
                          userName:
                            description: >
                              Username to be used in HTTP Basic authentication.
                              Shall be present if it has not been provisioned
                              out of band.
                            type: string
                          password:
                            description: >
                              Password to be used in HTTP Basic authentication.
                              Shall be present if it has not been provisioned
                              out of band.
                            type: string
                      paramsOauth2ClientCredentials:
                        description: >
                          Parameters for authentication/authorization using
                          OAUTH2_CLIENT_CREDENTIALS. Shall be present if
                          authType is "OAUTH2_CLIENT_CREDENTIALS" and the
                          contained information has not been provisioned out of
                          band. Shall be absent otherwise.
                        type: object
                        properties:
                          clientId:
                            description: >
                              Client identifier to be used in the access token
                              request of the OAuth 2.0 client credentials grant
                              type. Shall be present if it has not been
                              provisioned out of band. The clientId and
                              clientPassword passed in a subscription shall not
                              be the same as the clientId and clientPassword
                              that are used to obtain authorization for API
                              requests. Client credentials may differ between
                              subscriptions. The value of clientPassword should
                              be generated by a random process.
                            type: string
                          clientPassword:
                            description: >
                              Client password to be used in the access token
                              request of the OAuth 2.0 client credentials grant
                              type. Shall be present if it has not been
                              provisioned out of band. The clientId and
                              clientPassword passed in a subscription shall not
                              be the same as the clientId and clientPassword
                              that are used to obtain authorization for API
                              requests. Client credentials may differ between
                              subscriptions. The value of clientPassword should
                              be generated by a random process.
                            type: string
                          tokenEndpoint:
                            description: |
                              String formatted according to IETF RFC 3986.
                            type: string
            description: >
              Details of the subscription to be created, as defined in clause
              8.5.2.2.
      responses:
        '201':
          description: >
            201 Created

            The subscription was created successfully. The response body shall
            contain a representation of the created subscription resource. The
            HTTP response shall include a "Location:" HTTP header that points to
            the created subscription resource.              
          schema:
            type: object
            properties:
              FmSubscription:
                description: >
                  This type represents a subscription related to notifications
                  about VNF faults.
                type: object
                required:
                  - id
                  - callbackUri
                  - _links
                properties:
                  id:
                    description: |
                      An identifier with the intention of being globally unique.
                    type: string
                  filter:
                    description: >
                      This type represents a subscription filter related to
                      notifications about NS faults.  It shall comply with the
                      provisions defined in Table 8.5.3.2-1. At a particular
                      nesting level in the filter structure, the following
                      applies:  All attributes shall match in order for the
                      filter to match (logical "and" between different filter
                      attributes).  If an attribute is an array, the attribute
                      shall match if at least one of the values in the array
                      matches (logical "or" between the values of one filter
                      attribute)..
                    type: object
                    properties:
                      nsInstanceSubscriptionFilter:
                        required:
                          - nsdIds
                          - vnfdIds
                          - pnfdIds
                          - nsInstanceIds
                        type: object
                        description: >
                          This type represents subscription filter criteria to
                          match NS instances. It shall comply with the
                          provisions defined in Table 4.4.1.5-1.
                        properties:
                          nsdIds:
                            description: >
                              If present, match NS instances that were created
                              based on a NSD identified by one of the nsdId
                              values listed in this attribute.
                            type: array
                            items:
                              description: >
                                An identifier with the intention of being
                                globally unique.
                              type: string
                          vnfdIds:
                            description: >
                              If present, match NS instances that contain VNF
                              instances that were created based on a VNFD
                              identified by one of the vnfdId values listed in
                              this attribute.
                            type: array
                            items:
                              description: >
                                An identifier with the intention of being
                                globally unique.
                              type: string
                          pnfdIds:
                            description: >
                              If present, match NS instances that contain PNFs
                              that are represented by a PNFD identified by one
                              of the pnfdId values listed in this attribute.
                            type: array
                            items:
                              description: >
                                An identifier with the intention of being
                                globally unique.
                              type: string
                          nsInstanceIds:
                            description: >
                              If present, match NS instances with an instance
                              dentifier listed in this attribute.
                            type: array
                            items:
                              description: >
                                An identifier with the intention of being
                                globally unique.
                              type: string
                          nsInstanceNames:
                            description: >
                              If present, match NS instances with a NS Instance
                              Name listed in this attribute.
                            type: array
                            items:
                              description: |
                                This type represents stack of string values
                              type: string
                      notificationTypes:
                        description: >
                          Match particular notification types. Permitted values:
                          - AlarmNotification - AlarmClearedNotification -
                          AlarmListRebuiltNotification.
                        type: array
                        items:
                          type: string
                          enum:
                            - AlarmNotification
                            - AlarmClearedNotification
                            - AlarmListRebuiltNotification
                      faultyResourceTypes:
                        description: >
                          Match alarms related to NSs with a faulty resource
                          type listed in this attribute.
                        type: array
                        items:
                          description: >
                            The enumeration FaultyResourceType represents those
                            types of faulty resource. Acceptable values are: -
                            COMPUTE - Virtual compute resource. - STORAGE -
                            Virtual storage resource. - NETWORK - Virtual
                            network resource.
                          type: string
                          enum:
                            - COMPUTE
                            - STORAGE
                            - NETWORK
                      perceivedSeverities:
                        description: >
                          Match VNF alarms with a perceived severity listed in
                          this attribute.
                        type: array
                        items:
                          description: >
                            Indicates the relative level of urgency for operator
                            attention. * CRITICAL: The Critical severity level
                            indicates that a service
                              affecting condition has occurred and an immediate corrective action
                              is required. Such a severity can be reported, for example, when a
                              managed object becomes totally out of service and its capability needs
                              to be restored (ITU-T Recommendation X.733).
                            * MAJOR: The Major severity level indicates that a
                            service affecting
                              condition has developed and an urgent corrective action is required.
                              Such a severity can be reported, for example, when there is a severe
                              degradation in the capability of the managed object and its full
                              capability needs to be restored (ITU-T Recommendation X.733).
                            * MINOR: The Minor severity level indicates the
                            existence of a
                              non-service affecting fault condition and that corrective action
                              should be taken in order to prevent a more serious (for example,
                              service affecting) fault. Such a severity can be reported, for
                              example, when the detected alarm condition is not currently degrading
                              the capacity of the managed object (ITU-T Recommendation X.733).
                            * WARNING: The Warning severity level indicates the
                            detection of a
                              potential or impending service affecting fault, before any significant
                              effects have been felt. Action should be taken to further diagnose (if
                              necessary) and correct the problem in order to prevent it from
                              becoming a more serious service affecting fault (ITU-T Recommendation
                              X.733).
                            * INDETERMINATE: The Indeterminate severity level
                            indicates that the
                              severity level cannot be determined (ITU-T Recommendation X.733).
                            * CLEARED: The Cleared severity level indicates the
                            clearing of one or
                              more previously reported alarms. This alarm clears all alarms for this
                              managed object that have the same Alarm type, Probable cause and
                              Specific problems (if given) (ITU-T Recommendation X.733).
                          type: string
                          enum:
                            - CRITICAL
                            - MAJOR
                            - MINOR
                            - WARNING
                            - INDETERMINATE
                            - CLEARED
                      eventTypes:
                        description: >
                          Match VNF alarms with an event type listed in this
                          attribute.
                        type: array
                        items:
                          description: >
                            The enumeration EventType represents those types of
                            events that trigger an alarm. -
                            COMMUNICATIONS_ALARM: An alarm of this type is
                            associated with the
                              procedure and/or process required conveying information from one point
                              to another (ITU-T Recommendation X.733).
                            - PROCESSING_ERROR_ALARM: An alarm of this type is
                            associated with a
                              software or processing fault (ITU-T Recommendation X.733).
                            - ENVIRONMENTAL_ALARM: An alarm of this type is
                            associated with a
                              condition related to an enclosure in which the equipment resides
                              (ITU-T Recommendation X.733).
                            - QOS_ALARM: An alarm of this type is associated
                            with degradation in the
                              quality of a service (ITU-T Recommendation X.733).
                            - EQUIPMENT_ALARM: An alarm of this type is
                            associated with an equipment
                              fault (ITU-T Recommendation X.733).
                          type: string
                          enum:
                            - COMMUNICATIONS_ALARM
                            - PROCESSING_ERROR_ALARM
                            - ENVIRONMENTAL_ALARM
                            - QOS_ALARM
                            - EQUIPMENT_ALARM
                      probableCauses:
                        description: >
                          Match VNF alarms with a probable cause listed in this
                          attribute.
                        type: array
                        items:
                          type: string
                  callbackUri:
                    description: |
                      The URI of the endpoint to send the notification to.
                    type: string
                    format: url
                  _links:
                    description: |
                      Links for this resource.
                    type: object
                    required:
                      - self
                    properties:
                      self:
                        description: |
                          This type represents a link to a resource.
                        type: object
                        required:
                          - href
                        properties:
                          href:
                            description: |
                              URI of the referenced resource.
                            type: string
                            format: url
          headers:
            Content-Type:
              type: string
              description: >
                The MIME type of the body of the response.This header field
                shall be present if the response has a non-empty message body.
            WWW-Authenticate:
              type: string
              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.
              maximum: 1
              minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              type: string
              maximum: 1
              minimum: 1
        '303':
          description: >
            See Other

            A subscription with the same callbackURI and the same filter already
            exits and the policy of the NFVO is to not create redundant
            subscriptions. The HTTP response shall include a "Location" HTTP
            eader that contains the resource URI of the existing subscription
            resource. The response body shall be empty.
        '400':
          description: >
            Bad Request

            Error: Invalid attribute-based filtering parameters. The response
            body shall contain a ProblemDetails structure, in which the "detail"
            attribute should convey more information about the error.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              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 definition of the general "ProblemDetails" data structure from
              IETF RFC 7807 [19] is reproduced in this structure. Compared to
              the general framework defined in IETF RFC 7807 [19], the "status"
              and "detail" attributes are mandated to be included by the present
              document, to ensure that the response contains additional textual
              information about an error. IETF RFC 7807 [19] foresees
              extensibility of the "ProblemDetails" type. It is possible that
              particular APIs in the present document, or particular
              implementations, define extensions to define additional attributes
              that provide more information about the error. The description
              column only provides some explanation of the meaning to Facilitate
              understanding of the design. For a full description, see IETF RFC
              7807 [19].
            type: object
            required:
              - statussss
              - detail
            properties:
              type:
                description: >
                  A URI reference according to IETF RFC 3986 [5] that identifies
                  the problem type. It is encouraged that the URI provides
                  human-readable documentation for the problem (e.g. using HTML)
                  when dereferenced. When this member is not present, its value
                  is assumed to be "about:blank".
                type: string
                format: URI
              title:
                description: >
                  A short, human-readable summary of the problem type. It should
                  not change from occurrence to occurrence of the problem,
                  except for purposes of localization. If type is given and
                  other than "about:blank", this attribute shall also be
                  provided. A short, human-readable summary of the problem
                  type.  It SHOULD NOT change from occurrence to occurrence of
                  the problem, except for purposes of localization (e.g., using
                  proactive content negotiation; see [RFC7231], Section 3.4).
                type: string
              status:
                description: >
                  The HTTP status code for this occurrence of the problem. The
                  HTTP status code ([RFC7231], Section 6) generated by the
                  origin server for this occurrence of the problem.
                type: integer
              detail:
                description: >
                  A human-readable explanation specific to this occurrence of
                  the problem.
                type: string
              instance:
                description: >
                  A URI reference that identifies the specific occurrence of the
                  problem. It may yield further information if dereferenced.
                type: string
                format: URI
        '401':
          description: >
            Unauthorized. If the request contains no access token even though
            one is required, or if the request contains an authorization token
            that is invalid (e.g. expired or revoked), the API producer should
            respond with this response. The details of the error shall be
            returned in the WWW-Authenticate HTTP header, as defined in IETF RFC
            6750 and IETF RFC 7235. The ProblemDetails structure may be
            provided.
          headers:
            Content-Type:
              type: string
              description: The MIME type of the body of the response.
            WWW-Authenticate:
              type: string
              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.
          schema:
            description: >
              The definition of the general "ProblemDetails" data structure from
              IETF RFC 7807 [19] is reproduced in this structure. Compared to
              the general framework defined in IETF RFC 7807 [19], the "status"
              and "detail" attributes are mandated to be included by the present
              document, to ensure that the response contains additional textual
              information about an error. IETF RFC 7807 [19] foresees
              extensibility of the "ProblemDetails" type. It is possible that
              particular APIs in the present document, or particular
              implementations, define extensions to define additional attributes
              that provide more information about the error. The description
              column only provides some explanation of the meaning to Facilitate
              understanding of the design. For a full description, see IETF RFC
              7807 [19].
            type: object
            required:
              - statussss
              - detail
            properties:
              type:
                description: >
                  A URI reference according to IETF RFC 3986 [5] that identifies
                  the problem type. It is encouraged that the URI provides
                  human-readable documentation for the problem (e.g. using HTML)
                  when dereferenced. When this member is not present, its value
                  is assumed to be "about:blank".
                type: string
                format: URI
              title:
                description: >
                  A short, human-readable summary of the problem type. It should
                  not change from occurrence to occurrence of the problem,
                  except for purposes of localization. If type is given and
                  other than "about:blank", this attribute shall also be
                  provided. A short, human-readable summary of the problem
                  type.  It SHOULD NOT change from occurrence to occurrence of
                  the problem, except for purposes of localization (e.g., using
                  proactive content negotiation; see [RFC7231], Section 3.4).
                type: string
              status:
                description: >
                  The HTTP status code for this occurrence of the problem. The
                  HTTP status code ([RFC7231], Section 6) generated by the
                  origin server for this occurrence of the problem.
                type: integer
              detail:
                description: >
                  A human-readable explanation specific to this occurrence of
                  the problem.
                type: string
              instance:
                description: >
                  A URI reference that identifies the specific occurrence of the
                  problem. It may yield further information if dereferenced.
                type: string
                format: URI
        '403':
          description: >
            Forbidden If the API consumer is not allowed to perform a particular
            request to a particular resource, the API producer shall respond
            with this response code. The "ProblemDetails" structure shall be
            provided. It should include in the "detail" attribute information
            about the source of the problem, and may indicate how to solve it.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              type: string
              maximum: 1
              minimum: 1
          schema:
            description: >
              The definition of the general "ProblemDetails" data structure from
              IETF RFC 7807 [19] is reproduced in this structure. Compared to
              the general framework defined in IETF RFC 7807 [19], the "status"
              and "detail" attributes are mandated to be included by the present
              document, to ensure that the response contains additional textual
              information about an error. IETF RFC 7807 [19] foresees
              extensibility of the "ProblemDetails" type. It is possible that
              particular APIs in the present document, or particular
              implementations, define extensions to define additional attributes
              that provide more information about the error. The description
              column only provides some explanation of the meaning to Facilitate
              understanding of the design. For a full description, see IETF RFC
              7807 [19].
            type: object
            required:
              - statussss
              - detail
            properties:
              type:
                description: >
                  A URI reference according to IETF RFC 3986 [5] that identifies
                  the problem type. It is encouraged that the URI provides
                  human-readable documentation for the problem (e.g. using HTML)
                  when dereferenced. When this member is not present, its value
                  is assumed to be "about:blank".
                type: string
                format: URI
              title:
                description: >
                  A short, human-readable summary of the problem type. It should
                  not change from occurrence to occurrence of the problem,
                  except for purposes of localization. If type is given and
                  other than "about:blank", this attribute shall also be
                  provided. A short, human-readable summary of the problem
                  type.  It SHOULD NOT change from occurrence to occurrence of
                  the problem, except for purposes of localization (e.g., using
                  proactive content negotiation; see [RFC7231], Section 3.4).
                type: string
              status:
                description: >
                  The HTTP status code for this occurrence of the problem. The
                  HTTP status code ([RFC7231], Section 6) generated by the
                  origin server for this occurrence of the problem.
                type: integer
              detail:
                description: >
                  A human-readable explanation specific to this occurrence of
                  the problem.
                type: string
              instance:
                description: >
                  A URI reference that identifies the specific occurrence of the
                  problem. It may yield further information if dereferenced.
                type: string
                format: URI
        '405':
          description: >
            Method Not Allowed If a particular HTTP method is not supported for
            a particular resource, the API producer shall respond with this
            response code. The "ProblemDetails" structure may be omitted in that
            case.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              type: string
              maximum: 1
              minimum: 1
          schema:
            description: >
              The definition of the general "ProblemDetails" data structure from
              IETF RFC 7807 [19] is reproduced in this structure. Compared to
              the general framework defined in IETF RFC 7807 [19], the "status"
              and "detail" attributes are mandated to be included by the present
              document, to ensure that the response contains additional textual
              information about an error. IETF RFC 7807 [19] foresees
              extensibility of the "ProblemDetails" type. It is possible that
              particular APIs in the present document, or particular
              implementations, define extensions to define additional attributes
              that provide more information about the error. The description
              column only provides some explanation of the meaning to Facilitate
              understanding of the design. For a full description, see IETF RFC
              7807 [19].
            type: object
            required:
              - statussss
              - detail
            properties:
              type:
                description: >
                  A URI reference according to IETF RFC 3986 [5] that identifies
                  the problem type. It is encouraged that the URI provides
                  human-readable documentation for the problem (e.g. using HTML)
                  when dereferenced. When this member is not present, its value
                  is assumed to be "about:blank".
                type: string
                format: URI
              title:
                description: >
                  A short, human-readable summary of the problem type. It should
                  not change from occurrence to occurrence of the problem,
                  except for purposes of localization. If type is given and
                  other than "about:blank", this attribute shall also be
                  provided. A short, human-readable summary of the problem
                  type.  It SHOULD NOT change from occurrence to occurrence of
                  the problem, except for purposes of localization (e.g., using
                  proactive content negotiation; see [RFC7231], Section 3.4).
                type: string
              status:
                description: >
                  The HTTP status code for this occurrence of the problem. The
                  HTTP status code ([RFC7231], Section 6) generated by the
                  origin server for this occurrence of the problem.
                type: integer
              detail:
                description: >
                  A human-readable explanation specific to this occurrence of
                  the problem.
                type: string
              instance:
                description: >
                  A URI reference that identifies the specific occurrence of the
                  problem. It may yield further information if dereferenced.
                type: string
                format: URI
        '406':
          description: >
            If the "Accept" header does not contain at least one name of a
            content type for which the NFVO can provide a representation of the
            NSD, the NFVO shall respond with this response code. The
            "ProblemDetails" structure may be included with the "detail"
            attribute providing more information about the error.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              type: string
              maximum: 1
              minimum: 1
          schema:
            description: >
              The definition of the general "ProblemDetails" data structure from
              IETF RFC 7807 [19] is reproduced in this structure. Compared to
              the general framework defined in IETF RFC 7807 [19], the "status"
              and "detail" attributes are mandated to be included by the present
              document, to ensure that the response contains additional textual
              information about an error. IETF RFC 7807 [19] foresees
              extensibility of the "ProblemDetails" type. It is possible that
              particular APIs in the present document, or particular
              implementations, define extensions to define additional attributes
              that provide more information about the error. The description
              column only provides some explanation of the meaning to Facilitate
              understanding of the design. For a full description, see IETF RFC
              7807 [19].
            type: object
            required:
              - statussss
              - detail
            properties:
              type:
                description: >
                  A URI reference according to IETF RFC 3986 [5] that identifies
                  the problem type. It is encouraged that the URI provides
                  human-readable documentation for the problem (e.g. using HTML)
                  when dereferenced. When this member is not present, its value
                  is assumed to be "about:blank".
                type: string
                format: URI
              title:
                description: >
                  A short, human-readable summary of the problem type. It should
                  not change from occurrence to occurrence of the problem,
                  except for purposes of localization. If type is given and
                  other than "about:blank", this attribute shall also be
                  provided. A short, human-readable summary of the problem
                  type.  It SHOULD NOT change from occurrence to occurrence of
                  the problem, except for purposes of localization (e.g., using
                  proactive content negotiation; see [RFC7231], Section 3.4).
                type: string
              status:
                description: >
                  The HTTP status code for this occurrence of the problem. The
                  HTTP status code ([RFC7231], Section 6) generated by the
                  origin server for this occurrence of the problem.
                type: integer
              detail:
                description: >
                  A human-readable explanation specific to this occurrence of
                  the problem.
                type: string
              instance:
                description: >
                  A URI reference that identifies the specific occurrence of the
                  problem. It may yield further information if dereferenced.
                type: string
                format: URI
        '500':
          description: >
            Internal Server Error If there is an application error not related
            to the client's input that cannot be easily mapped to any other HTTP
            response code ("catch all error"), the API producer shall respond
            withthis response code. The ProblemDetails structure shall be
            provided, and shall include in the "detail" attribute more
            information about the source of the problem.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              type: string
              maximum: 1
              minimum: 1
          schema:
            description: >
              The definition of the general "ProblemDetails" data structure from
              IETF RFC 7807 [19] is reproduced in this structure. Compared to
              the general framework defined in IETF RFC 7807 [19], the "status"
              and "detail" attributes are mandated to be included by the present
              document, to ensure that the response contains additional textual
              information about an error. IETF RFC 7807 [19] foresees
              extensibility of the "ProblemDetails" type. It is possible that
              particular APIs in the present document, or particular
              implementations, define extensions to define additional attributes
              that provide more information about the error. The description
              column only provides some explanation of the meaning to Facilitate
              understanding of the design. For a full description, see IETF RFC
              7807 [19].
            type: object
            required:
              - statussss
              - detail
            properties:
              type:
                description: >
                  A URI reference according to IETF RFC 3986 [5] that identifies
                  the problem type. It is encouraged that the URI provides
                  human-readable documentation for the problem (e.g. using HTML)
                  when dereferenced. When this member is not present, its value
                  is assumed to be "about:blank".
                type: string
                format: URI
              title:
                description: >
                  A short, human-readable summary of the problem type. It should
                  not change from occurrence to occurrence of the problem,
                  except for purposes of localization. If type is given and
                  other than "about:blank", this attribute shall also be
                  provided. A short, human-readable summary of the problem
                  type.  It SHOULD NOT change from occurrence to occurrence of
                  the problem, except for purposes of localization (e.g., using
                  proactive content negotiation; see [RFC7231], Section 3.4).
                type: string
              status:
                description: >
                  The HTTP status code for this occurrence of the problem. The
                  HTTP status code ([RFC7231], Section 6) generated by the
                  origin server for this occurrence of the problem.
                type: integer
              detail:
                description: >
                  A human-readable explanation specific to this occurrence of
                  the problem.
                type: string
              instance:
                description: >
                  A URI reference that identifies the specific occurrence of the
                  problem. It may yield further information if dereferenced.
                type: string
                format: URI
        '503':
          description: >
            Service Unavailable If the API producer encounters an internal
            overload situation of itself or of a system it relies on, it should
            respond with this response code, following the provisions in IETF
            RFC 7231 [13] for the use of the Retry-After HTTP header and for the
            alternative to refuse the connection. The "ProblemDetails" structure
            may be omitted.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              type: string
              maximum: 1
              minimum: 1
          schema:
            description: >
              The definition of the general "ProblemDetails" data structure from
              IETF RFC 7807 [19] is reproduced in this structure. Compared to
              the general framework defined in IETF RFC 7807 [19], the "status"
              and "detail" attributes are mandated to be included by the present
              document, to ensure that the response contains additional textual
              information about an error. IETF RFC 7807 [19] foresees
              extensibility of the "ProblemDetails" type. It is possible that
              particular APIs in the present document, or particular
              implementations, define extensions to define additional attributes
              that provide more information about the error. The description
              column only provides some explanation of the meaning to Facilitate
              understanding of the design. For a full description, see IETF RFC
              7807 [19].
            type: object
            required:
              - statussss
              - detail
            properties:
              type:
                description: >
                  A URI reference according to IETF RFC 3986 [5] that identifies
                  the problem type. It is encouraged that the URI provides
                  human-readable documentation for the problem (e.g. using HTML)
                  when dereferenced. When this member is not present, its value
                  is assumed to be "about:blank".
                type: string
                format: URI
              title:
                description: >
                  A short, human-readable summary of the problem type. It should
                  not change from occurrence to occurrence of the problem,
                  except for purposes of localization. If type is given and
                  other than "about:blank", this attribute shall also be
                  provided. A short, human-readable summary of the problem
                  type.  It SHOULD NOT change from occurrence to occurrence of
                  the problem, except for purposes of localization (e.g., using
                  proactive content negotiation; see [RFC7231], Section 3.4).
                type: string
              status:
                description: >
                  The HTTP status code for this occurrence of the problem. The
                  HTTP status code ([RFC7231], Section 6) generated by the
                  origin server for this occurrence of the problem.
                type: integer
              detail:
                description: >
                  A human-readable explanation specific to this occurrence of
                  the problem.
                type: string
              instance:
                description: >
                  A URI reference that identifies the specific occurrence of the
                  problem. It may yield further information if dereferenced.
                type: string
                format: URI
    get:
      summary: Query multiple subscriptions.
      description: >
        Query Subscription Information

        The client can use this method to retrieve the list of active
        subscriptions  for alarms related to a NS subscribed by the client.  It
        can be used e.g. for resynchronization after error situations.

        This method shall follow the provisions specified in the Tables
        8.4.4.3.2-1 and 8.4.4.3.2-2 for URI query parameters, request and
        response data structures, and response codes. Table 8.4.4.3.2-1: URI
        query parameters supported.
      parameters:
        - name: filter
          in: query
          required: false
          type: string
          description: >
            Attribute-based filtering parameters according to clause 4.3.2. The
            NFVO shall support receiving filtering parameters as part of the URI
            query string. The OSS/BSS may supply filtering parameters. All
            attribute names that appear in the FmSubscription and in data types
            referenced from it shall be supported in attribute-based filtering
            parameters.       
        - name: Accept
          description: >
            Content-Types that are acceptable for the response. 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: false
          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: Version
          description: |
            Version of the API requested to use when responding to this request.
          in: header
          required: true
          type: string
      responses:
        '200':
          description: >
            200 OK

            The list of subscriptions was queried successfully. The response
            body shall contain the representations of all active subscriptions
            of the functional block that invokes the method.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              type: string
              maximum: 1
              minimum: 1
            WWW-Authenticate:
              type: string
              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.
              maximum: 1
              minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              type: string
              maximum: 1
              minimum: 1
          schema:
            type: array
            items:
              properties:
                FmSubscription:
                  description: >
                    This type represents a subscription related to notifications
                    about VNF faults.
                  type: object
                  required:
                    - id
                    - callbackUri
                    - _links
                  properties:
                    id:
                      description: >
                        An identifier with the intention of being globally
                        unique.
                      type: string
                    filter:
                      description: >
                        This type represents a subscription filter related to
                        notifications about NS faults.  It shall comply with the
                        provisions defined in Table 8.5.3.2-1. At a particular
                        nesting level in the filter structure, the following
                        applies:  All attributes shall match in order for the
                        filter to match (logical "and" between different filter
                        attributes).  If an attribute is an array, the attribute
                        shall match if at least one of the values in the array
                        matches (logical "or" between the values of one filter
                        attribute)..
                      type: object
                      properties:
                        nsInstanceSubscriptionFilter:
                          required:
                            - nsdIds
                            - vnfdIds
                            - pnfdIds
                            - nsInstanceIds
                          type: object
                          description: >
                            This type represents subscription filter criteria to
                            match NS instances. It shall comply with the
                            provisions defined in Table 4.4.1.5-1.
                          properties:
                            nsdIds:
                              description: >
                                If present, match NS instances that were created
                                based on a NSD identified by one of the nsdId
                                values listed in this attribute.
                              type: array
                              items:
                                description: >
                                  An identifier with the intention of being
                                  globally unique.
                                type: string
                            vnfdIds:
                              description: >
                                If present, match NS instances that contain VNF
                                instances that were created based on a VNFD
                                identified by one of the vnfdId values listed in
                                this attribute.
                              type: array
                              items:
                                description: >
                                  An identifier with the intention of being
                                  globally unique.
                                type: string
                            pnfdIds:
                              description: >
                                If present, match NS instances that contain PNFs
                                that are represented by a PNFD identified by one
                                of the pnfdId values listed in this attribute.
                              type: array
                              items:
                                description: >
                                  An identifier with the intention of being
                                  globally unique.
                                type: string
                            nsInstanceIds:
                              description: >
                                If present, match NS instances with an instance
                                dentifier listed in this attribute.
                              type: array
                              items:
                                description: >
                                  An identifier with the intention of being
                                  globally unique.
                                type: string
                            nsInstanceNames:
                              description: >
                                If present, match NS instances with a NS
                                Instance Name listed in this attribute.
                              type: array
                              items:
                                description: |
                                  This type represents stack of string values
                                type: string
                        notificationTypes:
                          description: >
                            Match particular notification types. Permitted
                            values: - AlarmNotification -
                            AlarmClearedNotification -
                            AlarmListRebuiltNotification.
                          type: array
                          items:
                            type: string
                            enum:
                              - AlarmNotification
                              - AlarmClearedNotification
                              - AlarmListRebuiltNotification
                        faultyResourceTypes:
                          description: >
                            Match alarms related to NSs with a faulty resource
                            type listed in this attribute.
                          type: array
                          items:
                            description: >
                              The enumeration FaultyResourceType represents
                              those types of faulty resource. Acceptable values
                              are: - COMPUTE - Virtual compute resource. -
                              STORAGE - Virtual storage resource. - NETWORK -
                              Virtual network resource.
                            type: string
                            enum:
                              - COMPUTE
                              - STORAGE
                              - NETWORK
                        perceivedSeverities:
                          description: >
                            Match VNF alarms with a perceived severity listed in
                            this attribute.
                          type: array
                          items:
                            description: >
                              Indicates the relative level of urgency for
                              operator attention. * CRITICAL: The Critical
                              severity level indicates that a service
                                affecting condition has occurred and an immediate corrective action
                                is required. Such a severity can be reported, for example, when a
                                managed object becomes totally out of service and its capability needs
                                to be restored (ITU-T Recommendation X.733).
                              * MAJOR: The Major severity level indicates that a
                              service affecting
                                condition has developed and an urgent corrective action is required.
                                Such a severity can be reported, for example, when there is a severe
                                degradation in the capability of the managed object and its full
                                capability needs to be restored (ITU-T Recommendation X.733).
                              * MINOR: The Minor severity level indicates the
                              existence of a
                                non-service affecting fault condition and that corrective action
                                should be taken in order to prevent a more serious (for example,
                                service affecting) fault. Such a severity can be reported, for
                                example, when the detected alarm condition is not currently degrading
                                the capacity of the managed object (ITU-T Recommendation X.733).
                              * WARNING: The Warning severity level indicates
                              the detection of a
                                potential or impending service affecting fault, before any significant
                                effects have been felt. Action should be taken to further diagnose (if
                                necessary) and correct the problem in order to prevent it from
                                becoming a more serious service affecting fault (ITU-T Recommendation
                                X.733).
                              * INDETERMINATE: The Indeterminate severity level
                              indicates that the
                                severity level cannot be determined (ITU-T Recommendation X.733).
                              * CLEARED: The Cleared severity level indicates
                              the clearing of one or
                                more previously reported alarms. This alarm clears all alarms for this
                                managed object that have the same Alarm type, Probable cause and
                                Specific problems (if given) (ITU-T Recommendation X.733).
                            type: string
                            enum:
                              - CRITICAL
                              - MAJOR
                              - MINOR
                              - WARNING
                              - INDETERMINATE
                              - CLEARED
                        eventTypes:
                          description: >
                            Match VNF alarms with an event type listed in this
                            attribute.
                          type: array
                          items:
                            description: >
                              The enumeration EventType represents those types
                              of events that trigger an alarm. -
                              COMMUNICATIONS_ALARM: An alarm of this type is
                              associated with the
                                procedure and/or process required conveying information from one point
                                to another (ITU-T Recommendation X.733).
                              - PROCESSING_ERROR_ALARM: An alarm of this type is
                              associated with a
                                software or processing fault (ITU-T Recommendation X.733).
                              - ENVIRONMENTAL_ALARM: An alarm of this type is
                              associated with a
                                condition related to an enclosure in which the equipment resides
                                (ITU-T Recommendation X.733).
                              - QOS_ALARM: An alarm of this type is associated
                              with degradation in the
                                quality of a service (ITU-T Recommendation X.733).
                              - EQUIPMENT_ALARM: An alarm of this type is
                              associated with an equipment
                                fault (ITU-T Recommendation X.733).
                            type: string
                            enum:
                              - COMMUNICATIONS_ALARM
                              - PROCESSING_ERROR_ALARM
                              - ENVIRONMENTAL_ALARM
                              - QOS_ALARM
                              - EQUIPMENT_ALARM
                        probableCauses:
                          description: >
                            Match VNF alarms with a probable cause listed in
                            this attribute.
                          type: array
                          items:
                            type: string
                    callbackUri:
                      description: |
                        The URI of the endpoint to send the notification to.
                      type: string
                      format: url
                    _links:
                      description: |
                        Links for this resource.
                      type: object
                      required:
                        - self
                      properties:
                        self:
                          description: |
                            This type represents a link to a resource.
                          type: object
                          required:
                            - href
                          properties:
                            href:
                              description: |
                                URI of the referenced resource.
                              type: string
                              format: url
        '400':
          description: >
            Bad Request Invalid attribute-based filtering parameters or Invalid
            attribute selector. It the request is malformed or syntactically
            incorrect (e.g. if the request URI contains incorrect query
            parameters or a syntactically incorrect payload body), the API
            producer shall respond with this response code. The "ProblemDetails"
            structure shall be provided, and should include in the "detail"
            attribute more information about the source of the problem. If the
            request contains a malformed access token, the API producer should
            respond with this response. The details of the error shall be
            returned in the WWW-Authenticate HTTP header, as defined in IETF RFC
            6750 and IETF RFC 7235. The ProblemDetails structure may be
            provided. If there is an application error related to the client's
            input that cannot be easily mapped to any other HTTP response code
            ("catch all error"), the API producer shall respond with this
            response code.The "ProblemDetails" structure shall be provided, and
            shall include in the "detail" attribute more information about the
            source of the problem.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              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
          schema:
            description: >
              The definition of the general "ProblemDetails" data structure from
              IETF RFC 7807 [19] is reproduced in this structure. Compared to
              the general framework defined in IETF RFC 7807 [19], the "status"
              and "detail" attributes are mandated to be included by the present
              document, to ensure that the response contains additional textual
              information about an error. IETF RFC 7807 [19] foresees
              extensibility of the "ProblemDetails" type. It is possible that
              particular APIs in the present document, or particular
              implementations, define extensions to define additional attributes
              that provide more information about the error. The description
              column only provides some explanation of the meaning to Facilitate
              understanding of the design. For a full description, see IETF RFC
              7807 [19].
            type: object
            required:
              - statussss
              - detail
            properties:
              type:
                description: >
                  A URI reference according to IETF RFC 3986 [5] that identifies
                  the problem type. It is encouraged that the URI provides
                  human-readable documentation for the problem (e.g. using HTML)
                  when dereferenced. When this member is not present, its value
                  is assumed to be "about:blank".
                type: string
                format: URI
              title:
                description: >
                  A short, human-readable summary of the problem type. It should
                  not change from occurrence to occurrence of the problem,
                  except for purposes of localization. If type is given and
                  other than "about:blank", this attribute shall also be
                  provided. A short, human-readable summary of the problem
                  type.  It SHOULD NOT change from occurrence to occurrence of
                  the problem, except for purposes of localization (e.g., using
                  proactive content negotiation; see [RFC7231], Section 3.4).
                type: string
              status:
                description: >
                  The HTTP status code for this occurrence of the problem. The
                  HTTP status code ([RFC7231], Section 6) generated by the
                  origin server for this occurrence of the problem.
                type: integer
              detail:
                description: >
                  A human-readable explanation specific to this occurrence of
                  the problem.
                type: string
              instance:
                description: >
                  A URI reference that identifies the specific occurrence of the
                  problem. It may yield further information if dereferenced.
                type: string
                format: URI
        '401':
          description: >
            Unauthorized. If the request contains no access token even though
            one is required, or if the request contains an authorization token
            that is invalid (e.g. expired or revoked), the API producer should
            respond with this response. The details of the error shall be
            returned in the WWW-Authenticate HTTP header, as defined in IETF RFC
            6750 and IETF RFC 7235. The ProblemDetails structure may be
            provided.
          headers:
            Content-Type:
              type: string
              description: The MIME type of the body of the response.
            WWW-Authenticate:
              type: string
              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.
          schema:
            description: >
              The definition of the general "ProblemDetails" data structure from
              IETF RFC 7807 [19] is reproduced in this structure. Compared to
              the general framework defined in IETF RFC 7807 [19], the "status"
              and "detail" attributes are mandated to be included by the present
              document, to ensure that the response contains additional textual
              information about an error. IETF RFC 7807 [19] foresees
              extensibility of the "ProblemDetails" type. It is possible that
              particular APIs in the present document, or particular
              implementations, define extensions to define additional attributes
              that provide more information about the error. The description
              column only provides some explanation of the meaning to Facilitate
              understanding of the design. For a full description, see IETF RFC
              7807 [19].
            type: object
            required:
              - statussss
              - detail
            properties:
              type:
                description: >
                  A URI reference according to IETF RFC 3986 [5] that identifies
                  the problem type. It is encouraged that the URI provides
                  human-readable documentation for the problem (e.g. using HTML)
                  when dereferenced. When this member is not present, its value
                  is assumed to be "about:blank".
                type: string
                format: URI
              title:
                description: >
                  A short, human-readable summary of the problem type. It should
                  not change from occurrence to occurrence of the problem,
                  except for purposes of localization. If type is given and
                  other than "about:blank", this attribute shall also be
                  provided. A short, human-readable summary of the problem
                  type.  It SHOULD NOT change from occurrence to occurrence of
                  the problem, except for purposes of localization (e.g., using
                  proactive content negotiation; see [RFC7231], Section 3.4).
                type: string
              status:
                description: >
                  The HTTP status code for this occurrence of the problem. The
                  HTTP status code ([RFC7231], Section 6) generated by the
                  origin server for this occurrence of the problem.
                type: integer
              detail:
                description: >
                  A human-readable explanation specific to this occurrence of
                  the problem.
                type: string
              instance:
                description: >
                  A URI reference that identifies the specific occurrence of the
                  problem. It may yield further information if dereferenced.
                type: string
                format: URI
        '403':
          description: >
            Forbidden If the API consumer is not allowed to perform a particular
            request to a particular resource, the API producer shall respond
            with this response code. The "ProblemDetails" structure shall be
            provided. It should include in the "detail" attribute information
            about the source of the problem, and may indicate how to solve it.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              type: string
              maximum: 1
              minimum: 1
          schema:
            description: >
              The definition of the general "ProblemDetails" data structure from
              IETF RFC 7807 [19] is reproduced in this structure. Compared to
              the general framework defined in IETF RFC 7807 [19], the "status"
              and "detail" attributes are mandated to be included by the present
              document, to ensure that the response contains additional textual
              information about an error. IETF RFC 7807 [19] foresees
              extensibility of the "ProblemDetails" type. It is possible that
              particular APIs in the present document, or particular
              implementations, define extensions to define additional attributes
              that provide more information about the error. The description
              column only provides some explanation of the meaning to Facilitate
              understanding of the design. For a full description, see IETF RFC
              7807 [19].
            type: object
            required:
              - statussss
              - detail
            properties:
              type:
                description: >
                  A URI reference according to IETF RFC 3986 [5] that identifies
                  the problem type. It is encouraged that the URI provides
                  human-readable documentation for the problem (e.g. using HTML)
                  when dereferenced. When this member is not present, its value
                  is assumed to be "about:blank".
                type: string
                format: URI
              title:
                description: >
                  A short, human-readable summary of the problem type. It should
                  not change from occurrence to occurrence of the problem,
                  except for purposes of localization. If type is given and
                  other than "about:blank", this attribute shall also be
                  provided. A short, human-readable summary of the problem
                  type.  It SHOULD NOT change from occurrence to occurrence of
                  the problem, except for purposes of localization (e.g., using
                  proactive content negotiation; see [RFC7231], Section 3.4).
                type: string
              status:
                description: >
                  The HTTP status code for this occurrence of the problem. The
                  HTTP status code ([RFC7231], Section 6) generated by the
                  origin server for this occurrence of the problem.
                type: integer
              detail:
                description: >
                  A human-readable explanation specific to this occurrence of
                  the problem.
                type: string
              instance:
                description: >
                  A URI reference that identifies the specific occurrence of the
                  problem. It may yield further information if dereferenced.
                type: string
                format: URI
        '405':
          description: >
            Method Not Allowed If a particular HTTP method is not supported for
            a particular resource, the API producer shall respond with this
            response code. The "ProblemDetails" structure may be omitted in that
            case.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              type: string
              maximum: 1
              minimum: 1
          schema:
            description: >
              The definition of the general "ProblemDetails" data structure from
              IETF RFC 7807 [19] is reproduced in this structure. Compared to
              the general framework defined in IETF RFC 7807 [19], the "status"
              and "detail" attributes are mandated to be included by the present
              document, to ensure that the response contains additional textual
              information about an error. IETF RFC 7807 [19] foresees
              extensibility of the "ProblemDetails" type. It is possible that
              particular APIs in the present document, or particular
              implementations, define extensions to define additional attributes
              that provide more information about the error. The description
              column only provides some explanation of the meaning to Facilitate
              understanding of the design. For a full description, see IETF RFC
              7807 [19].
            type: object
            required:
              - statussss
              - detail
            properties:
              type:
                description: >
                  A URI reference according to IETF RFC 3986 [5] that identifies
                  the problem type. It is encouraged that the URI provides
                  human-readable documentation for the problem (e.g. using HTML)
                  when dereferenced. When this member is not present, its value
                  is assumed to be "about:blank".
                type: string
                format: URI
              title:
                description: >
                  A short, human-readable summary of the problem type. It should
                  not change from occurrence to occurrence of the problem,
                  except for purposes of localization. If type is given and
                  other than "about:blank", this attribute shall also be
                  provided. A short, human-readable summary of the problem
                  type.  It SHOULD NOT change from occurrence to occurrence of
                  the problem, except for purposes of localization (e.g., using
                  proactive content negotiation; see [RFC7231], Section 3.4).
                type: string
              status:
                description: >
                  The HTTP status code for this occurrence of the problem. The
                  HTTP status code ([RFC7231], Section 6) generated by the
                  origin server for this occurrence of the problem.
                type: integer
              detail:
                description: >
                  A human-readable explanation specific to this occurrence of
                  the problem.
                type: string
              instance:
                description: >
                  A URI reference that identifies the specific occurrence of the
                  problem. It may yield further information if dereferenced.
                type: string
                format: URI
        '406':
          description: >
            If the "Accept" header does not contain at least one name of a
            content type for which the NFVO can provide a representation of the
            NSD, the NFVO shall respond with this response code. The
            "ProblemDetails" structure may be included with the "detail"
            attribute providing more information about the error.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              type: string
              maximum: 1
              minimum: 1
          schema:
            description: >
              The definition of the general "ProblemDetails" data structure from
              IETF RFC 7807 [19] is reproduced in this structure. Compared to
              the general framework defined in IETF RFC 7807 [19], the "status"
              and "detail" attributes are mandated to be included by the present
              document, to ensure that the response contains additional textual
              information about an error. IETF RFC 7807 [19] foresees
              extensibility of the "ProblemDetails" type. It is possible that
              particular APIs in the present document, or particular
              implementations, define extensions to define additional attributes
              that provide more information about the error. The description
              column only provides some explanation of the meaning to Facilitate
              understanding of the design. For a full description, see IETF RFC
              7807 [19].
            type: object
            required:
              - statussss
              - detail
            properties:
              type:
                description: >
                  A URI reference according to IETF RFC 3986 [5] that identifies
                  the problem type. It is encouraged that the URI provides
                  human-readable documentation for the problem (e.g. using HTML)
                  when dereferenced. When this member is not present, its value
                  is assumed to be "about:blank".
                type: string
                format: URI
              title:
                description: >
                  A short, human-readable summary of the problem type. It should
                  not change from occurrence to occurrence of the problem,
                  except for purposes of localization. If type is given and
                  other than "about:blank", this attribute shall also be
                  provided. A short, human-readable summary of the problem
                  type.  It SHOULD NOT change from occurrence to occurrence of
                  the problem, except for purposes of localization (e.g., using
                  proactive content negotiation; see [RFC7231], Section 3.4).
                type: string
              status:
                description: >
                  The HTTP status code for this occurrence of the problem. The
                  HTTP status code ([RFC7231], Section 6) generated by the
                  origin server for this occurrence of the problem.
                type: integer
              detail:
                description: >
                  A human-readable explanation specific to this occurrence of
                  the problem.
                type: string
              instance:
                description: >
                  A URI reference that identifies the specific occurrence of the
                  problem. It may yield further information if dereferenced.
                type: string
                format: URI
        '412':
          description: >
            Precondition Failed.

            Error: A precondition given in an HTTP request header is not
            fulfilled. Typically, this is due to an ETag mismatch, indicating
            that the resource was modified by another entity. The response body
            should contain a ProblemDetails structure, in which the "detail"
            attribute should convey more information about the error.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              type: string
              maximum: 1
              minimum: 1
          schema:
            description: >
              The definition of the general "ProblemDetails" data structure from
              IETF RFC 7807 [19] is reproduced in this structure. Compared to
              the general framework defined in IETF RFC 7807 [19], the "status"
              and "detail" attributes are mandated to be included by the present
              document, to ensure that the response contains additional textual
              information about an error. IETF RFC 7807 [19] foresees
              extensibility of the "ProblemDetails" type. It is possible that
              particular APIs in the present document, or particular
              implementations, define extensions to define additional attributes
              that provide more information about the error. The description
              column only provides some explanation of the meaning to Facilitate
              understanding of the design. For a full description, see IETF RFC
              7807 [19].
            type: object
            required:
              - statussss
              - detail
            properties:
              type:
                description: >
                  A URI reference according to IETF RFC 3986 [5] that identifies
                  the problem type. It is encouraged that the URI provides
                  human-readable documentation for the problem (e.g. using HTML)
                  when dereferenced. When this member is not present, its value
                  is assumed to be "about:blank".
                type: string
                format: URI
              title:
                description: >
                  A short, human-readable summary of the problem type. It should
                  not change from occurrence to occurrence of the problem,
                  except for purposes of localization. If type is given and
                  other than "about:blank", this attribute shall also be
                  provided. A short, human-readable summary of the problem
                  type.  It SHOULD NOT change from occurrence to occurrence of
                  the problem, except for purposes of localization (e.g., using
                  proactive content negotiation; see [RFC7231], Section 3.4).
                type: string
              status:
                description: >
                  The HTTP status code for this occurrence of the problem. The
                  HTTP status code ([RFC7231], Section 6) generated by the
                  origin server for this occurrence of the problem.
                type: integer
              detail:
                description: >
                  A human-readable explanation specific to this occurrence of
                  the problem.
                type: string
              instance:
                description: >
                  A URI reference that identifies the specific occurrence of the
                  problem. It may yield further information if dereferenced.
                type: string
                format: URI
        '500':
          description: >
            Internal Server Error If there is an application error not related
            to the client's input that cannot be easily mapped to any other HTTP
            response code ("catch all error"), the API producer shall respond
            withthis response code. The ProblemDetails structure shall be
            provided, and shall include in the "detail" attribute more
            information about the source of the problem.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              type: string
              maximum: 1
              minimum: 1
          schema:
            description: >
              The definition of the general "ProblemDetails" data structure from
              IETF RFC 7807 [19] is reproduced in this structure. Compared to
              the general framework defined in IETF RFC 7807 [19], the "status"
              and "detail" attributes are mandated to be included by the present
              document, to ensure that the response contains additional textual
              information about an error. IETF RFC 7807 [19] foresees
              extensibility of the "ProblemDetails" type. It is possible that
              particular APIs in the present document, or particular
              implementations, define extensions to define additional attributes
              that provide more information about the error. The description
              column only provides some explanation of the meaning to Facilitate
              understanding of the design. For a full description, see IETF RFC
              7807 [19].
            type: object
            required:
              - statussss
              - detail
            properties:
              type:
                description: >
                  A URI reference according to IETF RFC 3986 [5] that identifies
                  the problem type. It is encouraged that the URI provides
                  human-readable documentation for the problem (e.g. using HTML)
                  when dereferenced. When this member is not present, its value
                  is assumed to be "about:blank".
                type: string
                format: URI
              title:
                description: >
                  A short, human-readable summary of the problem type. It should
                  not change from occurrence to occurrence of the problem,
                  except for purposes of localization. If type is given and
                  other than "about:blank", this attribute shall also be
                  provided. A short, human-readable summary of the problem
                  type.  It SHOULD NOT change from occurrence to occurrence of
                  the problem, except for purposes of localization (e.g., using
                  proactive content negotiation; see [RFC7231], Section 3.4).
                type: string
              status:
                description: >
                  The HTTP status code for this occurrence of the problem. The
                  HTTP status code ([RFC7231], Section 6) generated by the
                  origin server for this occurrence of the problem.
                type: integer
              detail:
                description: >
                  A human-readable explanation specific to this occurrence of
                  the problem.
                type: string
              instance:
                description: >
                  A URI reference that identifies the specific occurrence of the
                  problem. It may yield further information if dereferenced.
                type: string
                format: URI
        '503':
          description: >
            Service Unavailable If the API producer encounters an internal
            overload situation of itself or of a system it relies on, it should
            respond with this response code, following the provisions in IETF
            RFC 7231 [13] for the use of the Retry-After HTTP header and for the
            alternative to refuse the connection. The "ProblemDetails" structure
            may be omitted.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              type: string
              maximum: 1
              minimum: 1
          schema:
            description: >
              The definition of the general "ProblemDetails" data structure from
              IETF RFC 7807 [19] is reproduced in this structure. Compared to
              the general framework defined in IETF RFC 7807 [19], the "status"
              and "detail" attributes are mandated to be included by the present
              document, to ensure that the response contains additional textual
              information about an error. IETF RFC 7807 [19] foresees
              extensibility of the "ProblemDetails" type. It is possible that
              particular APIs in the present document, or particular
              implementations, define extensions to define additional attributes
              that provide more information about the error. The description
              column only provides some explanation of the meaning to Facilitate
              understanding of the design. For a full description, see IETF RFC
              7807 [19].
            type: object
            required:
              - statussss
              - detail
            properties:
              type:
                description: >
                  A URI reference according to IETF RFC 3986 [5] that identifies
                  the problem type. It is encouraged that the URI provides
                  human-readable documentation for the problem (e.g. using HTML)
                  when dereferenced. When this member is not present, its value
                  is assumed to be "about:blank".
                type: string
                format: URI
              title:
                description: >
                  A short, human-readable summary of the problem type. It should
                  not change from occurrence to occurrence of the problem,
                  except for purposes of localization. If type is given and
                  other than "about:blank", this attribute shall also be
                  provided. A short, human-readable summary of the problem
                  type.  It SHOULD NOT change from occurrence to occurrence of
                  the problem, except for purposes of localization (e.g., using
                  proactive content negotiation; see [RFC7231], Section 3.4).
                type: string
              status:
                description: >
                  The HTTP status code for this occurrence of the problem. The
                  HTTP status code ([RFC7231], Section 6) generated by the
                  origin server for this occurrence of the problem.
                type: integer
              detail:
                description: >
                  A human-readable explanation specific to this occurrence of
                  the problem.
                type: string
              instance:
                description: >
                  A URI reference that identifies the specific occurrence of the
                  problem. It may yield further information if dereferenced.
                type: string
                format: URI
  '/subscriptions/{subscriptionId}':
    parameters:
      - name: subscriptionId
        description: >
          Identifier of this subscription. This identifier can be retrieved from
          the resource referenced by the "Location" HTTP header in the response
          to a POST request creating a new subscription resource. It can also be
          retrieved from the "id" attribute in the payload body of that
          response.
        in: path
        type: string
        required: true
    get:
      summary: Read an individual subscription.
      description: >
        Query Subscription Information

        The client can use this method for reading an individual subscription
        for alarms related to NSs subscribed by the client. This method shall
        follow the provisions specified in the Tables 8.4.5.3.2-1 and
        8.4.5.3.2-2 for URI query parameters, request and response data
        structures, and response codes
      parameters:
        - name: Accept
          description: >
            Content-Types that are acceptable for the response. 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: false
          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: Version
          description: |
            Version of the API requested to use when responding to this request.
          in: header
          required: true
          type: string
      responses:
        '200':
          description: >
            200 OK

            The operation has completed successfully. The response body shall
            contain a representation of the subscription resource.
          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:
              type: string
              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.
              maximum: 1
              minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              type: string
              maximum: 1
              minimum: 1
          schema:
            properties:
              FmSubscription:
                description: >
                  This type represents a subscription related to notifications
                  about VNF faults.
                type: object
                required:
                  - id
                  - callbackUri
                  - _links
                properties:
                  id:
                    description: |
                      An identifier with the intention of being globally unique.
                    type: string
                  filter:
                    description: >
                      This type represents a subscription filter related to
                      notifications about NS faults.  It shall comply with the
                      provisions defined in Table 8.5.3.2-1. At a particular
                      nesting level in the filter structure, the following
                      applies:  All attributes shall match in order for the
                      filter to match (logical "and" between different filter
                      attributes).  If an attribute is an array, the attribute
                      shall match if at least one of the values in the array
                      matches (logical "or" between the values of one filter
                      attribute)..
                    type: object
                    properties:
                      nsInstanceSubscriptionFilter:
                        required:
                          - nsdIds
                          - vnfdIds
                          - pnfdIds
                          - nsInstanceIds
                        type: object
                        description: >
                          This type represents subscription filter criteria to
                          match NS instances. It shall comply with the
                          provisions defined in Table 4.4.1.5-1.
                        properties:
                          nsdIds:
                            description: >
                              If present, match NS instances that were created
                              based on a NSD identified by one of the nsdId
                              values listed in this attribute.
                            type: array
                            items:
                              description: >
                                An identifier with the intention of being
                                globally unique.
                              type: string
                          vnfdIds:
                            description: >
                              If present, match NS instances that contain VNF
                              instances that were created based on a VNFD
                              identified by one of the vnfdId values listed in
                              this attribute.
                            type: array
                            items:
                              description: >
                                An identifier with the intention of being
                                globally unique.
                              type: string
                          pnfdIds:
                            description: >
                              If present, match NS instances that contain PNFs
                              that are represented by a PNFD identified by one
                              of the pnfdId values listed in this attribute.
                            type: array
                            items:
                              description: >
                                An identifier with the intention of being
                                globally unique.
                              type: string
                          nsInstanceIds:
                            description: >
                              If present, match NS instances with an instance
                              dentifier listed in this attribute.
                            type: array
                            items:
                              description: >
                                An identifier with the intention of being
                                globally unique.
                              type: string
                          nsInstanceNames:
                            description: >
                              If present, match NS instances with a NS Instance
                              Name listed in this attribute.
                            type: array
                            items:
                              description: |
                                This type represents stack of string values
                              type: string
                      notificationTypes:
                        description: >
                          Match particular notification types. Permitted values:
                          - AlarmNotification - AlarmClearedNotification -
                          AlarmListRebuiltNotification.
                        type: array
                        items:
                          type: string
                          enum:
                            - AlarmNotification
                            - AlarmClearedNotification
                            - AlarmListRebuiltNotification
                      faultyResourceTypes:
                        description: >
                          Match alarms related to NSs with a faulty resource
                          type listed in this attribute.
                        type: array
                        items:
                          description: >
                            The enumeration FaultyResourceType represents those
                            types of faulty resource. Acceptable values are: -
                            COMPUTE - Virtual compute resource. - STORAGE -
                            Virtual storage resource. - NETWORK - Virtual
                            network resource.
                          type: string
                          enum:
                            - COMPUTE
                            - STORAGE
                            - NETWORK
                      perceivedSeverities:
                        description: >
                          Match VNF alarms with a perceived severity listed in
                          this attribute.
                        type: array
                        items:
                          description: >
                            Indicates the relative level of urgency for operator
                            attention. * CRITICAL: The Critical severity level
                            indicates that a service
                              affecting condition has occurred and an immediate corrective action
                              is required. Such a severity can be reported, for example, when a
                              managed object becomes totally out of service and its capability needs
                              to be restored (ITU-T Recommendation X.733).
                            * MAJOR: The Major severity level indicates that a
                            service affecting
                              condition has developed and an urgent corrective action is required.
                              Such a severity can be reported, for example, when there is a severe
                              degradation in the capability of the managed object and its full
                              capability needs to be restored (ITU-T Recommendation X.733).
                            * MINOR: The Minor severity level indicates the
                            existence of a
                              non-service affecting fault condition and that corrective action
                              should be taken in order to prevent a more serious (for example,
                              service affecting) fault. Such a severity can be reported, for
                              example, when the detected alarm condition is not currently degrading
                              the capacity of the managed object (ITU-T Recommendation X.733).
                            * WARNING: The Warning severity level indicates the
                            detection of a
                              potential or impending service affecting fault, before any significant
                              effects have been felt. Action should be taken to further diagnose (if
                              necessary) and correct the problem in order to prevent it from
                              becoming a more serious service affecting fault (ITU-T Recommendation
                              X.733).
                            * INDETERMINATE: The Indeterminate severity level
                            indicates that the
                              severity level cannot be determined (ITU-T Recommendation X.733).
                            * CLEARED: The Cleared severity level indicates the
                            clearing of one or
                              more previously reported alarms. This alarm clears all alarms for this
                              managed object that have the same Alarm type, Probable cause and
                              Specific problems (if given) (ITU-T Recommendation X.733).
                          type: string
                          enum:
                            - CRITICAL
                            - MAJOR
                            - MINOR
                            - WARNING
                            - INDETERMINATE
                            - CLEARED
                      eventTypes:
                        description: >
                          Match VNF alarms with an event type listed in this
                          attribute.
                        type: array
                        items:
                          description: >
                            The enumeration EventType represents those types of
                            events that trigger an alarm. -
                            COMMUNICATIONS_ALARM: An alarm of this type is
                            associated with the
                              procedure and/or process required conveying information from one point
                              to another (ITU-T Recommendation X.733).
                            - PROCESSING_ERROR_ALARM: An alarm of this type is
                            associated with a
                              software or processing fault (ITU-T Recommendation X.733).
                            - ENVIRONMENTAL_ALARM: An alarm of this type is
                            associated with a
                              condition related to an enclosure in which the equipment resides
                              (ITU-T Recommendation X.733).
                            - QOS_ALARM: An alarm of this type is associated
                            with degradation in the
                              quality of a service (ITU-T Recommendation X.733).
                            - EQUIPMENT_ALARM: An alarm of this type is
                            associated with an equipment
                              fault (ITU-T Recommendation X.733).
                          type: string
                          enum:
                            - COMMUNICATIONS_ALARM
                            - PROCESSING_ERROR_ALARM
                            - ENVIRONMENTAL_ALARM
                            - QOS_ALARM
                            - EQUIPMENT_ALARM
                      probableCauses:
                        description: >
                          Match VNF alarms with a probable cause listed in this
                          attribute.
                        type: array
                        items:
                          type: string
                  callbackUri:
                    description: |
                      The URI of the endpoint to send the notification to.
                    type: string
                    format: url
                  _links:
                    description: |
                      Links for this resource.
                    type: object
                    required:
                      - self
                    properties:
                      self:
                        description: |
                          This type represents a link to a resource.
                        type: object
                        required:
                          - href
                        properties:
                          href:
                            description: |
                              URI of the referenced resource.
                            type: string
                            format: url
        '400':
          description: >
            Bad Request

            Error: Invalid attribute-based filtering parameters. The response
            body shall contain a ProblemDetails structure, in which the "detail"
            attribute should convey more information about the error.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              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 definition of the general "ProblemDetails" data structure from
              IETF RFC 7807 [19] is reproduced in this structure. Compared to
              the general framework defined in IETF RFC 7807 [19], the "status"
              and "detail" attributes are mandated to be included by the present
              document, to ensure that the response contains additional textual
              information about an error. IETF RFC 7807 [19] foresees
              extensibility of the "ProblemDetails" type. It is possible that
              particular APIs in the present document, or particular
              implementations, define extensions to define additional attributes
              that provide more information about the error. The description
              column only provides some explanation of the meaning to Facilitate
              understanding of the design. For a full description, see IETF RFC
              7807 [19].
            type: object
            required:
              - statussss
              - detail
            properties:
              type:
                description: >
                  A URI reference according to IETF RFC 3986 [5] that identifies
                  the problem type. It is encouraged that the URI provides
                  human-readable documentation for the problem (e.g. using HTML)
                  when dereferenced. When this member is not present, its value
                  is assumed to be "about:blank".
                type: string
                format: URI
              title:
                description: >
                  A short, human-readable summary of the problem type. It should
                  not change from occurrence to occurrence of the problem,
                  except for purposes of localization. If type is given and
                  other than "about:blank", this attribute shall also be
                  provided. A short, human-readable summary of the problem
                  type.  It SHOULD NOT change from occurrence to occurrence of
                  the problem, except for purposes of localization (e.g., using
                  proactive content negotiation; see [RFC7231], Section 3.4).
                type: string
              status:
                description: >
                  The HTTP status code for this occurrence of the problem. The
                  HTTP status code ([RFC7231], Section 6) generated by the
                  origin server for this occurrence of the problem.
                type: integer
              detail:
                description: >
                  A human-readable explanation specific to this occurrence of
                  the problem.
                type: string
              instance:
                description: >
                  A URI reference that identifies the specific occurrence of the
                  problem. It may yield further information if dereferenced.
                type: string
                format: URI
        '401':
          description: >
            Unauthorized. If the request contains no access token even though
            one is required, or if the request contains an authorization token
            that is invalid (e.g. expired or revoked), the API producer should
            respond with this response. The details of the error shall be
            returned in the WWW-Authenticate HTTP header, as defined in IETF RFC
            6750 and IETF RFC 7235. The ProblemDetails structure may be
            provided.
          headers:
            Content-Type:
              type: string
              description: The MIME type of the body of the response.
            WWW-Authenticate:
              type: string
              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.
          schema:
            description: >
              The definition of the general "ProblemDetails" data structure from
              IETF RFC 7807 [19] is reproduced in this structure. Compared to
              the general framework defined in IETF RFC 7807 [19], the "status"
              and "detail" attributes are mandated to be included by the present
              document, to ensure that the response contains additional textual
              information about an error. IETF RFC 7807 [19] foresees
              extensibility of the "ProblemDetails" type. It is possible that
              particular APIs in the present document, or particular
              implementations, define extensions to define additional attributes
              that provide more information about the error. The description
              column only provides some explanation of the meaning to Facilitate
              understanding of the design. For a full description, see IETF RFC
              7807 [19].
            type: object
            required:
              - statussss
              - detail
            properties:
              type:
                description: >
                  A URI reference according to IETF RFC 3986 [5] that identifies
                  the problem type. It is encouraged that the URI provides
                  human-readable documentation for the problem (e.g. using HTML)
                  when dereferenced. When this member is not present, its value
                  is assumed to be "about:blank".
                type: string
                format: URI
              title:
                description: >
                  A short, human-readable summary of the problem type. It should
                  not change from occurrence to occurrence of the problem,
                  except for purposes of localization. If type is given and
                  other than "about:blank", this attribute shall also be
                  provided. A short, human-readable summary of the problem
                  type.  It SHOULD NOT change from occurrence to occurrence of
                  the problem, except for purposes of localization (e.g., using
                  proactive content negotiation; see [RFC7231], Section 3.4).
                type: string
              status:
                description: >
                  The HTTP status code for this occurrence of the problem. The
                  HTTP status code ([RFC7231], Section 6) generated by the
                  origin server for this occurrence of the problem.
                type: integer
              detail:
                description: >
                  A human-readable explanation specific to this occurrence of
                  the problem.
                type: string
              instance:
                description: >
                  A URI reference that identifies the specific occurrence of the
                  problem. It may yield further information if dereferenced.
                type: string
                format: URI
        '403':
          description: >
            Forbidden If the API consumer is not allowed to perform a particular
            request to a particular resource, the API producer shall respond
            with this response code. The "ProblemDetails" structure shall be
            provided. It should include in the "detail" attribute information
            about the source of the problem, and may indicate how to solve it.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              type: string
              maximum: 1
              minimum: 1
          schema:
            description: >
              The definition of the general "ProblemDetails" data structure from
              IETF RFC 7807 [19] is reproduced in this structure. Compared to
              the general framework defined in IETF RFC 7807 [19], the "status"
              and "detail" attributes are mandated to be included by the present
              document, to ensure that the response contains additional textual
              information about an error. IETF RFC 7807 [19] foresees
              extensibility of the "ProblemDetails" type. It is possible that
              particular APIs in the present document, or particular
              implementations, define extensions to define additional attributes
              that provide more information about the error. The description
              column only provides some explanation of the meaning to Facilitate
              understanding of the design. For a full description, see IETF RFC
              7807 [19].
            type: object
            required:
              - statussss
              - detail
            properties:
              type:
                description: >
                  A URI reference according to IETF RFC 3986 [5] that identifies
                  the problem type. It is encouraged that the URI provides
                  human-readable documentation for the problem (e.g. using HTML)
                  when dereferenced. When this member is not present, its value
                  is assumed to be "about:blank".
                type: string
                format: URI
              title:
                description: >
                  A short, human-readable summary of the problem type. It should
                  not change from occurrence to occurrence of the problem,
                  except for purposes of localization. If type is given and
                  other than "about:blank", this attribute shall also be
                  provided. A short, human-readable summary of the problem
                  type.  It SHOULD NOT change from occurrence to occurrence of
                  the problem, except for purposes of localization (e.g., using
                  proactive content negotiation; see [RFC7231], Section 3.4).
                type: string
              status:
                description: >
                  The HTTP status code for this occurrence of the problem. The
                  HTTP status code ([RFC7231], Section 6) generated by the
                  origin server for this occurrence of the problem.
                type: integer
              detail:
                description: >
                  A human-readable explanation specific to this occurrence of
                  the problem.
                type: string
              instance:
                description: >
                  A URI reference that identifies the specific occurrence of the
                  problem. It may yield further information if dereferenced.
                type: string
                format: URI
        '405':
          description: >
            Method Not Allowed If a particular HTTP method is not supported for
            a particular resource, the API producer shall respond with this
            response code. The "ProblemDetails" structure may be omitted in that
            case.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              type: string
              maximum: 1
              minimum: 1
          schema:
            description: >
              The definition of the general "ProblemDetails" data structure from
              IETF RFC 7807 [19] is reproduced in this structure. Compared to
              the general framework defined in IETF RFC 7807 [19], the "status"
              and "detail" attributes are mandated to be included by the present
              document, to ensure that the response contains additional textual
              information about an error. IETF RFC 7807 [19] foresees
              extensibility of the "ProblemDetails" type. It is possible that
              particular APIs in the present document, or particular
              implementations, define extensions to define additional attributes
              that provide more information about the error. The description
              column only provides some explanation of the meaning to Facilitate
              understanding of the design. For a full description, see IETF RFC
              7807 [19].
            type: object
            required:
              - statussss
              - detail
            properties:
              type:
                description: >
                  A URI reference according to IETF RFC 3986 [5] that identifies
                  the problem type. It is encouraged that the URI provides
                  human-readable documentation for the problem (e.g. using HTML)
                  when dereferenced. When this member is not present, its value
                  is assumed to be "about:blank".
                type: string
                format: URI
              title:
                description: >
                  A short, human-readable summary of the problem type. It should
                  not change from occurrence to occurrence of the problem,
                  except for purposes of localization. If type is given and
                  other than "about:blank", this attribute shall also be
                  provided. A short, human-readable summary of the problem
                  type.  It SHOULD NOT change from occurrence to occurrence of
                  the problem, except for purposes of localization (e.g., using
                  proactive content negotiation; see [RFC7231], Section 3.4).
                type: string
              status:
                description: >
                  The HTTP status code for this occurrence of the problem. The
                  HTTP status code ([RFC7231], Section 6) generated by the
                  origin server for this occurrence of the problem.
                type: integer
              detail:
                description: >
                  A human-readable explanation specific to this occurrence of
                  the problem.
                type: string
              instance:
                description: >
                  A URI reference that identifies the specific occurrence of the
                  problem. It may yield further information if dereferenced.
                type: string
                format: URI
        '406':
          description: >
            If the "Accept" header does not contain at least one name of a
            content type for which the NFVO can provide a representation of the
            NSD, the NFVO shall respond with this response code. The
            "ProblemDetails" structure may be included with the "detail"
            attribute providing more information about the error.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              type: string
              maximum: 1
              minimum: 1
          schema:
            description: >
              The definition of the general "ProblemDetails" data structure from
              IETF RFC 7807 [19] is reproduced in this structure. Compared to
              the general framework defined in IETF RFC 7807 [19], the "status"
              and "detail" attributes are mandated to be included by the present
              document, to ensure that the response contains additional textual
              information about an error. IETF RFC 7807 [19] foresees
              extensibility of the "ProblemDetails" type. It is possible that
              particular APIs in the present document, or particular
              implementations, define extensions to define additional attributes
              that provide more information about the error. The description
              column only provides some explanation of the meaning to Facilitate
              understanding of the design. For a full description, see IETF RFC
              7807 [19].
            type: object
            required:
              - statussss
              - detail
            properties:
              type:
                description: >
                  A URI reference according to IETF RFC 3986 [5] that identifies
                  the problem type. It is encouraged that the URI provides
                  human-readable documentation for the problem (e.g. using HTML)
                  when dereferenced. When this member is not present, its value
                  is assumed to be "about:blank".
                type: string
                format: URI
              title:
                description: >
                  A short, human-readable summary of the problem type. It should
                  not change from occurrence to occurrence of the problem,
                  except for purposes of localization. If type is given and
                  other than "about:blank", this attribute shall also be
                  provided. A short, human-readable summary of the problem
                  type.  It SHOULD NOT change from occurrence to occurrence of
                  the problem, except for purposes of localization (e.g., using
                  proactive content negotiation; see [RFC7231], Section 3.4).
                type: string
              status:
                description: >
                  The HTTP status code for this occurrence of the problem. The
                  HTTP status code ([RFC7231], Section 6) generated by the
                  origin server for this occurrence of the problem.
                type: integer
              detail:
                description: >
                  A human-readable explanation specific to this occurrence of
                  the problem.
                type: string
              instance:
                description: >
                  A URI reference that identifies the specific occurrence of the
                  problem. It may yield further information if dereferenced.
                type: string
                format: URI
        '500':
          description: >
            Internal Server Error If there is an application error not related
            to the client's input that cannot be easily mapped to any other HTTP
            response code ("catch all error"), the API producer shall respond
            withthis response code. The ProblemDetails structure shall be
            provided, and shall include in the "detail" attribute more
            information about the source of the problem.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              type: string
              maximum: 1
              minimum: 1
          schema:
            description: >
              The definition of the general "ProblemDetails" data structure from
              IETF RFC 7807 [19] is reproduced in this structure. Compared to
              the general framework defined in IETF RFC 7807 [19], the "status"
              and "detail" attributes are mandated to be included by the present
              document, to ensure that the response contains additional textual
              information about an error. IETF RFC 7807 [19] foresees
              extensibility of the "ProblemDetails" type. It is possible that
              particular APIs in the present document, or particular
              implementations, define extensions to define additional attributes
              that provide more information about the error. The description
              column only provides some explanation of the meaning to Facilitate
              understanding of the design. For a full description, see IETF RFC
              7807 [19].
            type: object
            required:
              - statussss
              - detail
            properties:
              type:
                description: >
                  A URI reference according to IETF RFC 3986 [5] that identifies
                  the problem type. It is encouraged that the URI provides
                  human-readable documentation for the problem (e.g. using HTML)
                  when dereferenced. When this member is not present, its value
                  is assumed to be "about:blank".
                type: string
                format: URI
              title:
                description: >
                  A short, human-readable summary of the problem type. It should
                  not change from occurrence to occurrence of the problem,
                  except for purposes of localization. If type is given and
                  other than "about:blank", this attribute shall also be
                  provided. A short, human-readable summary of the problem
                  type.  It SHOULD NOT change from occurrence to occurrence of
                  the problem, except for purposes of localization (e.g., using
                  proactive content negotiation; see [RFC7231], Section 3.4).
                type: string
              status:
                description: >
                  The HTTP status code for this occurrence of the problem. The
                  HTTP status code ([RFC7231], Section 6) generated by the
                  origin server for this occurrence of the problem.
                type: integer
              detail:
                description: >
                  A human-readable explanation specific to this occurrence of
                  the problem.
                type: string
              instance:
                description: >
                  A URI reference that identifies the specific occurrence of the
                  problem. It may yield further information if dereferenced.
                type: string
                format: URI
        '503':
          description: >
            Service Unavailable If the API producer encounters an internal
            overload situation of itself or of a system it relies on, it should
            respond with this response code, following the provisions in IETF
            RFC 7231 [13] for the use of the Retry-After HTTP header and for the
            alternative to refuse the connection. The "ProblemDetails" structure
            may be omitted.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              type: string
              maximum: 1
              minimum: 1
          schema:
            description: >
              The definition of the general "ProblemDetails" data structure from
              IETF RFC 7807 [19] is reproduced in this structure. Compared to
              the general framework defined in IETF RFC 7807 [19], the "status"
              and "detail" attributes are mandated to be included by the present
              document, to ensure that the response contains additional textual
              information about an error. IETF RFC 7807 [19] foresees
              extensibility of the "ProblemDetails" type. It is possible that
              particular APIs in the present document, or particular
              implementations, define extensions to define additional attributes
              that provide more information about the error. The description
              column only provides some explanation of the meaning to Facilitate
              understanding of the design. For a full description, see IETF RFC
              7807 [19].
            type: object
            required:
              - statussss
              - detail
            properties:
              type:
                description: >
                  A URI reference according to IETF RFC 3986 [5] that identifies
                  the problem type. It is encouraged that the URI provides
                  human-readable documentation for the problem (e.g. using HTML)
                  when dereferenced. When this member is not present, its value
                  is assumed to be "about:blank".
                type: string
                format: URI
              title:
                description: >
                  A short, human-readable summary of the problem type. It should
                  not change from occurrence to occurrence of the problem,
                  except for purposes of localization. If type is given and
                  other than "about:blank", this attribute shall also be
                  provided. A short, human-readable summary of the problem
                  type.  It SHOULD NOT change from occurrence to occurrence of
                  the problem, except for purposes of localization (e.g., using
                  proactive content negotiation; see [RFC7231], Section 3.4).
                type: string
              status:
                description: >
                  The HTTP status code for this occurrence of the problem. The
                  HTTP status code ([RFC7231], Section 6) generated by the
                  origin server for this occurrence of the problem.
                type: integer
              detail:
                description: >
                  A human-readable explanation specific to this occurrence of
                  the problem.
                type: string
              instance:
                description: >
                  A URI reference that identifies the specific occurrence of the
                  problem. It may yield further information if dereferenced.
                type: string
                format: URI
    delete:
      summary: Terminate a subscription.
      description: |
        Terminate Subscription
        This method terminates an individual subscription.
      parameters:
        - name: Authorization
          description: |
            The authorization token for the request. Reference: IETF RFC 7235
          in: header
          required: false
          type: string
        - name: Version
          description: |
            Version of the API requested to use when responding to this request.
          in: header
          required: true
          type: string
      responses:
        '204':
          description: >
            204 - No Content

            The subscription resource was deleted successfully. The response
            body shall be empty.
          headers:
            WWW-Authenticate:
              type: string
              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.
              maximum: 1
              minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              type: string
              maximum: 1
              minimum: 1
        '400':
          description: >
            Bad Request

            Error: Invalid attribute-based filtering parameters. The response
            body shall contain a ProblemDetails structure, in which the "detail"
            attribute should convey more information about the error.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              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 definition of the general "ProblemDetails" data structure from
              IETF RFC 7807 [19] is reproduced in this structure. Compared to
              the general framework defined in IETF RFC 7807 [19], the "status"
              and "detail" attributes are mandated to be included by the present
              document, to ensure that the response contains additional textual
              information about an error. IETF RFC 7807 [19] foresees
              extensibility of the "ProblemDetails" type. It is possible that
              particular APIs in the present document, or particular
              implementations, define extensions to define additional attributes
              that provide more information about the error. The description
              column only provides some explanation of the meaning to Facilitate
              understanding of the design. For a full description, see IETF RFC
              7807 [19].
            type: object
            required:
              - statussss
              - detail
            properties:
              type:
                description: >
                  A URI reference according to IETF RFC 3986 [5] that identifies
                  the problem type. It is encouraged that the URI provides
                  human-readable documentation for the problem (e.g. using HTML)
                  when dereferenced. When this member is not present, its value
                  is assumed to be "about:blank".
                type: string
                format: URI
              title:
                description: >
                  A short, human-readable summary of the problem type. It should
                  not change from occurrence to occurrence of the problem,
                  except for purposes of localization. If type is given and
                  other than "about:blank", this attribute shall also be
                  provided. A short, human-readable summary of the problem
                  type.  It SHOULD NOT change from occurrence to occurrence of
                  the problem, except for purposes of localization (e.g., using
                  proactive content negotiation; see [RFC7231], Section 3.4).
                type: string
              status:
                description: >
                  The HTTP status code for this occurrence of the problem. The
                  HTTP status code ([RFC7231], Section 6) generated by the
                  origin server for this occurrence of the problem.
                type: integer
              detail:
                description: >
                  A human-readable explanation specific to this occurrence of
                  the problem.
                type: string
              instance:
                description: >
                  A URI reference that identifies the specific occurrence of the
                  problem. It may yield further information if dereferenced.
                type: string
                format: URI
        '401':
          description: >
            Unauthorized. If the request contains no access token even though
            one is required, or if the request contains an authorization token
            that is invalid (e.g. expired or revoked), the API producer should
            respond with this response. The details of the error shall be
            returned in the WWW-Authenticate HTTP header, as defined in IETF RFC
            6750 and IETF RFC 7235. The ProblemDetails structure may be
            provided.
          headers:
            Content-Type:
              type: string
              description: The MIME type of the body of the response.
            WWW-Authenticate:
              type: string
              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.
          schema:
            description: >
              The definition of the general "ProblemDetails" data structure from
              IETF RFC 7807 [19] is reproduced in this structure. Compared to
              the general framework defined in IETF RFC 7807 [19], the "status"
              and "detail" attributes are mandated to be included by the present
              document, to ensure that the response contains additional textual
              information about an error. IETF RFC 7807 [19] foresees
              extensibility of the "ProblemDetails" type. It is possible that
              particular APIs in the present document, or particular
              implementations, define extensions to define additional attributes
              that provide more information about the error. The description
              column only provides some explanation of the meaning to Facilitate
              understanding of the design. For a full description, see IETF RFC
              7807 [19].
            type: object
            required:
              - statussss
              - detail
            properties:
              type:
                description: >
                  A URI reference according to IETF RFC 3986 [5] that identifies
                  the problem type. It is encouraged that the URI provides
                  human-readable documentation for the problem (e.g. using HTML)
                  when dereferenced. When this member is not present, its value
                  is assumed to be "about:blank".
                type: string
                format: URI
              title:
                description: >
                  A short, human-readable summary of the problem type. It should
                  not change from occurrence to occurrence of the problem,
                  except for purposes of localization. If type is given and
                  other than "about:blank", this attribute shall also be
                  provided. A short, human-readable summary of the problem
                  type.  It SHOULD NOT change from occurrence to occurrence of
                  the problem, except for purposes of localization (e.g., using
                  proactive content negotiation; see [RFC7231], Section 3.4).
                type: string
              status:
                description: >
                  The HTTP status code for this occurrence of the problem. The
                  HTTP status code ([RFC7231], Section 6) generated by the
                  origin server for this occurrence of the problem.
                type: integer
              detail:
                description: >
                  A human-readable explanation specific to this occurrence of
                  the problem.
                type: string
              instance:
                description: >
                  A URI reference that identifies the specific occurrence of the
                  problem. It may yield further information if dereferenced.
                type: string
                format: URI
        '403':
          description: >
            Forbidden If the API consumer is not allowed to perform a particular
            request to a particular resource, the API producer shall respond
            with this response code. The "ProblemDetails" structure shall be
            provided. It should include in the "detail" attribute information
            about the source of the problem, and may indicate how to solve it.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              type: string
              maximum: 1
              minimum: 1
          schema:
            description: >
              The definition of the general "ProblemDetails" data structure from
              IETF RFC 7807 [19] is reproduced in this structure. Compared to
              the general framework defined in IETF RFC 7807 [19], the "status"
              and "detail" attributes are mandated to be included by the present
              document, to ensure that the response contains additional textual
              information about an error. IETF RFC 7807 [19] foresees
              extensibility of the "ProblemDetails" type. It is possible that
              particular APIs in the present document, or particular
              implementations, define extensions to define additional attributes
              that provide more information about the error. The description
              column only provides some explanation of the meaning to Facilitate
              understanding of the design. For a full description, see IETF RFC
              7807 [19].
            type: object
            required:
              - statussss
              - detail
            properties:
              type:
                description: >
                  A URI reference according to IETF RFC 3986 [5] that identifies
                  the problem type. It is encouraged that the URI provides
                  human-readable documentation for the problem (e.g. using HTML)
                  when dereferenced. When this member is not present, its value
                  is assumed to be "about:blank".
                type: string
                format: URI
              title:
                description: >
                  A short, human-readable summary of the problem type. It should
                  not change from occurrence to occurrence of the problem,
                  except for purposes of localization. If type is given and
                  other than "about:blank", this attribute shall also be
                  provided. A short, human-readable summary of the problem
                  type.  It SHOULD NOT change from occurrence to occurrence of
                  the problem, except for purposes of localization (e.g., using
                  proactive content negotiation; see [RFC7231], Section 3.4).
                type: string
              status:
                description: >
                  The HTTP status code for this occurrence of the problem. The
                  HTTP status code ([RFC7231], Section 6) generated by the
                  origin server for this occurrence of the problem.
                type: integer
              detail:
                description: >
                  A human-readable explanation specific to this occurrence of
                  the problem.
                type: string
              instance:
                description: >
                  A URI reference that identifies the specific occurrence of the
                  problem. It may yield further information if dereferenced.
                type: string
                format: URI
        '405':
          description: >
            Method Not Allowed If a particular HTTP method is not supported for
            a particular resource, the API producer shall respond with this
            response code. The "ProblemDetails" structure may be omitted in that
            case.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              type: string
              maximum: 1
              minimum: 1
          schema:
            description: >
              The definition of the general "ProblemDetails" data structure from
              IETF RFC 7807 [19] is reproduced in this structure. Compared to
              the general framework defined in IETF RFC 7807 [19], the "status"
              and "detail" attributes are mandated to be included by the present
              document, to ensure that the response contains additional textual
              information about an error. IETF RFC 7807 [19] foresees
              extensibility of the "ProblemDetails" type. It is possible that
              particular APIs in the present document, or particular
              implementations, define extensions to define additional attributes
              that provide more information about the error. The description
              column only provides some explanation of the meaning to Facilitate
              understanding of the design. For a full description, see IETF RFC
              7807 [19].
            type: object
            required:
              - statussss
              - detail
            properties:
              type:
                description: >
                  A URI reference according to IETF RFC 3986 [5] that identifies
                  the problem type. It is encouraged that the URI provides
                  human-readable documentation for the problem (e.g. using HTML)
                  when dereferenced. When this member is not present, its value
                  is assumed to be "about:blank".
                type: string
                format: URI
              title:
                description: >
                  A short, human-readable summary of the problem type. It should
                  not change from occurrence to occurrence of the problem,
                  except for purposes of localization. If type is given and
                  other than "about:blank", this attribute shall also be
                  provided. A short, human-readable summary of the problem
                  type.  It SHOULD NOT change from occurrence to occurrence of
                  the problem, except for purposes of localization (e.g., using
                  proactive content negotiation; see [RFC7231], Section 3.4).
                type: string
              status:
                description: >
                  The HTTP status code for this occurrence of the problem. The
                  HTTP status code ([RFC7231], Section 6) generated by the
                  origin server for this occurrence of the problem.
                type: integer
              detail:
                description: >
                  A human-readable explanation specific to this occurrence of
                  the problem.
                type: string
              instance:
                description: >
                  A URI reference that identifies the specific occurrence of the
                  problem. It may yield further information if dereferenced.
                type: string
                format: URI
        '406':
          description: >
            If the "Accept" header does not contain at least one name of a
            content type for which the NFVO can provide a representation of the
            NSD, the NFVO shall respond with this response code. The
            "ProblemDetails" structure may be included with the "detail"
            attribute providing more information about the error.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              type: string
              maximum: 1
              minimum: 1
          schema:
            description: >
              The definition of the general "ProblemDetails" data structure from
              IETF RFC 7807 [19] is reproduced in this structure. Compared to
              the general framework defined in IETF RFC 7807 [19], the "status"
              and "detail" attributes are mandated to be included by the present
              document, to ensure that the response contains additional textual
              information about an error. IETF RFC 7807 [19] foresees
              extensibility of the "ProblemDetails" type. It is possible that
              particular APIs in the present document, or particular
              implementations, define extensions to define additional attributes
              that provide more information about the error. The description
              column only provides some explanation of the meaning to Facilitate
              understanding of the design. For a full description, see IETF RFC
              7807 [19].
            type: object
            required:
              - statussss
              - detail
            properties:
              type:
                description: >
                  A URI reference according to IETF RFC 3986 [5] that identifies
                  the problem type. It is encouraged that the URI provides
                  human-readable documentation for the problem (e.g. using HTML)
                  when dereferenced. When this member is not present, its value
                  is assumed to be "about:blank".
                type: string
                format: URI
              title:
                description: >
                  A short, human-readable summary of the problem type. It should
                  not change from occurrence to occurrence of the problem,
                  except for purposes of localization. If type is given and
                  other than "about:blank", this attribute shall also be
                  provided. A short, human-readable summary of the problem
                  type.  It SHOULD NOT change from occurrence to occurrence of
                  the problem, except for purposes of localization (e.g., using
                  proactive content negotiation; see [RFC7231], Section 3.4).
                type: string
              status:
                description: >
                  The HTTP status code for this occurrence of the problem. The
                  HTTP status code ([RFC7231], Section 6) generated by the
                  origin server for this occurrence of the problem.
                type: integer
              detail:
                description: >
                  A human-readable explanation specific to this occurrence of
                  the problem.
                type: string
              instance:
                description: >
                  A URI reference that identifies the specific occurrence of the
                  problem. It may yield further information if dereferenced.
                type: string
                format: URI
        '500':
          description: >
            Internal Server Error If there is an application error not related
            to the client's input that cannot be easily mapped to any other HTTP
            response code ("catch all error"), the API producer shall respond
            withthis response code. The ProblemDetails structure shall be
            provided, and shall include in the "detail" attribute more
            information about the source of the problem.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              type: string
              maximum: 1
              minimum: 1
          schema:
            description: >
              The definition of the general "ProblemDetails" data structure from
              IETF RFC 7807 [19] is reproduced in this structure. Compared to
              the general framework defined in IETF RFC 7807 [19], the "status"
              and "detail" attributes are mandated to be included by the present
              document, to ensure that the response contains additional textual
              information about an error. IETF RFC 7807 [19] foresees
              extensibility of the "ProblemDetails" type. It is possible that
              particular APIs in the present document, or particular
              implementations, define extensions to define additional attributes
              that provide more information about the error. The description
              column only provides some explanation of the meaning to Facilitate
              understanding of the design. For a full description, see IETF RFC
              7807 [19].
            type: object
            required:
              - statussss
              - detail
            properties:
              type:
                description: >
                  A URI reference according to IETF RFC 3986 [5] that identifies
                  the problem type. It is encouraged that the URI provides
                  human-readable documentation for the problem (e.g. using HTML)
                  when dereferenced. When this member is not present, its value
                  is assumed to be "about:blank".
                type: string
                format: URI
              title:
                description: >
                  A short, human-readable summary of the problem type. It should
                  not change from occurrence to occurrence of the problem,
                  except for purposes of localization. If type is given and
                  other than "about:blank", this attribute shall also be
                  provided. A short, human-readable summary of the problem
                  type.  It SHOULD NOT change from occurrence to occurrence of
                  the problem, except for purposes of localization (e.g., using
                  proactive content negotiation; see [RFC7231], Section 3.4).
                type: string
              status:
                description: >
                  The HTTP status code for this occurrence of the problem. The
                  HTTP status code ([RFC7231], Section 6) generated by the
                  origin server for this occurrence of the problem.
                type: integer
              detail:
                description: >
                  A human-readable explanation specific to this occurrence of
                  the problem.
                type: string
              instance:
                description: >
                  A URI reference that identifies the specific occurrence of the
                  problem. It may yield further information if dereferenced.
                type: string
                format: URI
        '503':
          description: >
            Service Unavailable If the API producer encounters an internal
            overload situation of itself or of a system it relies on, it should
            respond with this response code, following the provisions in IETF
            RFC 7231 [13] for the use of the Retry-After HTTP header and for the
            alternative to refuse the connection. The "ProblemDetails" structure
            may be omitted.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              type: string
              maximum: 1
              minimum: 1
          schema:
            description: >
              The definition of the general "ProblemDetails" data structure from
              IETF RFC 7807 [19] is reproduced in this structure. Compared to
              the general framework defined in IETF RFC 7807 [19], the "status"
              and "detail" attributes are mandated to be included by the present
              document, to ensure that the response contains additional textual
              information about an error. IETF RFC 7807 [19] foresees
              extensibility of the "ProblemDetails" type. It is possible that
              particular APIs in the present document, or particular
              implementations, define extensions to define additional attributes
              that provide more information about the error. The description
              column only provides some explanation of the meaning to Facilitate
              understanding of the design. For a full description, see IETF RFC
              7807 [19].
            type: object
            required:
              - statussss
              - detail
            properties:
              type:
                description: >
                  A URI reference according to IETF RFC 3986 [5] that identifies
                  the problem type. It is encouraged that the URI provides
                  human-readable documentation for the problem (e.g. using HTML)
                  when dereferenced. When this member is not present, its value
                  is assumed to be "about:blank".
                type: string
                format: URI
              title:
                description: >
                  A short, human-readable summary of the problem type. It should
                  not change from occurrence to occurrence of the problem,
                  except for purposes of localization. If type is given and
                  other than "about:blank", this attribute shall also be
                  provided. A short, human-readable summary of the problem
                  type.  It SHOULD NOT change from occurrence to occurrence of
                  the problem, except for purposes of localization (e.g., using
                  proactive content negotiation; see [RFC7231], Section 3.4).
                type: string
              status:
                description: >
                  The HTTP status code for this occurrence of the problem. The
                  HTTP status code ([RFC7231], Section 6) generated by the
                  origin server for this occurrence of the problem.
                type: integer
              detail:
                description: >
                  A human-readable explanation specific to this occurrence of
                  the problem.
                type: string
              instance:
                description: >
                  A URI reference that identifies the specific occurrence of the
                  problem. It may yield further information if dereferenced.
                type: string
                format: URI
  /URI_is_provided_by_the_client_when_creating_the_subscription-AlarmNotification:
    post:
      summary: Notify about NS alarms
      description: >
        The POST method notifies an alarm related to a NS or that the alarm list
        has been rebuilt.
      parameters:
        - name: alarmNotification
          description: |
            Information of a NS alarm.
          in: body
          required: true
          schema:
            properties:
              AlarmNotification:
                description: |
                  This type represents an alarm notification about NS faults.
                type: object
                required:
                  - id
                  - notificationType
                  - subscriptionId
                  - timeStamp
                  - alarm
                  - _links
                properties:
                  id:
                    description: |
                      An identifier with the intention of being globally unique.
                    type: string
                  notificationType:
                    description: >
                      Discriminator for the different notification types. Shall
                      be set to "AlarmNotification" for this notification type.
                    type: string
                    enum:
                      - AlarmClearedNotification
                  subscriptionId:
                    description: |
                      An identifier with the intention of being globally unique.
                    type: string
                  timeStamp:
                    description: >
                      Date-time stamp. Representation: String formatted
                      according to IETF RFC 3339.
                    type: string
                    format: date-time
                  alarm:
                    description: >
                      The alarm data type encapsulates information about an
                      alarm. It shall comply with the provisions defined in
                      Table 8.5.2.4-1
                    type: object
                    required:
                      - id
                      - managedObjectId
                      - alarmRaisedTime
                      - rootCauseFaultyComponent
                      - 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
                      rootCauseFaultyComponent:
                        description: >
                          This type represents the faulty component that has a
                          negative impact on an NS.  It shall comply with the
                          provisions defined in Table 8.5.3.4-1.
                        type: object
                        properties:
                          faultyNestedNsInstanceId:
                            description: >
                              An identifier with the intention of being globally
                              unique.
                            type: string
                          faultyResourceType:
                            description: >
                              An identifier with the intention of being globally
                              unique.
                            type: string
                          faultyNsVirtualLinkInstanceId:
                            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 NS.
                        type: object
                        required:
                          - faultyResource
                          - faultyResourceType
                        properties:
                          faultyResource:
                            required:
                              - resourceId
                            type: object
                            description: >
                              This type represents the information that allows
                              addressing a virtualised resource that is used by
                              a VNF instance or by an NS instance. Information
                              about the resource is available from the VIM. The
                              ResourceHandle type shall comply with the
                              provisions defined in Table 6.5.3.54-1..
                            properties:
                              vimId:
                                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. Acceptable values
                              are: - COMPUTE - Virtual compute resource. -
                              STORAGE - Virtual storage resource. - NETWORK -
                              Virtual network 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: >
                          Acknowledgment state of the alarm. Permitted values:
                          UNACKNOWLEDGED ACKNOWLEDGED
                        type: string
                        enum:
                          - UNACKNOWLEDGED
                          - ACKNOWLEDGED
                      perceivedSeverity:
                        description: >
                          Indicates the relative level of urgency for operator
                          attention. * CRITICAL: The Critical severity level
                          indicates that a service
                            affecting condition has occurred and an immediate corrective action
                            is required. Such a severity can be reported, for example, when a
                            managed object becomes totally out of service and its capability needs
                            to be restored (ITU-T Recommendation X.733).
                          * MAJOR: The Major severity level indicates that a
                          service affecting
                            condition has developed and an urgent corrective action is required.
                            Such a severity can be reported, for example, when there is a severe
                            degradation in the capability of the managed object and its full
                            capability needs to be restored (ITU-T Recommendation X.733).
                          * MINOR: The Minor severity level indicates the
                          existence of a
                            non-service affecting fault condition and that corrective action
                            should be taken in order to prevent a more serious (for example,
                            service affecting) fault. Such a severity can be reported, for
                            example, when the detected alarm condition is not currently degrading
                            the capacity of the managed object (ITU-T Recommendation X.733).
                          * WARNING: The Warning severity level indicates the
                          detection of a
                            potential or impending service affecting fault, before any significant
                            effects have been felt. Action should be taken to further diagnose (if
                            necessary) and correct the problem in order to prevent it from
                            becoming a more serious service affecting fault (ITU-T Recommendation
                            X.733).
                          * INDETERMINATE: The Indeterminate severity level
                          indicates that the
                            severity level cannot be determined (ITU-T Recommendation X.733).
                          * CLEARED: The Cleared severity level indicates the
                          clearing of one or
                            more previously reported alarms. This alarm clears all alarms for this
                            managed object that have the same Alarm type, Probable cause and
                            Specific problems (if given) (ITU-T Recommendation X.733).
                        type: string
                        enum:
                          - CRITICAL
                          - MAJOR
                          - MINOR
                          - WARNING
                          - INDETERMINATE
                          - CLEARED
                      eventTime:
                        description: >
                          Date-time stamp. Representation: String formatted
                          according to IETF RFC 3339.
                        type: string
                        format: date-time
                      eventType:
                        description: >
                          The enumeration EventType represents those types of
                          events that trigger an alarm. - COMMUNICATIONS_ALARM:
                          An alarm of this type is associated with the
                            procedure and/or process required conveying information from one point
                            to another (ITU-T Recommendation X.733).
                          - PROCESSING_ERROR_ALARM: An alarm of this type is
                          associated with a
                            software or processing fault (ITU-T Recommendation X.733).
                          - ENVIRONMENTAL_ALARM: An alarm of this type is
                          associated with a
                            condition related to an enclosure in which the equipment resides
                            (ITU-T Recommendation X.733).
                          - QOS_ALARM: An alarm of this type is associated with
                          degradation in the
                            quality of a service (ITU-T Recommendation X.733).
                          - EQUIPMENT_ALARM: An alarm of this type is associated
                          with an equipment
                            fault (ITU-T Recommendation X.733).
                        type: string
                        enum:
                          - COMMUNICATIONS_ALARM
                          - PROCESSING_ERROR_ALARM
                          - ENVIRONMENTAL_ALARM
                          - QOS_ALARM
                          - EQUIPMENT_ALARM
                      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.
                        type: boolean
                      correlatedAlarmIds:
                        description: >
                          List of identifiers of other alarms correlated to this
                          fault.
                        type: array
                        items:
                          description: >
                            An identifier with the intention of being globally
                            unique.
                          type: string
                      faultDetails:
                        description: |
                          Provides additional information about the fault..
                        type: string
                      _links:
                        description: |
                          Links for this resource.
                        type: object
                        required:
                          - self
                        properties:
                          self:
                            description: |
                              This type represents a link to a resource.
                            type: object
                            required:
                              - href
                            properties:
                              href:
                                description: |
                                  URI of the referenced resource.
                                type: string
                                format: url
                  alarmClearedTime:
                    description: |
                      The time stamp indicating when the alarm was cleared.
                  _links:
                    description: |
                      Links to resources related to this notification.
                    type: object
                    required:
                      - subscription
                      - alarm
                    properties:
                      subscription:
                        description: |
                          This type represents a link to a resource.
                        type: object
                        required:
                          - href
                        properties:
                          href:
                            description: |
                              URI of the referenced resource.
                            type: string
                            format: url
                      alarm:
                        description: |
                          This type represents a link to a resource.
                        type: object
                        required:
                          - href
                        properties:
                          href:
                            description: |
                              URI of the referenced resource.
                            type: string
                            format: url
        - name: Accept
          description: >
            Content-Types that are acceptable for the response. 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: false
          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: Version
          description: |
            Version of the API requested to use when responding to this request.
          in: header
          required: true
          type: string
      responses:
        '204':
          description: >
            204 No Content

            The notification was delivered successfully. The response body shall
            be empty.        
          headers:
            WWW-Authenticate:
              type: string
              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.
              maximum: 1
              minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              type: string
              maximum: 1
              minimum: 1
        '400':
          description: >
            Bad Request

            Error: Invalid attribute-based filtering parameters. The response
            body shall contain a ProblemDetails structure, in which the "detail"
            attribute should convey more information about the error.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              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 definition of the general "ProblemDetails" data structure from
              IETF RFC 7807 [19] is reproduced in this structure. Compared to
              the general framework defined in IETF RFC 7807 [19], the "status"
              and "detail" attributes are mandated to be included by the present
              document, to ensure that the response contains additional textual
              information about an error. IETF RFC 7807 [19] foresees
              extensibility of the "ProblemDetails" type. It is possible that
              particular APIs in the present document, or particular
              implementations, define extensions to define additional attributes
              that provide more information about the error. The description
              column only provides some explanation of the meaning to Facilitate
              understanding of the design. For a full description, see IETF RFC
              7807 [19].
            type: object
            required:
              - statussss
              - detail
            properties:
              type:
                description: >
                  A URI reference according to IETF RFC 3986 [5] that identifies
                  the problem type. It is encouraged that the URI provides
                  human-readable documentation for the problem (e.g. using HTML)
                  when dereferenced. When this member is not present, its value
                  is assumed to be "about:blank".
                type: string
                format: URI
              title:
                description: >
                  A short, human-readable summary of the problem type. It should
                  not change from occurrence to occurrence of the problem,
                  except for purposes of localization. If type is given and
                  other than "about:blank", this attribute shall also be
                  provided. A short, human-readable summary of the problem
                  type.  It SHOULD NOT change from occurrence to occurrence of
                  the problem, except for purposes of localization (e.g., using
                  proactive content negotiation; see [RFC7231], Section 3.4).
                type: string
              status:
                description: >
                  The HTTP status code for this occurrence of the problem. The
                  HTTP status code ([RFC7231], Section 6) generated by the
                  origin server for this occurrence of the problem.
                type: integer
              detail:
                description: >
                  A human-readable explanation specific to this occurrence of
                  the problem.
                type: string
              instance:
                description: >
                  A URI reference that identifies the specific occurrence of the
                  problem. It may yield further information if dereferenced.
                type: string
                format: URI
        '401':
          description: >
            Unauthorized. If the request contains no access token even though
            one is required, or if the request contains an authorization token
            that is invalid (e.g. expired or revoked), the API producer should
            respond with this response. The details of the error shall be
            returned in the WWW-Authenticate HTTP header, as defined in IETF RFC
            6750 and IETF RFC 7235. The ProblemDetails structure may be
            provided.
          headers:
            Content-Type:
              type: string
              description: The MIME type of the body of the response.
            WWW-Authenticate:
              type: string
              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.
          schema:
            description: >
              The definition of the general "ProblemDetails" data structure from
              IETF RFC 7807 [19] is reproduced in this structure. Compared to
              the general framework defined in IETF RFC 7807 [19], the "status"
              and "detail" attributes are mandated to be included by the present
              document, to ensure that the response contains additional textual
              information about an error. IETF RFC 7807 [19] foresees
              extensibility of the "ProblemDetails" type. It is possible that
              particular APIs in the present document, or particular
              implementations, define extensions to define additional attributes
              that provide more information about the error. The description
              column only provides some explanation of the meaning to Facilitate
              understanding of the design. For a full description, see IETF RFC
              7807 [19].
            type: object
            required:
              - statussss
              - detail
            properties:
              type:
                description: >
                  A URI reference according to IETF RFC 3986 [5] that identifies
                  the problem type. It is encouraged that the URI provides
                  human-readable documentation for the problem (e.g. using HTML)
                  when dereferenced. When this member is not present, its value
                  is assumed to be "about:blank".
                type: string
                format: URI
              title:
                description: >
                  A short, human-readable summary of the problem type. It should
                  not change from occurrence to occurrence of the problem,
                  except for purposes of localization. If type is given and
                  other than "about:blank", this attribute shall also be
                  provided. A short, human-readable summary of the problem
                  type.  It SHOULD NOT change from occurrence to occurrence of
                  the problem, except for purposes of localization (e.g., using
                  proactive content negotiation; see [RFC7231], Section 3.4).
                type: string
              status:
                description: >
                  The HTTP status code for this occurrence of the problem. The
                  HTTP status code ([RFC7231], Section 6) generated by the
                  origin server for this occurrence of the problem.
                type: integer
              detail:
                description: >
                  A human-readable explanation specific to this occurrence of
                  the problem.
                type: string
              instance:
                description: >
                  A URI reference that identifies the specific occurrence of the
                  problem. It may yield further information if dereferenced.
                type: string
                format: URI
        '403':
          description: >
            Forbidden If the API consumer is not allowed to perform a particular
            request to a particular resource, the API producer shall respond
            with this response code. The "ProblemDetails" structure shall be
            provided. It should include in the "detail" attribute information
            about the source of the problem, and may indicate how to solve it.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              type: string
              maximum: 1
              minimum: 1
          schema:
            description: >
              The definition of the general "ProblemDetails" data structure from
              IETF RFC 7807 [19] is reproduced in this structure. Compared to
              the general framework defined in IETF RFC 7807 [19], the "status"
              and "detail" attributes are mandated to be included by the present
              document, to ensure that the response contains additional textual
              information about an error. IETF RFC 7807 [19] foresees
              extensibility of the "ProblemDetails" type. It is possible that
              particular APIs in the present document, or particular
              implementations, define extensions to define additional attributes
              that provide more information about the error. The description
              column only provides some explanation of the meaning to Facilitate
              understanding of the design. For a full description, see IETF RFC
              7807 [19].
            type: object
            required:
              - statussss
              - detail
            properties:
              type:
                description: >
                  A URI reference according to IETF RFC 3986 [5] that identifies
                  the problem type. It is encouraged that the URI provides
                  human-readable documentation for the problem (e.g. using HTML)
                  when dereferenced. When this member is not present, its value
                  is assumed to be "about:blank".
                type: string
                format: URI
              title:
                description: >
                  A short, human-readable summary of the problem type. It should
                  not change from occurrence to occurrence of the problem,
                  except for purposes of localization. If type is given and
                  other than "about:blank", this attribute shall also be
                  provided. A short, human-readable summary of the problem
                  type.  It SHOULD NOT change from occurrence to occurrence of
                  the problem, except for purposes of localization (e.g., using
                  proactive content negotiation; see [RFC7231], Section 3.4).
                type: string
              status:
                description: >
                  The HTTP status code for this occurrence of the problem. The
                  HTTP status code ([RFC7231], Section 6) generated by the
                  origin server for this occurrence of the problem.
                type: integer
              detail:
                description: >
                  A human-readable explanation specific to this occurrence of
                  the problem.
                type: string
              instance:
                description: >
                  A URI reference that identifies the specific occurrence of the
                  problem. It may yield further information if dereferenced.
                type: string
                format: URI
        '500':
          description: >
            Internal Server Error If there is an application error not related
            to the client's input that cannot be easily mapped to any other HTTP
            response code ("catch all error"), the API producer shall respond
            withthis response code. The ProblemDetails structure shall be
            provided, and shall include in the "detail" attribute more
            information about the source of the problem.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              type: string
              maximum: 1
              minimum: 1
          schema:
            description: >
              The definition of the general "ProblemDetails" data structure from
              IETF RFC 7807 [19] is reproduced in this structure. Compared to
              the general framework defined in IETF RFC 7807 [19], the "status"
              and "detail" attributes are mandated to be included by the present
              document, to ensure that the response contains additional textual
              information about an error. IETF RFC 7807 [19] foresees
              extensibility of the "ProblemDetails" type. It is possible that
              particular APIs in the present document, or particular
              implementations, define extensions to define additional attributes
              that provide more information about the error. The description
              column only provides some explanation of the meaning to Facilitate
              understanding of the design. For a full description, see IETF RFC
              7807 [19].
            type: object
            required:
              - statussss
              - detail
            properties:
              type:
                description: >
                  A URI reference according to IETF RFC 3986 [5] that identifies
                  the problem type. It is encouraged that the URI provides
                  human-readable documentation for the problem (e.g. using HTML)
                  when dereferenced. When this member is not present, its value
                  is assumed to be "about:blank".
                type: string
                format: URI
              title:
                description: >
                  A short, human-readable summary of the problem type. It should
                  not change from occurrence to occurrence of the problem,
                  except for purposes of localization. If type is given and
                  other than "about:blank", this attribute shall also be
                  provided. A short, human-readable summary of the problem
                  type.  It SHOULD NOT change from occurrence to occurrence of
                  the problem, except for purposes of localization (e.g., using
                  proactive content negotiation; see [RFC7231], Section 3.4).
                type: string
              status:
                description: >
                  The HTTP status code for this occurrence of the problem. The
                  HTTP status code ([RFC7231], Section 6) generated by the
                  origin server for this occurrence of the problem.
                type: integer
              detail:
                description: >
                  A human-readable explanation specific to this occurrence of
                  the problem.
                type: string
              instance:
                description: >
                  A URI reference that identifies the specific occurrence of the
                  problem. It may yield further information if dereferenced.
                type: string
                format: URI
        '503':
          description: >
            Service Unavailable If the API producer encounters an internal
            overload situation of itself or of a system it relies on, it should
            respond with this response code, following the provisions in IETF
            RFC 7231 [13] for the use of the Retry-After HTTP header and for the
            alternative to refuse the connection. The "ProblemDetails" structure
            may be omitted.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              type: string
              maximum: 1
              minimum: 1
          schema:
            description: >
              The definition of the general "ProblemDetails" data structure from
              IETF RFC 7807 [19] is reproduced in this structure. Compared to
              the general framework defined in IETF RFC 7807 [19], the "status"
              and "detail" attributes are mandated to be included by the present
              document, to ensure that the response contains additional textual
              information about an error. IETF RFC 7807 [19] foresees
              extensibility of the "ProblemDetails" type. It is possible that
              particular APIs in the present document, or particular
              implementations, define extensions to define additional attributes
              that provide more information about the error. The description
              column only provides some explanation of the meaning to Facilitate
              understanding of the design. For a full description, see IETF RFC
              7807 [19].
            type: object
            required:
              - statussss
              - detail
            properties:
              type:
                description: >
                  A URI reference according to IETF RFC 3986 [5] that identifies
                  the problem type. It is encouraged that the URI provides
                  human-readable documentation for the problem (e.g. using HTML)
                  when dereferenced. When this member is not present, its value
                  is assumed to be "about:blank".
                type: string
                format: URI
              title:
                description: >
                  A short, human-readable summary of the problem type. It should
                  not change from occurrence to occurrence of the problem,
                  except for purposes of localization. If type is given and
                  other than "about:blank", this attribute shall also be
                  provided. A short, human-readable summary of the problem
                  type.  It SHOULD NOT change from occurrence to occurrence of
                  the problem, except for purposes of localization (e.g., using
                  proactive content negotiation; see [RFC7231], Section 3.4).
                type: string
              status:
                description: >
                  The HTTP status code for this occurrence of the problem. The
                  HTTP status code ([RFC7231], Section 6) generated by the
                  origin server for this occurrence of the problem.
                type: integer
              detail:
                description: >
                  A human-readable explanation specific to this occurrence of
                  the problem.
                type: string
              instance:
                description: >
                  A URI reference that identifies the specific occurrence of the
                  problem. It may yield further information if dereferenced.
                type: string
                format: URI
  /URI_is_provided_by_the_client_when_creating_the_subscription-AlarmClearedNotification:
    post:
      summary: Notify about NS alarms
      description: >
        The POST method notifies an alarm related to a NS or that the alarm list
        has been rebuilt.
      parameters:
        - name: alarmClearedNotification
          description: |
            Information of the clearance of a NS alarm.
          in: body
          required: true
          schema:
            properties:
              AlarmClearedNotification:
                description: >
                  This type represents an alarm cleared notification about VNF
                  faults. The notification shall be triggered by the VNFM when
                  an alarm has been cleared.
                type: object
                required:
                  - id
                  - notificationType
                  - subscriptionId
                  - timeStamp
                  - alarmId
                  - alarmClearedTime
                  - _links
                properties:
                  id:
                    description: |
                      An identifier with the intention of being globally unique.
                    type: string
                  notificationType:
                    description: >
                      Discriminator for the different notification types. Shall
                      be set to "AlarmClearedNotification" for this notification
                      type.
                    type: string
                    enum:
                      - AlarmClearedNotification
                  subscriptionId:
                    description: |
                      An identifier with the intention of being globally unique.
                    type: string
                  timeStamp:
                    description: >
                      Date-time stamp. Representation: String formatted
                      according to IETF RFC 3339.
                    type: string
                    format: date-time
                  alarmId:
                    description: |
                      An identifier with the intention of being globally unique.
                    type: string
                  alarmClearedTime:
                    description: |
                      The time stamp indicating when the alarm was cleared.
                  _links:
                    description: |
                      Links to resources related to this notification.
                    type: object
                    required:
                      - subscription
                      - alarm
                    properties:
                      subscription:
                        description: |
                          This type represents a link to a resource.
                        type: object
                        required:
                          - href
                        properties:
                          href:
                            description: |
                              URI of the referenced resource.
                            type: string
                            format: url
                      alarm:
                        description: |
                          This type represents a link to a resource.
                        type: object
                        required:
                          - href
                        properties:
                          href:
                            description: |
                              URI of the referenced resource.
                            type: string
                            format: url
        - name: Accept
          description: >
            Content-Types that are acceptable for the response. 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: false
          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: Version
          description: |
            Version of the API requested to use when responding to this request.
          in: header
          required: true
          type: string
      responses:
        '204':
          description: >
            204 No Content

            The notification was delivered successfully. The response body shall
            be empty.
          headers:
            WWW-Authenticate:
              type: string
              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.
              maximum: 1
              minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              type: string
              maximum: 1
              minimum: 1
        '400':
          description: >
            Bad Request

            Error: Invalid attribute-based filtering parameters. The response
            body shall contain a ProblemDetails structure, in which the "detail"
            attribute should convey more information about the error.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              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 definition of the general "ProblemDetails" data structure from
              IETF RFC 7807 [19] is reproduced in this structure. Compared to
              the general framework defined in IETF RFC 7807 [19], the "status"
              and "detail" attributes are mandated to be included by the present
              document, to ensure that the response contains additional textual
              information about an error. IETF RFC 7807 [19] foresees
              extensibility of the "ProblemDetails" type. It is possible that
              particular APIs in the present document, or particular
              implementations, define extensions to define additional attributes
              that provide more information about the error. The description
              column only provides some explanation of the meaning to Facilitate
              understanding of the design. For a full description, see IETF RFC
              7807 [19].
            type: object
            required:
              - statussss
              - detail
            properties:
              type:
                description: >
                  A URI reference according to IETF RFC 3986 [5] that identifies
                  the problem type. It is encouraged that the URI provides
                  human-readable documentation for the problem (e.g. using HTML)
                  when dereferenced. When this member is not present, its value
                  is assumed to be "about:blank".
                type: string
                format: URI
              title:
                description: >
                  A short, human-readable summary of the problem type. It should
                  not change from occurrence to occurrence of the problem,
                  except for purposes of localization. If type is given and
                  other than "about:blank", this attribute shall also be
                  provided. A short, human-readable summary of the problem
                  type.  It SHOULD NOT change from occurrence to occurrence of
                  the problem, except for purposes of localization (e.g., using
                  proactive content negotiation; see [RFC7231], Section 3.4).
                type: string
              status:
                description: >
                  The HTTP status code for this occurrence of the problem. The
                  HTTP status code ([RFC7231], Section 6) generated by the
                  origin server for this occurrence of the problem.
                type: integer
              detail:
                description: >
                  A human-readable explanation specific to this occurrence of
                  the problem.
                type: string
              instance:
                description: >
                  A URI reference that identifies the specific occurrence of the
                  problem. It may yield further information if dereferenced.
                type: string
                format: URI
        '401':
          description: >
            Unauthorized. If the request contains no access token even though
            one is required, or if the request contains an authorization token
            that is invalid (e.g. expired or revoked), the API producer should
            respond with this response. The details of the error shall be
            returned in the WWW-Authenticate HTTP header, as defined in IETF RFC
            6750 and IETF RFC 7235. The ProblemDetails structure may be
            provided.
          headers:
            Content-Type:
              type: string
              description: The MIME type of the body of the response.
            WWW-Authenticate:
              type: string
              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.
          schema:
            description: >
              The definition of the general "ProblemDetails" data structure from
              IETF RFC 7807 [19] is reproduced in this structure. Compared to
              the general framework defined in IETF RFC 7807 [19], the "status"
              and "detail" attributes are mandated to be included by the present
              document, to ensure that the response contains additional textual
              information about an error. IETF RFC 7807 [19] foresees
              extensibility of the "ProblemDetails" type. It is possible that
              particular APIs in the present document, or particular
              implementations, define extensions to define additional attributes
              that provide more information about the error. The description
              column only provides some explanation of the meaning to Facilitate
              understanding of the design. For a full description, see IETF RFC
              7807 [19].
            type: object
            required:
              - statussss
              - detail
            properties:
              type:
                description: >
                  A URI reference according to IETF RFC 3986 [5] that identifies
                  the problem type. It is encouraged that the URI provides
                  human-readable documentation for the problem (e.g. using HTML)
                  when dereferenced. When this member is not present, its value
                  is assumed to be "about:blank".
                type: string
                format: URI
              title:
                description: >
                  A short, human-readable summary of the problem type. It should
                  not change from occurrence to occurrence of the problem,
                  except for purposes of localization. If type is given and
                  other than "about:blank", this attribute shall also be
                  provided. A short, human-readable summary of the problem
                  type.  It SHOULD NOT change from occurrence to occurrence of
                  the problem, except for purposes of localization (e.g., using
                  proactive content negotiation; see [RFC7231], Section 3.4).
                type: string
              status:
                description: >
                  The HTTP status code for this occurrence of the problem. The
                  HTTP status code ([RFC7231], Section 6) generated by the
                  origin server for this occurrence of the problem.
                type: integer
              detail:
                description: >
                  A human-readable explanation specific to this occurrence of
                  the problem.
                type: string
              instance:
                description: >
                  A URI reference that identifies the specific occurrence of the
                  problem. It may yield further information if dereferenced.
                type: string
                format: URI
        '403':
          description: >
            Forbidden If the API consumer is not allowed to perform a particular
            request to a particular resource, the API producer shall respond
            with this response code. The "ProblemDetails" structure shall be
            provided. It should include in the "detail" attribute information
            about the source of the problem, and may indicate how to solve it.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              type: string
              maximum: 1
              minimum: 1
          schema:
            description: >
              The definition of the general "ProblemDetails" data structure from
              IETF RFC 7807 [19] is reproduced in this structure. Compared to
              the general framework defined in IETF RFC 7807 [19], the "status"
              and "detail" attributes are mandated to be included by the present
              document, to ensure that the response contains additional textual
              information about an error. IETF RFC 7807 [19] foresees
              extensibility of the "ProblemDetails" type. It is possible that
              particular APIs in the present document, or particular
              implementations, define extensions to define additional attributes
              that provide more information about the error. The description
              column only provides some explanation of the meaning to Facilitate
              understanding of the design. For a full description, see IETF RFC
              7807 [19].
            type: object
            required:
              - statussss
              - detail
            properties:
              type:
                description: >
                  A URI reference according to IETF RFC 3986 [5] that identifies
                  the problem type. It is encouraged that the URI provides
                  human-readable documentation for the problem (e.g. using HTML)
                  when dereferenced. When this member is not present, its value
                  is assumed to be "about:blank".
                type: string
                format: URI
              title:
                description: >
                  A short, human-readable summary of the problem type. It should
                  not change from occurrence to occurrence of the problem,
                  except for purposes of localization. If type is given and
                  other than "about:blank", this attribute shall also be
                  provided. A short, human-readable summary of the problem
                  type.  It SHOULD NOT change from occurrence to occurrence of
                  the problem, except for purposes of localization (e.g., using
                  proactive content negotiation; see [RFC7231], Section 3.4).
                type: string
              status:
                description: >
                  The HTTP status code for this occurrence of the problem. The
                  HTTP status code ([RFC7231], Section 6) generated by the
                  origin server for this occurrence of the problem.
                type: integer
              detail:
                description: >
                  A human-readable explanation specific to this occurrence of
                  the problem.
                type: string
              instance:
                description: >
                  A URI reference that identifies the specific occurrence of the
                  problem. It may yield further information if dereferenced.
                type: string
                format: URI
        '500':
          description: >
            Internal Server Error If there is an application error not related
            to the client's input that cannot be easily mapped to any other HTTP
            response code ("catch all error"), the API producer shall respond
            withthis response code. The ProblemDetails structure shall be
            provided, and shall include in the "detail" attribute more
            information about the source of the problem.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              type: string
              maximum: 1
              minimum: 1
          schema:
            description: >
              The definition of the general "ProblemDetails" data structure from
              IETF RFC 7807 [19] is reproduced in this structure. Compared to
              the general framework defined in IETF RFC 7807 [19], the "status"
              and "detail" attributes are mandated to be included by the present
              document, to ensure that the response contains additional textual
              information about an error. IETF RFC 7807 [19] foresees
              extensibility of the "ProblemDetails" type. It is possible that
              particular APIs in the present document, or particular
              implementations, define extensions to define additional attributes
              that provide more information about the error. The description
              column only provides some explanation of the meaning to Facilitate
              understanding of the design. For a full description, see IETF RFC
              7807 [19].
            type: object
            required:
              - statussss
              - detail
            properties:
              type:
                description: >
                  A URI reference according to IETF RFC 3986 [5] that identifies
                  the problem type. It is encouraged that the URI provides
                  human-readable documentation for the problem (e.g. using HTML)
                  when dereferenced. When this member is not present, its value
                  is assumed to be "about:blank".
                type: string
                format: URI
              title:
                description: >
                  A short, human-readable summary of the problem type. It should
                  not change from occurrence to occurrence of the problem,
                  except for purposes of localization. If type is given and
                  other than "about:blank", this attribute shall also be
                  provided. A short, human-readable summary of the problem
                  type.  It SHOULD NOT change from occurrence to occurrence of
                  the problem, except for purposes of localization (e.g., using
                  proactive content negotiation; see [RFC7231], Section 3.4).
                type: string
              status:
                description: >
                  The HTTP status code for this occurrence of the problem. The
                  HTTP status code ([RFC7231], Section 6) generated by the
                  origin server for this occurrence of the problem.
                type: integer
              detail:
                description: >
                  A human-readable explanation specific to this occurrence of
                  the problem.
                type: string
              instance:
                description: >
                  A URI reference that identifies the specific occurrence of the
                  problem. It may yield further information if dereferenced.
                type: string
                format: URI
        '503':
          description: >
            Service Unavailable If the API producer encounters an internal
            overload situation of itself or of a system it relies on, it should
            respond with this response code, following the provisions in IETF
            RFC 7231 [13] for the use of the Retry-After HTTP header and for the
            alternative to refuse the connection. The "ProblemDetails" structure
            may be omitted.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              type: string
              maximum: 1
              minimum: 1
          schema:
            description: >
              The definition of the general "ProblemDetails" data structure from
              IETF RFC 7807 [19] is reproduced in this structure. Compared to
              the general framework defined in IETF RFC 7807 [19], the "status"
              and "detail" attributes are mandated to be included by the present
              document, to ensure that the response contains additional textual
              information about an error. IETF RFC 7807 [19] foresees
              extensibility of the "ProblemDetails" type. It is possible that
              particular APIs in the present document, or particular
              implementations, define extensions to define additional attributes
              that provide more information about the error. The description
              column only provides some explanation of the meaning to Facilitate
              understanding of the design. For a full description, see IETF RFC
              7807 [19].
            type: object
            required:
              - statussss
              - detail
            properties:
              type:
                description: >
                  A URI reference according to IETF RFC 3986 [5] that identifies
                  the problem type. It is encouraged that the URI provides
                  human-readable documentation for the problem (e.g. using HTML)
                  when dereferenced. When this member is not present, its value
                  is assumed to be "about:blank".
                type: string
                format: URI
              title:
                description: >
                  A short, human-readable summary of the problem type. It should
                  not change from occurrence to occurrence of the problem,
                  except for purposes of localization. If type is given and
                  other than "about:blank", this attribute shall also be
                  provided. A short, human-readable summary of the problem
                  type.  It SHOULD NOT change from occurrence to occurrence of
                  the problem, except for purposes of localization (e.g., using
                  proactive content negotiation; see [RFC7231], Section 3.4).
                type: string
              status:
                description: >
                  The HTTP status code for this occurrence of the problem. The
                  HTTP status code ([RFC7231], Section 6) generated by the
                  origin server for this occurrence of the problem.
                type: integer
              detail:
                description: >
                  A human-readable explanation specific to this occurrence of
                  the problem.
                type: string
              instance:
                description: >
                  A URI reference that identifies the specific occurrence of the
                  problem. It may yield further information if dereferenced.
                type: string
                format: URI
  /URI_is_provided_by_the_client_when_creating_the_subscription-AlarmListRebuiltNotification:
    post:
      summary: Notify about NS alarms
      description: >
        The POST method notifies an alarm related to a NS or that the alarm list
        has been rebuilt.
      parameters:
        - name: AlarmListRebuiltNotification
          description: |
            Information that the alarm list has been rebuilt by the NFVO.
          in: body
          required: true
          schema:
            properties:
              AlarmListRebuiltNotification:
                description: >
                  This type represents a notification that the alarm list has
                  been rebuilt, e.g. if the VNFM detects its storage holding the
                  alarm list is corrupted. The notification shall be triggered
                  by the VNFM when the alarm list has been rebuilt.
                type: object
                required:
                  - id
                  - notificationType
                  - subscriptionId
                  - timeStamp
                  - _links
                properties:
                  id:
                    description: |
                      An identifier with the intention of being globally unique.
                    type: string
                  notificationType:
                    description: >
                      Discriminator for the different notification types. Shall
                      be set to "AlarmListRebuiltNotification" for this
                      notification type.
                    type: string
                    enum:
                      - AlarmListRebuiltNotification
                  subscriptionId:
                    description: |
                      An identifier with the intention of being globally unique.
                    type: string
                  timeStamp:
                    description: >
                      Date-time stamp. Representation: String formatted
                      according to IETF RFC 3339.
                    type: string
                    format: date-time
                  _links:
                    description: |
                      Links to resources related to this notification.
                    type: object
                    required:
                      - subscription
                      - alarms
                    properties:
                      subscription:
                        description: |
                          This type represents a link to a resource.
                        type: object
                        required:
                          - href
                        properties:
                          href:
                            description: |
                              URI of the referenced resource.
                            type: string
                            format: url
                      alarms:
                        description: |
                          This type represents a link to a resource.
                        type: object
                        required:
                          - href
                        properties:
                          href:
                            description: |
                              URI of the referenced resource.
                            type: string
                            format: url
        - name: Accept
          description: >
            Content-Types that are acceptable for the response. 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: false
          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: Version
          description: |
            Version of the API requested to use when responding to this request.
          in: header
          required: true
          type: string
      responses:
        '204':
          description: >
            204 No Content

            The notification was delivered successfully. The response body shall
            be empty. 
          headers:
            WWW-Authenticate:
              type: string
              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.
              maximum: 1
              minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              type: string
              maximum: 1
              minimum: 1
        '400':
          description: >
            Bad Request

            Error: Invalid attribute-based filtering parameters. The response
            body shall contain a ProblemDetails structure, in which the "detail"
            attribute should convey more information about the error.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              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 definition of the general "ProblemDetails" data structure from
              IETF RFC 7807 [19] is reproduced in this structure. Compared to
              the general framework defined in IETF RFC 7807 [19], the "status"
              and "detail" attributes are mandated to be included by the present
              document, to ensure that the response contains additional textual
              information about an error. IETF RFC 7807 [19] foresees
              extensibility of the "ProblemDetails" type. It is possible that
              particular APIs in the present document, or particular
              implementations, define extensions to define additional attributes
              that provide more information about the error. The description
              column only provides some explanation of the meaning to Facilitate
              understanding of the design. For a full description, see IETF RFC
              7807 [19].
            type: object
            required:
              - statussss
              - detail
            properties:
              type:
                description: >
                  A URI reference according to IETF RFC 3986 [5] that identifies
                  the problem type. It is encouraged that the URI provides
                  human-readable documentation for the problem (e.g. using HTML)
                  when dereferenced. When this member is not present, its value
                  is assumed to be "about:blank".
                type: string
                format: URI
              title:
                description: >
                  A short, human-readable summary of the problem type. It should
                  not change from occurrence to occurrence of the problem,
                  except for purposes of localization. If type is given and
                  other than "about:blank", this attribute shall also be
                  provided. A short, human-readable summary of the problem
                  type.  It SHOULD NOT change from occurrence to occurrence of
                  the problem, except for purposes of localization (e.g., using
                  proactive content negotiation; see [RFC7231], Section 3.4).
                type: string
              status:
                description: >
                  The HTTP status code for this occurrence of the problem. The
                  HTTP status code ([RFC7231], Section 6) generated by the
                  origin server for this occurrence of the problem.
                type: integer
              detail:
                description: >
                  A human-readable explanation specific to this occurrence of
                  the problem.
                type: string
              instance:
                description: >
                  A URI reference that identifies the specific occurrence of the
                  problem. It may yield further information if dereferenced.
                type: string
                format: URI
        '401':
          description: >
            Unauthorized. If the request contains no access token even though
            one is required, or if the request contains an authorization token
            that is invalid (e.g. expired or revoked), the API producer should
            respond with this response. The details of the error shall be
            returned in the WWW-Authenticate HTTP header, as defined in IETF RFC
            6750 and IETF RFC 7235. The ProblemDetails structure may be
            provided.
          headers:
            Content-Type:
              type: string
              description: The MIME type of the body of the response.
            WWW-Authenticate:
              type: string
              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.
          schema:
            description: >
              The definition of the general "ProblemDetails" data structure from
              IETF RFC 7807 [19] is reproduced in this structure. Compared to
              the general framework defined in IETF RFC 7807 [19], the "status"
              and "detail" attributes are mandated to be included by the present
              document, to ensure that the response contains additional textual
              information about an error. IETF RFC 7807 [19] foresees
              extensibility of the "ProblemDetails" type. It is possible that
              particular APIs in the present document, or particular
              implementations, define extensions to define additional attributes
              that provide more information about the error. The description
              column only provides some explanation of the meaning to Facilitate
              understanding of the design. For a full description, see IETF RFC
              7807 [19].
            type: object
            required:
              - statussss
              - detail
            properties:
              type:
                description: >
                  A URI reference according to IETF RFC 3986 [5] that identifies
                  the problem type. It is encouraged that the URI provides
                  human-readable documentation for the problem (e.g. using HTML)
                  when dereferenced. When this member is not present, its value
                  is assumed to be "about:blank".
                type: string
                format: URI
              title:
                description: >
                  A short, human-readable summary of the problem type. It should
                  not change from occurrence to occurrence of the problem,
                  except for purposes of localization. If type is given and
                  other than "about:blank", this attribute shall also be
                  provided. A short, human-readable summary of the problem
                  type.  It SHOULD NOT change from occurrence to occurrence of
                  the problem, except for purposes of localization (e.g., using
                  proactive content negotiation; see [RFC7231], Section 3.4).
                type: string
              status:
                description: >
                  The HTTP status code for this occurrence of the problem. The
                  HTTP status code ([RFC7231], Section 6) generated by the
                  origin server for this occurrence of the problem.
                type: integer
              detail:
                description: >
                  A human-readable explanation specific to this occurrence of
                  the problem.
                type: string
              instance:
                description: >
                  A URI reference that identifies the specific occurrence of the
                  problem. It may yield further information if dereferenced.
                type: string
                format: URI
        '403':
          description: >
            Forbidden If the API consumer is not allowed to perform a particular
            request to a particular resource, the API producer shall respond
            with this response code. The "ProblemDetails" structure shall be
            provided. It should include in the "detail" attribute information
            about the source of the problem, and may indicate how to solve it.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              type: string
              maximum: 1
              minimum: 1
          schema:
            description: >
              The definition of the general "ProblemDetails" data structure from
              IETF RFC 7807 [19] is reproduced in this structure. Compared to
              the general framework defined in IETF RFC 7807 [19], the "status"
              and "detail" attributes are mandated to be included by the present
              document, to ensure that the response contains additional textual
              information about an error. IETF RFC 7807 [19] foresees
              extensibility of the "ProblemDetails" type. It is possible that
              particular APIs in the present document, or particular
              implementations, define extensions to define additional attributes
              that provide more information about the error. The description
              column only provides some explanation of the meaning to Facilitate
              understanding of the design. For a full description, see IETF RFC
              7807 [19].
            type: object
            required:
              - statussss
              - detail
            properties:
              type:
                description: >
                  A URI reference according to IETF RFC 3986 [5] that identifies
                  the problem type. It is encouraged that the URI provides
                  human-readable documentation for the problem (e.g. using HTML)
                  when dereferenced. When this member is not present, its value
                  is assumed to be "about:blank".
                type: string
                format: URI
              title:
                description: >
                  A short, human-readable summary of the problem type. It should
                  not change from occurrence to occurrence of the problem,
                  except for purposes of localization. If type is given and
                  other than "about:blank", this attribute shall also be
                  provided. A short, human-readable summary of the problem
                  type.  It SHOULD NOT change from occurrence to occurrence of
                  the problem, except for purposes of localization (e.g., using
                  proactive content negotiation; see [RFC7231], Section 3.4).
                type: string
              status:
                description: >
                  The HTTP status code for this occurrence of the problem. The
                  HTTP status code ([RFC7231], Section 6) generated by the
                  origin server for this occurrence of the problem.
                type: integer
              detail:
                description: >
                  A human-readable explanation specific to this occurrence of
                  the problem.
                type: string
              instance:
                description: >
                  A URI reference that identifies the specific occurrence of the
                  problem. It may yield further information if dereferenced.
                type: string
                format: URI
        '500':
          description: >
            Internal Server Error If there is an application error not related
            to the client's input that cannot be easily mapped to any other HTTP
            response code ("catch all error"), the API producer shall respond
            withthis response code. The ProblemDetails structure shall be
            provided, and shall include in the "detail" attribute more
            information about the source of the problem.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              type: string
              maximum: 1
              minimum: 1
          schema:
            description: >
              The definition of the general "ProblemDetails" data structure from
              IETF RFC 7807 [19] is reproduced in this structure. Compared to
              the general framework defined in IETF RFC 7807 [19], the "status"
              and "detail" attributes are mandated to be included by the present
              document, to ensure that the response contains additional textual
              information about an error. IETF RFC 7807 [19] foresees
              extensibility of the "ProblemDetails" type. It is possible that
              particular APIs in the present document, or particular
              implementations, define extensions to define additional attributes
              that provide more information about the error. The description
              column only provides some explanation of the meaning to Facilitate
              understanding of the design. For a full description, see IETF RFC
              7807 [19].
            type: object
            required:
              - statussss
              - detail
            properties:
              type:
                description: >
                  A URI reference according to IETF RFC 3986 [5] that identifies
                  the problem type. It is encouraged that the URI provides
                  human-readable documentation for the problem (e.g. using HTML)
                  when dereferenced. When this member is not present, its value
                  is assumed to be "about:blank".
                type: string
                format: URI
              title:
                description: >
                  A short, human-readable summary of the problem type. It should
                  not change from occurrence to occurrence of the problem,
                  except for purposes of localization. If type is given and
                  other than "about:blank", this attribute shall also be
                  provided. A short, human-readable summary of the problem
                  type.  It SHOULD NOT change from occurrence to occurrence of
                  the problem, except for purposes of localization (e.g., using
                  proactive content negotiation; see [RFC7231], Section 3.4).
                type: string
              status:
                description: >
                  The HTTP status code for this occurrence of the problem. The
                  HTTP status code ([RFC7231], Section 6) generated by the
                  origin server for this occurrence of the problem.
                type: integer
              detail:
                description: >
                  A human-readable explanation specific to this occurrence of
                  the problem.
                type: string
              instance:
                description: >
                  A URI reference that identifies the specific occurrence of the
                  problem. It may yield further information if dereferenced.
                type: string
                format: URI
        '503':
          description: >
            Service Unavailable If the API producer encounters an internal
            overload situation of itself or of a system it relies on, it should
            respond with this response code, following the provisions in IETF
            RFC 7231 [13] for the use of the Retry-After HTTP header and for the
            alternative to refuse the connection. The "ProblemDetails" structure
            may be omitted.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              type: string
              maximum: 1
              minimum: 1
          schema:
            description: >
              The definition of the general "ProblemDetails" data structure from
              IETF RFC 7807 [19] is reproduced in this structure. Compared to
              the general framework defined in IETF RFC 7807 [19], the "status"
              and "detail" attributes are mandated to be included by the present
              document, to ensure that the response contains additional textual
              information about an error. IETF RFC 7807 [19] foresees
              extensibility of the "ProblemDetails" type. It is possible that
              particular APIs in the present document, or particular
              implementations, define extensions to define additional attributes
              that provide more information about the error. The description
              column only provides some explanation of the meaning to Facilitate
              understanding of the design. For a full description, see IETF RFC
              7807 [19].
            type: object
            required:
              - statussss
              - detail
            properties:
              type:
                description: >
                  A URI reference according to IETF RFC 3986 [5] that identifies
                  the problem type. It is encouraged that the URI provides
                  human-readable documentation for the problem (e.g. using HTML)
                  when dereferenced. When this member is not present, its value
                  is assumed to be "about:blank".
                type: string
                format: URI
              title:
                description: >
                  A short, human-readable summary of the problem type. It should
                  not change from occurrence to occurrence of the problem,
                  except for purposes of localization. If type is given and
                  other than "about:blank", this attribute shall also be
                  provided. A short, human-readable summary of the problem
                  type.  It SHOULD NOT change from occurrence to occurrence of
                  the problem, except for purposes of localization (e.g., using
                  proactive content negotiation; see [RFC7231], Section 3.4).
                type: string
              status:
                description: >
                  The HTTP status code for this occurrence of the problem. The
                  HTTP status code ([RFC7231], Section 6) generated by the
                  origin server for this occurrence of the problem.
                type: integer
              detail:
                description: >
                  A human-readable explanation specific to this occurrence of
                  the problem.
                type: string
              instance:
                description: >
                  A URI reference that identifies the specific occurrence of the
                  problem. It may yield further information if dereferenced.
                type: string
                format: URI
    get:
      summary: Test the notification endpoint
      description: >
        The GET method allows the server to test the notification endpoint that
        is provided by the client, e.g. during subscription.
      parameters:
        - name: Accept
          description: >
            Content-Types that are acceptable for the response. 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: false
          type: string
        - name: Version
          description: |
            Version of the API requested to use when responding to this request.
          in: header
          required: true
          type: string
      responses:
        '204':
          description: >
            204 No Content

            The notification endpoint was tested successfully. The response body
            shall be empty. 
          headers:
            WWW-Authenticate:
              type: string
              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.
              maximum: 1
              minimum: 0
        '400':
          description: >
            Bad Request

            Error: Invalid attribute-based filtering parameters. The response
            body shall contain a ProblemDetails structure, in which the "detail"
            attribute should convey more information about the error.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              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 definition of the general "ProblemDetails" data structure from
              IETF RFC 7807 [19] is reproduced in this structure. Compared to
              the general framework defined in IETF RFC 7807 [19], the "status"
              and "detail" attributes are mandated to be included by the present
              document, to ensure that the response contains additional textual
              information about an error. IETF RFC 7807 [19] foresees
              extensibility of the "ProblemDetails" type. It is possible that
              particular APIs in the present document, or particular
              implementations, define extensions to define additional attributes
              that provide more information about the error. The description
              column only provides some explanation of the meaning to Facilitate
              understanding of the design. For a full description, see IETF RFC
              7807 [19].
            type: object
            required:
              - statussss
              - detail
            properties:
              type:
                description: >
                  A URI reference according to IETF RFC 3986 [5] that identifies
                  the problem type. It is encouraged that the URI provides
                  human-readable documentation for the problem (e.g. using HTML)
                  when dereferenced. When this member is not present, its value
                  is assumed to be "about:blank".
                type: string
                format: URI
              title:
                description: >
                  A short, human-readable summary of the problem type. It should
                  not change from occurrence to occurrence of the problem,
                  except for purposes of localization. If type is given and
                  other than "about:blank", this attribute shall also be
                  provided. A short, human-readable summary of the problem
                  type.  It SHOULD NOT change from occurrence to occurrence of
                  the problem, except for purposes of localization (e.g., using
                  proactive content negotiation; see [RFC7231], Section 3.4).
                type: string
              status:
                description: >
                  The HTTP status code for this occurrence of the problem. The
                  HTTP status code ([RFC7231], Section 6) generated by the
                  origin server for this occurrence of the problem.
                type: integer
              detail:
                description: >
                  A human-readable explanation specific to this occurrence of
                  the problem.
                type: string
              instance:
                description: >
                  A URI reference that identifies the specific occurrence of the
                  problem. It may yield further information if dereferenced.
                type: string
                format: URI
        '401':
          description: >
            Unauthorized. If the request contains no access token even though
            one is required, or if the request contains an authorization token
            that is invalid (e.g. expired or revoked), the API producer should
            respond with this response. The details of the error shall be
            returned in the WWW-Authenticate HTTP header, as defined in IETF RFC
            6750 and IETF RFC 7235. The ProblemDetails structure may be
            provided.
          headers:
            Content-Type:
              type: string
              description: The MIME type of the body of the response.
            WWW-Authenticate:
              type: string
              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.
          schema:
            description: >
              The definition of the general "ProblemDetails" data structure from
              IETF RFC 7807 [19] is reproduced in this structure. Compared to
              the general framework defined in IETF RFC 7807 [19], the "status"
              and "detail" attributes are mandated to be included by the present
              document, to ensure that the response contains additional textual
              information about an error. IETF RFC 7807 [19] foresees
              extensibility of the "ProblemDetails" type. It is possible that
              particular APIs in the present document, or particular
              implementations, define extensions to define additional attributes
              that provide more information about the error. The description
              column only provides some explanation of the meaning to Facilitate
              understanding of the design. For a full description, see IETF RFC
              7807 [19].
            type: object
            required:
              - statussss
              - detail
            properties:
              type:
                description: >
                  A URI reference according to IETF RFC 3986 [5] that identifies
                  the problem type. It is encouraged that the URI provides
                  human-readable documentation for the problem (e.g. using HTML)
                  when dereferenced. When this member is not present, its value
                  is assumed to be "about:blank".
                type: string
                format: URI
              title:
                description: >
                  A short, human-readable summary of the problem type. It should
                  not change from occurrence to occurrence of the problem,
                  except for purposes of localization. If type is given and
                  other than "about:blank", this attribute shall also be
                  provided. A short, human-readable summary of the problem
                  type.  It SHOULD NOT change from occurrence to occurrence of
                  the problem, except for purposes of localization (e.g., using
                  proactive content negotiation; see [RFC7231], Section 3.4).
                type: string
              status:
                description: >
                  The HTTP status code for this occurrence of the problem. The
                  HTTP status code ([RFC7231], Section 6) generated by the
                  origin server for this occurrence of the problem.
                type: integer
              detail:
                description: >
                  A human-readable explanation specific to this occurrence of
                  the problem.
                type: string
              instance:
                description: >
                  A URI reference that identifies the specific occurrence of the
                  problem. It may yield further information if dereferenced.
                type: string
                format: URI
        '403':
          description: >
            Forbidden If the API consumer is not allowed to perform a particular
            request to a particular resource, the API producer shall respond
            with this response code. The "ProblemDetails" structure shall be
            provided. It should include in the "detail" attribute information
            about the source of the problem, and may indicate how to solve it.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              type: string
              maximum: 1
              minimum: 1
          schema:
            description: >
              The definition of the general "ProblemDetails" data structure from
              IETF RFC 7807 [19] is reproduced in this structure. Compared to
              the general framework defined in IETF RFC 7807 [19], the "status"
              and "detail" attributes are mandated to be included by the present
              document, to ensure that the response contains additional textual
              information about an error. IETF RFC 7807 [19] foresees
              extensibility of the "ProblemDetails" type. It is possible that
              particular APIs in the present document, or particular
              implementations, define extensions to define additional attributes
              that provide more information about the error. The description
              column only provides some explanation of the meaning to Facilitate
              understanding of the design. For a full description, see IETF RFC
              7807 [19].
            type: object
            required:
              - statussss
              - detail
            properties:
              type:
                description: >
                  A URI reference according to IETF RFC 3986 [5] that identifies
                  the problem type. It is encouraged that the URI provides
                  human-readable documentation for the problem (e.g. using HTML)
                  when dereferenced. When this member is not present, its value
                  is assumed to be "about:blank".
                type: string
                format: URI
              title:
                description: >
                  A short, human-readable summary of the problem type. It should
                  not change from occurrence to occurrence of the problem,
                  except for purposes of localization. If type is given and
                  other than "about:blank", this attribute shall also be
                  provided. A short, human-readable summary of the problem
                  type.  It SHOULD NOT change from occurrence to occurrence of
                  the problem, except for purposes of localization (e.g., using
                  proactive content negotiation; see [RFC7231], Section 3.4).
                type: string
              status:
                description: >
                  The HTTP status code for this occurrence of the problem. The
                  HTTP status code ([RFC7231], Section 6) generated by the
                  origin server for this occurrence of the problem.
                type: integer
              detail:
                description: >
                  A human-readable explanation specific to this occurrence of
                  the problem.
                type: string
              instance:
                description: >
                  A URI reference that identifies the specific occurrence of the
                  problem. It may yield further information if dereferenced.
                type: string
                format: URI
        '500':
          description: >
            Internal Server Error If there is an application error not related
            to the client's input that cannot be easily mapped to any other HTTP
            response code ("catch all error"), the API producer shall respond
            withthis response code. The ProblemDetails structure shall be
            provided, and shall include in the "detail" attribute more
            information about the source of the problem.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              type: string
              maximum: 1
              minimum: 1
          schema:
            description: >
              The definition of the general "ProblemDetails" data structure from
              IETF RFC 7807 [19] is reproduced in this structure. Compared to
              the general framework defined in IETF RFC 7807 [19], the "status"
              and "detail" attributes are mandated to be included by the present
              document, to ensure that the response contains additional textual
              information about an error. IETF RFC 7807 [19] foresees
              extensibility of the "ProblemDetails" type. It is possible that
              particular APIs in the present document, or particular
              implementations, define extensions to define additional attributes
              that provide more information about the error. The description
              column only provides some explanation of the meaning to Facilitate
              understanding of the design. For a full description, see IETF RFC
              7807 [19].
            type: object
            required:
              - statussss
              - detail
            properties:
              type:
                description: >
                  A URI reference according to IETF RFC 3986 [5] that identifies
                  the problem type. It is encouraged that the URI provides
                  human-readable documentation for the problem (e.g. using HTML)
                  when dereferenced. When this member is not present, its value
                  is assumed to be "about:blank".
                type: string
                format: URI
              title:
                description: >
                  A short, human-readable summary of the problem type. It should
                  not change from occurrence to occurrence of the problem,
                  except for purposes of localization. If type is given and
                  other than "about:blank", this attribute shall also be
                  provided. A short, human-readable summary of the problem
                  type.  It SHOULD NOT change from occurrence to occurrence of
                  the problem, except for purposes of localization (e.g., using
                  proactive content negotiation; see [RFC7231], Section 3.4).
                type: string
              status:
                description: >
                  The HTTP status code for this occurrence of the problem. The
                  HTTP status code ([RFC7231], Section 6) generated by the
                  origin server for this occurrence of the problem.
                type: integer
              detail:
                description: >
                  A human-readable explanation specific to this occurrence of
                  the problem.
                type: string
              instance:
                description: >
                  A URI reference that identifies the specific occurrence of the
                  problem. It may yield further information if dereferenced.
                type: string
                format: URI
        '503':
          description: >
            Service Unavailable If the API producer encounters an internal
            overload situation of itself or of a system it relies on, it should
            respond with this response code, following the provisions in IETF
            RFC 7231 [13] for the use of the Retry-After HTTP header and for the
            alternative to refuse the connection. The "ProblemDetails" structure
            may be omitted.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              type: string
              maximum: 1
              minimum: 1
          schema:
            description: >
              The definition of the general "ProblemDetails" data structure from
              IETF RFC 7807 [19] is reproduced in this structure. Compared to
              the general framework defined in IETF RFC 7807 [19], the "status"
              and "detail" attributes are mandated to be included by the present
              document, to ensure that the response contains additional textual
              information about an error. IETF RFC 7807 [19] foresees
              extensibility of the "ProblemDetails" type. It is possible that
              particular APIs in the present document, or particular
              implementations, define extensions to define additional attributes
              that provide more information about the error. The description
              column only provides some explanation of the meaning to Facilitate
              understanding of the design. For a full description, see IETF RFC
              7807 [19].
            type: object
            required:
              - statussss
              - detail
            properties:
              type:
                description: >
                  A URI reference according to IETF RFC 3986 [5] that identifies
                  the problem type. It is encouraged that the URI provides
                  human-readable documentation for the problem (e.g. using HTML)
                  when dereferenced. When this member is not present, its value
                  is assumed to be "about:blank".
                type: string
                format: URI
              title:
                description: >
                  A short, human-readable summary of the problem type. It should
                  not change from occurrence to occurrence of the problem,
                  except for purposes of localization. If type is given and
                  other than "about:blank", this attribute shall also be
                  provided. A short, human-readable summary of the problem
                  type.  It SHOULD NOT change from occurrence to occurrence of
                  the problem, except for purposes of localization (e.g., using
                  proactive content negotiation; see [RFC7231], Section 3.4).
                type: string
              status:
                description: >
                  The HTTP status code for this occurrence of the problem. The
                  HTTP status code ([RFC7231], Section 6) generated by the
                  origin server for this occurrence of the problem.
                type: integer
              detail:
                description: >
                  A human-readable explanation specific to this occurrence of
                  the problem.
                type: string
              instance:
                description: >
                  A URI reference that identifies the specific occurrence of the
                  problem. It may yield further information if dereferenced.
                type: string
                format: URI

