openapi: 3.0.2
info:
  title: SOL005 - NFVI Capacity Information Interface
  description: >
    SOL005 - NFVI Capacity Information 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/rep/nfv/SOL005/issues
  contact:
    name: NFV-SOL WG
  license:
    name: ETSI Forge copyright notice
    url: 'https://forge.etsi.org/etsi-forge-copyright-notice.txt'
  version: '1.0.0-impl:etsi.org:ETSI_NFV_OpenAPI:1'
externalDocs:
  description: ETSI GS NFV-SOL 005 V3.5.1
  url: >-
    https://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/005/03.03.01_60/gs_nfv-sol005v030301p.pdf
servers:
  - url: 'http://127.0.0.1/nfvici/v1'
  - url: 'https://127.0.0.1/nfvici/v1'
paths:
  /api_versions:
    parameters:
      - name: Version
        description: |
          Version of the API requested to use when responding to this request.
        in: header
        required: true
        schema:
          type: string
    get:
      summary: Retrieve API version information
      description: >
        The GET method reads API version information. This method shall follow
        the provisions specified in table 4.6.3.3.3.2-1 for request and response
        data structures, and response codes. URI query parameters are not
        supported.
      responses:
        '200':
          description: >
            200 OK

            API version information was read successfully. The response body
            shall contain 4.4 API version information, as defined in clause
            4.4.1.13.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
            Version:
              description: The used API version.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              schema:
                description: |
                  This type represents API version information.
                type: object
                required:
                  - uriPrefix
                  - apiVersions
                properties:
                  uriPrefix:
                    description: >
                      Specifies the URI prefix for the API, in the following
                      form {apiRoot}/{apiName}/{apiMajorVersion}/.
                    type: string
                  apiVersions:
                    description: >
                      Version(s) supported for the API signalled by the
                      uriPrefix attribute.
                    type: array
                    items:
                      type: object
                      required:
                        - version
                      properties:
                        version:
                          description: >
                            Identifies a supported version. The value of the
                            version attribute shall be a version identifier as
                            specified in clause 4.6.1.
                          type: string
                        isDeprecated:
                          description: >
                            The Boolean is a data type having two values (TRUE
                            and FALSE).
                          type: boolean
                        retirementDate:
                          description: >
                            Date-time stamp. Representation: String formatted
                            according toas defined by the date-time production
                            in IETF RFC 3339.
                          format: date-time
        '400':
          description: >
            400 BAD REQUEST

            400 code can be returned in the following specified cases, the
            specific cause has to be proper specified in the "ProblemDetails"
            structure to be returned.

            If the request is malformed or syntactically incorrect (e.g. if the
            request URI contains incorrect query parameters or the payload body
            contains a syntactically incorrect data structure), 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 response to a GET request which queries a container resource
            would be so big that the performance of the API producer is
            adversely affected, and the API producer does not support paging for
            the affected resource, it 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 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.

            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.

            The use of this HTTP error response code described above is
            applicable to the use of the OAuth 2.0 for the authorization of API
            requests and notifications, as defined in clauses 4.5.3.3 and
            4.5.3.4.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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: >
            401 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:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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: >
            403 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.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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
        '404':
          description: >
            404 NOT FOUND

            If the API producer did not find a current representation for the
            resource addressed by the URI passed in the request or is not
            willing to disclose that one exists, it shall respond with this
            response code. The "ProblemDetails" structure may be provided,
            including in the "detail" attribute information about the source of
            the problem, e.g. a wrong resource URI variable.

            This response code is not appropriate in case the resource addressed
            by the URI is a container resource which is designed to contain
            child resources, but does not contain any child resource at the time
            the request is received. For a GET request to an existing empty
            container resource, a typical response contains a 200 OK response
            code and a payload body with an empty array.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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: >
            406 NOT ACCEPTABLE

            If the "Accept" HTTP header does not contain at least one name of a
            content type that is acceptable to the API producer, the API
            producer shall respond with this response code. The "ProblemDetails"
            structure may be omitted.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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
        '413':
          description: >
            413 PAYLOAD TOO LARGE

            If the payload body of a request is larger than the amount of data
            the API producer is willing or able to process, it shall respond
            with this response code, following the provisions in IETF RFC 7231
            for the use of the "Retry-After" HTTP header and for closing the
            connection. The "ProblemDetails" structure may be omitted.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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
        '414':
          description: >
            414 URI TOO LONG

            If the request URI of a request is longer than the API producer is
            willing or able to process, it shall respond with this response
            code. This condition can e.g. be caused by passing long queries in
            the request URI of a GET request. The "ProblemDetails" structure may
            be omitted.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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
        '416':
          description: |
            416 Range Not Satisfiable
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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
        '422':
          description: >
            422 UNPROCESSABLE ENTITY

            If the payload body of a request contains syntactically correct data
            (e.g. well-formed JSON) but the data cannot be processed (e.g.
            because it fails validation against a schema), 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.

            This error response code is only applicable for methods that have a
            request body.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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
        '429':
          description: >
            429 TOO MANY REQUESTS

            If the API consumer has sent too many requests in a defined period
            of time and the API producer is able to detect that condition ("rate
            limiting"), the API producer shall respond with this response code,
            following the provisions in IETF RFC 6585 [17] for the use of the
            "Retry-After" HTTP header. The "ProblemDetails" structure shall be
            provided and shall include in the "detail" attribute more
            information about the source of the problem.

            The period of time and allowed number of requests are configured
            within the API producer by means outside the scope of the present
            document.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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: >
            500 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 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.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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: >
            503 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 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.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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
        '504':
          description: >
            504 GATEWAY TIMEOUT

            If the API producer encounters a timeout while waiting for a
            response from an upstream server (i.e. a server that the API
            producer communicates with when fulfilling a request), it should
            respond with this response code.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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
    post:
      description: >
        This method is not supported. When this method is requested on this
        resource, the API producer shall return a "405 Method Not Allowed"
        response
      responses:
        '405':
          description: >
            405 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.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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
    put:
      description: >
        This method is not supported. When this method is requested on this
        resource, the API producer shall return a "405 Method Not Allowed"
        response
      responses:
        '405':
          description: >
            405 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.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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:
      description: >
        This method is not supported. When this method is requested on this
        resource, the API producer shall return a "405 Method Not Allowed"
        response
      responses:
        '405':
          description: >
            405 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.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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:
      description: >
        This method is not supported. When this method is requested on this
        resource, the API producer shall return a "405 Method Not Allowed"
        response
      responses:
        '405':
          description: >
            405 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.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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
  /nfvi_capacity_infos:
    parameters:
      - name: Version
        description: |
          Version of the API requested to use when responding to this request.
        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
    get:
      summary: Query NFVI capacity information
      description: >
        The API consumer can use this method to retrieve information about NFVI
        capacity information.
      parameters:
        - 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: all_fields
          description: >
            Include all complex attributes in the response. See clause 5.3 of
            ETSI GS NFV-SOL 013. The NFV-MANO functional entity shall support
            this parameter.
          in: query
          required: false
          schema:
            type: string
        - name: fields
          description: >
            Complex attributes to be included into the response. See clause 5.3
            of ETSI GS NFV-SOL 013 for details. The NFV-MANO functional entity
            should support this parameter.
          in: query
          required: false
          schema:
            type: string
        - name: exclude_fields
          description: >
            Complex attributes to be excluded from the response. See clause 5.3
            of ETSI GS NFV-SOL 013 for details. The NFV-MANO functional entity
            should support this parameter.
          in: query
          required: false
          schema:
            type: string
        - name: exclude_default
          in: query
          description: "Indicates to exclude the following complex attributes from the response. See clause 5.3 of ETSI GS NFV-SOL 013 for details. The NFV-MANO functional entity shall support this parameter. The NFVO shall support this parameter.\nThe following attributes shall be excluded from the NsInstance structure in the response body if this parameter is provided, or none of the parameters \"all_fields,\" \"fields\", \"exclude_fields\", \"exclude_default\" are provided: -\tvnfInstances -\tpnfInfo -\tvirtualLinkInfo -\tvnffgInfo -\tsapInfo -\tnsScaleStatus -\tadditionalAffinityOrAntiAffinityRules -   wanConnectionInfo"
          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: Accept
          description: >
            Content-Types that are acceptable for the response. Reference: IETF
            RFC 7231.
          in: header
          required: true
          schema:
            type: string
      responses:
        '200':
          description: >
            Shall be returned when information about NFVI capacity information
            has been queried successfully.

            The response body shall contain NFVI capacity information, as
            defined in clause 10.5.2.4.

            If the "filter" URI parameter was supplied in the request, the data
            in the response body shall have been

            transformed according to the rules specified in clauses 5.2.2 of
            ETSI GS NFV-SOL 013.

            If the NFVO supports alternative 2 (paging) according to clause
            5.4.2.1 of ETSI GS NFV-SOL 013 for this resource,

            inclusion of the Link HTTP header in this response shall follow the
            provisions in clause 5.4.2.3 of ETSI GS NFV-SOL 013.
          headers:
            Version:
              description: |
                Version of the API used in the response.
              style: simple
              explode: false
              schema:
                type: string
            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.
              style: simple
              explode: false
              schema:
                type: string
            Content-Type:
              description: The MIME type of the body of the response.
              style: simple
              explode: false
              schema:
                type: string
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  description: >
                    This type defines the format of the NFVI capacity
                    information. The type shall comply with the provisions
                    defined

                    in Table 10.5.2.4-1.
                  required:
                    - id
                    - vimId
                    - capacityInfoPerZone
                  properties:
                    id:
                      description: >
                        An identifier with the intention of being globally
                        unique.
                      type: string
                    vimId:
                      description: >
                        An identifier with the intention of being globally
                        unique.
                      type: string
                    capacityInfoPerZone:
                      description: >
                        Capacity information on a per resource zone basis under
                        control by the associated VIM.
                      type: array
                      items:
                        type: object
                        description: >
                          This type defines the format of the NFVI capacity
                          information on a per resource zone basis.

                          The type shall comply with the provisions defined in
                          table 10.5.2.5-1.
                        required:
                          - capacityMeasurements
                        properties:
                          resourceZoneId:
                            description: >
                              An identifier with the intention of being globally
                              unique.
                            type: string
                          capacityMeasurements:
                            description: |
                              Capacity measurement on a per resource type basis.
                            type: array
                            items:
                              type: object
                              description: >
                                This type defines the format of the NFVI
                                capacity information on a per resource type
                                basis.

                                The type shall comply with the provisions
                                defined in table 10.5.2.6-1.
                              required:
                                - resourceType
                                - capacityMeasurementName
                                - totalCapacity
                                - allocatedCapacity
                                - availableCapacity
                              properties:
                                resourceType:
                                  type: string
                                  description: >
                                    The enumeration
                                    NfviCapacityResourceTypeEnumeration shall
                                    comply with the provisions in table
                                    10.5.4.3-1.

                                    * VR_COMPUTE: For virtualised compute
                                    resource.

                                    * VR_NETWORK: For virtualised network
                                    resource.

                                    * VR_STORAGE: For virtualised storage
                                    resource.

                                    * HOST_COMPUTE: For host compute resource.
                                  enum:
                                    - VR_COMPUTE
                                    - VR_NETWORK
                                    - VR_STORAGE
                                    - HOST_COMPUTE
                                capacityMeasurementName:
                                  description: >
                                    Name of the capacity measurement. Different
                                    resource types can have different associated
                                    capacity measurements,

                                    typically associated to different sub-types
                                    of the resource type.

                                    The present document and referred documents
                                    do not specify the capacity measurements,
                                    thus the capacity

                                    measurement names are not specified in the
                                    present document version.
                                  type: string
                                totalCapacity:
                                  description: |
                                    The total capacity.
                                  type: object
                                allocatedCapacity:
                                  description: |
                                    The allocated/used capacity.
                                  type: object
                                reservedCapacity:
                                  description: >
                                    The reserved capacity. Shall be present if
                                    the capacity measurement relates to a
                                    resource type and

                                    (and sub-type) that is reservable.
                                  type: object
                                availableCapacity:
                                  description: |
                                    The available capacity.
                                  type: object
                    totalCapacityInfo:
                      type: object
                      description: >
                        This type defines the format of the NFVI capacity
                        information on a per resource type basis.

                        The type shall comply with the provisions defined in
                        table 10.5.2.6-1.
                      required:
                        - resourceType
                        - capacityMeasurementName
                        - totalCapacity
                        - allocatedCapacity
                        - availableCapacity
                      properties:
                        resourceType:
                          type: string
                          description: >
                            The enumeration NfviCapacityResourceTypeEnumeration
                            shall comply with the provisions in table
                            10.5.4.3-1.

                            * VR_COMPUTE: For virtualised compute resource.

                            * VR_NETWORK: For virtualised network resource.

                            * VR_STORAGE: For virtualised storage resource.

                            * HOST_COMPUTE: For host compute resource.
                          enum:
                            - VR_COMPUTE
                            - VR_NETWORK
                            - VR_STORAGE
                            - HOST_COMPUTE
                        capacityMeasurementName:
                          description: >
                            Name of the capacity measurement. Different resource
                            types can have different associated capacity
                            measurements,

                            typically associated to different sub-types of the
                            resource type.

                            The present document and referred documents do not
                            specify the capacity measurements, thus the capacity

                            measurement names are not specified in the present
                            document version.
                          type: string
                        totalCapacity:
                          description: |
                            The total capacity.
                          type: object
                        allocatedCapacity:
                          description: |
                            The allocated/used capacity.
                          type: object
                        reservedCapacity:
                          description: >
                            The reserved capacity. Shall be present if the
                            capacity measurement relates to a resource type and

                            (and sub-type) that is reservable.
                          type: object
                        availableCapacity:
                          description: |
                            The available capacity.
                          type: object
                    timeInterval:
                      type: object
                      description: >
                        This type defines the format of a time interval. The
                        type shall comply with the provisions defined in table
                        10.5.2.7-1.
                      required:
                        - aTime
                      properties:
                        aTime:
                          description: >
                            Date-time stamp. Representation: String formatted
                            according toas defined by the date-time production
                            in IETF RFC 3339.
                          format: date-time
                        bTime:
                          description: >
                            Date-time stamp. Representation: String formatted
                            according toas defined by the date-time production
                            in IETF RFC 3339.
                          format: date-time
        '400':
          description: >
            400 BAD REQUEST

            400 code can be returned in the following specified cases, the
            specific cause has to be proper specified in the "ProblemDetails"
            structure to be returned.

            If the request is malformed or syntactically incorrect (e.g. if the
            request URI contains incorrect query parameters or the payload body
            contains a syntactically incorrect data structure), 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 response to a GET request which queries a container resource
            would be so big that the performance of the API producer is
            adversely affected, and the API producer does not support paging for
            the affected resource, it 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 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.

            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.

            The use of this HTTP error response code described above is
            applicable to the use of the OAuth 2.0 for the authorization of API
            requests and notifications, as defined in clauses 4.5.3.3 and
            4.5.3.4.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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: >
            401 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:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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: >
            403 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.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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
        '404':
          description: >
            404 NOT FOUND

            If the API producer did not find a current representation for the
            resource addressed by the URI passed in the request or is not
            willing to disclose that one exists, it shall respond with this
            response code. The "ProblemDetails" structure may be provided,
            including in the "detail" attribute information about the source of
            the problem, e.g. a wrong resource URI variable.

            This response code is not appropriate in case the resource addressed
            by the URI is a container resource which is designed to contain
            child resources, but does not contain any child resource at the time
            the request is received. For a GET request to an existing empty
            container resource, a typical response contains a 200 OK response
            code and a payload body with an empty array.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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: >
            405 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.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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: >
            406 NOT ACCEPTABLE

            If the "Accept" HTTP header does not contain at least one name of a
            content type that is acceptable to the API producer, the API
            producer shall respond with this response code. The "ProblemDetails"
            structure may be omitted.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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: >
            500 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 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.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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: >
            503 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 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.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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
        '504':
          description: >
            504 GATEWAY TIMEOUT

            If the API producer encounters a timeout while waiting for a
            response from an upstream server (i.e. a server that the API
            producer communicates with when fulfilling a request), it should
            respond with this response code.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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
  '/nfvi_capacity_infos/{vimId}':
    parameters:
      - name: vimId
        in: path
        description: >
          Identifier of the VIM with associated NFVI capacity information.

          This identifier can be retrieved from the "vimId" attribute in the
          CapacityShortageNotification.

          It can also be retrieved from the "vimId" attribute in the payload
          body of the response.
        required: true
        style: simple
        explode: 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
      - name: Authorization
        description: |
          The authorization token for the request. Reference: IETF RFC 7235.
        in: header
        required: false
        schema:
          type: string
    get:
      summary: Query NFVI capacity information for a specific VIM
      description: >
        The API consumer can use this method for reading an individual VIM’s
        NFVI capacity information.
      parameters:
        - 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: Accept
          description: >
            Content-Types that are acceptable for the response. Reference: IETF
            RFC 7231.
          in: header
          required: true
          schema:
            type: string
      responses:
        '200':
          description: >
            Shall be returned when information of an individual VIM’s NFVI
            capacity has been read successfully.

            The response body shall contain a representation of  the NFVI
            capacity information, as defined in clause 10.5.2.4.
          headers:
            Version:
              description: |
                Version of the API used in the response.
              style: simple
              explode: false
              schema:
                type: string
            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.
              style: simple
              explode: false
              schema:
                type: string
            Content-Type:
              description: The MIME type of the body of the response.
              style: simple
              explode: false
              schema:
                type: string
          content:
            application/json:
              schema:
                type: object
                description: >
                  This type defines the format of the NFVI capacity information.
                  The type shall comply with the provisions defined

                  in Table 10.5.2.4-1.
                required:
                  - id
                  - vimId
                  - capacityInfoPerZone
                properties:
                  id:
                    description: |
                      An identifier with the intention of being globally unique.
                    type: string
                  vimId:
                    description: |
                      An identifier with the intention of being globally unique.
                    type: string
                  capacityInfoPerZone:
                    description: >
                      Capacity information on a per resource zone basis under
                      control by the associated VIM.
                    type: array
                    items:
                      type: object
                      description: >
                        This type defines the format of the NFVI capacity
                        information on a per resource zone basis.

                        The type shall comply with the provisions defined in
                        table 10.5.2.5-1.
                      required:
                        - capacityMeasurements
                      properties:
                        resourceZoneId:
                          description: >
                            An identifier with the intention of being globally
                            unique.
                          type: string
                        capacityMeasurements:
                          description: |
                            Capacity measurement on a per resource type basis.
                          type: array
                          items:
                            type: object
                            description: >
                              This type defines the format of the NFVI capacity
                              information on a per resource type basis.

                              The type shall comply with the provisions defined
                              in table 10.5.2.6-1.
                            required:
                              - resourceType
                              - capacityMeasurementName
                              - totalCapacity
                              - allocatedCapacity
                              - availableCapacity
                            properties:
                              resourceType:
                                type: string
                                description: >
                                  The enumeration
                                  NfviCapacityResourceTypeEnumeration shall
                                  comply with the provisions in table
                                  10.5.4.3-1.

                                  * VR_COMPUTE: For virtualised compute
                                  resource.

                                  * VR_NETWORK: For virtualised network
                                  resource.

                                  * VR_STORAGE: For virtualised storage
                                  resource.

                                  * HOST_COMPUTE: For host compute resource.
                                enum:
                                  - VR_COMPUTE
                                  - VR_NETWORK
                                  - VR_STORAGE
                                  - HOST_COMPUTE
                              capacityMeasurementName:
                                description: >
                                  Name of the capacity measurement. Different
                                  resource types can have different associated
                                  capacity measurements,

                                  typically associated to different sub-types of
                                  the resource type.

                                  The present document and referred documents do
                                  not specify the capacity measurements, thus
                                  the capacity

                                  measurement names are not specified in the
                                  present document version.
                                type: string
                              totalCapacity:
                                description: |
                                  The total capacity.
                                type: object
                              allocatedCapacity:
                                description: |
                                  The allocated/used capacity.
                                type: object
                              reservedCapacity:
                                description: >
                                  The reserved capacity. Shall be present if the
                                  capacity measurement relates to a resource
                                  type and

                                  (and sub-type) that is reservable.
                                type: object
                              availableCapacity:
                                description: |
                                  The available capacity.
                                type: object
                  totalCapacityInfo:
                    type: object
                    description: >
                      This type defines the format of the NFVI capacity
                      information on a per resource type basis.

                      The type shall comply with the provisions defined in table
                      10.5.2.6-1.
                    required:
                      - resourceType
                      - capacityMeasurementName
                      - totalCapacity
                      - allocatedCapacity
                      - availableCapacity
                    properties:
                      resourceType:
                        type: string
                        description: >
                          The enumeration NfviCapacityResourceTypeEnumeration
                          shall comply with the provisions in table 10.5.4.3-1.

                          * VR_COMPUTE: For virtualised compute resource.

                          * VR_NETWORK: For virtualised network resource.

                          * VR_STORAGE: For virtualised storage resource.

                          * HOST_COMPUTE: For host compute resource.
                        enum:
                          - VR_COMPUTE
                          - VR_NETWORK
                          - VR_STORAGE
                          - HOST_COMPUTE
                      capacityMeasurementName:
                        description: >
                          Name of the capacity measurement. Different resource
                          types can have different associated capacity
                          measurements,

                          typically associated to different sub-types of the
                          resource type.

                          The present document and referred documents do not
                          specify the capacity measurements, thus the capacity

                          measurement names are not specified in the present
                          document version.
                        type: string
                      totalCapacity:
                        description: |
                          The total capacity.
                        type: object
                      allocatedCapacity:
                        description: |
                          The allocated/used capacity.
                        type: object
                      reservedCapacity:
                        description: >
                          The reserved capacity. Shall be present if the
                          capacity measurement relates to a resource type and

                          (and sub-type) that is reservable.
                        type: object
                      availableCapacity:
                        description: |
                          The available capacity.
                        type: object
                  timeInterval:
                    type: object
                    description: >
                      This type defines the format of a time interval. The type
                      shall comply with the provisions defined in table
                      10.5.2.7-1.
                    required:
                      - aTime
                    properties:
                      aTime:
                        description: >
                          Date-time stamp. Representation: String formatted
                          according toas defined by the date-time production in
                          IETF RFC 3339.
                        format: date-time
                      bTime:
                        description: >
                          Date-time stamp. Representation: String formatted
                          according toas defined by the date-time production in
                          IETF RFC 3339.
                        format: date-time
        '400':
          description: >
            400 BAD REQUEST

            400 code can be returned in the following specified cases, the
            specific cause has to be proper specified in the "ProblemDetails"
            structure to be returned.

            If the request is malformed or syntactically incorrect (e.g. if the
            request URI contains incorrect query parameters or the payload body
            contains a syntactically incorrect data structure), 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 response to a GET request which queries a container resource
            would be so big that the performance of the API producer is
            adversely affected, and the API producer does not support paging for
            the affected resource, it 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 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.

            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.

            The use of this HTTP error response code described above is
            applicable to the use of the OAuth 2.0 for the authorization of API
            requests and notifications, as defined in clauses 4.5.3.3 and
            4.5.3.4.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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: >
            401 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:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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: >
            403 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.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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
        '404':
          description: >
            404 NOT FOUND

            If the API producer did not find a current representation for the
            resource addressed by the URI passed in the request or is not
            willing to disclose that one exists, it shall respond with this
            response code. The "ProblemDetails" structure may be provided,
            including in the "detail" attribute information about the source of
            the problem, e.g. a wrong resource URI variable.

            This response code is not appropriate in case the resource addressed
            by the URI is a container resource which is designed to contain
            child resources, but does not contain any child resource at the time
            the request is received. For a GET request to an existing empty
            container resource, a typical response contains a 200 OK response
            code and a payload body with an empty array.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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: >
            405 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.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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: >
            406 NOT ACCEPTABLE

            If the "Accept" HTTP header does not contain at least one name of a
            content type that is acceptable to the API producer, the API
            producer shall respond with this response code. The "ProblemDetails"
            structure may be omitted.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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: >
            500 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 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.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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: >
            503 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 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.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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
        '504':
          description: >
            504 GATEWAY TIMEOUT

            If the API producer encounters a timeout while waiting for a
            response from an upstream server (i.e. a server that the API
            producer communicates with when fulfilling a request), it should
            respond with this response code.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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
  /capacity_thresholds:
    parameters:
      - name: Version
        description: |
          Version of the API requested to use when responding to this request.
        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
    get:
      summary: Query NFVI capacity thresholds
      description: >
        This resource represents NFVI capacity thresholds.

        The API consumer can use this resource to create and query NFVI capacity
        thresholds.
      parameters:
        - 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: Accept
          description: >
            Content-Types that are acceptable for the response. Reference: IETF
            RFC 7231.
          in: header
          required: true
          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
      responses:
        '200':
          description: >
            Shall be returned when information about zero or more capacity
            thresholds has been queried successfully.

            If the "filter" URI parameter was supplied in the request, the data
            in the response body shall have been

            transformed according to the rules specified in clause 5.2.2 of ETSI
            GS NFV-SOL 013.

            The response body shall contain in an array the representations of
            zero or more capacity thresholds, as

            defined in clause 10.5.2.8.

            If the NFVO supports alternative 2 (paging) according to clause
            5.4.2.1 of ETSI GS NFV-SOL 013 for this resource,

            inclusion of the Link HTTP header in this response shall follow the
            provisions in clause 5.4.2.3 of ETSI GS NFV-SOL 013.
          headers:
            Version:
              description: |
                Version of the API used in the response.
              style: simple
              explode: false
              schema:
                type: string
            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.
              style: simple
              explode: false
              schema:
                type: string
            Content-Type:
              description: The MIME type of the body of the response.
              style: simple
              explode: false
              schema:
                type: string
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  description: >
                    This type represents a capacity threshold. It shall comply
                    with the provisions defined in table 10.5.2.8-1.
                  required:
                    - id
                    - objectInstanceId
                    - criteria
                    - callbackUri
                    - _links
                  properties:
                    id:
                      description: >
                        An identifier with the intention of being globally
                        unique.
                      type: string
                    objectInstanceId:
                      description: >
                        An identifier with the intention of being globally
                        unique.
                      type: string
                    subObjectInstanceIds:
                      description: >
                        Identifiers of the sub-object instances of the measured
                        object instance associate with this capacity threshold.

                        If this attribute is absent, measurements are taken for
                        all sub-object instances of the measured object
                        instance.
                      type: array
                      items:
                        description: >
                          An identifier maintained by the VIM or other resource
                          provider. It is expected to be unique within the VIM
                          instance. Representation: string of variable length.
                        type: string
                    criteria:
                      type: object
                      description: >
                        This type represents criteria that define a capacity
                        threshold.

                        It shall comply with the provisions defined in table
                        10.5.3.3-1.
                      required:
                        - capacityMetric
                        - thresholdType
                      properties:
                        capacityMetric:
                          description: >
                            Defines the capacity metric for which the threshold
                            applies.
                          type: object
                          required:
                            - resourceType
                            - capacityMeasurementName
                            - capacityType
                          properties:
                            resourceType:
                              type: string
                              description: >
                                The enumeration
                                NfviCapacityResourceTypeEnumeration shall comply
                                with the provisions in table 10.5.4.3-1.

                                * VR_COMPUTE: For virtualised compute resource.

                                * VR_NETWORK: For virtualised network resource.

                                * VR_STORAGE: For virtualised storage resource.

                                * HOST_COMPUTE: For host compute resource.
                              enum:
                                - VR_COMPUTE
                                - VR_NETWORK
                                - VR_STORAGE
                                - HOST_COMPUTE
                            capacityMeasurementName:
                              description: >
                                Name of the capacity measurement. Different
                                resource types can have different associated
                                capacity measurements,

                                typically associated to different sub-types of
                                the resource type.
                              type: string
                            capacityType:
                              description: "The type of capacity for the threshold.\nPermitted values:\n-\tTOTAL: for total capacity.\n-\tALLOCATED: for allocated/used capacity.\n-\tRESERVED: for reserved capacity.\n-\tAVAILABLE: for available capacity.\n"
                              type: string
                              enum:
                                - TOTAL
                                - ALLOCATED
                                - RESERVED
                                - AVAILABLE
                        thresholdType:
                          description: "Type of capacity threshold. This attribute determines which other attributes are present in the data structure.\nPermitted values:\n-\tSIMPLE: Single-valued static threshold.\nIn the present document, simple thresholds are defined. The definition of additional threshold types is left\nfor future specification.\n"
                          type: string
                          enum:
                            - SIMPLE
                        simpleThresholdDetails:
                          description: >
                            Details of a simple threshold. Shall be present if
                            thresholdType="SIMPLE".
                          type: array
                          items:
                            type: object
                            required:
                              - thresholdValue
                              - hysteresis
                            properties:
                              thresholdValue:
                                description: >
                                  The threshold value. Shall be represented as a
                                  floating point number.
                                type: number
                              hysteresis:
                                description: >
                                  The hysteresis of the threshold.

                                  Shall be represented as a non-negative
                                  floating point number.

                                  A notification with crossing direction "UP"
                                  will be generated if the measured value
                                  reaches or

                                  exceeds "thresholdValue" + "hysteresis". A
                                  notification with crossing direction "DOWN"
                                  will be

                                  generated if the measured value reaches or
                                  undercuts "thresholdValue" - "hysteresis".

                                  The hysteresis is defined to prevent storms of
                                  threshold crossing notifications.

                                  When processing a request to create a
                                  threshold, implementations should enforce a
                                  suitable minimum

                                  value for this attribute (e.g. override the
                                  value or reject the request).
                                type: number
                    callbackUri:
                      description: |
                        String formatted according to IETF RFC 3986.
                      type: string
                      format: uri
                    _links:
                      type: object
                      description: |
                        Links for this resource.
                      required:
                        - self
                      properties:
                        self:
                          description: |
                            This type represents a link to a resource.
                          type: object
                          required:
                            - href
                          properties:
                            href:
                              description: >
                                URI of a resource referenced from a
                                notification. Should be an absolute URI (i.e. a
                                URI that contains {apiRoot}), however, may be a
                                relative URI (i.e. a URI where the {apiRoot}
                                part is omitted) if the {apiRoot} information is
                                not available.
                              type: string
                              format: url
                        object:
                          description: |
                            This type represents a link to a resource.
                          type: object
                          required:
                            - href
                          properties:
                            href:
                              description: >
                                URI of a resource referenced from a
                                notification. Should be an absolute URI (i.e. a
                                URI that contains {apiRoot}), however, may be a
                                relative URI (i.e. a URI where the {apiRoot}
                                part is omitted) if the {apiRoot} information is
                                not available.
                              type: string
                              format: url
        '400':
          description: >
            400 BAD REQUEST

            400 code can be returned in the following specified cases, the
            specific cause has to be proper specified in the "ProblemDetails"
            structure to be returned.

            If the request is malformed or syntactically incorrect (e.g. if the
            request URI contains incorrect query parameters or the payload body
            contains a syntactically incorrect data structure), 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 response to a GET request which queries a container resource
            would be so big that the performance of the API producer is
            adversely affected, and the API producer does not support paging for
            the affected resource, it 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 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.

            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.

            The use of this HTTP error response code described above is
            applicable to the use of the OAuth 2.0 for the authorization of API
            requests and notifications, as defined in clauses 4.5.3.3 and
            4.5.3.4.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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: >
            401 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:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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: >
            403 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.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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
        '404':
          description: >
            404 NOT FOUND

            If the API producer did not find a current representation for the
            resource addressed by the URI passed in the request or is not
            willing to disclose that one exists, it shall respond with this
            response code. The "ProblemDetails" structure may be provided,
            including in the "detail" attribute information about the source of
            the problem, e.g. a wrong resource URI variable.

            This response code is not appropriate in case the resource addressed
            by the URI is a container resource which is designed to contain
            child resources, but does not contain any child resource at the time
            the request is received. For a GET request to an existing empty
            container resource, a typical response contains a 200 OK response
            code and a payload body with an empty array.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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: >
            405 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.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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: >
            406 NOT ACCEPTABLE

            If the "Accept" HTTP header does not contain at least one name of a
            content type that is acceptable to the API producer, the API
            producer shall respond with this response code. The "ProblemDetails"
            structure may be omitted.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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: >
            500 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 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.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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: >
            503 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 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.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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
        '504':
          description: >
            504 GATEWAY TIMEOUT

            If the API producer encounters a timeout while waiting for a
            response from an upstream server (i.e. a server that the API
            producer communicates with when fulfilling a request), it should
            respond with this response code.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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
    post:
      summary: Create a NFVI capacity threshold
      description: >
        The POST method creates a new NFVI capacity threshold.

        As a result of successfully executing this method, a new "Individual
        capacity threshold" resource as defined

        in clause 10.4.5 shall have been created.
      parameters:
        - name: Accept
          description: >
            Content-Types that are acceptable for the response. Reference: IETF
            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
      requestBody:
        description: >
          Request parameters to create a new "Individual capacity threshold"
          resource.
        content:
          application/json:
            schema:
              type: object
              description: >
                This type represents a request to create a capacity threshold.
                It shall comply with the provisions defined in

                table 10.5.2.3-1.
              required:
                - objectInstanceId
                - criteria
              properties:
                objectInstanceId:
                  description: |
                    An identifier with the intention of being globally unique.
                  type: string
                subObjectInstanceIds:
                  description: >
                    Identifiers of the sub-object instances of the measured
                    object instance associate with this capacity threshold.

                    If this attribute is absent, measurements will be taken for
                    all sub-object instances of the measured object instance.
                  type: array
                  items:
                    description: >
                      An identifier maintained by the VIM or other resource
                      provider. It is expected to be unique within the VIM
                      instance. Representation: string of variable length.
                    type: string
                criteria:
                  type: object
                  description: >
                    This type represents criteria that define a capacity
                    threshold.

                    It shall comply with the provisions defined in table
                    10.5.3.3-1.
                  required:
                    - capacityMetric
                    - thresholdType
                  properties:
                    capacityMetric:
                      description: >
                        Defines the capacity metric for which the threshold
                        applies.
                      type: object
                      required:
                        - resourceType
                        - capacityMeasurementName
                        - capacityType
                      properties:
                        resourceType:
                          type: string
                          description: >
                            The enumeration NfviCapacityResourceTypeEnumeration
                            shall comply with the provisions in table
                            10.5.4.3-1.

                            * VR_COMPUTE: For virtualised compute resource.

                            * VR_NETWORK: For virtualised network resource.

                            * VR_STORAGE: For virtualised storage resource.

                            * HOST_COMPUTE: For host compute resource.
                          enum:
                            - VR_COMPUTE
                            - VR_NETWORK
                            - VR_STORAGE
                            - HOST_COMPUTE
                        capacityMeasurementName:
                          description: >
                            Name of the capacity measurement. Different resource
                            types can have different associated capacity
                            measurements,

                            typically associated to different sub-types of the
                            resource type.
                          type: string
                        capacityType:
                          description: "The type of capacity for the threshold.\nPermitted values:\n-\tTOTAL: for total capacity.\n-\tALLOCATED: for allocated/used capacity.\n-\tRESERVED: for reserved capacity.\n-\tAVAILABLE: for available capacity.\n"
                          type: string
                          enum:
                            - TOTAL
                            - ALLOCATED
                            - RESERVED
                            - AVAILABLE
                    thresholdType:
                      description: "Type of capacity threshold. This attribute determines which other attributes are present in the data structure.\nPermitted values:\n-\tSIMPLE: Single-valued static threshold.\nIn the present document, simple thresholds are defined. The definition of additional threshold types is left\nfor future specification.\n"
                      type: string
                      enum:
                        - SIMPLE
                    simpleThresholdDetails:
                      description: >
                        Details of a simple threshold. Shall be present if
                        thresholdType="SIMPLE".
                      type: array
                      items:
                        type: object
                        required:
                          - thresholdValue
                          - hysteresis
                        properties:
                          thresholdValue:
                            description: >
                              The threshold value. Shall be represented as a
                              floating point number.
                            type: number
                          hysteresis:
                            description: >
                              The hysteresis of the threshold.

                              Shall be represented as a non-negative floating
                              point number.

                              A notification with crossing direction "UP" will
                              be generated if the measured value reaches or

                              exceeds "thresholdValue" + "hysteresis". A
                              notification with crossing direction "DOWN" will
                              be

                              generated if the measured value reaches or
                              undercuts "thresholdValue" - "hysteresis".

                              The hysteresis is defined to prevent storms of
                              threshold crossing notifications.

                              When processing a request to create a threshold,
                              implementations should enforce a suitable minimum

                              value for this attribute (e.g. override the value
                              or reject the request).
                            type: number
                callbackUri:
                  description: |
                    String formatted according to IETF RFC 3986.
                  type: string
                  format: uri
                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.
                        - 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
                          format: uri
        required: true
      responses:
        '201':
          description: >
            Shall be returned when a capacity threshold has been created
            successfully.

            The response body shall contain a representation of the created
            "Individual capacity threshold" resource,

            as defined in clause 10.5.2.8.

            The HTTP response shall include a "Location" HTTP header that
            contains the resource URI of the created resource.
          headers:
            Version:
              description: |
                Version of the API used in the response.
              style: simple
              explode: false
              schema:
                type: string
            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.
              style: simple
              explode: false
              schema:
                type: string
            Content-Type:
              description: The MIME type of the body of the response.
              style: simple
              explode: false
              schema:
                type: string
          content:
            application/json:
              schema:
                type: object
                description: >
                  This type represents a capacity threshold. It shall comply
                  with the provisions defined in table 10.5.2.8-1.
                required:
                  - id
                  - objectInstanceId
                  - criteria
                  - callbackUri
                  - _links
                properties:
                  id:
                    description: |
                      An identifier with the intention of being globally unique.
                    type: string
                  objectInstanceId:
                    description: |
                      An identifier with the intention of being globally unique.
                    type: string
                  subObjectInstanceIds:
                    description: >
                      Identifiers of the sub-object instances of the measured
                      object instance associate with this capacity threshold.

                      If this attribute is absent, measurements are taken for
                      all sub-object instances of the measured object instance.
                    type: array
                    items:
                      description: >
                        An identifier maintained by the VIM or other resource
                        provider. It is expected to be unique within the VIM
                        instance. Representation: string of variable length.
                      type: string
                  criteria:
                    type: object
                    description: >
                      This type represents criteria that define a capacity
                      threshold.

                      It shall comply with the provisions defined in table
                      10.5.3.3-1.
                    required:
                      - capacityMetric
                      - thresholdType
                    properties:
                      capacityMetric:
                        description: >
                          Defines the capacity metric for which the threshold
                          applies.
                        type: object
                        required:
                          - resourceType
                          - capacityMeasurementName
                          - capacityType
                        properties:
                          resourceType:
                            type: string
                            description: >
                              The enumeration
                              NfviCapacityResourceTypeEnumeration shall comply
                              with the provisions in table 10.5.4.3-1.

                              * VR_COMPUTE: For virtualised compute resource.

                              * VR_NETWORK: For virtualised network resource.

                              * VR_STORAGE: For virtualised storage resource.

                              * HOST_COMPUTE: For host compute resource.
                            enum:
                              - VR_COMPUTE
                              - VR_NETWORK
                              - VR_STORAGE
                              - HOST_COMPUTE
                          capacityMeasurementName:
                            description: >
                              Name of the capacity measurement. Different
                              resource types can have different associated
                              capacity measurements,

                              typically associated to different sub-types of the
                              resource type.
                            type: string
                          capacityType:
                            description: "The type of capacity for the threshold.\nPermitted values:\n-\tTOTAL: for total capacity.\n-\tALLOCATED: for allocated/used capacity.\n-\tRESERVED: for reserved capacity.\n-\tAVAILABLE: for available capacity.\n"
                            type: string
                            enum:
                              - TOTAL
                              - ALLOCATED
                              - RESERVED
                              - AVAILABLE
                      thresholdType:
                        description: "Type of capacity threshold. This attribute determines which other attributes are present in the data structure.\nPermitted values:\n-\tSIMPLE: Single-valued static threshold.\nIn the present document, simple thresholds are defined. The definition of additional threshold types is left\nfor future specification.\n"
                        type: string
                        enum:
                          - SIMPLE
                      simpleThresholdDetails:
                        description: >
                          Details of a simple threshold. Shall be present if
                          thresholdType="SIMPLE".
                        type: array
                        items:
                          type: object
                          required:
                            - thresholdValue
                            - hysteresis
                          properties:
                            thresholdValue:
                              description: >
                                The threshold value. Shall be represented as a
                                floating point number.
                              type: number
                            hysteresis:
                              description: >
                                The hysteresis of the threshold.

                                Shall be represented as a non-negative floating
                                point number.

                                A notification with crossing direction "UP" will
                                be generated if the measured value reaches or

                                exceeds "thresholdValue" + "hysteresis". A
                                notification with crossing direction "DOWN" will
                                be

                                generated if the measured value reaches or
                                undercuts "thresholdValue" - "hysteresis".

                                The hysteresis is defined to prevent storms of
                                threshold crossing notifications.

                                When processing a request to create a threshold,
                                implementations should enforce a suitable
                                minimum

                                value for this attribute (e.g. override the
                                value or reject the request).
                              type: number
                  callbackUri:
                    description: |
                      String formatted according to IETF RFC 3986.
                    type: string
                    format: uri
                  _links:
                    type: object
                    description: |
                      Links for this resource.
                    required:
                      - self
                    properties:
                      self:
                        description: |
                          This type represents a link to a resource.
                        type: object
                        required:
                          - href
                        properties:
                          href:
                            description: >
                              URI of a resource referenced from a notification.
                              Should be an absolute URI (i.e. a URI that
                              contains {apiRoot}), however, may be a relative
                              URI (i.e. a URI where the {apiRoot} part is
                              omitted) if the {apiRoot} information is not
                              available.
                            type: string
                            format: url
                      object:
                        description: |
                          This type represents a link to a resource.
                        type: object
                        required:
                          - href
                        properties:
                          href:
                            description: >
                              URI of a resource referenced from a notification.
                              Should be an absolute URI (i.e. a URI that
                              contains {apiRoot}), however, may be a relative
                              URI (i.e. a URI where the {apiRoot} part is
                              omitted) if the {apiRoot} information is not
                              available.
                            type: string
                            format: url
        '400':
          description: >
            400 BAD REQUEST

            400 code can be returned in the following specified cases, the
            specific cause has to be proper specified in the "ProblemDetails"
            structure to be returned.

            If the request is malformed or syntactically incorrect (e.g. if the
            request URI contains incorrect query parameters or the payload body
            contains a syntactically incorrect data structure), 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 response to a GET request which queries a container resource
            would be so big that the performance of the API producer is
            adversely affected, and the API producer does not support paging for
            the affected resource, it 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 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.

            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.

            The use of this HTTP error response code described above is
            applicable to the use of the OAuth 2.0 for the authorization of API
            requests and notifications, as defined in clauses 4.5.3.3 and
            4.5.3.4.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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: >
            401 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:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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: >
            403 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.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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
        '404':
          description: >
            404 NOT FOUND

            If the API producer did not find a current representation for the
            resource addressed by the URI passed in the request or is not
            willing to disclose that one exists, it shall respond with this
            response code. The "ProblemDetails" structure may be provided,
            including in the "detail" attribute information about the source of
            the problem, e.g. a wrong resource URI variable.

            This response code is not appropriate in case the resource addressed
            by the URI is a container resource which is designed to contain
            child resources, but does not contain any child resource at the time
            the request is received. For a GET request to an existing empty
            container resource, a typical response contains a 200 OK response
            code and a payload body with an empty array.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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: >
            405 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.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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: >
            406 NOT ACCEPTABLE

            If the "Accept" HTTP header does not contain at least one name of a
            content type that is acceptable to the API producer, the API
            producer shall respond with this response code. The "ProblemDetails"
            structure may be omitted.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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
        '422':
          description: >
            422 UNPROCESSABLE ENTITY

            If the payload body of a request contains syntactically correct data
            (e.g. well-formed JSON) but the data cannot be processed (e.g.
            because it fails validation against a schema), 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.

            This error response code is only applicable for methods that have a
            request body.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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: >
            500 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 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.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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: >
            503 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 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.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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
        '504':
          description: >
            504 GATEWAY TIMEOUT

            If the API producer encounters a timeout while waiting for a
            response from an upstream server (i.e. a server that the API
            producer communicates with when fulfilling a request), it should
            respond with this response code.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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
  '/capacity_thresholds/{capacityThresholdId}':
    parameters:
      - name: capacityThresholdId
        in: path
        description: >
          Identifier of the capacity threshold.

          This identifier can be retrieved from the resource referenced by the
          "Location" HTTP header in the response to

          a POST request creating a new "Individual capacity threshold"
          resource. It can also be retrieved from the "id"

          attribute in the payload body of that response.
        required: true
        style: simple
        explode: 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
      - name: Authorization
        description: |
          The authorization token for the request. Reference: IETF RFC 7235.
        in: header
        required: false
        schema:
          type: string
    get:
      summary: Query Individual NFVI capacity threshold
      description: >
        The API consumer can use this method for reading information about an
        NFVI capacity threshold.

        This method shall follow the provisions specified in the tables
        10.4.5.3.2-1 and 10.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
          schema:
            type: string
      responses:
        '200':
          description: >
            Shall be returned when information about an individual capacity
            threshold has been read successfully.

            The response body shall contain in a representation of the capacity
            threshold, as defined in clause 10.5.2.8.
          headers:
            Version:
              description: |
                Version of the API used in the response.
              style: simple
              explode: false
              schema:
                type: string
            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.
              style: simple
              explode: false
              schema:
                type: string
            Content-Type:
              description: The MIME type of the body of the response.
              style: simple
              explode: false
              schema:
                type: string
          content:
            application/json:
              schema:
                type: object
                description: >
                  This type represents a capacity threshold. It shall comply
                  with the provisions defined in table 10.5.2.8-1.
                required:
                  - id
                  - objectInstanceId
                  - criteria
                  - callbackUri
                  - _links
                properties:
                  id:
                    description: |
                      An identifier with the intention of being globally unique.
                    type: string
                  objectInstanceId:
                    description: |
                      An identifier with the intention of being globally unique.
                    type: string
                  subObjectInstanceIds:
                    description: >
                      Identifiers of the sub-object instances of the measured
                      object instance associate with this capacity threshold.

                      If this attribute is absent, measurements are taken for
                      all sub-object instances of the measured object instance.
                    type: array
                    items:
                      description: >
                        An identifier maintained by the VIM or other resource
                        provider. It is expected to be unique within the VIM
                        instance. Representation: string of variable length.
                      type: string
                  criteria:
                    type: object
                    description: >
                      This type represents criteria that define a capacity
                      threshold.

                      It shall comply with the provisions defined in table
                      10.5.3.3-1.
                    required:
                      - capacityMetric
                      - thresholdType
                    properties:
                      capacityMetric:
                        description: >
                          Defines the capacity metric for which the threshold
                          applies.
                        type: object
                        required:
                          - resourceType
                          - capacityMeasurementName
                          - capacityType
                        properties:
                          resourceType:
                            type: string
                            description: >
                              The enumeration
                              NfviCapacityResourceTypeEnumeration shall comply
                              with the provisions in table 10.5.4.3-1.

                              * VR_COMPUTE: For virtualised compute resource.

                              * VR_NETWORK: For virtualised network resource.

                              * VR_STORAGE: For virtualised storage resource.

                              * HOST_COMPUTE: For host compute resource.
                            enum:
                              - VR_COMPUTE
                              - VR_NETWORK
                              - VR_STORAGE
                              - HOST_COMPUTE
                          capacityMeasurementName:
                            description: >
                              Name of the capacity measurement. Different
                              resource types can have different associated
                              capacity measurements,

                              typically associated to different sub-types of the
                              resource type.
                            type: string
                          capacityType:
                            description: "The type of capacity for the threshold.\nPermitted values:\n-\tTOTAL: for total capacity.\n-\tALLOCATED: for allocated/used capacity.\n-\tRESERVED: for reserved capacity.\n-\tAVAILABLE: for available capacity.\n"
                            type: string
                            enum:
                              - TOTAL
                              - ALLOCATED
                              - RESERVED
                              - AVAILABLE
                      thresholdType:
                        description: "Type of capacity threshold. This attribute determines which other attributes are present in the data structure.\nPermitted values:\n-\tSIMPLE: Single-valued static threshold.\nIn the present document, simple thresholds are defined. The definition of additional threshold types is left\nfor future specification.\n"
                        type: string
                        enum:
                          - SIMPLE
                      simpleThresholdDetails:
                        description: >
                          Details of a simple threshold. Shall be present if
                          thresholdType="SIMPLE".
                        type: array
                        items:
                          type: object
                          required:
                            - thresholdValue
                            - hysteresis
                          properties:
                            thresholdValue:
                              description: >
                                The threshold value. Shall be represented as a
                                floating point number.
                              type: number
                            hysteresis:
                              description: >
                                The hysteresis of the threshold.

                                Shall be represented as a non-negative floating
                                point number.

                                A notification with crossing direction "UP" will
                                be generated if the measured value reaches or

                                exceeds "thresholdValue" + "hysteresis". A
                                notification with crossing direction "DOWN" will
                                be

                                generated if the measured value reaches or
                                undercuts "thresholdValue" - "hysteresis".

                                The hysteresis is defined to prevent storms of
                                threshold crossing notifications.

                                When processing a request to create a threshold,
                                implementations should enforce a suitable
                                minimum

                                value for this attribute (e.g. override the
                                value or reject the request).
                              type: number
                  callbackUri:
                    description: |
                      String formatted according to IETF RFC 3986.
                    type: string
                    format: uri
                  _links:
                    type: object
                    description: |
                      Links for this resource.
                    required:
                      - self
                    properties:
                      self:
                        description: |
                          This type represents a link to a resource.
                        type: object
                        required:
                          - href
                        properties:
                          href:
                            description: >
                              URI of a resource referenced from a notification.
                              Should be an absolute URI (i.e. a URI that
                              contains {apiRoot}), however, may be a relative
                              URI (i.e. a URI where the {apiRoot} part is
                              omitted) if the {apiRoot} information is not
                              available.
                            type: string
                            format: url
                      object:
                        description: |
                          This type represents a link to a resource.
                        type: object
                        required:
                          - href
                        properties:
                          href:
                            description: >
                              URI of a resource referenced from a notification.
                              Should be an absolute URI (i.e. a URI that
                              contains {apiRoot}), however, may be a relative
                              URI (i.e. a URI where the {apiRoot} part is
                              omitted) if the {apiRoot} information is not
                              available.
                            type: string
                            format: url
        '400':
          description: >
            400 BAD REQUEST

            400 code can be returned in the following specified cases, the
            specific cause has to be proper specified in the "ProblemDetails"
            structure to be returned.

            If the request is malformed or syntactically incorrect (e.g. if the
            request URI contains incorrect query parameters or the payload body
            contains a syntactically incorrect data structure), 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 response to a GET request which queries a container resource
            would be so big that the performance of the API producer is
            adversely affected, and the API producer does not support paging for
            the affected resource, it 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 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.

            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.

            The use of this HTTP error response code described above is
            applicable to the use of the OAuth 2.0 for the authorization of API
            requests and notifications, as defined in clauses 4.5.3.3 and
            4.5.3.4.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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: >
            401 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:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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: >
            403 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.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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
        '404':
          description: >
            404 NOT FOUND

            If the API producer did not find a current representation for the
            resource addressed by the URI passed in the request or is not
            willing to disclose that one exists, it shall respond with this
            response code. The "ProblemDetails" structure may be provided,
            including in the "detail" attribute information about the source of
            the problem, e.g. a wrong resource URI variable.

            This response code is not appropriate in case the resource addressed
            by the URI is a container resource which is designed to contain
            child resources, but does not contain any child resource at the time
            the request is received. For a GET request to an existing empty
            container resource, a typical response contains a 200 OK response
            code and a payload body with an empty array.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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: >
            405 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.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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: >
            406 NOT ACCEPTABLE

            If the "Accept" HTTP header does not contain at least one name of a
            content type that is acceptable to the API producer, the API
            producer shall respond with this response code. The "ProblemDetails"
            structure may be omitted.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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: >
            500 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 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.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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: >
            503 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 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.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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
        '504':
          description: >
            504 GATEWAY TIMEOUT

            If the API producer encounters a timeout while waiting for a
            response from an upstream server (i.e. a server that the API
            producer communicates with when fulfilling a request), it should
            respond with this response code.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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: Modify an "Individual capacity threshold" resource
      description: >
        This method iallows to modify an "Individual capacity threshold"
        resource.

        This method shall follow the provisions specified in the Tables
        10.4.5.3.4-1 and 10.4.5.3.4-2 for URI query

        parameters, request and response data structures, and response codes.
      requestBody:
        description: >
          Parameters for the capacity threshold modification.

          The Content-Type header shall be set to "application/merge-patch+json"
          according to IETF RFC 7396.
        content:
          application/json:
            schema:
              description: >
                This type represents modifications to a capacity threshold. It
                shall comply with the provisions defined in table 10.5.2.8-1.
              type: object
              properties:
                callbackUri:
                  description: |
                    String formatted according to IETF RFC 3986.
                  type: string
                  format: uri
                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.
                        - 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
                          format: uri
        required: true
      responses:
        '200':
          description: >
            200 OK

            Shall be returned when the request has been processed successfully.

            The response body shall contain a data structure of type
            "CapacityThresholdModifications".
          headers:
            Version:
              description: |
                Version of the API used in the response.
              style: simple
              explode: false
              schema:
                type: string
            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.
              style: simple
              explode: false
              schema:
                type: string
            Content-Type:
              description: The MIME type of the body of the response.
              style: simple
              explode: false
              schema:
                type: string
          content:
            application/json:
              schema:
                description: >
                  This type represents modifications to a capacity threshold. It
                  shall comply with the provisions defined in table 10.5.2.8-1.
                type: object
                properties:
                  callbackUri:
                    description: |
                      String formatted according to IETF RFC 3986.
                    type: string
                    format: uri
                  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.
                          - 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
                            format: uri
        '400':
          description: >
            400 BAD REQUEST

            400 code can be returned in the following specified cases, the
            specific cause has to be proper specified in the "ProblemDetails"
            structure to be returned.

            If the request is malformed or syntactically incorrect (e.g. if the
            request URI contains incorrect query parameters or the payload body
            contains a syntactically incorrect data structure), 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 response to a GET request which queries a container resource
            would be so big that the performance of the API producer is
            adversely affected, and the API producer does not support paging for
            the affected resource, it 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 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.

            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.

            The use of this HTTP error response code described above is
            applicable to the use of the OAuth 2.0 for the authorization of API
            requests and notifications, as defined in clauses 4.5.3.3 and
            4.5.3.4.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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: >
            401 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:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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: >
            403 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.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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
        '404':
          description: >
            404 NOT FOUND

            If the API producer did not find a current representation for the
            resource addressed by the URI passed in the request or is not
            willing to disclose that one exists, it shall respond with this
            response code. The "ProblemDetails" structure may be provided,
            including in the "detail" attribute information about the source of
            the problem, e.g. a wrong resource URI variable.

            This response code is not appropriate in case the resource addressed
            by the URI is a container resource which is designed to contain
            child resources, but does not contain any child resource at the time
            the request is received. For a GET request to an existing empty
            container resource, a typical response contains a 200 OK response
            code and a payload body with an empty array.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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: >
            405 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.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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: >
            406 NOT ACCEPTABLE

            If the "Accept" HTTP header does not contain at least one name of a
            content type that is acceptable to the API producer, the API
            producer shall respond with this response code. The "ProblemDetails"
            structure may be omitted.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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: >
            412 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.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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
        '422':
          description: >
            422 UNPROCESSABLE ENTITY

            If the payload body of a request contains syntactically correct data
            (e.g. well-formed JSON) but the data cannot be processed (e.g.
            because it fails validation against a schema), 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.

            This error response code is only applicable for methods that have a
            request body.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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: >
            500 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 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.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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: >
            503 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 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.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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
        '504':
          description: >
            504 GATEWAY TIMEOUT

            If the API producer encounters a timeout while waiting for a
            response from an upstream server (i.e. a server that the API
            producer communicates with when fulfilling a request), it should
            respond with this response code.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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: Delete an NFVI capacity threshold
      description: >
        This method allows to delete an NFVI capacity threshold.

        As a result of successfully executing this method, the "Individual
        capacity threshold" resource shall not exist

        any longer.
      responses:
        '204':
          description: >
            Shall be returned when the NFVI capacity threshold has been deleted
            successfully.

            The response body shall be empty.
          headers:
            Version:
              description: |
                Version of the API used in the response.
              style: simple
              explode: false
              schema:
                type: string
            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.
              style: simple
              explode: false
              schema:
                type: string
            Content-Type:
              description: The MIME type of the body of the response.
              style: simple
              explode: false
              schema:
                type: string
          content: {}
        '400':
          description: >
            400 BAD REQUEST

            400 code can be returned in the following specified cases, the
            specific cause has to be proper specified in the "ProblemDetails"
            structure to be returned.

            If the request is malformed or syntactically incorrect (e.g. if the
            request URI contains incorrect query parameters or the payload body
            contains a syntactically incorrect data structure), 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 response to a GET request which queries a container resource
            would be so big that the performance of the API producer is
            adversely affected, and the API producer does not support paging for
            the affected resource, it 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 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.

            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.

            The use of this HTTP error response code described above is
            applicable to the use of the OAuth 2.0 for the authorization of API
            requests and notifications, as defined in clauses 4.5.3.3 and
            4.5.3.4.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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: >
            401 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:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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: >
            403 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.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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
        '404':
          description: >
            404 NOT FOUND

            If the API producer did not find a current representation for the
            resource addressed by the URI passed in the request or is not
            willing to disclose that one exists, it shall respond with this
            response code. The "ProblemDetails" structure may be provided,
            including in the "detail" attribute information about the source of
            the problem, e.g. a wrong resource URI variable.

            This response code is not appropriate in case the resource addressed
            by the URI is a container resource which is designed to contain
            child resources, but does not contain any child resource at the time
            the request is received. For a GET request to an existing empty
            container resource, a typical response contains a 200 OK response
            code and a payload body with an empty array.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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: >
            405 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.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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: >
            406 NOT ACCEPTABLE

            If the "Accept" HTTP header does not contain at least one name of a
            content type that is acceptable to the API producer, the API
            producer shall respond with this response code. The "ProblemDetails"
            structure may be omitted.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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: >
            500 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 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.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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: >
            503 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 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.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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
        '504':
          description: >
            504 GATEWAY TIMEOUT

            If the API producer encounters a timeout while waiting for a
            response from an upstream server (i.e. a server that the API
            producer communicates with when fulfilling a request), it should
            respond with this response code.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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:
    parameters:
      - name: Version
        description: |
          Version of the API requested to use when responding to this request.
        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
    get:
      summary: Query multiple subscriptions.
      description: >
        The API consumer can use this method to query the list of active
        subscriptions to NFVI capacity information

        notifications subscribed by the API consumer.
      parameters:
        - name: Accept
          description: >
            Content-Types that are acceptable for the response. 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
      responses:
        '200':
          description: >
            Shall be returned when the list of subscriptions has been queried
            successfully.

            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
            NFVI capacity information subscriptions,

            as defined in clause 10.5.2.9.

            If the "filter" URI parameter was supplied in the request, the data
            in the response body shall have been

            transformed according to the rules specified in clause 5.2.2 of ETSI
            GS NFV-SOL 013.

            If the NFVO supports alternative 2 (paging) according to clause
            5.4.2.1 of ETSI GS NFV SOL 013 for this resource,

            inclusion of the Link HTTP header in this response shall follow the
            provisions in clause 5.4.2.3 of ETSI GS NFV SOL 013.
          headers:
            Version:
              description: |
                Version of the API used in the response.
              style: simple
              explode: false
              schema:
                type: string
            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.
              style: simple
              explode: false
              schema:
                type: string
            Content-Type:
              description: The MIME type of the body of the response.
              style: simple
              explode: false
              schema:
                type: string
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  description: >
                    This type represents a subscription. It shall comply with
                    the provisions defined in Table 10.5.2.9-1.
                  required:
                    - id
                    - callbackUri
                    - _links
                  properties:
                    id:
                      description: >
                        An identifier with the intention of being globally
                        unique.
                      type: string
                    filter:
                      type: object
                      description: >
                        This type represents a filter that can be used to
                        subscribe for notifications related to NFVI capacity
                        information events.

                        It shall comply with the provisions defined in Table
                        10.5.3.2-1.
                      properties:
                        notificationTypes:
                          description: "Match particular notification types.\nPermitted values:\n-\tCapacityShortageNotification\n"
                          type: array
                          items:
                            type: string
                            enum:
                              - CapacityShortageNotification
                    callbackUri:
                      description: |
                        String formatted according to IETF RFC 3986.
                      type: string
                      format: uri
                    _links:
                      type: object
                      description: |
                        Links to resources related to this resource.
                      required:
                        - self
                      properties:
                        self:
                          description: |
                            This type represents a link to a resource.
                          type: object
                          required:
                            - href
                          properties:
                            href:
                              description: >
                                URI of a resource referenced from a
                                notification. Should be an absolute URI (i.e. a
                                URI that contains {apiRoot}), however, may be a
                                relative URI (i.e. a URI where the {apiRoot}
                                part is omitted) if the {apiRoot} information is
                                not available.
                              type: string
                              format: url
        '400':
          description: >
            400 BAD REQUEST

            400 code can be returned in the following specified cases, the
            specific cause has to be proper specified in the "ProblemDetails"
            structure to be returned.

            If the request is malformed or syntactically incorrect (e.g. if the
            request URI contains incorrect query parameters or the payload body
            contains a syntactically incorrect data structure), 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 response to a GET request which queries a container resource
            would be so big that the performance of the API producer is
            adversely affected, and the API producer does not support paging for
            the affected resource, it 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 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.

            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.

            The use of this HTTP error response code described above is
            applicable to the use of the OAuth 2.0 for the authorization of API
            requests and notifications, as defined in clauses 4.5.3.3 and
            4.5.3.4.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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: >
            401 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:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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: >
            403 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.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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
        '404':
          description: >
            404 NOT FOUND

            If the API producer did not find a current representation for the
            resource addressed by the URI passed in the request or is not
            willing to disclose that one exists, it shall respond with this
            response code. The "ProblemDetails" structure may be provided,
            including in the "detail" attribute information about the source of
            the problem, e.g. a wrong resource URI variable.

            This response code is not appropriate in case the resource addressed
            by the URI is a container resource which is designed to contain
            child resources, but does not contain any child resource at the time
            the request is received. For a GET request to an existing empty
            container resource, a typical response contains a 200 OK response
            code and a payload body with an empty array.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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: >
            405 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.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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: >
            406 NOT ACCEPTABLE

            If the "Accept" HTTP header does not contain at least one name of a
            content type that is acceptable to the API producer, the API
            producer shall respond with this response code. The "ProblemDetails"
            structure may be omitted.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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: >
            500 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 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.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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: >
            503 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 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.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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
        '504':
          description: >
            504 GATEWAY TIMEOUT

            If the API producer encounters a timeout while waiting for a
            response from an upstream server (i.e. a server that the API
            producer communicates with when fulfilling a request), it should
            respond with this response code.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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
    post:
      summary: Create an NFVI capacity subscription
      description: >
        The POST method creates a new subscription.

        This method shall follow the provisions specified in the Tables
        10.4.6.3.1-1 and 10.4.6.3.1-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
          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
      requestBody:
        description: |
          Details of the subscription to be created.
        content:
          application/json:
            schema:
              type: object
              description: >
                This type represents a subscription request. It shall comply
                with the provisions defined in Table 10.5.2.2-1.
              required:
                - callbackUri
              properties:
                filter:
                  type: object
                  description: >
                    This type represents a filter that can be used to subscribe
                    for notifications related to NFVI capacity information
                    events.

                    It shall comply with the provisions defined in Table
                    10.5.3.2-1.
                  properties:
                    notificationTypes:
                      description: "Match particular notification types.\nPermitted values:\n-\tCapacityShortageNotification\n"
                      type: array
                      items:
                        type: string
                        enum:
                          - CapacityShortageNotification
                callbackUri:
                  description: |
                    String formatted according to IETF RFC 3986.
                  type: string
                  format: uri
                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.
                        - 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
                          format: uri
        required: true
      responses:
        '201':
          description: >
            Shall be returned when the subscription has been created
            successfully.

            A representation of the created subscription resource shall be
            returned in the response body, as defined in

            clause 10.5.2.9.

            The HTTP response shall include a "Location" HTTP header that
            contains the resource URI of the created subscription

            resource.
          headers:
            Version:
              description: |
                Version of the API used in the response.
              style: simple
              explode: false
              schema:
                type: string
            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.
              style: simple
              explode: false
              schema:
                type: string
            Content-Type:
              description: The MIME type of the body of the response.
              style: simple
              explode: false
              schema:
                type: string
          content:
            application/json:
              schema:
                type: object
                description: >
                  This type represents a subscription. It shall comply with the
                  provisions defined in Table 10.5.2.9-1.
                required:
                  - id
                  - callbackUri
                  - _links
                properties:
                  id:
                    description: |
                      An identifier with the intention of being globally unique.
                    type: string
                  filter:
                    type: object
                    description: >
                      This type represents a filter that can be used to
                      subscribe for notifications related to NFVI capacity
                      information events.

                      It shall comply with the provisions defined in Table
                      10.5.3.2-1.
                    properties:
                      notificationTypes:
                        description: "Match particular notification types.\nPermitted values:\n-\tCapacityShortageNotification\n"
                        type: array
                        items:
                          type: string
                          enum:
                            - CapacityShortageNotification
                  callbackUri:
                    description: |
                      String formatted according to IETF RFC 3986.
                    type: string
                    format: uri
                  _links:
                    type: object
                    description: |
                      Links to resources related to this resource.
                    required:
                      - self
                    properties:
                      self:
                        description: |
                          This type represents a link to a resource.
                        type: object
                        required:
                          - href
                        properties:
                          href:
                            description: >
                              URI of a resource referenced from a notification.
                              Should be an absolute URI (i.e. a URI that
                              contains {apiRoot}), however, may be a relative
                              URI (i.e. a URI where the {apiRoot} part is
                              omitted) if the {apiRoot} information is not
                              available.
                            type: string
                            format: url
        '303':
          description: |
            303 See Other
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
        '400':
          description: >
            400 BAD REQUEST

            400 code can be returned in the following specified cases, the
            specific cause has to be proper specified in the "ProblemDetails"
            structure to be returned.

            If the request is malformed or syntactically incorrect (e.g. if the
            request URI contains incorrect query parameters or the payload body
            contains a syntactically incorrect data structure), 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 response to a GET request which queries a container resource
            would be so big that the performance of the API producer is
            adversely affected, and the API producer does not support paging for
            the affected resource, it 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 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.

            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.

            The use of this HTTP error response code described above is
            applicable to the use of the OAuth 2.0 for the authorization of API
            requests and notifications, as defined in clauses 4.5.3.3 and
            4.5.3.4.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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: >
            401 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:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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: >
            403 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.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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
        '404':
          description: >
            404 NOT FOUND

            If the API producer did not find a current representation for the
            resource addressed by the URI passed in the request or is not
            willing to disclose that one exists, it shall respond with this
            response code. The "ProblemDetails" structure may be provided,
            including in the "detail" attribute information about the source of
            the problem, e.g. a wrong resource URI variable.

            This response code is not appropriate in case the resource addressed
            by the URI is a container resource which is designed to contain
            child resources, but does not contain any child resource at the time
            the request is received. For a GET request to an existing empty
            container resource, a typical response contains a 200 OK response
            code and a payload body with an empty array.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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: >
            405 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.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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: >
            406 NOT ACCEPTABLE

            If the "Accept" HTTP header does not contain at least one name of a
            content type that is acceptable to the API producer, the API
            producer shall respond with this response code. The "ProblemDetails"
            structure may be omitted.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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
        '422':
          description: >
            422 UNPROCESSABLE ENTITY

            If the payload body of a request contains syntactically correct data
            (e.g. well-formed JSON) but the data cannot be processed (e.g.
            because it fails validation against a schema), 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.

            This error response code is only applicable for methods that have a
            request body.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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: >
            500 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 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.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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: >
            503 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 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.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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
        '504':
          description: >
            504 GATEWAY TIMEOUT

            If the API producer encounters a timeout while waiting for a
            response from an upstream server (i.e. a server that the API
            producer communicates with when fulfilling a request), it should
            respond with this response code.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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
      callbacks:
        CapacityShortageNotification:
          '{$request.body#/callbackUri}':
            description: >-
              This resource represents a notification endpoint for NFVI capacity
              information. The API producer can use this resource to send
              notifications related to log management events to a subscribed API
              consumer, which has provided the URI of this resource during the
              capacity threshold creation process.
            post:
              description: >-
                The POST method delivers a notification regarding an NFVI
                capacity information event from the API producer to an API
                consumer. The API consumer shall have previously created an
                "Individual capacity threshold" resource"
              parameters:
                - name: Version
                  description: >
                    Version of the API requested to use when responding to this
                    request.
                  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
              requestBody:
                description: >
                  Notification about the available NFVI capacity having crossed
                  below a threshold value or having re-covered from

                  a capacity shortage.
                content:
                  application/json:
                    schema:
                      type: object
                      description: >
                        This notification informs the receiver that the
                        available NFVI capacity has crossed below a threshold
                        value or

                        has re-covered from a capacity shortage. It shall comply
                        with the provisions defined in Table 10.5.2.10-1.
                      required:
                        - id
                        - notificationType
                        - thresholdId
                        - timeStamp
                        - direction
                        - capacityInformation
                        - objectInstanceId
                      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 "CapacityShortageNotification" for
                            this notification type.
                          type: string
                        thresholdId:
                          description: >
                            An identifier with the intention of being globally
                            unique.
                          type: string
                        timeStamp:
                          description: >
                            Date-time stamp. Representation: String formatted
                            according toas defined by the date-time production
                            in IETF RFC 3339.
                          format: date-time
                        objectInstanceId:
                          description: >
                            An identifier with the intention of being globally
                            unique.
                          type: string
                        subObjectInstanceId:
                          description: >
                            An identifier maintained by the VIM or other
                            resource provider. It is expected to be unique
                            within the VIM instance. Representation: string of
                            variable length.
                          type: string
                        direction:
                          description: >
                            Specifies if the threshold has been crossed in UP or
                            DOWN direction.
                          type: string
                          enum:
                            - UP
                            - DOWN
                        capacityInformation:
                          type: object
                          description: >
                            This type defines the format of the NFVI capacity
                            information on a per resource type basis.

                            The type shall comply with the provisions defined in
                            table 10.5.2.6-1.
                          required:
                            - resourceType
                            - capacityMeasurementName
                            - totalCapacity
                            - allocatedCapacity
                            - availableCapacity
                          properties:
                            resourceType:
                              type: string
                              description: >
                                The enumeration
                                NfviCapacityResourceTypeEnumeration shall comply
                                with the provisions in table 10.5.4.3-1.

                                * VR_COMPUTE: For virtualised compute resource.

                                * VR_NETWORK: For virtualised network resource.

                                * VR_STORAGE: For virtualised storage resource.

                                * HOST_COMPUTE: For host compute resource.
                              enum:
                                - VR_COMPUTE
                                - VR_NETWORK
                                - VR_STORAGE
                                - HOST_COMPUTE
                            capacityMeasurementName:
                              description: >
                                Name of the capacity measurement. Different
                                resource types can have different associated
                                capacity measurements,

                                typically associated to different sub-types of
                                the resource type.

                                The present document and referred documents do
                                not specify the capacity measurements, thus the
                                capacity

                                measurement names are not specified in the
                                present document version.
                              type: string
                            totalCapacity:
                              description: |
                                The total capacity.
                              type: object
                            allocatedCapacity:
                              description: |
                                The allocated/used capacity.
                              type: object
                            reservedCapacity:
                              description: >
                                The reserved capacity. Shall be present if the
                                capacity measurement relates to a resource type
                                and

                                (and sub-type) that is reservable.
                              type: object
                            availableCapacity:
                              description: |
                                The available capacity.
                              type: object
                        _links:
                          description: |
                            Links to resources related to this notification.
                          type: object
                          required:
                            - threshold
                          properties:
                            objectInstance:
                              description: >
                                This type represents a link to a resource in a
                                notification, using an absolute or relative URI.
                              type: object
                              required:
                                - href
                              properties:
                                href:
                                  description: >
                                    URI of a resource referenced from a
                                    notification. Should be an absolute URI
                                    (i.e. a URI that contains {apiRoot}),
                                    however, may be a relative URI (i.e. a URI
                                    where the {apiRoot} part is omitted) if the
                                    {apiRoot} information is not available.
                                  type: string
                                  format: url
                            threshold:
                              description: >
                                This type represents a link to a resource in a
                                notification, using an absolute or relative URI.
                              type: object
                              required:
                                - href
                              properties:
                                href:
                                  description: >
                                    URI of a resource referenced from a
                                    notification. Should be an absolute URI
                                    (i.e. a URI that contains {apiRoot}),
                                    however, may be a relative URI (i.e. a URI
                                    where the {apiRoot} part is omitted) if the
                                    {apiRoot} information is not available.
                                  type: string
                                  format: url
                required: true
              responses:
                '204':
                  description: >
                    Shall be returned when the notification has been delivered
                    successfully.
                  headers:
                    Version:
                      description: |
                        Version of the API used in the response.
                      style: simple
                      explode: false
                      schema:
                        type: string
                    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.
                      style: simple
                      explode: false
                      schema:
                        type: string
                    Content-Type:
                      description: The MIME type of the body of the response.
                      style: simple
                      explode: false
                      schema:
                        type: string
                  content: {}
                '400':
                  description: >
                    400 BAD REQUEST

                    400 code can be returned in the following specified cases,
                    the specific cause has to be proper specified in the
                    "ProblemDetails" structure to be returned.

                    If the request is malformed or syntactically incorrect (e.g.
                    if the request URI contains incorrect query parameters or
                    the payload body contains a syntactically incorrect data
                    structure), 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 response to a GET request which queries a container
                    resource would be so big that the performance of the API
                    producer is adversely affected, and the API producer does
                    not support paging for the affected resource, it 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 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.

                    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.

                    The use of this HTTP error response code described above is
                    applicable to the use of the OAuth 2.0 for the authorization
                    of API requests and notifications, as defined in clauses
                    4.5.3.3 and 4.5.3.4.
                  headers:
                    Content-Type:
                      description: The MIME type of the body of the response.
                      schema:
                        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.
                      schema:
                        type: string
                        maximum: 1
                        minimum: 0
                    Version:
                      description: |
                        Version of the API used in the response.
                      schema:
                        type: string
                        maximum: 1
                        minimum: 1
                  content:
                    application/json:
                      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:
                          - status
                          - 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: >
                    401 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:
                      description: The MIME type of the body of the response.
                      schema:
                        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.
                      schema:
                        type: string
                        maximum: 1
                        minimum: 0
                    Version:
                      description: |
                        Version of the API used in the response.
                      schema:
                        type: string
                        maximum: 1
                        minimum: 1
                  content:
                    application/json:
                      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:
                          - status
                          - 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: >
                    403 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.
                      schema:
                        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.
                      schema:
                        type: string
                        maximum: 1
                        minimum: 0
                    Version:
                      description: |
                        Version of the API used in the response.
                      schema:
                        type: string
                        maximum: 1
                        minimum: 1
                  content:
                    application/json:
                      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:
                          - status
                          - 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
                '404':
                  description: >
                    404 NOT FOUND

                    If the API producer did not find a current representation
                    for the resource addressed by the URI passed in the request
                    or is not willing to disclose that one exists, it shall
                    respond with this response code. The "ProblemDetails"
                    structure may be provided, including in the "detail"
                    attribute information about the source of the problem, e.g.
                    a wrong resource URI variable.

                    This response code is not appropriate in case the resource
                    addressed by the URI is a container resource which is
                    designed to contain child resources, but does not contain
                    any child resource at the time the request is received. For
                    a GET request to an existing empty container resource, a
                    typical response contains a 200 OK response code and a
                    payload body with an empty array.
                  headers:
                    Content-Type:
                      description: The MIME type of the body of the response.
                      schema:
                        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.
                      schema:
                        type: string
                        maximum: 1
                        minimum: 0
                    Version:
                      description: |
                        Version of the API used in the response.
                      schema:
                        type: string
                        maximum: 1
                        minimum: 1
                  content:
                    application/json:
                      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:
                          - status
                          - 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: >
                    405 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.
                  headers:
                    Content-Type:
                      description: The MIME type of the body of the response.
                      schema:
                        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.
                      schema:
                        type: string
                        maximum: 1
                        minimum: 0
                    Version:
                      description: |
                        Version of the API used in the response.
                      schema:
                        type: string
                        maximum: 1
                        minimum: 1
                  content:
                    application/json:
                      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:
                          - status
                          - 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: >
                    406 NOT ACCEPTABLE

                    If the "Accept" HTTP header does not contain at least one
                    name of a content type that is acceptable to the API
                    producer, the API producer shall respond with this response
                    code. The "ProblemDetails" structure may be omitted.
                  headers:
                    Content-Type:
                      description: The MIME type of the body of the response.
                      schema:
                        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.
                      schema:
                        type: string
                        maximum: 1
                        minimum: 0
                    Version:
                      description: |
                        Version of the API used in the response.
                      schema:
                        type: string
                        maximum: 1
                        minimum: 1
                  content:
                    application/json:
                      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:
                          - status
                          - 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
                '422':
                  description: >
                    422 UNPROCESSABLE ENTITY

                    If the payload body of a request contains syntactically
                    correct data (e.g. well-formed JSON) but the data cannot be
                    processed (e.g. because it fails validation against a
                    schema), 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.

                    This error response code is only applicable for methods that
                    have a request body.
                  headers:
                    Content-Type:
                      description: The MIME type of the body of the response.
                      schema:
                        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.
                      schema:
                        type: string
                        maximum: 1
                        minimum: 0
                    Version:
                      description: |
                        Version of the API used in the response.
                      schema:
                        type: string
                        maximum: 1
                        minimum: 1
                  content:
                    application/json:
                      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:
                          - status
                          - 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: >
                    500 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 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.
                      schema:
                        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.
                      schema:
                        type: string
                        maximum: 1
                        minimum: 0
                    Version:
                      description: |
                        Version of the API used in the response.
                      schema:
                        type: string
                        maximum: 1
                        minimum: 1
                  content:
                    application/json:
                      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:
                          - status
                          - 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: >
                    503 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 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.
                      schema:
                        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.
                      schema:
                        type: string
                        maximum: 1
                        minimum: 0
                    Version:
                      description: |
                        Version of the API used in the response.
                      schema:
                        type: string
                        maximum: 1
                        minimum: 1
                  content:
                    application/json:
                      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:
                          - status
                          - 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
                '504':
                  description: >
                    504 GATEWAY TIMEOUT

                    If the API producer encounters a timeout while waiting for a
                    response from an upstream server (i.e. a server that the API
                    producer communicates with when fulfilling a request), it
                    should respond with this response code.
                  headers:
                    Content-Type:
                      description: The MIME type of the body of the response.
                      schema:
                        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.
                      schema:
                        type: string
                        maximum: 1
                        minimum: 0
                    Version:
                      description: |
                        Version of the API used in the response.
                      schema:
                        type: string
                        maximum: 1
                        minimum: 1
                  content:
                    application/json:
                      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:
                          - status
                          - 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:
              description: >-
                The GET method allows the API producer to test the notification
                endpoint that is provided by the API consumer, e.g. during
                creation of the capacity threshold resource.
              parameters:
                - name: Version
                  description: >
                    Version of the API requested to use when responding to this
                    request.
                  in: header
                  required: true
                  schema:
                    type: string
                - name: Accept
                  description: >
                    Content-Types that are acceptable for the response.
                    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
              responses:
                '204':
                  description: >
                    Shall be returned to indicate that the notification endpoint
                    has been tested successfully.

                    The response body shall be empty.
                  headers:
                    Version:
                      description: |
                        Version of the API used in the response.
                      style: simple
                      explode: false
                      schema:
                        type: string
                    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.
                      style: simple
                      explode: false
                      schema:
                        type: string
                    Content-Type:
                      description: The MIME type of the body of the response.
                      style: simple
                      explode: false
                      schema:
                        type: string
                  content: {}
                '400':
                  description: >
                    400 BAD REQUEST

                    400 code can be returned in the following specified cases,
                    the specific cause has to be proper specified in the
                    "ProblemDetails" structure to be returned.

                    If the request is malformed or syntactically incorrect (e.g.
                    if the request URI contains incorrect query parameters or
                    the payload body contains a syntactically incorrect data
                    structure), 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 response to a GET request which queries a container
                    resource would be so big that the performance of the API
                    producer is adversely affected, and the API producer does
                    not support paging for the affected resource, it 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 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.

                    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.

                    The use of this HTTP error response code described above is
                    applicable to the use of the OAuth 2.0 for the authorization
                    of API requests and notifications, as defined in clauses
                    4.5.3.3 and 4.5.3.4.
                  headers:
                    Content-Type:
                      description: The MIME type of the body of the response.
                      schema:
                        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.
                      schema:
                        type: string
                        maximum: 1
                        minimum: 0
                    Version:
                      description: |
                        Version of the API used in the response.
                      schema:
                        type: string
                        maximum: 1
                        minimum: 1
                  content:
                    application/json:
                      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:
                          - status
                          - 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: >
                    401 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:
                      description: The MIME type of the body of the response.
                      schema:
                        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.
                      schema:
                        type: string
                        maximum: 1
                        minimum: 0
                    Version:
                      description: |
                        Version of the API used in the response.
                      schema:
                        type: string
                        maximum: 1
                        minimum: 1
                  content:
                    application/json:
                      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:
                          - status
                          - 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: >
                    403 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.
                      schema:
                        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.
                      schema:
                        type: string
                        maximum: 1
                        minimum: 0
                    Version:
                      description: |
                        Version of the API used in the response.
                      schema:
                        type: string
                        maximum: 1
                        minimum: 1
                  content:
                    application/json:
                      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:
                          - status
                          - 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
                '404':
                  description: >
                    404 NOT FOUND

                    If the API producer did not find a current representation
                    for the resource addressed by the URI passed in the request
                    or is not willing to disclose that one exists, it shall
                    respond with this response code. The "ProblemDetails"
                    structure may be provided, including in the "detail"
                    attribute information about the source of the problem, e.g.
                    a wrong resource URI variable.

                    This response code is not appropriate in case the resource
                    addressed by the URI is a container resource which is
                    designed to contain child resources, but does not contain
                    any child resource at the time the request is received. For
                    a GET request to an existing empty container resource, a
                    typical response contains a 200 OK response code and a
                    payload body with an empty array.
                  headers:
                    Content-Type:
                      description: The MIME type of the body of the response.
                      schema:
                        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.
                      schema:
                        type: string
                        maximum: 1
                        minimum: 0
                    Version:
                      description: |
                        Version of the API used in the response.
                      schema:
                        type: string
                        maximum: 1
                        minimum: 1
                  content:
                    application/json:
                      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:
                          - status
                          - 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: >
                    405 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.
                  headers:
                    Content-Type:
                      description: The MIME type of the body of the response.
                      schema:
                        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.
                      schema:
                        type: string
                        maximum: 1
                        minimum: 0
                    Version:
                      description: |
                        Version of the API used in the response.
                      schema:
                        type: string
                        maximum: 1
                        minimum: 1
                  content:
                    application/json:
                      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:
                          - status
                          - 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: >
                    406 NOT ACCEPTABLE

                    If the "Accept" HTTP header does not contain at least one
                    name of a content type that is acceptable to the API
                    producer, the API producer shall respond with this response
                    code. The "ProblemDetails" structure may be omitted.
                  headers:
                    Content-Type:
                      description: The MIME type of the body of the response.
                      schema:
                        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.
                      schema:
                        type: string
                        maximum: 1
                        minimum: 0
                    Version:
                      description: |
                        Version of the API used in the response.
                      schema:
                        type: string
                        maximum: 1
                        minimum: 1
                  content:
                    application/json:
                      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:
                          - status
                          - 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
                '422':
                  description: >
                    422 UNPROCESSABLE ENTITY

                    If the payload body of a request contains syntactically
                    correct data (e.g. well-formed JSON) but the data cannot be
                    processed (e.g. because it fails validation against a
                    schema), 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.

                    This error response code is only applicable for methods that
                    have a request body.
                  headers:
                    Content-Type:
                      description: The MIME type of the body of the response.
                      schema:
                        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.
                      schema:
                        type: string
                        maximum: 1
                        minimum: 0
                    Version:
                      description: |
                        Version of the API used in the response.
                      schema:
                        type: string
                        maximum: 1
                        minimum: 1
                  content:
                    application/json:
                      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:
                          - status
                          - 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: >
                    500 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 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.
                      schema:
                        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.
                      schema:
                        type: string
                        maximum: 1
                        minimum: 0
                    Version:
                      description: |
                        Version of the API used in the response.
                      schema:
                        type: string
                        maximum: 1
                        minimum: 1
                  content:
                    application/json:
                      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:
                          - status
                          - 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: >
                    503 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 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.
                      schema:
                        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.
                      schema:
                        type: string
                        maximum: 1
                        minimum: 0
                    Version:
                      description: |
                        Version of the API used in the response.
                      schema:
                        type: string
                        maximum: 1
                        minimum: 1
                  content:
                    application/json:
                      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:
                          - status
                          - 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
                '504':
                  description: >
                    504 GATEWAY TIMEOUT

                    If the API producer encounters a timeout while waiting for a
                    response from an upstream server (i.e. a server that the API
                    producer communicates with when fulfilling a request), it
                    should respond with this response code.
                  headers:
                    Content-Type:
                      description: The MIME type of the body of the response.
                      schema:
                        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.
                      schema:
                        type: string
                        maximum: 1
                        minimum: 0
                    Version:
                      description: |
                        Version of the API used in the response.
                      schema:
                        type: string
                        maximum: 1
                        minimum: 1
                  content:
                    application/json:
                      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:
                          - status
                          - 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
        in: path
        description: >
          Identifier of the 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.
        required: true
        style: simple
        explode: 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
      - name: Authorization
        description: |
          The authorization token for the request. Reference: IETF RFC 7235.
        in: header
        required: false
        schema:
          type: string
    get:
      summary: Read an individual subscription resource
      description: >
        The API consumer can use this method for reading an individual
        subscription about NFVI capacity information

        notifications subscribed by the API consumer.
      parameters:
        - name: Accept
          description: >
            Content-Types that are acceptable for the response. Reference: IETF
            RFC 7231.
          in: header
          required: true
          schema:
            type: string
      responses:
        '200':
          description: >
            Shall be returned when the subscription has been read successfully.

            The response body shall contain a representation of the subscription
            resource, as defined in clause 10.5.2.9.
          headers:
            Version:
              description: |
                Version of the API used in the response.
              style: simple
              explode: false
              schema:
                type: string
            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.
              style: simple
              explode: false
              schema:
                type: string
            Content-Type:
              description: The MIME type of the body of the response.
              style: simple
              explode: false
              schema:
                type: string
          content:
            application/json:
              schema:
                type: object
                description: >
                  This type represents a subscription. It shall comply with the
                  provisions defined in Table 10.5.2.9-1.
                required:
                  - id
                  - callbackUri
                  - _links
                properties:
                  id:
                    description: |
                      An identifier with the intention of being globally unique.
                    type: string
                  filter:
                    type: object
                    description: >
                      This type represents a filter that can be used to
                      subscribe for notifications related to NFVI capacity
                      information events.

                      It shall comply with the provisions defined in Table
                      10.5.3.2-1.
                    properties:
                      notificationTypes:
                        description: "Match particular notification types.\nPermitted values:\n-\tCapacityShortageNotification\n"
                        type: array
                        items:
                          type: string
                          enum:
                            - CapacityShortageNotification
                  callbackUri:
                    description: |
                      String formatted according to IETF RFC 3986.
                    type: string
                    format: uri
                  _links:
                    type: object
                    description: |
                      Links to resources related to this resource.
                    required:
                      - self
                    properties:
                      self:
                        description: |
                          This type represents a link to a resource.
                        type: object
                        required:
                          - href
                        properties:
                          href:
                            description: >
                              URI of a resource referenced from a notification.
                              Should be an absolute URI (i.e. a URI that
                              contains {apiRoot}), however, may be a relative
                              URI (i.e. a URI where the {apiRoot} part is
                              omitted) if the {apiRoot} information is not
                              available.
                            type: string
                            format: url
        '400':
          description: >
            400 BAD REQUEST

            400 code can be returned in the following specified cases, the
            specific cause has to be proper specified in the "ProblemDetails"
            structure to be returned.

            If the request is malformed or syntactically incorrect (e.g. if the
            request URI contains incorrect query parameters or the payload body
            contains a syntactically incorrect data structure), 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 response to a GET request which queries a container resource
            would be so big that the performance of the API producer is
            adversely affected, and the API producer does not support paging for
            the affected resource, it 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 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.

            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.

            The use of this HTTP error response code described above is
            applicable to the use of the OAuth 2.0 for the authorization of API
            requests and notifications, as defined in clauses 4.5.3.3 and
            4.5.3.4.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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: >
            401 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:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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: >
            403 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.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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
        '404':
          description: >
            404 NOT FOUND

            If the API producer did not find a current representation for the
            resource addressed by the URI passed in the request or is not
            willing to disclose that one exists, it shall respond with this
            response code. The "ProblemDetails" structure may be provided,
            including in the "detail" attribute information about the source of
            the problem, e.g. a wrong resource URI variable.

            This response code is not appropriate in case the resource addressed
            by the URI is a container resource which is designed to contain
            child resources, but does not contain any child resource at the time
            the request is received. For a GET request to an existing empty
            container resource, a typical response contains a 200 OK response
            code and a payload body with an empty array.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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: >
            405 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.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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: >
            406 NOT ACCEPTABLE

            If the "Accept" HTTP header does not contain at least one name of a
            content type that is acceptable to the API producer, the API
            producer shall respond with this response code. The "ProblemDetails"
            structure may be omitted.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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: >
            500 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 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.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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: >
            503 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 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.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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
        '504':
          description: >
            504 GATEWAY TIMEOUT

            If the API producer encounters a timeout while waiting for a
            response from an upstream server (i.e. a server that the API
            producer communicates with when fulfilling a request), it should
            respond with this response code.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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: >
        This method terminates an individual subscription.

        This method shall follow the provisions specified in the Tables
        10.4.7.3.5-1 and 10.4.7.3.5-2 for URI query

        parameters, request and response data structures, and response codes.
      responses:
        '204':
          description: >
            Shall be returned when the subscription resource has been deleted
            successfully.

            The response body shall be empty.
          headers:
            Version:
              description: |
                Version of the API used in the response.
              style: simple
              explode: false
              schema:
                type: string
            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.
              style: simple
              explode: false
              schema:
                type: string
            Content-Type:
              description: The MIME type of the body of the response.
              style: simple
              explode: false
              schema:
                type: string
          content: {}
        '400':
          description: >
            400 BAD REQUEST

            400 code can be returned in the following specified cases, the
            specific cause has to be proper specified in the "ProblemDetails"
            structure to be returned.

            If the request is malformed or syntactically incorrect (e.g. if the
            request URI contains incorrect query parameters or the payload body
            contains a syntactically incorrect data structure), 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 response to a GET request which queries a container resource
            would be so big that the performance of the API producer is
            adversely affected, and the API producer does not support paging for
            the affected resource, it 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 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.

            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.

            The use of this HTTP error response code described above is
            applicable to the use of the OAuth 2.0 for the authorization of API
            requests and notifications, as defined in clauses 4.5.3.3 and
            4.5.3.4.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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: >
            401 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:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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: >
            403 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.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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
        '404':
          description: >
            404 NOT FOUND

            If the API producer did not find a current representation for the
            resource addressed by the URI passed in the request or is not
            willing to disclose that one exists, it shall respond with this
            response code. The "ProblemDetails" structure may be provided,
            including in the "detail" attribute information about the source of
            the problem, e.g. a wrong resource URI variable.

            This response code is not appropriate in case the resource addressed
            by the URI is a container resource which is designed to contain
            child resources, but does not contain any child resource at the time
            the request is received. For a GET request to an existing empty
            container resource, a typical response contains a 200 OK response
            code and a payload body with an empty array.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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: >
            405 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.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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: >
            406 NOT ACCEPTABLE

            If the "Accept" HTTP header does not contain at least one name of a
            content type that is acceptable to the API producer, the API
            producer shall respond with this response code. The "ProblemDetails"
            structure may be omitted.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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: >
            500 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 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.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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: >
            503 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 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.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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
        '504':
          description: >
            504 GATEWAY TIMEOUT

            If the API producer encounters a timeout while waiting for a
            response from an upstream server (i.e. a server that the API
            producer communicates with when fulfilling a request), it should
            respond with this response code.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              schema:
                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.
              schema:
                type: string
                maximum: 1
                minimum: 0
            Version:
              description: |
                Version of the API used in the response.
              schema:
                type: string
                maximum: 1
                minimum: 1
          content:
            application/json:
              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:
                  - status
                  - 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
components:
  parameters:
    VimId:
      name: vimId
      in: path
      description: >
        Identifier of the VIM with associated NFVI capacity information.

        This identifier can be retrieved from the "vimId" attribute in the
        CapacityShortageNotification.

        It can also be retrieved from the "vimId" attribute in the payload body
        of the response.
      required: true
      style: simple
      explode: false
      schema:
        type: string
    CapacityThresholdId:
      name: capacityThresholdId
      in: path
      description: >
        Identifier of the capacity threshold.

        This identifier can be retrieved from the resource referenced by the
        "Location" HTTP header in the response to

        a POST request creating a new "Individual capacity threshold" resource.
        It can also be retrieved from the "id"

        attribute in the payload body of that response.
      required: true
      style: simple
      explode: false
      schema:
        type: string
    SubscriptionId:
      name: subscriptionId
      in: path
      description: >
        Identifier of the 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.
      required: true
      style: simple
      explode: false
      schema:
        type: string
  requestBodies:
    NfviCapacityThresholdRequest:
      description: >
        Request parameters to create a new "Individual capacity threshold"
        resource.
      content:
        application/json:
          schema:
            type: object
            description: >
              This type represents a request to create a capacity threshold. It
              shall comply with the provisions defined in

              table 10.5.2.3-1.
            required:
              - objectInstanceId
              - criteria
            properties:
              objectInstanceId:
                description: |
                  An identifier with the intention of being globally unique.
                type: string
              subObjectInstanceIds:
                description: >
                  Identifiers of the sub-object instances of the measured object
                  instance associate with this capacity threshold.

                  If this attribute is absent, measurements will be taken for
                  all sub-object instances of the measured object instance.
                type: array
                items:
                  description: >
                    An identifier maintained by the VIM or other resource
                    provider. It is expected to be unique within the VIM
                    instance. Representation: string of variable length.
                  type: string
              criteria:
                type: object
                description: >
                  This type represents criteria that define a capacity
                  threshold.

                  It shall comply with the provisions defined in table
                  10.5.3.3-1.
                required:
                  - capacityMetric
                  - thresholdType
                properties:
                  capacityMetric:
                    description: >
                      Defines the capacity metric for which the threshold
                      applies.
                    type: object
                    required:
                      - resourceType
                      - capacityMeasurementName
                      - capacityType
                    properties:
                      resourceType:
                        type: string
                        description: >
                          The enumeration NfviCapacityResourceTypeEnumeration
                          shall comply with the provisions in table 10.5.4.3-1.

                          * VR_COMPUTE: For virtualised compute resource.

                          * VR_NETWORK: For virtualised network resource.

                          * VR_STORAGE: For virtualised storage resource.

                          * HOST_COMPUTE: For host compute resource.
                        enum:
                          - VR_COMPUTE
                          - VR_NETWORK
                          - VR_STORAGE
                          - HOST_COMPUTE
                      capacityMeasurementName:
                        description: >
                          Name of the capacity measurement. Different resource
                          types can have different associated capacity
                          measurements,

                          typically associated to different sub-types of the
                          resource type.
                        type: string
                      capacityType:
                        description: "The type of capacity for the threshold.\nPermitted values:\n-\tTOTAL: for total capacity.\n-\tALLOCATED: for allocated/used capacity.\n-\tRESERVED: for reserved capacity.\n-\tAVAILABLE: for available capacity.\n"
                        type: string
                        enum:
                          - TOTAL
                          - ALLOCATED
                          - RESERVED
                          - AVAILABLE
                  thresholdType:
                    description: "Type of capacity threshold. This attribute determines which other attributes are present in the data structure.\nPermitted values:\n-\tSIMPLE: Single-valued static threshold.\nIn the present document, simple thresholds are defined. The definition of additional threshold types is left\nfor future specification.\n"
                    type: string
                    enum:
                      - SIMPLE
                  simpleThresholdDetails:
                    description: >
                      Details of a simple threshold. Shall be present if
                      thresholdType="SIMPLE".
                    type: array
                    items:
                      type: object
                      required:
                        - thresholdValue
                        - hysteresis
                      properties:
                        thresholdValue:
                          description: >
                            The threshold value. Shall be represented as a
                            floating point number.
                          type: number
                        hysteresis:
                          description: >
                            The hysteresis of the threshold.

                            Shall be represented as a non-negative floating
                            point number.

                            A notification with crossing direction "UP" will be
                            generated if the measured value reaches or

                            exceeds "thresholdValue" + "hysteresis". A
                            notification with crossing direction "DOWN" will be

                            generated if the measured value reaches or undercuts
                            "thresholdValue" - "hysteresis".

                            The hysteresis is defined to prevent storms of
                            threshold crossing notifications.

                            When processing a request to create a threshold,
                            implementations should enforce a suitable minimum

                            value for this attribute (e.g. override the value or
                            reject the request).
                          type: number
              callbackUri:
                description: |
                  String formatted according to IETF RFC 3986.
                type: string
                format: uri
              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.
                      - 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
                        format: uri
      required: true
    IndividualNfviCapacityThresholdRequest:
      description: >
        Parameters for the capacity threshold modification.

        The Content-Type header shall be set to "application/merge-patch+json"
        according to IETF RFC 7396.
      content:
        application/json:
          schema:
            description: >
              This type represents modifications to a capacity threshold. It
              shall comply with the provisions defined in table 10.5.2.8-1.
            type: object
            properties:
              callbackUri:
                description: |
                  String formatted according to IETF RFC 3986.
                type: string
                format: uri
              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.
                      - 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
                        format: uri
      required: true
    NfviCapacitySubscriptionRequest:
      description: |
        Details of the subscription to be created.
      content:
        application/json:
          schema:
            type: object
            description: >
              This type represents a subscription request. It shall comply with
              the provisions defined in Table 10.5.2.2-1.
            required:
              - callbackUri
            properties:
              filter:
                type: object
                description: >
                  This type represents a filter that can be used to subscribe
                  for notifications related to NFVI capacity information events.

                  It shall comply with the provisions defined in Table
                  10.5.3.2-1.
                properties:
                  notificationTypes:
                    description: "Match particular notification types.\nPermitted values:\n-\tCapacityShortageNotification\n"
                    type: array
                    items:
                      type: string
                      enum:
                        - CapacityShortageNotification
              callbackUri:
                description: |
                  String formatted according to IETF RFC 3986.
                type: string
                format: uri
              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.
                      - 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
                        format: uri
      required: true
    CapacityShortageNotificationRequest:
      description: >
        Notification about the available NFVI capacity having crossed below a
        threshold value or having re-covered from

        a capacity shortage.
      content:
        application/json:
          schema:
            type: object
            description: >
              This notification informs the receiver that the available NFVI
              capacity has crossed below a threshold value or

              has re-covered from a capacity shortage. It shall comply with the
              provisions defined in Table 10.5.2.10-1.
            required:
              - id
              - notificationType
              - thresholdId
              - timeStamp
              - direction
              - capacityInformation
              - objectInstanceId
            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 "CapacityShortageNotification" for this
                  notification type.
                type: string
              thresholdId:
                description: |
                  An identifier with the intention of being globally unique.
                type: string
              timeStamp:
                description: >
                  Date-time stamp. Representation: String formatted according
                  toas defined by the date-time production in IETF RFC 3339.
                format: date-time
              objectInstanceId:
                description: |
                  An identifier with the intention of being globally unique.
                type: string
              subObjectInstanceId:
                description: >
                  An identifier maintained by the VIM or other resource
                  provider. It is expected to be unique within the VIM instance.
                  Representation: string of variable length.
                type: string
              direction:
                description: >
                  Specifies if the threshold has been crossed in UP or DOWN
                  direction.
                type: string
                enum:
                  - UP
                  - DOWN
              capacityInformation:
                type: object
                description: >
                  This type defines the format of the NFVI capacity information
                  on a per resource type basis.

                  The type shall comply with the provisions defined in table
                  10.5.2.6-1.
                required:
                  - resourceType
                  - capacityMeasurementName
                  - totalCapacity
                  - allocatedCapacity
                  - availableCapacity
                properties:
                  resourceType:
                    type: string
                    description: >
                      The enumeration NfviCapacityResourceTypeEnumeration shall
                      comply with the provisions in table 10.5.4.3-1.

                      * VR_COMPUTE: For virtualised compute resource.

                      * VR_NETWORK: For virtualised network resource.

                      * VR_STORAGE: For virtualised storage resource.

                      * HOST_COMPUTE: For host compute resource.
                    enum:
                      - VR_COMPUTE
                      - VR_NETWORK
                      - VR_STORAGE
                      - HOST_COMPUTE
                  capacityMeasurementName:
                    description: >
                      Name of the capacity measurement. Different resource types
                      can have different associated capacity measurements,

                      typically associated to different sub-types of the
                      resource type.

                      The present document and referred documents do not specify
                      the capacity measurements, thus the capacity

                      measurement names are not specified in the present
                      document version.
                    type: string
                  totalCapacity:
                    description: |
                      The total capacity.
                    type: object
                  allocatedCapacity:
                    description: |
                      The allocated/used capacity.
                    type: object
                  reservedCapacity:
                    description: >
                      The reserved capacity. Shall be present if the capacity
                      measurement relates to a resource type and

                      (and sub-type) that is reservable.
                    type: object
                  availableCapacity:
                    description: |
                      The available capacity.
                    type: object
              _links:
                description: |
                  Links to resources related to this notification.
                type: object
                required:
                  - threshold
                properties:
                  objectInstance:
                    description: >
                      This type represents a link to a resource in a
                      notification, using an absolute or relative URI.
                    type: object
                    required:
                      - href
                    properties:
                      href:
                        description: >
                          URI of a resource referenced from a notification.
                          Should be an absolute URI (i.e. a URI that contains
                          {apiRoot}), however, may be a relative URI (i.e. a URI
                          where the {apiRoot} part is omitted) if the {apiRoot}
                          information is not available.
                        type: string
                        format: url
                  threshold:
                    description: >
                      This type represents a link to a resource in a
                      notification, using an absolute or relative URI.
                    type: object
                    required:
                      - href
                    properties:
                      href:
                        description: >
                          URI of a resource referenced from a notification.
                          Should be an absolute URI (i.e. a URI that contains
                          {apiRoot}), however, may be a relative URI (i.e. a URI
                          where the {apiRoot} part is omitted) if the {apiRoot}
                          information is not available.
                        type: string
                        format: url
      required: true
  responses:
    NfviCapacityInfos.Get:
      description: >
        Shall be returned when information about NFVI capacity information has
        been queried successfully.

        The response body shall contain NFVI capacity information, as defined in
        clause 10.5.2.4.

        If the "filter" URI parameter was supplied in the request, the data in
        the response body shall have been

        transformed according to the rules specified in clauses 5.2.2 of ETSI GS
        NFV-SOL 013.

        If the NFVO supports alternative 2 (paging) according to clause 5.4.2.1
        of ETSI GS NFV-SOL 013 for this resource,

        inclusion of the Link HTTP header in this response shall follow the
        provisions in clause 5.4.2.3 of ETSI GS NFV-SOL 013.
      headers:
        Version:
          description: |
            Version of the API used in the response.
          style: simple
          explode: false
          schema:
            type: string
        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.
          style: simple
          explode: false
          schema:
            type: string
        Content-Type:
          description: The MIME type of the body of the response.
          style: simple
          explode: false
          schema:
            type: string
      content:
        application/json:
          schema:
            type: array
            items:
              type: object
              description: >
                This type defines the format of the NFVI capacity information.
                The type shall comply with the provisions defined

                in Table 10.5.2.4-1.
              required:
                - id
                - vimId
                - capacityInfoPerZone
              properties:
                id:
                  description: |
                    An identifier with the intention of being globally unique.
                  type: string
                vimId:
                  description: |
                    An identifier with the intention of being globally unique.
                  type: string
                capacityInfoPerZone:
                  description: >
                    Capacity information on a per resource zone basis under
                    control by the associated VIM.
                  type: array
                  items:
                    type: object
                    description: >
                      This type defines the format of the NFVI capacity
                      information on a per resource zone basis.

                      The type shall comply with the provisions defined in table
                      10.5.2.5-1.
                    required:
                      - capacityMeasurements
                    properties:
                      resourceZoneId:
                        description: >
                          An identifier with the intention of being globally
                          unique.
                        type: string
                      capacityMeasurements:
                        description: |
                          Capacity measurement on a per resource type basis.
                        type: array
                        items:
                          type: object
                          description: >
                            This type defines the format of the NFVI capacity
                            information on a per resource type basis.

                            The type shall comply with the provisions defined in
                            table 10.5.2.6-1.
                          required:
                            - resourceType
                            - capacityMeasurementName
                            - totalCapacity
                            - allocatedCapacity
                            - availableCapacity
                          properties:
                            resourceType:
                              type: string
                              description: >
                                The enumeration
                                NfviCapacityResourceTypeEnumeration shall comply
                                with the provisions in table 10.5.4.3-1.

                                * VR_COMPUTE: For virtualised compute resource.

                                * VR_NETWORK: For virtualised network resource.

                                * VR_STORAGE: For virtualised storage resource.

                                * HOST_COMPUTE: For host compute resource.
                              enum:
                                - VR_COMPUTE
                                - VR_NETWORK
                                - VR_STORAGE
                                - HOST_COMPUTE
                            capacityMeasurementName:
                              description: >
                                Name of the capacity measurement. Different
                                resource types can have different associated
                                capacity measurements,

                                typically associated to different sub-types of
                                the resource type.

                                The present document and referred documents do
                                not specify the capacity measurements, thus the
                                capacity

                                measurement names are not specified in the
                                present document version.
                              type: string
                            totalCapacity:
                              description: |
                                The total capacity.
                              type: object
                            allocatedCapacity:
                              description: |
                                The allocated/used capacity.
                              type: object
                            reservedCapacity:
                              description: >
                                The reserved capacity. Shall be present if the
                                capacity measurement relates to a resource type
                                and

                                (and sub-type) that is reservable.
                              type: object
                            availableCapacity:
                              description: |
                                The available capacity.
                              type: object
                totalCapacityInfo:
                  type: object
                  description: >
                    This type defines the format of the NFVI capacity
                    information on a per resource type basis.

                    The type shall comply with the provisions defined in table
                    10.5.2.6-1.
                  required:
                    - resourceType
                    - capacityMeasurementName
                    - totalCapacity
                    - allocatedCapacity
                    - availableCapacity
                  properties:
                    resourceType:
                      type: string
                      description: >
                        The enumeration NfviCapacityResourceTypeEnumeration
                        shall comply with the provisions in table 10.5.4.3-1.

                        * VR_COMPUTE: For virtualised compute resource.

                        * VR_NETWORK: For virtualised network resource.

                        * VR_STORAGE: For virtualised storage resource.

                        * HOST_COMPUTE: For host compute resource.
                      enum:
                        - VR_COMPUTE
                        - VR_NETWORK
                        - VR_STORAGE
                        - HOST_COMPUTE
                    capacityMeasurementName:
                      description: >
                        Name of the capacity measurement. Different resource
                        types can have different associated capacity
                        measurements,

                        typically associated to different sub-types of the
                        resource type.

                        The present document and referred documents do not
                        specify the capacity measurements, thus the capacity

                        measurement names are not specified in the present
                        document version.
                      type: string
                    totalCapacity:
                      description: |
                        The total capacity.
                      type: object
                    allocatedCapacity:
                      description: |
                        The allocated/used capacity.
                      type: object
                    reservedCapacity:
                      description: >
                        The reserved capacity. Shall be present if the capacity
                        measurement relates to a resource type and

                        (and sub-type) that is reservable.
                      type: object
                    availableCapacity:
                      description: |
                        The available capacity.
                      type: object
                timeInterval:
                  type: object
                  description: >
                    This type defines the format of a time interval. The type
                    shall comply with the provisions defined in table
                    10.5.2.7-1.
                  required:
                    - aTime
                  properties:
                    aTime:
                      description: >
                        Date-time stamp. Representation: String formatted
                        according toas defined by the date-time production in
                        IETF RFC 3339.
                      format: date-time
                    bTime:
                      description: >
                        Date-time stamp. Representation: String formatted
                        according toas defined by the date-time production in
                        IETF RFC 3339.
                      format: date-time
    NfviCapacityInfo.Get:
      description: >
        Shall be returned when information of an individual VIM’s NFVI capacity
        has been read successfully.

        The response body shall contain a representation of  the NFVI capacity
        information, as defined in clause 10.5.2.4.
      headers:
        Version:
          description: |
            Version of the API used in the response.
          style: simple
          explode: false
          schema:
            type: string
        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.
          style: simple
          explode: false
          schema:
            type: string
        Content-Type:
          description: The MIME type of the body of the response.
          style: simple
          explode: false
          schema:
            type: string
      content:
        application/json:
          schema:
            type: object
            description: >
              This type defines the format of the NFVI capacity information. The
              type shall comply with the provisions defined

              in Table 10.5.2.4-1.
            required:
              - id
              - vimId
              - capacityInfoPerZone
            properties:
              id:
                description: |
                  An identifier with the intention of being globally unique.
                type: string
              vimId:
                description: |
                  An identifier with the intention of being globally unique.
                type: string
              capacityInfoPerZone:
                description: >
                  Capacity information on a per resource zone basis under
                  control by the associated VIM.
                type: array
                items:
                  type: object
                  description: >
                    This type defines the format of the NFVI capacity
                    information on a per resource zone basis.

                    The type shall comply with the provisions defined in table
                    10.5.2.5-1.
                  required:
                    - capacityMeasurements
                  properties:
                    resourceZoneId:
                      description: >
                        An identifier with the intention of being globally
                        unique.
                      type: string
                    capacityMeasurements:
                      description: |
                        Capacity measurement on a per resource type basis.
                      type: array
                      items:
                        type: object
                        description: >
                          This type defines the format of the NFVI capacity
                          information on a per resource type basis.

                          The type shall comply with the provisions defined in
                          table 10.5.2.6-1.
                        required:
                          - resourceType
                          - capacityMeasurementName
                          - totalCapacity
                          - allocatedCapacity
                          - availableCapacity
                        properties:
                          resourceType:
                            type: string
                            description: >
                              The enumeration
                              NfviCapacityResourceTypeEnumeration shall comply
                              with the provisions in table 10.5.4.3-1.

                              * VR_COMPUTE: For virtualised compute resource.

                              * VR_NETWORK: For virtualised network resource.

                              * VR_STORAGE: For virtualised storage resource.

                              * HOST_COMPUTE: For host compute resource.
                            enum:
                              - VR_COMPUTE
                              - VR_NETWORK
                              - VR_STORAGE
                              - HOST_COMPUTE
                          capacityMeasurementName:
                            description: >
                              Name of the capacity measurement. Different
                              resource types can have different associated
                              capacity measurements,

                              typically associated to different sub-types of the
                              resource type.

                              The present document and referred documents do not
                              specify the capacity measurements, thus the
                              capacity

                              measurement names are not specified in the present
                              document version.
                            type: string
                          totalCapacity:
                            description: |
                              The total capacity.
                            type: object
                          allocatedCapacity:
                            description: |
                              The allocated/used capacity.
                            type: object
                          reservedCapacity:
                            description: >
                              The reserved capacity. Shall be present if the
                              capacity measurement relates to a resource type
                              and

                              (and sub-type) that is reservable.
                            type: object
                          availableCapacity:
                            description: |
                              The available capacity.
                            type: object
              totalCapacityInfo:
                type: object
                description: >
                  This type defines the format of the NFVI capacity information
                  on a per resource type basis.

                  The type shall comply with the provisions defined in table
                  10.5.2.6-1.
                required:
                  - resourceType
                  - capacityMeasurementName
                  - totalCapacity
                  - allocatedCapacity
                  - availableCapacity
                properties:
                  resourceType:
                    type: string
                    description: >
                      The enumeration NfviCapacityResourceTypeEnumeration shall
                      comply with the provisions in table 10.5.4.3-1.

                      * VR_COMPUTE: For virtualised compute resource.

                      * VR_NETWORK: For virtualised network resource.

                      * VR_STORAGE: For virtualised storage resource.

                      * HOST_COMPUTE: For host compute resource.
                    enum:
                      - VR_COMPUTE
                      - VR_NETWORK
                      - VR_STORAGE
                      - HOST_COMPUTE
                  capacityMeasurementName:
                    description: >
                      Name of the capacity measurement. Different resource types
                      can have different associated capacity measurements,

                      typically associated to different sub-types of the
                      resource type.

                      The present document and referred documents do not specify
                      the capacity measurements, thus the capacity

                      measurement names are not specified in the present
                      document version.
                    type: string
                  totalCapacity:
                    description: |
                      The total capacity.
                    type: object
                  allocatedCapacity:
                    description: |
                      The allocated/used capacity.
                    type: object
                  reservedCapacity:
                    description: >
                      The reserved capacity. Shall be present if the capacity
                      measurement relates to a resource type and

                      (and sub-type) that is reservable.
                    type: object
                  availableCapacity:
                    description: |
                      The available capacity.
                    type: object
              timeInterval:
                type: object
                description: >
                  This type defines the format of a time interval. The type
                  shall comply with the provisions defined in table 10.5.2.7-1.
                required:
                  - aTime
                properties:
                  aTime:
                    description: >
                      Date-time stamp. Representation: String formatted
                      according toas defined by the date-time production in IETF
                      RFC 3339.
                    format: date-time
                  bTime:
                    description: >
                      Date-time stamp. Representation: String formatted
                      according toas defined by the date-time production in IETF
                      RFC 3339.
                    format: date-time
    CapacityThresholds.Get:
      description: >
        Shall be returned when information about zero or more capacity
        thresholds has been queried successfully.

        If the "filter" URI parameter was supplied in the request, the data in
        the response body shall have been

        transformed according to the rules specified in clause 5.2.2 of ETSI GS
        NFV-SOL 013.

        The response body shall contain in an array the representations of zero
        or more capacity thresholds, as

        defined in clause 10.5.2.8.

        If the NFVO supports alternative 2 (paging) according to clause 5.4.2.1
        of ETSI GS NFV-SOL 013 for this resource,

        inclusion of the Link HTTP header in this response shall follow the
        provisions in clause 5.4.2.3 of ETSI GS NFV-SOL 013.
      headers:
        Version:
          description: |
            Version of the API used in the response.
          style: simple
          explode: false
          schema:
            type: string
        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.
          style: simple
          explode: false
          schema:
            type: string
        Content-Type:
          description: The MIME type of the body of the response.
          style: simple
          explode: false
          schema:
            type: string
      content:
        application/json:
          schema:
            type: array
            items:
              type: object
              description: >
                This type represents a capacity threshold. It shall comply with
                the provisions defined in table 10.5.2.8-1.
              required:
                - id
                - objectInstanceId
                - criteria
                - callbackUri
                - _links
              properties:
                id:
                  description: |
                    An identifier with the intention of being globally unique.
                  type: string
                objectInstanceId:
                  description: |
                    An identifier with the intention of being globally unique.
                  type: string
                subObjectInstanceIds:
                  description: >
                    Identifiers of the sub-object instances of the measured
                    object instance associate with this capacity threshold.

                    If this attribute is absent, measurements are taken for all
                    sub-object instances of the measured object instance.
                  type: array
                  items:
                    description: >
                      An identifier maintained by the VIM or other resource
                      provider. It is expected to be unique within the VIM
                      instance. Representation: string of variable length.
                    type: string
                criteria:
                  type: object
                  description: >
                    This type represents criteria that define a capacity
                    threshold.

                    It shall comply with the provisions defined in table
                    10.5.3.3-1.
                  required:
                    - capacityMetric
                    - thresholdType
                  properties:
                    capacityMetric:
                      description: >
                        Defines the capacity metric for which the threshold
                        applies.
                      type: object
                      required:
                        - resourceType
                        - capacityMeasurementName
                        - capacityType
                      properties:
                        resourceType:
                          type: string
                          description: >
                            The enumeration NfviCapacityResourceTypeEnumeration
                            shall comply with the provisions in table
                            10.5.4.3-1.

                            * VR_COMPUTE: For virtualised compute resource.

                            * VR_NETWORK: For virtualised network resource.

                            * VR_STORAGE: For virtualised storage resource.

                            * HOST_COMPUTE: For host compute resource.
                          enum:
                            - VR_COMPUTE
                            - VR_NETWORK
                            - VR_STORAGE
                            - HOST_COMPUTE
                        capacityMeasurementName:
                          description: >
                            Name of the capacity measurement. Different resource
                            types can have different associated capacity
                            measurements,

                            typically associated to different sub-types of the
                            resource type.
                          type: string
                        capacityType:
                          description: "The type of capacity for the threshold.\nPermitted values:\n-\tTOTAL: for total capacity.\n-\tALLOCATED: for allocated/used capacity.\n-\tRESERVED: for reserved capacity.\n-\tAVAILABLE: for available capacity.\n"
                          type: string
                          enum:
                            - TOTAL
                            - ALLOCATED
                            - RESERVED
                            - AVAILABLE
                    thresholdType:
                      description: "Type of capacity threshold. This attribute determines which other attributes are present in the data structure.\nPermitted values:\n-\tSIMPLE: Single-valued static threshold.\nIn the present document, simple thresholds are defined. The definition of additional threshold types is left\nfor future specification.\n"
                      type: string
                      enum:
                        - SIMPLE
                    simpleThresholdDetails:
                      description: >
                        Details of a simple threshold. Shall be present if
                        thresholdType="SIMPLE".
                      type: array
                      items:
                        type: object
                        required:
                          - thresholdValue
                          - hysteresis
                        properties:
                          thresholdValue:
                            description: >
                              The threshold value. Shall be represented as a
                              floating point number.
                            type: number
                          hysteresis:
                            description: >
                              The hysteresis of the threshold.

                              Shall be represented as a non-negative floating
                              point number.

                              A notification with crossing direction "UP" will
                              be generated if the measured value reaches or

                              exceeds "thresholdValue" + "hysteresis". A
                              notification with crossing direction "DOWN" will
                              be

                              generated if the measured value reaches or
                              undercuts "thresholdValue" - "hysteresis".

                              The hysteresis is defined to prevent storms of
                              threshold crossing notifications.

                              When processing a request to create a threshold,
                              implementations should enforce a suitable minimum

                              value for this attribute (e.g. override the value
                              or reject the request).
                            type: number
                callbackUri:
                  description: |
                    String formatted according to IETF RFC 3986.
                  type: string
                  format: uri
                _links:
                  type: object
                  description: |
                    Links for this resource.
                  required:
                    - self
                  properties:
                    self:
                      description: |
                        This type represents a link to a resource.
                      type: object
                      required:
                        - href
                      properties:
                        href:
                          description: >
                            URI of a resource referenced from a notification.
                            Should be an absolute URI (i.e. a URI that contains
                            {apiRoot}), however, may be a relative URI (i.e. a
                            URI where the {apiRoot} part is omitted) if the
                            {apiRoot} information is not available.
                          type: string
                          format: url
                    object:
                      description: |
                        This type represents a link to a resource.
                      type: object
                      required:
                        - href
                      properties:
                        href:
                          description: >
                            URI of a resource referenced from a notification.
                            Should be an absolute URI (i.e. a URI that contains
                            {apiRoot}), however, may be a relative URI (i.e. a
                            URI where the {apiRoot} part is omitted) if the
                            {apiRoot} information is not available.
                          type: string
                          format: url
    CapacityThresholds.Post:
      description: >
        Shall be returned when a capacity threshold has been created
        successfully.

        The response body shall contain a representation of the created
        "Individual capacity threshold" resource,

        as defined in clause 10.5.2.8.

        The HTTP response shall include a "Location" HTTP header that contains
        the resource URI of the created resource.
      headers:
        Version:
          description: |
            Version of the API used in the response.
          style: simple
          explode: false
          schema:
            type: string
        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.
          style: simple
          explode: false
          schema:
            type: string
        Content-Type:
          description: The MIME type of the body of the response.
          style: simple
          explode: false
          schema:
            type: string
      content:
        application/json:
          schema:
            type: object
            description: >
              This type represents a capacity threshold. It shall comply with
              the provisions defined in table 10.5.2.8-1.
            required:
              - id
              - objectInstanceId
              - criteria
              - callbackUri
              - _links
            properties:
              id:
                description: |
                  An identifier with the intention of being globally unique.
                type: string
              objectInstanceId:
                description: |
                  An identifier with the intention of being globally unique.
                type: string
              subObjectInstanceIds:
                description: >
                  Identifiers of the sub-object instances of the measured object
                  instance associate with this capacity threshold.

                  If this attribute is absent, measurements are taken for all
                  sub-object instances of the measured object instance.
                type: array
                items:
                  description: >
                    An identifier maintained by the VIM or other resource
                    provider. It is expected to be unique within the VIM
                    instance. Representation: string of variable length.
                  type: string
              criteria:
                type: object
                description: >
                  This type represents criteria that define a capacity
                  threshold.

                  It shall comply with the provisions defined in table
                  10.5.3.3-1.
                required:
                  - capacityMetric
                  - thresholdType
                properties:
                  capacityMetric:
                    description: >
                      Defines the capacity metric for which the threshold
                      applies.
                    type: object
                    required:
                      - resourceType
                      - capacityMeasurementName
                      - capacityType
                    properties:
                      resourceType:
                        type: string
                        description: >
                          The enumeration NfviCapacityResourceTypeEnumeration
                          shall comply with the provisions in table 10.5.4.3-1.

                          * VR_COMPUTE: For virtualised compute resource.

                          * VR_NETWORK: For virtualised network resource.

                          * VR_STORAGE: For virtualised storage resource.

                          * HOST_COMPUTE: For host compute resource.
                        enum:
                          - VR_COMPUTE
                          - VR_NETWORK
                          - VR_STORAGE
                          - HOST_COMPUTE
                      capacityMeasurementName:
                        description: >
                          Name of the capacity measurement. Different resource
                          types can have different associated capacity
                          measurements,

                          typically associated to different sub-types of the
                          resource type.
                        type: string
                      capacityType:
                        description: "The type of capacity for the threshold.\nPermitted values:\n-\tTOTAL: for total capacity.\n-\tALLOCATED: for allocated/used capacity.\n-\tRESERVED: for reserved capacity.\n-\tAVAILABLE: for available capacity.\n"
                        type: string
                        enum:
                          - TOTAL
                          - ALLOCATED
                          - RESERVED
                          - AVAILABLE
                  thresholdType:
                    description: "Type of capacity threshold. This attribute determines which other attributes are present in the data structure.\nPermitted values:\n-\tSIMPLE: Single-valued static threshold.\nIn the present document, simple thresholds are defined. The definition of additional threshold types is left\nfor future specification.\n"
                    type: string
                    enum:
                      - SIMPLE
                  simpleThresholdDetails:
                    description: >
                      Details of a simple threshold. Shall be present if
                      thresholdType="SIMPLE".
                    type: array
                    items:
                      type: object
                      required:
                        - thresholdValue
                        - hysteresis
                      properties:
                        thresholdValue:
                          description: >
                            The threshold value. Shall be represented as a
                            floating point number.
                          type: number
                        hysteresis:
                          description: >
                            The hysteresis of the threshold.

                            Shall be represented as a non-negative floating
                            point number.

                            A notification with crossing direction "UP" will be
                            generated if the measured value reaches or

                            exceeds "thresholdValue" + "hysteresis". A
                            notification with crossing direction "DOWN" will be

                            generated if the measured value reaches or undercuts
                            "thresholdValue" - "hysteresis".

                            The hysteresis is defined to prevent storms of
                            threshold crossing notifications.

                            When processing a request to create a threshold,
                            implementations should enforce a suitable minimum

                            value for this attribute (e.g. override the value or
                            reject the request).
                          type: number
              callbackUri:
                description: |
                  String formatted according to IETF RFC 3986.
                type: string
                format: uri
              _links:
                type: object
                description: |
                  Links for this resource.
                required:
                  - self
                properties:
                  self:
                    description: |
                      This type represents a link to a resource.
                    type: object
                    required:
                      - href
                    properties:
                      href:
                        description: >
                          URI of a resource referenced from a notification.
                          Should be an absolute URI (i.e. a URI that contains
                          {apiRoot}), however, may be a relative URI (i.e. a URI
                          where the {apiRoot} part is omitted) if the {apiRoot}
                          information is not available.
                        type: string
                        format: url
                  object:
                    description: |
                      This type represents a link to a resource.
                    type: object
                    required:
                      - href
                    properties:
                      href:
                        description: >
                          URI of a resource referenced from a notification.
                          Should be an absolute URI (i.e. a URI that contains
                          {apiRoot}), however, may be a relative URI (i.e. a URI
                          where the {apiRoot} part is omitted) if the {apiRoot}
                          information is not available.
                        type: string
                        format: url
    IndividualCapacityThreshold.Get:
      description: >
        Shall be returned when information about an individual capacity
        threshold has been read successfully.

        The response body shall contain in a representation of the capacity
        threshold, as defined in clause 10.5.2.8.
      headers:
        Version:
          description: |
            Version of the API used in the response.
          style: simple
          explode: false
          schema:
            type: string
        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.
          style: simple
          explode: false
          schema:
            type: string
        Content-Type:
          description: The MIME type of the body of the response.
          style: simple
          explode: false
          schema:
            type: string
      content:
        application/json:
          schema:
            type: object
            description: >
              This type represents a capacity threshold. It shall comply with
              the provisions defined in table 10.5.2.8-1.
            required:
              - id
              - objectInstanceId
              - criteria
              - callbackUri
              - _links
            properties:
              id:
                description: |
                  An identifier with the intention of being globally unique.
                type: string
              objectInstanceId:
                description: |
                  An identifier with the intention of being globally unique.
                type: string
              subObjectInstanceIds:
                description: >
                  Identifiers of the sub-object instances of the measured object
                  instance associate with this capacity threshold.

                  If this attribute is absent, measurements are taken for all
                  sub-object instances of the measured object instance.
                type: array
                items:
                  description: >
                    An identifier maintained by the VIM or other resource
                    provider. It is expected to be unique within the VIM
                    instance. Representation: string of variable length.
                  type: string
              criteria:
                type: object
                description: >
                  This type represents criteria that define a capacity
                  threshold.

                  It shall comply with the provisions defined in table
                  10.5.3.3-1.
                required:
                  - capacityMetric
                  - thresholdType
                properties:
                  capacityMetric:
                    description: >
                      Defines the capacity metric for which the threshold
                      applies.
                    type: object
                    required:
                      - resourceType
                      - capacityMeasurementName
                      - capacityType
                    properties:
                      resourceType:
                        type: string
                        description: >
                          The enumeration NfviCapacityResourceTypeEnumeration
                          shall comply with the provisions in table 10.5.4.3-1.

                          * VR_COMPUTE: For virtualised compute resource.

                          * VR_NETWORK: For virtualised network resource.

                          * VR_STORAGE: For virtualised storage resource.

                          * HOST_COMPUTE: For host compute resource.
                        enum:
                          - VR_COMPUTE
                          - VR_NETWORK
                          - VR_STORAGE
                          - HOST_COMPUTE
                      capacityMeasurementName:
                        description: >
                          Name of the capacity measurement. Different resource
                          types can have different associated capacity
                          measurements,

                          typically associated to different sub-types of the
                          resource type.
                        type: string
                      capacityType:
                        description: "The type of capacity for the threshold.\nPermitted values:\n-\tTOTAL: for total capacity.\n-\tALLOCATED: for allocated/used capacity.\n-\tRESERVED: for reserved capacity.\n-\tAVAILABLE: for available capacity.\n"
                        type: string
                        enum:
                          - TOTAL
                          - ALLOCATED
                          - RESERVED
                          - AVAILABLE
                  thresholdType:
                    description: "Type of capacity threshold. This attribute determines which other attributes are present in the data structure.\nPermitted values:\n-\tSIMPLE: Single-valued static threshold.\nIn the present document, simple thresholds are defined. The definition of additional threshold types is left\nfor future specification.\n"
                    type: string
                    enum:
                      - SIMPLE
                  simpleThresholdDetails:
                    description: >
                      Details of a simple threshold. Shall be present if
                      thresholdType="SIMPLE".
                    type: array
                    items:
                      type: object
                      required:
                        - thresholdValue
                        - hysteresis
                      properties:
                        thresholdValue:
                          description: >
                            The threshold value. Shall be represented as a
                            floating point number.
                          type: number
                        hysteresis:
                          description: >
                            The hysteresis of the threshold.

                            Shall be represented as a non-negative floating
                            point number.

                            A notification with crossing direction "UP" will be
                            generated if the measured value reaches or

                            exceeds "thresholdValue" + "hysteresis". A
                            notification with crossing direction "DOWN" will be

                            generated if the measured value reaches or undercuts
                            "thresholdValue" - "hysteresis".

                            The hysteresis is defined to prevent storms of
                            threshold crossing notifications.

                            When processing a request to create a threshold,
                            implementations should enforce a suitable minimum

                            value for this attribute (e.g. override the value or
                            reject the request).
                          type: number
              callbackUri:
                description: |
                  String formatted according to IETF RFC 3986.
                type: string
                format: uri
              _links:
                type: object
                description: |
                  Links for this resource.
                required:
                  - self
                properties:
                  self:
                    description: |
                      This type represents a link to a resource.
                    type: object
                    required:
                      - href
                    properties:
                      href:
                        description: >
                          URI of a resource referenced from a notification.
                          Should be an absolute URI (i.e. a URI that contains
                          {apiRoot}), however, may be a relative URI (i.e. a URI
                          where the {apiRoot} part is omitted) if the {apiRoot}
                          information is not available.
                        type: string
                        format: url
                  object:
                    description: |
                      This type represents a link to a resource.
                    type: object
                    required:
                      - href
                    properties:
                      href:
                        description: >
                          URI of a resource referenced from a notification.
                          Should be an absolute URI (i.e. a URI that contains
                          {apiRoot}), however, may be a relative URI (i.e. a URI
                          where the {apiRoot} part is omitted) if the {apiRoot}
                          information is not available.
                        type: string
                        format: url
    IndividualCapacityThreshold.Patch:
      description: >
        200 OK

        Shall be returned when the request has been processed successfully.

        The response body shall contain a data structure of type
        "CapacityThresholdModifications".
      headers:
        Version:
          description: |
            Version of the API used in the response.
          style: simple
          explode: false
          schema:
            type: string
        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.
          style: simple
          explode: false
          schema:
            type: string
        Content-Type:
          description: The MIME type of the body of the response.
          style: simple
          explode: false
          schema:
            type: string
      content:
        application/json:
          schema:
            description: >
              This type represents modifications to a capacity threshold. It
              shall comply with the provisions defined in table 10.5.2.8-1.
            type: object
            properties:
              callbackUri:
                description: |
                  String formatted according to IETF RFC 3986.
                type: string
                format: uri
              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.
                      - 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
                        format: uri
    IndividualCapacityThreshold.Delete:
      description: >
        Shall be returned when the NFVI capacity threshold has been deleted
        successfully.

        The response body shall be empty.
      headers:
        Version:
          description: |
            Version of the API used in the response.
          style: simple
          explode: false
          schema:
            type: string
        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.
          style: simple
          explode: false
          schema:
            type: string
        Content-Type:
          description: The MIME type of the body of the response.
          style: simple
          explode: false
          schema:
            type: string
      content: {}
    NfviCiSubscriptions.Get:
      description: >
        Shall be returned when the list of subscriptions has been queried
        successfully.

        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 NFVI
        capacity information subscriptions,

        as defined in clause 10.5.2.9.

        If the "filter" URI parameter was supplied in the request, the data in
        the response body shall have been

        transformed according to the rules specified in clause 5.2.2 of ETSI GS
        NFV-SOL 013.

        If the NFVO supports alternative 2 (paging) according to clause 5.4.2.1
        of ETSI GS NFV SOL 013 for this resource,

        inclusion of the Link HTTP header in this response shall follow the
        provisions in clause 5.4.2.3 of ETSI GS NFV SOL 013.
      headers:
        Version:
          description: |
            Version of the API used in the response.
          style: simple
          explode: false
          schema:
            type: string
        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.
          style: simple
          explode: false
          schema:
            type: string
        Content-Type:
          description: The MIME type of the body of the response.
          style: simple
          explode: false
          schema:
            type: string
      content:
        application/json:
          schema:
            type: array
            items:
              type: object
              description: >
                This type represents a subscription. It shall comply with the
                provisions defined in Table 10.5.2.9-1.
              required:
                - id
                - callbackUri
                - _links
              properties:
                id:
                  description: |
                    An identifier with the intention of being globally unique.
                  type: string
                filter:
                  type: object
                  description: >
                    This type represents a filter that can be used to subscribe
                    for notifications related to NFVI capacity information
                    events.

                    It shall comply with the provisions defined in Table
                    10.5.3.2-1.
                  properties:
                    notificationTypes:
                      description: "Match particular notification types.\nPermitted values:\n-\tCapacityShortageNotification\n"
                      type: array
                      items:
                        type: string
                        enum:
                          - CapacityShortageNotification
                callbackUri:
                  description: |
                    String formatted according to IETF RFC 3986.
                  type: string
                  format: uri
                _links:
                  type: object
                  description: |
                    Links to resources related to this resource.
                  required:
                    - self
                  properties:
                    self:
                      description: |
                        This type represents a link to a resource.
                      type: object
                      required:
                        - href
                      properties:
                        href:
                          description: >
                            URI of a resource referenced from a notification.
                            Should be an absolute URI (i.e. a URI that contains
                            {apiRoot}), however, may be a relative URI (i.e. a
                            URI where the {apiRoot} part is omitted) if the
                            {apiRoot} information is not available.
                          type: string
                          format: url
    NfviCiSubscriptions.Post:
      description: >
        Shall be returned when the subscription has been created successfully.

        A representation of the created subscription resource shall be returned
        in the response body, as defined in

        clause 10.5.2.9.

        The HTTP response shall include a "Location" HTTP header that contains
        the resource URI of the created subscription

        resource.
      headers:
        Version:
          description: |
            Version of the API used in the response.
          style: simple
          explode: false
          schema:
            type: string
        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.
          style: simple
          explode: false
          schema:
            type: string
        Content-Type:
          description: The MIME type of the body of the response.
          style: simple
          explode: false
          schema:
            type: string
      content:
        application/json:
          schema:
            type: object
            description: >
              This type represents a subscription. It shall comply with the
              provisions defined in Table 10.5.2.9-1.
            required:
              - id
              - callbackUri
              - _links
            properties:
              id:
                description: |
                  An identifier with the intention of being globally unique.
                type: string
              filter:
                type: object
                description: >
                  This type represents a filter that can be used to subscribe
                  for notifications related to NFVI capacity information events.

                  It shall comply with the provisions defined in Table
                  10.5.3.2-1.
                properties:
                  notificationTypes:
                    description: "Match particular notification types.\nPermitted values:\n-\tCapacityShortageNotification\n"
                    type: array
                    items:
                      type: string
                      enum:
                        - CapacityShortageNotification
              callbackUri:
                description: |
                  String formatted according to IETF RFC 3986.
                type: string
                format: uri
              _links:
                type: object
                description: |
                  Links to resources related to this resource.
                required:
                  - self
                properties:
                  self:
                    description: |
                      This type represents a link to a resource.
                    type: object
                    required:
                      - href
                    properties:
                      href:
                        description: >
                          URI of a resource referenced from a notification.
                          Should be an absolute URI (i.e. a URI that contains
                          {apiRoot}), however, may be a relative URI (i.e. a URI
                          where the {apiRoot} part is omitted) if the {apiRoot}
                          information is not available.
                        type: string
                        format: url
    NfviCiSubscription.Get:
      description: >
        Shall be returned when the subscription has been read successfully.

        The response body shall contain a representation of the subscription
        resource, as defined in clause 10.5.2.9.
      headers:
        Version:
          description: |
            Version of the API used in the response.
          style: simple
          explode: false
          schema:
            type: string
        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.
          style: simple
          explode: false
          schema:
            type: string
        Content-Type:
          description: The MIME type of the body of the response.
          style: simple
          explode: false
          schema:
            type: string
      content:
        application/json:
          schema:
            type: object
            description: >
              This type represents a subscription. It shall comply with the
              provisions defined in Table 10.5.2.9-1.
            required:
              - id
              - callbackUri
              - _links
            properties:
              id:
                description: |
                  An identifier with the intention of being globally unique.
                type: string
              filter:
                type: object
                description: >
                  This type represents a filter that can be used to subscribe
                  for notifications related to NFVI capacity information events.

                  It shall comply with the provisions defined in Table
                  10.5.3.2-1.
                properties:
                  notificationTypes:
                    description: "Match particular notification types.\nPermitted values:\n-\tCapacityShortageNotification\n"
                    type: array
                    items:
                      type: string
                      enum:
                        - CapacityShortageNotification
              callbackUri:
                description: |
                  String formatted according to IETF RFC 3986.
                type: string
                format: uri
              _links:
                type: object
                description: |
                  Links to resources related to this resource.
                required:
                  - self
                properties:
                  self:
                    description: |
                      This type represents a link to a resource.
                    type: object
                    required:
                      - href
                    properties:
                      href:
                        description: >
                          URI of a resource referenced from a notification.
                          Should be an absolute URI (i.e. a URI that contains
                          {apiRoot}), however, may be a relative URI (i.e. a URI
                          where the {apiRoot} part is omitted) if the {apiRoot}
                          information is not available.
                        type: string
                        format: url
    NfviCiSubscription.Delete:
      description: >
        Shall be returned when the subscription resource has been deleted
        successfully.

        The response body shall be empty.
      headers:
        Version:
          description: |
            Version of the API used in the response.
          style: simple
          explode: false
          schema:
            type: string
        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.
          style: simple
          explode: false
          schema:
            type: string
        Content-Type:
          description: The MIME type of the body of the response.
          style: simple
          explode: false
          schema:
            type: string
      content: {}
    CapacityShortageNotification.Post:
      description: |
        Shall be returned when the notification has been delivered successfully.
      headers:
        Version:
          description: |
            Version of the API used in the response.
          style: simple
          explode: false
          schema:
            type: string
        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.
          style: simple
          explode: false
          schema:
            type: string
        Content-Type:
          description: The MIME type of the body of the response.
          style: simple
          explode: false
          schema:
            type: string
      content: {}
    CapacityShortageNotification.Get:
      description: >
        Shall be returned to indicate that the notification endpoint has been
        tested successfully.

        The response body shall be empty.
      headers:
        Version:
          description: |
            Version of the API used in the response.
          style: simple
          explode: false
          schema:
            type: string
        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.
          style: simple
          explode: false
          schema:
            type: string
        Content-Type:
          description: The MIME type of the body of the response.
          style: simple
          explode: false
          schema:
            type: string
      content: {}
  callbacks:
    CapacityShortageNotification:
      '{$request.body#/callbackUri}':
        description: >-
          This resource represents a notification endpoint for NFVI capacity
          information. The API producer can use this resource to send
          notifications related to log management events to a subscribed API
          consumer, which has provided the URI of this resource during the
          capacity threshold creation process.
        post:
          description: >-
            The POST method delivers a notification regarding an NFVI capacity
            information event from the API producer to an API consumer. The API
            consumer shall have previously created an "Individual capacity
            threshold" resource"
          parameters:
            - name: Version
              description: >
                Version of the API requested to use when responding to this
                request.
              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
          requestBody:
            description: >
              Notification about the available NFVI capacity having crossed
              below a threshold value or having re-covered from

              a capacity shortage.
            content:
              application/json:
                schema:
                  type: object
                  description: >
                    This notification informs the receiver that the available
                    NFVI capacity has crossed below a threshold value or

                    has re-covered from a capacity shortage. It shall comply
                    with the provisions defined in Table 10.5.2.10-1.
                  required:
                    - id
                    - notificationType
                    - thresholdId
                    - timeStamp
                    - direction
                    - capacityInformation
                    - objectInstanceId
                  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 "CapacityShortageNotification" for this
                        notification type.
                      type: string
                    thresholdId:
                      description: >
                        An identifier with the intention of being globally
                        unique.
                      type: string
                    timeStamp:
                      description: >
                        Date-time stamp. Representation: String formatted
                        according toas defined by the date-time production in
                        IETF RFC 3339.
                      format: date-time
                    objectInstanceId:
                      description: >
                        An identifier with the intention of being globally
                        unique.
                      type: string
                    subObjectInstanceId:
                      description: >
                        An identifier maintained by the VIM or other resource
                        provider. It is expected to be unique within the VIM
                        instance. Representation: string of variable length.
                      type: string
                    direction:
                      description: >
                        Specifies if the threshold has been crossed in UP or
                        DOWN direction.
                      type: string
                      enum:
                        - UP
                        - DOWN
                    capacityInformation:
                      type: object
                      description: >
                        This type defines the format of the NFVI capacity
                        information on a per resource type basis.

                        The type shall comply with the provisions defined in
                        table 10.5.2.6-1.
                      required:
                        - resourceType
                        - capacityMeasurementName
                        - totalCapacity
                        - allocatedCapacity
                        - availableCapacity
                      properties:
                        resourceType:
                          type: string
                          description: >
                            The enumeration NfviCapacityResourceTypeEnumeration
                            shall comply with the provisions in table
                            10.5.4.3-1.

                            * VR_COMPUTE: For virtualised compute resource.

                            * VR_NETWORK: For virtualised network resource.

                            * VR_STORAGE: For virtualised storage resource.

                            * HOST_COMPUTE: For host compute resource.
                          enum:
                            - VR_COMPUTE
                            - VR_NETWORK
                            - VR_STORAGE
                            - HOST_COMPUTE
                        capacityMeasurementName:
                          description: >
                            Name of the capacity measurement. Different resource
                            types can have different associated capacity
                            measurements,

                            typically associated to different sub-types of the
                            resource type.

                            The present document and referred documents do not
                            specify the capacity measurements, thus the capacity

                            measurement names are not specified in the present
                            document version.
                          type: string
                        totalCapacity:
                          description: |
                            The total capacity.
                          type: object
                        allocatedCapacity:
                          description: |
                            The allocated/used capacity.
                          type: object
                        reservedCapacity:
                          description: >
                            The reserved capacity. Shall be present if the
                            capacity measurement relates to a resource type and

                            (and sub-type) that is reservable.
                          type: object
                        availableCapacity:
                          description: |
                            The available capacity.
                          type: object
                    _links:
                      description: |
                        Links to resources related to this notification.
                      type: object
                      required:
                        - threshold
                      properties:
                        objectInstance:
                          description: >
                            This type represents a link to a resource in a
                            notification, using an absolute or relative URI.
                          type: object
                          required:
                            - href
                          properties:
                            href:
                              description: >
                                URI of a resource referenced from a
                                notification. Should be an absolute URI (i.e. a
                                URI that contains {apiRoot}), however, may be a
                                relative URI (i.e. a URI where the {apiRoot}
                                part is omitted) if the {apiRoot} information is
                                not available.
                              type: string
                              format: url
                        threshold:
                          description: >
                            This type represents a link to a resource in a
                            notification, using an absolute or relative URI.
                          type: object
                          required:
                            - href
                          properties:
                            href:
                              description: >
                                URI of a resource referenced from a
                                notification. Should be an absolute URI (i.e. a
                                URI that contains {apiRoot}), however, may be a
                                relative URI (i.e. a URI where the {apiRoot}
                                part is omitted) if the {apiRoot} information is
                                not available.
                              type: string
                              format: url
            required: true
          responses:
            '204':
              description: >
                Shall be returned when the notification has been delivered
                successfully.
              headers:
                Version:
                  description: |
                    Version of the API used in the response.
                  style: simple
                  explode: false
                  schema:
                    type: string
                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.
                  style: simple
                  explode: false
                  schema:
                    type: string
                Content-Type:
                  description: The MIME type of the body of the response.
                  style: simple
                  explode: false
                  schema:
                    type: string
              content: {}
            '400':
              description: >
                400 BAD REQUEST

                400 code can be returned in the following specified cases, the
                specific cause has to be proper specified in the
                "ProblemDetails" structure to be returned.

                If the request is malformed or syntactically incorrect (e.g. if
                the request URI contains incorrect query parameters or the
                payload body contains a syntactically incorrect data structure),
                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 response to a GET request which queries a container
                resource would be so big that the performance of the API
                producer is adversely affected, and the API producer does not
                support paging for the affected resource, it 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 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.

                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.

                The use of this HTTP error response code described above is
                applicable to the use of the OAuth 2.0 for the authorization of
                API requests and notifications, as defined in clauses 4.5.3.3
                and 4.5.3.4.
              headers:
                Content-Type:
                  description: The MIME type of the body of the response.
                  schema:
                    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.
                  schema:
                    type: string
                    maximum: 1
                    minimum: 0
                Version:
                  description: |
                    Version of the API used in the response.
                  schema:
                    type: string
                    maximum: 1
                    minimum: 1
              content:
                application/json:
                  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:
                      - status
                      - 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: >
                401 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:
                  description: The MIME type of the body of the response.
                  schema:
                    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.
                  schema:
                    type: string
                    maximum: 1
                    minimum: 0
                Version:
                  description: |
                    Version of the API used in the response.
                  schema:
                    type: string
                    maximum: 1
                    minimum: 1
              content:
                application/json:
                  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:
                      - status
                      - 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: >
                403 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.
                  schema:
                    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.
                  schema:
                    type: string
                    maximum: 1
                    minimum: 0
                Version:
                  description: |
                    Version of the API used in the response.
                  schema:
                    type: string
                    maximum: 1
                    minimum: 1
              content:
                application/json:
                  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:
                      - status
                      - 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
            '404':
              description: >
                404 NOT FOUND

                If the API producer did not find a current representation for
                the resource addressed by the URI passed in the request or is
                not willing to disclose that one exists, it shall respond with
                this response code. The "ProblemDetails" structure may be
                provided, including in the "detail" attribute information about
                the source of the problem, e.g. a wrong resource URI variable.

                This response code is not appropriate in case the resource
                addressed by the URI is a container resource which is designed
                to contain child resources, but does not contain any child
                resource at the time the request is received. For a GET request
                to an existing empty container resource, a typical response
                contains a 200 OK response code and a payload body with an empty
                array.
              headers:
                Content-Type:
                  description: The MIME type of the body of the response.
                  schema:
                    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.
                  schema:
                    type: string
                    maximum: 1
                    minimum: 0
                Version:
                  description: |
                    Version of the API used in the response.
                  schema:
                    type: string
                    maximum: 1
                    minimum: 1
              content:
                application/json:
                  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:
                      - status
                      - 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: >
                405 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.
              headers:
                Content-Type:
                  description: The MIME type of the body of the response.
                  schema:
                    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.
                  schema:
                    type: string
                    maximum: 1
                    minimum: 0
                Version:
                  description: |
                    Version of the API used in the response.
                  schema:
                    type: string
                    maximum: 1
                    minimum: 1
              content:
                application/json:
                  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:
                      - status
                      - 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: >
                406 NOT ACCEPTABLE

                If the "Accept" HTTP header does not contain at least one name
                of a content type that is acceptable to the API producer, the
                API producer shall respond with this response code. The
                "ProblemDetails" structure may be omitted.
              headers:
                Content-Type:
                  description: The MIME type of the body of the response.
                  schema:
                    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.
                  schema:
                    type: string
                    maximum: 1
                    minimum: 0
                Version:
                  description: |
                    Version of the API used in the response.
                  schema:
                    type: string
                    maximum: 1
                    minimum: 1
              content:
                application/json:
                  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:
                      - status
                      - 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
            '422':
              description: >
                422 UNPROCESSABLE ENTITY

                If the payload body of a request contains syntactically correct
                data (e.g. well-formed JSON) but the data cannot be processed
                (e.g. because it fails validation against a schema), 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.

                This error response code is only applicable for methods that
                have a request body.
              headers:
                Content-Type:
                  description: The MIME type of the body of the response.
                  schema:
                    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.
                  schema:
                    type: string
                    maximum: 1
                    minimum: 0
                Version:
                  description: |
                    Version of the API used in the response.
                  schema:
                    type: string
                    maximum: 1
                    minimum: 1
              content:
                application/json:
                  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:
                      - status
                      - 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: >
                500 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 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.
                  schema:
                    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.
                  schema:
                    type: string
                    maximum: 1
                    minimum: 0
                Version:
                  description: |
                    Version of the API used in the response.
                  schema:
                    type: string
                    maximum: 1
                    minimum: 1
              content:
                application/json:
                  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:
                      - status
                      - 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: >
                503 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 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.
                  schema:
                    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.
                  schema:
                    type: string
                    maximum: 1
                    minimum: 0
                Version:
                  description: |
                    Version of the API used in the response.
                  schema:
                    type: string
                    maximum: 1
                    minimum: 1
              content:
                application/json:
                  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:
                      - status
                      - 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
            '504':
              description: >
                504 GATEWAY TIMEOUT

                If the API producer encounters a timeout while waiting for a
                response from an upstream server (i.e. a server that the API
                producer communicates with when fulfilling a request), it should
                respond with this response code.
              headers:
                Content-Type:
                  description: The MIME type of the body of the response.
                  schema:
                    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.
                  schema:
                    type: string
                    maximum: 1
                    minimum: 0
                Version:
                  description: |
                    Version of the API used in the response.
                  schema:
                    type: string
                    maximum: 1
                    minimum: 1
              content:
                application/json:
                  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:
                      - status
                      - 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:
          description: >-
            The GET method allows the API producer to test the notification
            endpoint that is provided by the API consumer, e.g. during creation
            of the capacity threshold resource.
          parameters:
            - name: Version
              description: >
                Version of the API requested to use when responding to this
                request.
              in: header
              required: true
              schema:
                type: string
            - name: Accept
              description: >
                Content-Types that are acceptable for the response. 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
          responses:
            '204':
              description: >
                Shall be returned to indicate that the notification endpoint has
                been tested successfully.

                The response body shall be empty.
              headers:
                Version:
                  description: |
                    Version of the API used in the response.
                  style: simple
                  explode: false
                  schema:
                    type: string
                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.
                  style: simple
                  explode: false
                  schema:
                    type: string
                Content-Type:
                  description: The MIME type of the body of the response.
                  style: simple
                  explode: false
                  schema:
                    type: string
              content: {}
            '400':
              description: >
                400 BAD REQUEST

                400 code can be returned in the following specified cases, the
                specific cause has to be proper specified in the
                "ProblemDetails" structure to be returned.

                If the request is malformed or syntactically incorrect (e.g. if
                the request URI contains incorrect query parameters or the
                payload body contains a syntactically incorrect data structure),
                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 response to a GET request which queries a container
                resource would be so big that the performance of the API
                producer is adversely affected, and the API producer does not
                support paging for the affected resource, it 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 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.

                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.

                The use of this HTTP error response code described above is
                applicable to the use of the OAuth 2.0 for the authorization of
                API requests and notifications, as defined in clauses 4.5.3.3
                and 4.5.3.4.
              headers:
                Content-Type:
                  description: The MIME type of the body of the response.
                  schema:
                    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.
                  schema:
                    type: string
                    maximum: 1
                    minimum: 0
                Version:
                  description: |
                    Version of the API used in the response.
                  schema:
                    type: string
                    maximum: 1
                    minimum: 1
              content:
                application/json:
                  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:
                      - status
                      - 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: >
                401 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:
                  description: The MIME type of the body of the response.
                  schema:
                    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.
                  schema:
                    type: string
                    maximum: 1
                    minimum: 0
                Version:
                  description: |
                    Version of the API used in the response.
                  schema:
                    type: string
                    maximum: 1
                    minimum: 1
              content:
                application/json:
                  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:
                      - status
                      - 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: >
                403 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.
                  schema:
                    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.
                  schema:
                    type: string
                    maximum: 1
                    minimum: 0
                Version:
                  description: |
                    Version of the API used in the response.
                  schema:
                    type: string
                    maximum: 1
                    minimum: 1
              content:
                application/json:
                  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:
                      - status
                      - 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
            '404':
              description: >
                404 NOT FOUND

                If the API producer did not find a current representation for
                the resource addressed by the URI passed in the request or is
                not willing to disclose that one exists, it shall respond with
                this response code. The "ProblemDetails" structure may be
                provided, including in the "detail" attribute information about
                the source of the problem, e.g. a wrong resource URI variable.

                This response code is not appropriate in case the resource
                addressed by the URI is a container resource which is designed
                to contain child resources, but does not contain any child
                resource at the time the request is received. For a GET request
                to an existing empty container resource, a typical response
                contains a 200 OK response code and a payload body with an empty
                array.
              headers:
                Content-Type:
                  description: The MIME type of the body of the response.
                  schema:
                    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.
                  schema:
                    type: string
                    maximum: 1
                    minimum: 0
                Version:
                  description: |
                    Version of the API used in the response.
                  schema:
                    type: string
                    maximum: 1
                    minimum: 1
              content:
                application/json:
                  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:
                      - status
                      - 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: >
                405 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.
              headers:
                Content-Type:
                  description: The MIME type of the body of the response.
                  schema:
                    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.
                  schema:
                    type: string
                    maximum: 1
                    minimum: 0
                Version:
                  description: |
                    Version of the API used in the response.
                  schema:
                    type: string
                    maximum: 1
                    minimum: 1
              content:
                application/json:
                  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:
                      - status
                      - 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: >
                406 NOT ACCEPTABLE

                If the "Accept" HTTP header does not contain at least one name
                of a content type that is acceptable to the API producer, the
                API producer shall respond with this response code. The
                "ProblemDetails" structure may be omitted.
              headers:
                Content-Type:
                  description: The MIME type of the body of the response.
                  schema:
                    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.
                  schema:
                    type: string
                    maximum: 1
                    minimum: 0
                Version:
                  description: |
                    Version of the API used in the response.
                  schema:
                    type: string
                    maximum: 1
                    minimum: 1
              content:
                application/json:
                  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:
                      - status
                      - 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
            '422':
              description: >
                422 UNPROCESSABLE ENTITY

                If the payload body of a request contains syntactically correct
                data (e.g. well-formed JSON) but the data cannot be processed
                (e.g. because it fails validation against a schema), 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.

                This error response code is only applicable for methods that
                have a request body.
              headers:
                Content-Type:
                  description: The MIME type of the body of the response.
                  schema:
                    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.
                  schema:
                    type: string
                    maximum: 1
                    minimum: 0
                Version:
                  description: |
                    Version of the API used in the response.
                  schema:
                    type: string
                    maximum: 1
                    minimum: 1
              content:
                application/json:
                  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:
                      - status
                      - 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: >
                500 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 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.
                  schema:
                    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.
                  schema:
                    type: string
                    maximum: 1
                    minimum: 0
                Version:
                  description: |
                    Version of the API used in the response.
                  schema:
                    type: string
                    maximum: 1
                    minimum: 1
              content:
                application/json:
                  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:
                      - status
                      - 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: >
                503 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 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.
                  schema:
                    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.
                  schema:
                    type: string
                    maximum: 1
                    minimum: 0
                Version:
                  description: |
                    Version of the API used in the response.
                  schema:
                    type: string
                    maximum: 1
                    minimum: 1
              content:
                application/json:
                  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:
                      - status
                      - 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
            '504':
              description: >
                504 GATEWAY TIMEOUT

                If the API producer encounters a timeout while waiting for a
                response from an upstream server (i.e. a server that the API
                producer communicates with when fulfilling a request), it should
                respond with this response code.
              headers:
                Content-Type:
                  description: The MIME type of the body of the response.
                  schema:
                    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.
                  schema:
                    type: string
                    maximum: 1
                    minimum: 0
                Version:
                  description: |
                    Version of the API used in the response.
                  schema:
                    type: string
                    maximum: 1
                    minimum: 1
              content:
                application/json:
                  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:
                      - status
                      - 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

