NSFaultManagement.yaml 26.7 KB
Newer Older
1
swagger: "2.0"
2

3
info:
4
  version: "1.2.0"
5
  title: "SOL005 - NS Fault Management Interface"
6
  description: >
rameshnaraya's avatar
rameshnaraya committed
7
    SOL005 - NS Fault Management Interface
8
9
10
11
12
13
14
15
    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
16
  contact:
17
18
    name: "NFV-SOL WG"
externalDocs:
19
20
  description: ETSI GS NFV-SOL 005 V2.5.1
  url: https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/005/02.05.01_60/gs_NFV-SOL005v020501p.pdf
21
basePath: /nsfm/v1
22
schemes:
23
  - http
24
25
  - https
consumes:
26
  - application/json
27
produces:
28
  - application/json
29
paths:
30
  ###############################################################################
31
32
33
  # API Versions                                                                #
  ###############################################################################
  '/api-versions':
34
35
    $ref: '../endpoints/SOL005_endpoints.yaml#/endpoints/api-versions'

36
  ###############################################################################
37
38
  # Alarms                                                                      #
  ###############################################################################
39
  '/alarms':
40
    #ETSI GS NFV-SOL 005 V2.4.1 location: 8.4.2
41
    get:
42
      summary: Query alarms related to NS instances.
43
      description: >
rameshnaraya's avatar
rameshnaraya committed
44
        Get Alarm List.
45
46
47

        The client can use this method to retrieve information about the alarm list.
      parameters:
48
49
        - name: filter
          in: query
50
          required: false
51
          type: string
52
          description: >
53
54
55
56
57
            Attribute-based filtering expression according to clause 4.3.2.
            The NFVO shall support receiving this parameter as part of the URI query string.
            The OSS/BSS may supply this parameter.
            The following attribute names shall be supported by the NFVO in the filter 
            expression: 
58
59
60
61
62
63
64
            - id            
            - nsInstanceId            
            - rootCauseFaultyComponent.faultyNestedNsInstanceId            
            - rootCauseFaultyComponent.faultyNsVirtualLinkInstanceId            
            - rootCauseFaultyComponent.faultyVnfInstanceId           
            - rootCauseFaultyResource.faultyResourceType            
            - eventType            
65
66
            - perceivedSeverity
            - probableCause
67
68
69
70
71
72
73
        - name: nextpage_opaque_marker
          in: query
          description: >
            Marker to obtain the next page of a paged response. Shall be supported by the NFVO
            if the NFVO supports alternative 2 (paging) according to clause 4.7.2.1 for this resource.
          required: false
          type: string
74
75
76
77
78
79
80
81
82
83
84
85
86
87
        - 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
88
89
90
91
92
93
        - name: Version
          description: >
            Version of the API requested to use when responding to this request.
          in: header
          required: true
          type: string
94
95
      responses:
        200:
rameshnaraya's avatar
rameshnaraya committed
96
          description: >
97
            200 OK
98

99
            Information about zero or more alarms was queried successfully.
100
            The response body shall contain the list of related alarms.
101
102
103
            If the NFVO supports alternative 2 (paging) according to 
            clause 4.7.2.1 for this resource, inclusion of the Link HTTP header 
            in this response shall follow the provisions in clause 4.7.2.3.
rameshnaraya's avatar
rameshnaraya committed
104
105
106
107
108
109
110
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              type: string
              maximum: 1
              minimum: 1
            WWW-Authenticate:
111
              type: string
rameshnaraya's avatar
rameshnaraya committed
112
113
              description: >
                Challenge if the corresponding HTTP request has not provided
114
115
116
                authorization, or error details if the corresponding HTTP request
                has provided an invalid authorization token.
              maximum: 1
117
118
119
120
121
122
123
              minimum: 0
            Version:
              description: >
                Version of the API used in the response.
              type: string
              maximum: 1
              minimum: 1
