SOL003-VNFFaultManagement-API.json 238 KB
Newer Older
3001 3002 3003 3004 3005 3006 3007 3008 3009 3010 3011 3012 3013 3014 3015 3016 3017 3018 3019 3020 3021 3022 3023 3024 3025 3026 3027 3028 3029 3030 3031 3032 3033 3034 3035 3036 3037 3038 3039 3040 3041 3042 3043 3044 3045 3046 3047 3048 3049 3050 3051 3052 3053 3054 3055 3056 3057 3058 3059 3060 3061 3062 3063 3064 3065 3066 3067 3068 3069 3070 3071 3072 3073 3074 3075 3076 3077 3078 3079 3080 3081 3082 3083 3084 3085 3086 3087 3088 3089 3090 3091 3092 3093 3094 3095 3096 3097 3098 3099 3100 3101 3102 3103 3104 3105 3106 3107 3108 3109 3110 3111 3112 3113 3114 3115 3116 3117 3118 3119 3120 3121 3122 3123 3124 3125 3126 3127 3128 3129 3130 3131 3132 3133 3134 3135 3136 3137 3138 3139 3140 3141 3142 3143 3144 3145 3146 3147 3148 3149 3150 3151 3152 3153 3154 3155 3156 3157 3158 3159 3160 3161 3162 3163 3164 3165 3166 3167 3168 3169 3170 3171 3172 3173 3174 3175 3176 3177 3178 3179 3180 3181 3182 3183 3184 3185 3186 3187 3188 3189 3190 3191 3192 3193 3194 3195 3196 3197 3198 3199 3200 3201 3202 3203 3204 3205 3206 3207 3208 3209 3210 3211 3212 3213 3214 3215 3216 3217 3218 3219 3220 3221 3222 3223 3224 3225 3226 3227 3228 3229 3230 3231 3232 3233 3234 3235 3236 3237 3238 3239 3240 3241 3242 3243 3244 3245 3246 3247 3248 3249 3250 3251 3252 3253 3254 3255 3256 3257 3258 3259 3260 3261 3262 3263 3264 3265 3266 3267 3268 3269 3270 3271 3272 3273 3274 3275 3276 3277 3278 3279 3280 3281 3282 3283 3284 3285 3286 3287 3288 3289 3290 3291 3292 3293 3294 3295 3296 3297 3298 3299 3300 3301 3302 3303 3304 3305 3306 3307 3308 3309 3310 3311 3312 3313 3314 3315 3316 3317 3318 3319 3320 3321
                  }
                }
              }
            },
            "notificationTypes": {
              "description": "Match particular notification types. Permitted values: * AlarmNotification * AlarmClearedNotification * AlarmListRebuiltNotification The permitted values of the \"notificationTypes\" attribute are spelled exactly as the names of the notification types to facilitate automated code generation systems.\n",
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "AlarmNotification",
                  "AlarmClearedNotification",
                  "AlarmListRebuiltNotification"
                ]
              }
            },
            "faultyResourceTypes": {
              "description": "Match VNF alarms with a faulty resource type listed in this attribute.\n",
              "type": "array",
              "items": {
                "description": "The enumeration FaultyResourceType represents those types of faulty resource.\n",
                "type": "string",
                "enum": [
                  "COMPUTE",
                  "STORAGE",
                  "NETWORK"
                ]
              }
            },
            "perceivedSeverities": {
              "description": "Match VNF alarms with a perceived severity listed in this attribute.\n",
              "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\n  is required. Such a severity can be reported, for example, when a\n  managed object becomes totally out of service and its capability needs\n  to be restored (ITU-T Recommendation X.733).\n* MAJOR: The Major severity level indicates that a service affecting  condition has developed and an urgent corrective action is required.\n  Such a severity can be reported, for example, when there is a severe\n  degradation in the capability of the managed object and its full\n  capability needs to be restored (ITU-T Recommendation X.733).\n* MINOR: The Minor severity level indicates the existence of a  non-service affecting fault condition and that corrective action\n  should be taken in order to prevent a more serious (for example,\n  service affecting) fault. Such a severity can be reported, for\n  example, when the detected alarm condition is not currently degrading\n  the capacity of the managed object (ITU-T Recommendation X.733).\n* WARNING: The Warning severity level indicates the detection of a  potential or impending service affecting fault, before any significant\n  effects have been felt. Action should be taken to further diagnose (if\n  necessary) and correct the problem in order to prevent it from\n  becoming a more serious service affecting fault (ITU-T Recommendation\n  X.733).\n* INDETERMINATE: The Indeterminate severity level indicates that the  severity level cannot be determined (ITU-T Recommendation X.733).\n* CLEARED: The Cleared severity level indicates the clearing of one or  more previously reported alarms. This alarm clears all alarms for this\n  managed object that have the same Alarm type, Probable cause and\n  Specific problems (if given) (ITU-T Recommendation X.733).\n",
                "type": "string",
                "enum": [
                  "CRITICAL",
                  "MAJOR",
                  "MINOR",
                  "WARNING",
                  "INDETERMINATE",
                  "CLEARED"
                ]
              }
            },
            "eventTypes": {
              "description": "Match VNF alarms with an event type listed in this attribute.\n",
              "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\n  to another (ITU-T Recommendation X.733).\n* PROCESSING_ERROR_ALARM: An alarm of this type is associated with a  software or processing fault (ITU-T Recommendation X.733).\n* ENVIRONMENTAL_ALARM: An alarm of this type is associated with a  condition related to an enclosure in which the equipment resides\n  (ITU-T Recommendation X.733).\n* QOS_ALARM: An alarm of this type is associated with degradation in the  quality of a service (ITU-T Recommendation X.733).\n* EQUIPMENT_ALARM: An alarm of this type is associated with an equipment  fault (ITU-T Recommendation X.733).\n",
                "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.\n",
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          }
        },
        "callbackUri": {
          "description": "The URI of the endpoint to send the notification to.\n",
          "type": "string",
          "format": "url"
        },
        "_links": {
          "description": "Links for this resource.\n",
          "type": "object",
          "required": [
            "self"
          ],
          "properties": {
            "self": {
              "description": "This type represents a link to a resource.\n",
              "type": "object",
              "required": [
                "href"
              ],
              "properties": {
                "href": {
                  "description": "URI of the referenced resource.\n",
                  "type": "string",
                  "format": "url"
                }
              }
            }
          }
        }
      }
    },
    "FmSubscriptionRequest": {
      "description": "This type represents a subscription request related to notifications about VNF faults.\n",
      "type": "object",
      "required": [
        "callbackUri"
      ],
      "properties": {
        "filter": {
          "description": "This type represents a subscription filter related to notifications about VNF faults. 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).\n",
          "type": "object",
          "properties": {
            "vnfInstanceSubscriptionFilter": {
              "description": "This type represents subscription filter criteria to match VNF instances.\n",
              "type": "object",
              "properties": {
                "vnfdIds": {
                  "description": "If present, match VNF instances that were created based on a VNFD identified by one of the vnfdId values listed in this attribute. The attributes \"vnfdIds\" and \"vnfProductsFromProviders\" are alternatives to reference to VNF instances that are based on certain VNFDs in a filter. They should not be used both in the same filter instance, but one alternative should be chosen.\n",
                  "type": "array",
                  "items": {
                    "description": "An identifier with the intention of being globally unique.\n",
                    "type": "string"
                  }
                },
                "vnfProductsFromProviders": {
                  "description": "If present, match VNF instances that belong to VNF products from certain providers. The attributes \"vnfdIds\" and \"vnfProductsFromProviders\" are alternatives to reference to VNF instances that are based on certain VNFDs in a filter. They should not be used both in the same filter instance, but one alternative should be chosen.\n",
                  "type": "array",
                  "items": {
                    "type": "object",
                    "required": [
                      "vnfProvider"
                    ],
                    "properties": {
                      "vnfProvider": {
                        "description": "Name of the VNF provider to match.\n",
                        "type": "string"
                      },
                      "vnfProducts": {
                        "description": "If present, match VNF instances that belong to VNF products with certain product names, from one particular provider.\n",
                        "type": "array",
                        "items": {
                          "type": "object",
                          "required": [
                            "vnfProductName"
                          ],
                          "properties": {
                            "vnfProductName": {
                              "description": "Name of the VNF product to match.\n",
                              "type": "string"
                            },
                            "versions": {
                              "description": "If present, match VNF instances that belong to VNF products with certain versions and a certain product name, from one particular provider.\n",
                              "type": "array",
                              "items": {
                                "type": "object",
                                "required": [
                                  "vnfSoftwareVersion"
                                ],
                                "properties": {
                                  "vnfSoftwareVersion": {
                                    "description": "A version.\n",
                                    "type": "string"
                                  },
                                  "vnfdVersions": {
                                    "description": "If present, match VNF instances that belong to VNF products with certain VNFD versions, a certain software version and a certain product name, from one particular provider.\n",
                                    "type": "array",
                                    "items": {
                                      "description": "A version.\n",
                                      "type": "string"
                                    }
                                  }
                                }
                              }
                            }
                          }
                        }
                      }
                    }
                  }
                },
                "vnfInstanceIds": {
                  "description": "If present, match VNF instances with an instance identifier listed in this attribute. The attributes \"vnfInstanceIds\" and \"vnfInstanceNames\" are alternatives to reference to particular VNF Instances in a filter. They should not be used both in the same filter instance, but one alternative should be chosen.\n",
                  "type": "array",
                  "items": {
                    "description": "An identifier with the intention of being globally unique.\n",
                    "type": "string"
                  }
                },
                "vnfInstanceNames": {
                  "description": "If present, match VNF instances with a VNF Instance Name listed in this attribute. The attributes \"vnfInstanceIds\" and \"vnfInstanceNames\" are alternatives to reference to particular VNF Instances in a filter. They should not be used both in the same filter instance, but one alternative should be chosen.\n",
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                }
              }
            },
            "notificationTypes": {
              "description": "Match particular notification types. Permitted values: * AlarmNotification * AlarmClearedNotification * AlarmListRebuiltNotification The permitted values of the \"notificationTypes\" attribute are spelled exactly as the names of the notification types to facilitate automated code generation systems.\n",
              "type": "array",
              "items": {
                "type": "string",
                "enum": [
                  "AlarmNotification",
                  "AlarmClearedNotification",
                  "AlarmListRebuiltNotification"
                ]
              }
            },
            "faultyResourceTypes": {
              "description": "Match VNF alarms with a faulty resource type listed in this attribute.\n",
              "type": "array",
              "items": {
                "description": "The enumeration FaultyResourceType represents those types of faulty resource.\n",
                "type": "string",
                "enum": [
                  "COMPUTE",
                  "STORAGE",
                  "NETWORK"
                ]
              }
            },
            "perceivedSeverities": {
              "description": "Match VNF alarms with a perceived severity listed in this attribute.\n",
              "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\n  is required. Such a severity can be reported, for example, when a\n  managed object becomes totally out of service and its capability needs\n  to be restored (ITU-T Recommendation X.733).\n* MAJOR: The Major severity level indicates that a service affecting  condition has developed and an urgent corrective action is required.\n  Such a severity can be reported, for example, when there is a severe\n  degradation in the capability of the managed object and its full\n  capability needs to be restored (ITU-T Recommendation X.733).\n* MINOR: The Minor severity level indicates the existence of a  non-service affecting fault condition and that corrective action\n  should be taken in order to prevent a more serious (for example,\n  service affecting) fault. Such a severity can be reported, for\n  example, when the detected alarm condition is not currently degrading\n  the capacity of the managed object (ITU-T Recommendation X.733).\n* WARNING: The Warning severity level indicates the detection of a  potential or impending service affecting fault, before any significant\n  effects have been felt. Action should be taken to further diagnose (if\n  necessary) and correct the problem in order to prevent it from\n  becoming a more serious service affecting fault (ITU-T Recommendation\n  X.733).\n* INDETERMINATE: The Indeterminate severity level indicates that the  severity level cannot be determined (ITU-T Recommendation X.733).\n* CLEARED: The Cleared severity level indicates the clearing of one or  more previously reported alarms. This alarm clears all alarms for this\n  managed object that have the same Alarm type, Probable cause and\n  Specific problems (if given) (ITU-T Recommendation X.733).\n",
                "type": "string",
                "enum": [
                  "CRITICAL",
                  "MAJOR",
                  "MINOR",
                  "WARNING",
                  "INDETERMINATE",
                  "CLEARED"
                ]
              }
            },
            "eventTypes": {
              "description": "Match VNF alarms with an event type listed in this attribute.\n",
              "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\n  to another (ITU-T Recommendation X.733).\n* PROCESSING_ERROR_ALARM: An alarm of this type is associated with a  software or processing fault (ITU-T Recommendation X.733).\n* ENVIRONMENTAL_ALARM: An alarm of this type is associated with a  condition related to an enclosure in which the equipment resides\n  (ITU-T Recommendation X.733).\n* QOS_ALARM: An alarm of this type is associated with degradation in the  quality of a service (ITU-T Recommendation X.733).\n* EQUIPMENT_ALARM: An alarm of this type is associated with an equipment  fault (ITU-T Recommendation X.733).\n",
                "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.\n",
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          }
        },
        "callbackUri": {
          "description": "The URI of the endpoint to send the notification to.\n",
          "type": "string",
          "format": "url"
        },
        "authentication": {
          "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. \n* OAUTH2_CLIENT_CREDENTIALS: In every HTTP request to the  notification endpoint, use an OAuth 2.0 Bearer token, obtained\n  using the client credentials grant type.\n* TLS_CERT: Every HTTP request to the notification endpoint is sent  over a mutually authenticated TLS session, i.e. not only the\n  server is authenticated, but also the client is authenticated\n  during the TLS tunnel setup.\n",
              "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.\n",
              "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.\n",
                  "type": "string"
                },
                "password": {
                  "description": "Password to be used in HTTP Basic authentication. Shall be present if it has not been provisioned out of band.\n",
                  "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.\n",
              "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.\n",
                  "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.\n",
                  "type": "string"
                },
                "tokenEndpoint": {
                  "description": "String formatted according to IETF RFC 3986.\n",
                  "type": "string"
                }
              }
            }
          }
        }
      }
    }
  }
}