# Copyright (c) ETSI 2017.
# https://forge.etsi.org/etsi-forge-copyright-notice.txt

definitions:
  PerformanceInformationAvailableNotification:
    description: >
      This notification informs the receiver that performance information is available.
    type: object
    required:
      - id
      - notificationType
      - subscriptionId
      - timeStamp
      - objectInstanceId
      - _links
    properties:
      id:
        description: >
          Identifier of this notification. If a notification is
          sent multiple times due to multiple
          subscriptions, the "id" attribute of all these
          notifications shall have the same value.
        $ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
      notificationType:
        description: >
          Discriminator for the different notification types.
          Shall be set to
          "PerformanceInformationAvailableNotification"
          for this notification type.
        type: string
      subscriptionId:
        description: >
          Identifier of the subscription that this notification relates to.
        $ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
      timeStamp:
        description: >
          Date and time of the generation of the notification.
        $ref: "../../definitions/SOL005_def.yaml#/definitions/DateTime"
      objectInstanceId:
        description: >
          Identifier that identifies a NS instance.
        $ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
      _links:
        description: >
          Links to resources related to this notification.
        type: object
        required:
          - subscription
          - pmJob
          - performanceReport
        properties:
          subscription:
            description: >
              Link to the related subscription.
            $ref: "../../definitions/SOL005_def.yaml#/definitions/NotificationLink"
          objectInstance:
            description: >
              Link to the resource representing the NS
              instance to which the notified change applies.
              Shall be present if the NS instance information
              is accessible as a resource.
            $ref: "../../definitions/SOL005_def.yaml#/definitions/NotificationLink"
          pmJob:
            description: >
              Link to the resource that represents the PM job
              for which performance information is available.
            $ref: "../../definitions/SOL005_def.yaml#/definitions/NotificationLink"
          performanceReport:
            description: >
              Link from which the available performance
              information of data type "PerformanceReport"
              (see clause 7.5.2.10) can be obtained.
              This link should point to an "Individual
              performance report" resource as defined in
              clause 6.4.3a.
            $ref: "../../definitions/SOL005_def.yaml#/definitions/NotificationLink"

  ThresholdCrossedNotification:
    description: >
      This type represents a notification that is sent when a threshold has been crossed.
      NOTE:	The timing of sending this notification is determined by the capability of 
      the producing entity to evaluate the threshold crossing condition.
      The notification shall be triggered by the NFVO when a threshold has been crossed.
    type: object
    required:
      - id
      - notificationType
      - subscriptionId
      - timeStamp
      - thresholdId
      - crossingDirection
      - objectInstanceId
      - performanceMetric
      - performanceValue
      - _links
    properties:
      id:
        description: >
          Identifier of this notification. If a notification is
          sent multiple times due to multiple
          subscriptions, the "id" attribute of all these
          notifications shall have the same value..
        $ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
      notificationType:
        description: >
          Discriminator for the different notification types.
          Shall be set to "ThresholdCrossedNotification "
          for this notification type.
        type: string
      subscriptionId:
        description: >
          Identifier of the subscription that this notification relates to.
        $ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
      timeStamp:
        description: >
          Date and time of the generation of the notification.
        $ref: "../../definitions/SOL005_def.yaml#/definitions/DateTime"
      thresholdId:
        description: >
          Identifier of the threshold which has been crossed.
        $ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
      crossingDirection:
        description: >
          An indication of whether the threshold was crossed in upward or downward direction.
        $ref: "#/definitions/CrossingDirectionType"
      objectInstanceId:
        description: >
          Identifier that identifies a NS instance.
        $ref: "../../definitions/SOL005_def.yaml#/definitions/Identifier"
      performanceMetric:
        description: >
          Performance metric associated with the threshold.
          This attribute shall contain the related "Measurement Name" value
          as defined in clause 7.2 of ETSI GS NFV-IFA 027.
        type: string
      performanceValue:
        description: >
          Value of the metric that resulted in threshold crossing.
          The type of this attribute shall correspond to the related
          "Measurement Unit" as defined in clause 7.2 of ETSI GS NFV-IFA 027.
        type: object
      _links:
        description: >
          Links to resources related to this notification.
        type: object
        required:
          - subscription
          - objectInstance
          - threshold
        properties:
          subscription:
            description: >
              Link to the related subscription.
            $ref: "../../definitions/SOL005_def.yaml#/definitions/NotificationLink"
          objectInstance:
            description: >
              Link to the resource representing the NS
              instance to which the notified change applies.
              Shall be present if the NS instance information
              is accessible as a resource..
            $ref: "../../definitions/SOL005_def.yaml#/definitions/NotificationLink"
          threshold:
            description: >
              Link to the resource that represents the
              threshold that was crossed.
            $ref: "../../definitions/SOL005_def.yaml#/definitions/NotificationLink"

  CrossingDirectionType:
    description: >
      The enumeration CrossingDirectionType shall comply with the provisions.
      Acceptable Values are:
      UP - The threshold was crossed in upward direction.
      DOWN - The threshold was crossed in downward direction.
    type: string
    enum:
      - UP
      - DOWN