124
125
126
127
128
129
            Link:
              description: >
                Reference to other resources. Used for paging in the present document, see clause 4.7.2.1.
              type: string
              maximum: 1
              minimum: 0
130
          schema:
rameshnaraya's avatar
rameshnaraya committed
131
132
133
134
            type: array
            items:
              properties:
                Alarm:
135
                  $ref: "definitions/SOL005NSFaultManagement_def.yaml#/definitions/Alarm"
136
        400:
137
          $ref: "../responses/SOL005_resp.yaml#/responses/400"
138
        401:
139
          $ref: "../responses/SOL005_resp.yaml#/responses/401"
140
        403:
141
          $ref: "../responses/SOL005_resp.yaml#/responses/403"
142
        405:
143
          $ref: "../responses/SOL005_resp.yaml#/responses/405"
144
        406:
145
          $ref: "../responses/SOL005_resp.yaml#/responses/406"
146
        500:
147
          $ref: "../responses/SOL005_resp.yaml#/responses/500"
148
        503:
149
          $ref: "../responses/SOL005_resp.yaml#/responses/503"
150
151
152
153

  ###############################################################################
  # Individual alarm                                                            #
  ###############################################################################
154
  '/alarms/{alarmId}':
155
    #ETSI GS NFV-SOL 005 V2.4.1 location: 8.4.3
156
157
158
    parameters:
      - name: alarmId
        description: >
rameshnaraya's avatar
rameshnaraya committed
159
160
161
162
163
          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.
164
165
166
        in: path
        type: string
        required: true
167
    get:
168
      summary: Read individual alarm.
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
      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
193
194
195
196
197
198
        - name: Version
          description: >
            Version of the API requested to use when responding to this request.
          in: header
          required: true
          type: string
199
      responses:
200
        200:
rameshnaraya's avatar
rameshnaraya committed
201
          description: >
202
            200 OK
203

204
205
206
207
208
            Information about an individual alarm was read successfully.
            The response body shall contain a representation of the
            individual alarm.
          headers:
            Content-Type:
rameshnaraya's avatar
rameshnaraya committed
209
              description: The MIME type of the body of the response.
210
211
212
              type: string
              maximum: 1
              minimum: 1
rameshnaraya's avatar
rameshnaraya committed
213
            WWW-Authenticate:
214
              type: string
rameshnaraya's avatar
rameshnaraya committed
215
216
              description: >
                Challenge if the corresponding HTTP request has not provided
217
218
219
                authorization, or error details if the corresponding HTTP request
                has provided an invalid authorization token.
              maximum: 1
220
221
222
223
224
225
226
              minimum: 0
            Version:
              description: >
                Version of the API used in the response.
              type: string
              maximum: 1
              minimum: 1
227
          schema:
rameshnaraya's avatar
rameshnaraya committed
228
229
            properties:
              Alarm:
230
                $ref: "definitions/SOL005NSFaultManagement_def.yaml#/definitions/Alarm"
231
        400:
232
          $ref: "../responses/SOL005_resp.yaml#/responses/400"
233
        401:
234
          $ref: "../responses/SOL005_resp.yaml#/responses/401"
235
        403:
236
          $ref: "../responses/SOL005_resp.yaml#/responses/403"
237
        405:
238
          $ref: "../responses/SOL005_resp.yaml#/responses/405"
239
        406:
240
          $ref: "../responses/SOL005_resp.yaml#/responses/406"
241
        500:
242
          $ref: "../responses/SOL005_resp.yaml#/responses/500"
243
        503:
244
          $ref: "../responses/SOL005_resp.yaml#/responses/503"
245
    patch:
246
      summary: Acknowledge individual alarm.
247
248
      description: >
        Acknowledge Alarm
249

250
251
        This method modifies an individual alarm resource.
      parameters:
252
253
        - name: body
          in: body
254
255
          required: true
          schema:
