Skip to content
SOL003-VNFIndicator-API.yaml 247 KiB
Newer Older
swagger: '2.0'
info:
  version: 1.1.1
  title: SOL003 - VNF Indicator interface
  description: >
    SOL003 - VNF Indicator interface


    IMPORTANT: Please note that this file might be not aligned to the current
    version of the ETSI Group Specification it refers to. In case of
    discrepancies the published ETSI Group Specification takes precedence.


    In clause 4.3.2 of ETSI GS NFV-SOL 003 v2.4.1, an attribute-based filtering
    mechanism is defined. This mechanism is currently not included in the
    corresponding OpenAPI design for this GS version. Changes to the
    attribute-based filtering mechanism are being considered in v2.5.1 of this
    GS for inclusion in the corresponding future ETSI NFV OpenAPI design. Please
    report bugs to
    https://forge.etsi.org/bugzilla/buglist.cgi?component=Nfv-Openapis&list_id=61&product=NFV&resolution=
  license:
    name: ETSI Forge copyright notice
    url: 'https://forge.etsi.org/etsi-forge-copyright-notice.txt'
externalDocs:
  description: ETSI GS NFV-SOL 003 V2.4.1
  url: >-
    http://www.etsi.org/deliver/etsi_gs/NFV-SOL/001_099/003/02.04.01_60/gs_NFV-SOL003v020401p.pdf
basePath: /vnfind/v1
schemes:
  - https
consumes:
  - application/json
produces:
  - application/json
paths:
  /indicators:
    get:
      description: |
        Get Indicator Value

        The GET method queries multiple VNF indicators.
      parameters:
        - name: Accept
          description: >
            Content-Types that are acceptable for the response. Reference: IETF
            RFC 7231
          in: header
          required: true
          type: string
        - name: Authorization
          description: |
            The authorization token for the request. Reference: IETF RFC 7235
          in: header
          required: false
          type: string
      responses:
        '200':
          description: >
            OK

            The list of VNF indicators was queried successfully. The response
            body shall contain the representations of all VNF indicators that
            match the attribute filter.
          headers:
            Content-Type:
              description: >
                The MIME type of the body of the request. Reference: IETF RFC
                7231
              type: string
              maximum: 1
              minimum: 1
            WWW-Authenticate:
              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.
              type: string
              maximum: 1
              minimum: 0
          schema:
            type: array
            items:
              description: |
                This type represents a VNF indicator value.
              type: object
              required:
                - id
                - value
                - vnfInstanceId
                - _links
              properties:
                id:
                  description: |
                    An identifier that is unique within a VNF descriptor.
                  type: string
                name:
                  description: >
                    Human readable name of the indicator. Shall be present if
                    defined in the VNFD.
                  type: string
                value:
                  description: >
                    Provides the value of the indicator. The value format is
                    defined in the VNFD. ETSI GS NFV-SOL 001 specifies the
                    structure and format of the  VNFD based on TOSCA
                    specifications.
                  type: object
                vnfInstanceId:
                  description: |
                    An identifier with the intention of being globally unique.
                  type: string
                _links:
                  description: |
                    Links for this resource.
                  type: object
                  required:
                    - self
                    - vnfInstance
                  properties:
                    self:
                      description: |
                        This type represents a link to a resource.
                      type: object
                      required:
                        - href
                      properties:
                        href:
                          description: |
                            URI of the referenced resource.
                          type: string
                          format: url
                    vnfInstance:
                      description: |
                        This type represents a link to a resource.
                      type: object
                      required:
                        - href
                      properties:
                        href:
                          description: |
                            URI of the referenced resource.
                          type: string
                          format: url
        '400':
          description: >
            Bad Request

            Invalid attribute-based filtering parameters or Invalid attribute
            selector. It fhe request is malformed or syntactically incorrect
            (e.g. if the request URI contains incorrect query parameters or a
            syntactically incorrect payload body), 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 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. 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.
          headers:
            Content-Type:
              description: The MIME type of the body of the response.
              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.
              type: string
          schema:
            description: >
              The definition of the general "ProblemDetails" data structure from
              IETF RFC 7807 [19] is reproduced inthis 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
Loading
Loading full blame…