Commit 1fc8f313 authored by Giacomo Bernini's avatar Giacomo Bernini
Browse files

updated usage of common parameters data types

parent 9f0bd374
...@@ -30,51 +30,11 @@ paths: ...@@ -30,51 +30,11 @@ paths:
in the tables 7.5.3.3.2-1 and 7.5.3.3.2-2 for URI query parameters, in the tables 7.5.3.3.2-1 and 7.5.3.3.2-2 for URI query parameters,
request and response data structures, and response codes. request and response data structures, and response codes.
parameters: parameters:
- name: Accept - $ref: "../components/SOL009_params.yaml#/components/parameters/Version"
description: > - $ref: "../components/SOL009_params.yaml#/components/parameters/Accept"
Content-Types that are acceptable for the response. Reference: IETF - $ref: "../components/SOL009_params.yaml#/components/parameters/Authorization"
RFC 7231 - $ref: "../components/SOL009_params.yaml#/components/parameters/filter"
in: header - $ref: "../components/SOL009_params.yaml#/components/parameters/nextpage_opaque_marker"
required: true
schema:
type: string
- name: Authorization
description: |
The authorization token for the request. Reference: IETF RFC 7235
in: header
required: false
schema:
type: string
- name: filter
description: >
Attribute-based filtering expression according to clause 5.2 of ETSI
GS NFV-SOL 013. The NFV-MANO functional entity shall support
receiving this parameter as part of the URI query string. The API
consumer may supply this parameter. The following attribute names
shall be supported by the NFV-MANO functional entity in the
attribute-based filtering expression: id, managedObjectId,
eventType, perceivedSeverity, probableCause.
in: query
required: false
schema:
type: string
- name: nextpage_opaque_marker
description: >
Marker to obtain the next page of a paged resource. Shall be
supported by the NFV-MANO functional entity if the entity supports
alternative 2 (paging) according to clause 5.4.2.1 of ETSI GS
NFV-SOL 013 for this resource.
in: query
required: false
schema:
type: string
- name: Version
description: |
Version of the API requested to use when responding to this request.
in: header
required: true
schema:
type: string
responses: responses:
"200": "200":
description: > description: >
...@@ -157,35 +117,9 @@ paths: ...@@ -157,35 +117,9 @@ paths:
7.5.4.3.2-2 for URI query parameters, request and response data 7.5.4.3.2-2 for URI query parameters, request and response data
structures, and response codes. structures, and response codes.
parameters: parameters:
- name: Accept - $ref: "../components/SOL009_params.yaml#/components/parameters/Version"
description: > - $ref: "../components/SOL009_params.yaml#/components/parameters/Accept"
Content-Types that are acceptable for the response. Reference: IETF - $ref: "../components/SOL009_params.yaml#/components/parameters/Authorization"
RFC 7231
in: header
required: true
schema:
type: string
- name: Content-Type
description: |
The MIME type of the body of the request. Reference: IETF RFC 7231
in: header
required: true
schema:
type: string
- name: Authorization
description: |
The authorization token for the request. Reference: IETF RFC 7235
in: header
required: false
schema:
type: string
- name: Version
description: |
Version of the API requested to use when responding to this request.
in: header
required: true
schema:
type: string
responses: responses:
"200": "200":
description: > description: >
...@@ -233,38 +167,10 @@ paths: ...@@ -233,38 +167,10 @@ paths:
7.5.4.3.4-2 for URI query parameters, request and response data 7.5.4.3.4-2 for URI query parameters, request and response data
structures, and response codes. structures, and response codes.
parameters: parameters:
- name: Accept - $ref: "../components/SOL009_params.yaml#/components/parameters/Version"
description: > - $ref: "../components/SOL009_params.yaml#/components/parameters/Accept"
Content-Types that are acceptable for the response. Reference: IETF - $ref: "../components/SOL009_params.yaml#/components/parameters/Authorization"
RFC 7231 - $ref: "../components/SOL009_params.yaml#/components/parameters/ContentType"
in: header
required: true
schema:
type: string
- name: Authorization
description: |
The authorization token for the request. Reference: IETF RFC 7235
in: header
required: false
schema:
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
schema:
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
schema:
type: string
requestBody: requestBody:
content: content:
application/json: application/json:
...@@ -350,35 +256,10 @@ paths: ...@@ -350,35 +256,10 @@ paths:
referencing the existing "Individual subscription" resource with the referencing the existing "Individual subscription" resource with the
same filter and callbackUri). same filter and callbackUri).
parameters: parameters:
- name: Accept - $ref: "../components/SOL009_params.yaml#/components/parameters/Version"
description: > - $ref: "../components/SOL009_params.yaml#/components/parameters/Accept"
Content-Types that are acceptable for the response. Reference: IETF - $ref: "../components/SOL009_params.yaml#/components/parameters/Authorization"
RFC 7231 - $ref: "../components/SOL009_params.yaml#/components/parameters/ContentType"
in: header
required: true
schema:
type: string
- name: Authorization
description: |
The authorization token for the request. Reference: IETF RFC 7235
in: header
required: false
schema:
type: string
- name: Content-Type
description: |
The MIME type of the body of the request. Reference: IETF RFC 7231
in: header
required: true
schema:
type: string
- name: Version
description: |
Version of the API requested to use when responding to this request.
in: header
required: true
schema:
type: string
requestBody: requestBody:
content: content:
application/json: application/json:
...@@ -457,58 +338,11 @@ paths: ...@@ -457,58 +338,11 @@ paths:
shall follow the provisions specified in the tables 7.5.5.3.2-1 and 7.5.5.3.2-2 for URI query parameters, shall follow the provisions specified in the tables 7.5.5.3.2-1 and 7.5.5.3.2-2 for URI query parameters,
request and response data structures, and response codes. request and response data structures, and response codes.
parameters: parameters:
- name: Accept - $ref: "../components/SOL009_params.yaml#/components/parameters/Version"
description: > - $ref: "../components/SOL009_params.yaml#/components/parameters/Accept"
Content-Types that are acceptable for the response. Reference: IETF - $ref: "../components/SOL009_params.yaml#/components/parameters/Authorization"
RFC 7231 - $ref: "../components/SOL009_params.yaml#/components/parameters/filter"
in: header - $ref: "../components/SOL009_params.yaml#/components/parameters/nextpage_opaque_marker"
required: true
schema:
type: string
- name: Authorization
description: |
The authorization token for the request. Reference: IETF RFC 7235
in: header
required: false
schema:
type: string
- name: Content-Type
description: |
The MIME type of the body of the request. Reference: IETF RFC 7231
in: header
required: true
schema:
type: string
- name: filter
description: >
Attribute-based filtering expression according to clause 5.2 of ETSI
GS NFV-SOL 013. The NFV-MANO functional entity shall support
receiving this parameter as part of the URI query string. The API
consumer may supply this parameter. All attribute names that appear
in the FmSubscription and in data types referenced from it shall be
supported by the NFV-MANO functional entity in the filter
expression.
in: query
required: false
schema:
type: string
- name: nextpage_opaque_marker
description: >
Marker to obtain the next page of a paged response. Shall be
supported by the NFV-MANO functional entity if the entity supports
alternative 2 (paging) according to clause 5.4.2.1 of ETSI GS
NFV-SOL 013 for this resource.
in: query
required: false
schema:
type: string
- name: Version
description: |
Version of the API requested to use when responding to this request.
in: header
required: true
schema:
type: string
responses: responses:
"200": "200":
description: > description: >
...@@ -600,35 +434,9 @@ paths: ...@@ -600,35 +434,9 @@ paths:
specified in the tables 7.5.6.3.2-1 and 7.5.6.3.2-2 for URI query specified in the tables 7.5.6.3.2-1 and 7.5.6.3.2-2 for URI query
parameters, request and response data structures, and response codes. parameters, request and response data structures, and response codes.
parameters: parameters:
- name: Accept - $ref: "../components/SOL009_params.yaml#/components/parameters/Version"
description: > - $ref: "../components/SOL009_params.yaml#/components/parameters/Accept"
Content-Types that are acceptable for the response. Reference: IETF - $ref: "../components/SOL009_params.yaml#/components/parameters/Authorization"
RFC 7231
in: header
required: true
schema:
type: string
- name: Authorization
description: |
The authorization token for the request. Reference: IETF RFC 7235
in: header
required: false
schema:
type: string
- name: Content-Type
description: |
The MIME type of the body of the request. Reference: IETF RFC 7231
in: header
required: true
schema:
type: string
- name: Version
description: |
Version of the API requested to use when responding to this request.
in: header
required: true
schema:
type: string
responses: responses:
"200": "200":
description: > description: >
...@@ -698,20 +506,8 @@ paths: ...@@ -698,20 +506,8 @@ paths:
be received by the formerly-subscribed API consumer for a certain time be received by the formerly-subscribed API consumer for a certain time
period after the deletion. period after the deletion.
parameters: parameters:
- name: Authorization - $ref: "../components/SOL009_params.yaml#/components/parameters/Version"
description: | - $ref: "../components/SOL009_params.yaml#/components/parameters/Authorization"
The authorization token for the request. Reference: IETF RFC 7235
in: header
required: false
schema:
type: string
- name: Version
description: |
Version of the API requested to use when responding to this request.
in: header
required: true
schema:
type: string
responses: responses:
"204": "204":
description: > description: >
......
...@@ -34,28 +34,9 @@ paths: ...@@ -34,28 +34,9 @@ paths:
7.5.7.3.1-1 and 7.5.7.3.1-2 for URI query parameters, request and 7.5.7.3.1-1 and 7.5.7.3.1-2 for URI query parameters, request and
response data structures, and response codes. response data structures, and response codes.
parameters: parameters:
- name: Authorization - $ref: "../components/SOL009_params.yaml#/components/parameters/Version"
description: > - $ref: "../components/SOL009_params.yaml#/components/parameters/ContentType"
The authorization token for the request. Reference: IETF RFC 7235 - $ref: "../components/SOL009_params.yaml#/components/parameters/Authorization"
in: header
required: false
schema:
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
schema:
type: string
- name: Version
description: >
Version of the API requested to use when responding to this request.
in: header
required: true
schema:
type: string
requestBody: requestBody:
content: content:
application/json: application/json:
...@@ -109,20 +90,8 @@ paths: ...@@ -109,20 +90,8 @@ paths:
7.5.7.3.2-2 for URI query parameters, request and response data 7.5.7.3.2-2 for URI query parameters, request and response data
structures, and response codes. structures, and response codes.
parameters: parameters:
- name: Authorization - $ref: "../components/SOL009_params.yaml#/components/parameters/Version"
description: | - $ref: "../components/SOL009_params.yaml#/components/parameters/Authorization"
The authorization token for the request. Reference: IETF RFC 7235
in: header
required: false
schema:
type: string
- name: Version
description: |
Version of the API requested to use when responding to this request.
in: header
required: true
schema:
type: string
responses: responses:
"204": "204":
description: > description: >
...@@ -171,28 +140,9 @@ paths: ...@@ -171,28 +140,9 @@ paths:
7.5.7.3.1-1 and 7.5.7.3.1-2 for URI query parameters, request and 7.5.7.3.1-1 and 7.5.7.3.1-2 for URI query parameters, request and
response data structures, and response codes. response data structures, and response codes.
parameters: parameters:
- name: Authorization - $ref: "../components/SOL009_params.yaml#/components/parameters/Version"
description: | - $ref: "../components/SOL009_params.yaml#/components/parameters/ContentType"
The authorization token for the request. Reference: IETF RFC 7235 - $ref: "../components/SOL009_params.yaml#/components/parameters/Authorization"
in: header
required: false
schema:
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
schema:
type: string
- name: Version
description: |
Version of the API requested to use when responding to this request.
in: header
required: true
schema:
type: string
requestBody: requestBody:
content: content:
application/json: application/json:
...@@ -246,20 +196,8 @@ paths: ...@@ -246,20 +196,8 @@ paths:
7.5.7.3.2-2 for URI query parameters, request and response data 7.5.7.3.2-2 for URI query parameters, request and response data
structures, and response codes. structures, and response codes.
parameters: parameters:
- name: Authorization - $ref: "../components/SOL009_params.yaml#/components/parameters/Version"
description: | - $ref: "../components/SOL009_params.yaml#/components/parameters/Authorization"
The authorization token for the request. Reference: IETF RFC 7235
in: header
required: false
schema:
type: string
- name: Version
description: |
Version of the API requested to use when responding to this request.
in: header
required: true
schema:
type: string
responses: responses:
"204": "204":
description: > description: >
...@@ -308,28 +246,9 @@ paths: ...@@ -308,28 +246,9 @@ paths:
7.5.7.3.1-1 and 7.5.7.3.1-2 for URI query parameters, request and 7.5.7.3.1-1 and 7.5.7.3.1-2 for URI query parameters, request and
response data structures, and response codes. response data structures, and response codes.
parameters: parameters:
- name: Authorization - $ref: "../components/SOL009_params.yaml#/components/parameters/Version"
description: | - $ref: "../components/SOL009_params.yaml#/components/parameters/ContentType"
The authorization token for the request. Reference: IETF RFC 7235 - $ref: "../components/SOL009_params.yaml#/components/parameters/Authorization"
in: header
required: false
schema:
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
schema:
type: string
- name: Version
description: |
Version of the API requested to use when responding to this request.
in: header
required: true
schema:
type: string
requestBody: requestBody:
content: content:
application/json: application/json:
...@@ -384,29 +303,17 @@ paths: ...@@ -384,29 +303,17 @@ paths:
7.5.7.3.2-2 for URI query parameters, request and response data 7.5.7.3.2-2 for URI query parameters, request and response data
structures, and response codes. structures, and response codes.
parameters: parameters:
- name: Authorization - $ref: "../components/SOL009_params.yaml#/components/parameters/Version"
description: | - $ref: "../components/SOL009_params.yaml#/components/parameters/Authorization"
The authorization token for the request. Reference: IETF RFC 7235
in: header
required: false
schema:
type: string
- name: Version
description: |
Version of the API requested to use when responding to this request.
in: header
required: true
schema:
type: string
responses: responses:
"204": "204":
description: > description: >
204 NO CONTENT 204 NO CONTENT
Shall be returned to indicate that the notification endpoint has been tested successfully. The response body shall be empty. Shall be returned to indicate that the notification endpoint has been tested successfully. The response body shall be empty.
headers: headers:
WWW-Authenticate: WWW-Authenticate:
description: > description: >-
Challenge if the corresponding HTTP request has not provided Challenge if the corresponding HTTP request has not provided
authorization, or error details if the corresponding HTTP authorization, or error details if the corresponding HTTP
request has provided an invalid authorization token. request has provided an invalid authorization token.
...@@ -415,7 +322,7 @@ paths: ...@@ -415,7 +322,7 @@ paths:
minimum: 0 minimum: 0
maximum: 1 maximum: 1
Version: Version:
description: | description: >-
Version of the API used in the response. Version of the API used in the response.
schema: schema:
type: string type: string
......
...@@ -37,9 +37,10 @@ paths: ...@@ -37,9 +37,10 @@ paths:
As the result of successfully executing this method, a new "Individual logging job" resource as defined in As the result of successfully executing this method, a new "Individual logging job" resource as defined in
clause 9.5.4 shall have been created. clause 9.5.4 shall have been created.
parameters: parameters:
- $ref: "#/components/parameters/Version" - $ref: "../components/SOL009_params.yaml#/components/parameters/Version"
- $ref: "#/components/parameters/Accept" - $ref: "../components/SOL009_params.yaml#/components/parameters/Accept"
- $ref: "#/components/parameters/Authorization" - $ref: "../components/SOL009_params.yaml#/components/parameters/ContentType"
- $ref: "../components/SOL009_params.yaml#/components/parameters/Authorization"
requestBody: requestBody:
$ref: "#/components/requestBodies/CreateLoggingJobRequest" $ref: "#/components/requestBodies/CreateLoggingJobRequest"
responses: responses:
...@@ -71,15 +72,15 @@ paths: ...@@ -71,15 +72,15 @@ paths:
This method shall follow the provisions specified in the tables 8.5.3.3.2-1 and 8.5.3.3.2-2 for This method shall follow the provisions specified in the tables 8.5.3.3.2-1 and 8.5.3.3.2-2 for
URI query parameters, request and response data structures, and response codes. URI query parameters, request and response data structures, and response codes.
parameters: parameters:
- $ref: "#/components/parameters/filter" - $ref: "../components/SOL009_params.yaml#/components/parameters/filter"
- $ref: "#/components/parameters/all_fields" - $ref: "../components/SOL009_params.yaml#/components/parameters/all_fields"
- $ref: "#/components/parameters/fields" - $ref: "../components/SOL009_params.yaml#/components/parameters/fields"
- $ref: "#/components/parameters/exclude_fields" - $ref: "../components/SOL009_params.yaml#/components/parameters/exclude_fields"
- $ref: "#/components/parameters/exclude_default" - $ref: "../components/SOL009_params.yaml#/components/parameters/exclude_default"
- $ref: "#/components/parameters/nextpage_opaque_marker" - $ref: "../components/SOL009_params.yaml#/components/parameters/nextpage_opaque_marker"
- $ref: "#/components/parameters/Version" - $ref: "../components/SOL009_params.yaml#/components/parameters/Version"
- $ref: "#/components/parameters/Accept" - $ref: "../components/SOL009_params.yaml#/components/parameters/Accept"
- $ref: "#/components/parameters/Authorization" - $ref: "../components/SOL009_params.yaml#/components/parameters/Authorization"
responses: responses:
"200": "200":
$ref: '#/components/responses/LoggingJobs.Get' $ref: '#/components/responses/LoggingJobs.Get'
...@@ -