SOL005_params.yaml 5.83 KB
Newer Older
components:
  parameters:
    Version:
      name: Version
      description: >
        Version of the API requested to use when responding to this request.
      in: header
      required: true
      schema:
        type: string

    Accept:
      name: Accept
      description: >
        Content-Types that are acceptable for the response. Reference: IETF RFC 7231.
      in: header
      required: true
      schema:
        type: string

    Authorization:
      name: Authorization
      description: >
        The authorization token for the request. Reference: IETF RFC 7235.
      in: header
      required: false
      schema:
        type: string

    ContentType:
      name: Content-Type
      description: |
        The MIME type of the body of the request. Reference: IETF RFC 7231
      in: header
      required: true
      schema:
        type: string

    Range:
      name: Range
      in: header
      description: |
        The request may contain a "Range" HTTP header to obtain single range of bytes from the VNF package file.
        This can be used to continue an aborted transmission.
        If the NFVO does not support range requests, it should return the whole file with a 200 OK response instead.
      required: false
      style: simple
      explode: false
      schema:
        type: string

    filter:
      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

    all_fields:
      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

    fields:
      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

    exclude_fields:
      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

    exclude_default:
      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.

        The 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:
        -	vnfInstances
        -	pnfInfo
        -	virtualLinkInfo
        -	vnffgInfo
        -	sapInfo
        -	nsScaleStatus
        -	additionalAffinityOrAntiAffinityRules
        -   wanConnectionInfo
      required: false
      schema:
        type: string

    nextpage_opaque_marker:
      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

    include_signature:
      name: include_signature
      description: >
        If this parameter is provided, the NFVO shall include in the ZIP archive the security information
        as specified above.
        This URI query parameter is a flag, i.e. it shall have no value. The NFVO shall support this parameter.
      in: query
      required: false
      schema:
        type: string

    exclude_all_mano_artifacts:
      name: exclude_all_mano_artifacts
      in: query
      description: |
        Flag (i.e. parameter without value) that instructs the NFVO to exclude the set of additional MANO artifacts
        (i.e. those that are not images) from the response payload body. The NFVO shall support this parameter.
        The VNFM may supply this parameter.
      required: false
      style: form
      explode: true
      schema:
        type: string

    exclude_all_non_mano_artifacts:
      name: exclude_all_non_mano_artifacts
      in: query
      description: |
        Flag (i.e. parameter without value) that instructs the NFVO to exclude the set of non-MANO artifacts from the
        response payload body. The NFVO shall support this parameter. The VNFM may supply this parameter.
      required: false
      style: form
      explode: true
      schema:
        type: string

    select_non_mano_artifact_sets:
      name: select_non_mano_artifact_sets
      in: query
      description: |
        Comma-separated list of non-MANO artifact set identifiers for which the artifacts are to be included in the
        response body. The NFVO should support this parameter. If the NFVO does not support this parameter, it shall
        ignore it, i.e. provide a response as if no parameter was provided. The VNFM may supply this parameter.
      required: false
      style: form
      explode: true