256
257
258
            $ref: "definitions/SOL005NSFaultManagement_def.yaml#/definitions/AlarmModifications"
          description: >
            The parameter for the alarm modification, as defined in clause 8.5.2.8.
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
        - 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
281
282
          enum:
            - application/merge-patch+json
283
284
285
286
287
288
        - name: Version
          description: >
            Version of the API requested to use when responding to this request.
          in: header
          required: true
          type: string
289
290
      responses:
        200:
rameshnaraya's avatar
rameshnaraya committed
291
          description: >
292
            200 OK
293

294
295
296
297
298
            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:
rameshnaraya's avatar
rameshnaraya committed
299
              description: The MIME type of the body of the response.
300
301
302
303
              type: string
              maximum: 1
              minimum: 1
            WWW-Authenticate:
304
              type: string
305
306
              description: >
                Challenge if the corresponding HTTP request has not provided
307
308
                authorization, or error details if the corresponding HTTP request
                has provided an invalid authorization token.
309
              maximum: 1
310
311
312
313
314
315
316
              minimum: 0
            Version:
              description: >
                Version of the API used in the response.
              type: string
              maximum: 1
              minimum: 1
317
          schema:
rameshnaraya's avatar
rameshnaraya committed
318
319
320
            properties:
              AlarmModifications:
                $ref: "definitions/SOL005NSFaultManagement_def.yaml#/definitions/AlarmModifications"
321
        400:
322
          $ref: "../responses/SOL005_resp.yaml#/responses/400"
323
        401:
324
          $ref: "../responses/SOL005_resp.yaml#/responses/401"
325
        403:
326
          $ref: "../responses/SOL005_resp.yaml#/responses/403"
327
        405:
328
          $ref: "../responses/SOL005_resp.yaml#/responses/405"
329
        406:
330
          $ref: "../responses/SOL005_resp.yaml#/responses/406"
331
        409:
332
          $ref: "../responses/SOL005_resp.yaml#/responses/409"
333
        412:
334
          $ref: "../responses/SOL005_resp.yaml#/responses/412"
335
        500:
336
          $ref: "../responses/SOL005_resp.yaml#/responses/500"
337
        503:
338
339
          $ref: "../responses/SOL005_resp.yaml#/responses/503"

340
341
342
  ##############################################################################
  #Subscriptions                                                               #
  ##############################################################################
343
  '/subscriptions':
344
    #ETSI GS NFV-SOL 005 V2.4.1 location: 8.4.4
345
    post:
346
      summary: Subscribe to alarms related to NSs.
347
      description: >
348
        The POST method creates a new subscription.
349
350
        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.
351
        Creation of two subscription resources with the same callbackURI and the same filter can result in performance
352
353
354
355
356
        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).
357
      parameters:
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
        - 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
378
379
380
381
382
383
384
          type: string
        - name: Version
          description: >
            Version of the API requested to use when responding to this request.
          in: header
          required: true
          type: string
385
386
        - name: body
          in: body
rameshnaraya's avatar
rameshnaraya committed
387
388
          required: true
          schema:
389
390
391
            $ref: "definitions/SOL005NSFaultManagement_def.yaml#/definitions/FmSubscriptionRequest"
          description: >
            Details of the subscription to be created, as defined in clause 8.5.2.2.
392
393
      responses:
        201:
394
395
          description: >
            201 Created
396

397
398
399
400
401
            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.              
rameshnaraya's avatar
rameshnaraya committed
402
          schema:
403
            $ref: "definitions/SOL005NSFaultManagement_def.yaml#/definitions/FmSubscription"
404
          headers:
rameshnaraya's avatar
rameshnaraya committed
405
            Content-Type:
406
              type: string
rameshnaraya's avatar
rameshnaraya committed
407
408
409
410
              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.
411
            WWW-Authenticate:
412
              type: string
413
414
              description: >
                Challenge if the corresponding HTTP request has not provided
rameshnaraya's avatar
rameshnaraya committed
415
                authorization, or error details if the corresponding HTTP request
416
417
                has provided an invalid authorization token.
              maximum: 1
418
419
420
421
422
423
424
              minimum: 0
            Version:
              description: >
                Version of the API used in the response.
              type: string
              maximum: 1
              minimum: 1
425
        303:
426
          $ref: "../responses/SOL005_resp.yaml#/responses/303"
427
        400:
428
          $ref: "../responses/SOL005_resp.yaml#/responses/400"
429
        401:
430
          $ref: "../responses/SOL005_resp.yaml#/responses/401"
431
        403:
432
          $ref: "../responses/SOL005_resp.yaml#/responses/403"
433
        405:
434
          $ref: "../responses/SOL005_resp.yaml#/responses/405"
435
        406:
436
          $ref: "../responses/SOL005_resp.yaml#/responses/406"
437
        500:
438
          $ref: "../responses/SOL005_resp.yaml#/responses/500"
439
        503:
440
          $ref: "../responses/SOL005_resp.yaml#/responses/503"
441
    get:
442
      summary: Query multiple subscriptions.
443
444
      description: >
        Query Subscription Information
445

446
447
448
        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.
449

450
451
        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.
452
453
        Table 8.4.4.3.2-1: URI query parameters supported.
      parameters:
454
455
        - name: filter
          in: query
456
          required: false
457
          type: string
458
          description: >
459
460
461
            Attribute-based filtering expression according to clause 4.3.2.
            The NFVO shall support receiving this parameter as part of the URI
            query string. The OSS/BSS may supply this parameter.
462
            All attribute names that appear in the FmSubscription and in data types
463
            referenced from it shall be supported by the NFVO in the filter expression.       
464
465
466
467
468
469
470
        - name: nextpage_opaque_marker
          in: query
          description: >
            Marker to obtain the next page of a paged response. Shall be supported by the NFVO
            if the NFVO supports alternative 2 (paging) according to clause 4.7.2.1 for this resource.
          required: false
          type: string
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
        - 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
492
493
494
495
496
497
        - name: Version
          description: >
            Version of the API requested to use when responding to this request.
          in: header
          required: true
          type: string
498
499
      responses:
        200:
rameshnaraya's avatar
rameshnaraya committed
500
          description: >
501
            200 OK
502

503
            The list of subscriptions was queried successfully.
504
505
506
507
508
509
510
            The response body shall contain in an array the representations 
            of all active subscriptions of the functional block that invokes 
            the method, i.e. zero or more representations of FM subscriptions,
            as defined in clause 8.5.2.3.
            If the NFVO supports alternative 2 (paging) according to 
            clause 4.7.2.1 for this resource, inclusion of the Link HTTP header 
            in this response shall follow the provisions in clause 4.7.2.3.
511
512
          headers:
            Content-Type:
rameshnaraya's avatar
rameshnaraya committed
513
              description: The MIME type of the body of the response.
514
515
516
517
              type: string
              maximum: 1
              minimum: 1
            WWW-Authenticate:
518
              type: string
519
520
              description: >
                Challenge if the corresponding HTTP request has not provided
521
522
523
                authorization, or error details if the corresponding HTTP request
                has provided an invalid authorization token.
              maximum: 1
524
525
526
527
528
529
530
              minimum: 0
            Version:
              description: >
                Version of the API used in the response.
              type: string
              maximum: 1
              minimum: 1
531
532
533
534
535
536
            Link:
              description: >
                Reference to other resources. Used for paging in the present document, see clause 4.7.2.1.
              type: string
              maximum: 1
              minimum: 0
537
538
539
          schema:
            type: array
            items:
540
              $ref: "definitions/SOL005NSFaultManagement_def.yaml#/definitions/FmSubscription"
541
        400:
542
          $ref: "../responses/SOL005_resp.yaml#/responses/400"
543
        401:
544
          $ref: "../responses/SOL005_resp.yaml#/responses/401"
545
        403:
546
          $ref: "../responses/SOL005_resp.yaml#/responses/403"
547
        405:
548
          $ref: "../responses/SOL005_resp.yaml#/responses/405"
549
        406:
550
          $ref: "../responses/SOL005_resp.yaml#/responses/406"
551
        412:
552
          $ref: "../responses/SOL005_resp.yaml#/responses/412"
553
        500:
554
          $ref: "../responses/SOL005_resp.yaml#/responses/500"
555
        503:
556
          $ref: "../responses/SOL005_resp.yaml#/responses/503"
557
558
559
560

  ###############################################################################
  # Individual subscription                                                     #
  ###############################################################################
561
  '/subscriptions/{subscriptionId}':
562
    #ETSI GS NFV-SOL 005 V2.4.1 location: 8.4.5
563
564
565
566
567
568
569
570
571
572
573
574
    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:
575
      summary: Read an individual subscription.
576
577
      description: >
        Query Subscription Information
578

579
580
581
        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
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
      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
604
605
606
607
608
609
        - name: Version
          description: >
            Version of the API requested to use when responding to this request.
          in: header
          required: true
          type: string
610
611
      responses:
        200:
612
613
          description: >
            200 OK
614

615
616
617
618
619
620
621
622
623
624
625
626
            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:
627
              type: string
628
629
              description: >
                Challenge if the corresponding HTTP request has not provided
630
631
                authorization, or error details if the corresponding HTTP request
                has provided an invalid authorization token.
632
633
              maximum: 1
              minimum: 0
634
635
636
637
638
639
            Version:
              description: >
                Version of the API used in the response.
              type: string
              maximum: 1
              minimum: 1
640
          schema:
641
            $ref: "definitions/SOL005NSFaultManagement_def.yaml#/definitions/FmSubscription"
642
        400:
643
          $ref: "../responses/SOL005_resp.yaml#/responses/400"
644
        401:
645
          $ref: "../responses/SOL005_resp.yaml#/responses/401"
646
        403:
647
          $ref: "../responses/SOL005_resp.yaml#/responses/403"
648
        405:
649
          $ref: "../responses/SOL005_resp.yaml#/responses/405"
650
        406:
651
          $ref: "../responses/SOL005_resp.yaml#/responses/406"
652
        500:
653
          $ref: "../responses/SOL005_resp.yaml#/responses/500"
654
        503:
655
          $ref: "../responses/SOL005_resp.yaml#/responses/503"
656
    delete:
657
      summary: Terminate a subscription.
658
659
      description: >
        Terminate Subscription
660

661
662
663
664
665
666
667
668
669
        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
670
671
672
673
674
675
        - name: Version
          description: >
            Version of the API requested to use when responding to this request.
          in: header
          required: true
          type: string
676
677
      responses:
        204:
678
          description: >
679
            204 - No Content
680

681
682
683
684
            The subscription resource was deleted successfully.
            The response body shall be empty.
          headers:
            WWW-Authenticate:
685
              type: string
686
687
              description: >
                Challenge if the corresponding HTTP request has not provided
688
689
                authorization, or error details if the corresponding HTTP request
                has provided an invalid authorization token.
690
691
              maximum: 1
              minimum: 0
692
693
694
695
696
697
            Version:
              description: >
                Version of the API used in the response.
              type: string
              maximum: 1
              minimum: 1
698
        400:
699
          $ref: "../responses/SOL005_resp.yaml#/responses/400"
700
        401:
701
          $ref: "../responses/SOL005_resp.yaml#/responses/401"
702
        403:
703
          $ref: "../responses/SOL005_resp.yaml#/responses/403"
704
        405:
705
          $ref: "../responses/SOL005_resp.yaml#/responses/405"
706
        406:
707
          $ref: "../responses/SOL005_resp.yaml#/responses/406"
708
        500:
709
          $ref: "../responses/SOL005_resp.yaml#/responses/500"
710
        503:
711
          $ref: "../responses/SOL005_resp.yaml#/responses/503"