Commit 9b45f53b authored by Ikram Haq's avatar Ikram Haq
Browse files

Latest ato generated OAS for MEC 014

parent af4c47f5
Loading
Loading
Loading
Loading
Loading
+180 −0
Original line number Diff line number Diff line
openapi: 3.1.0
jsonSchemaDialect: https://json-schema.org/draft/2020-12/schema
info:
  contact:
    url: https://forge.etsi.org/rep/mec/gs014-ue-identity-api
  title: ETSI GS MEC 014 UE Identity API
  description: "The present document focuses on the UE Identity functionality. It describes the related application policy information (including authorization, access control and traffic rule pattern format), information flows, required information and service aggregation patterns. The present document specifies the necessary API, data model and data format, considering existing API(s) if applicable. \n"
  license:
    name: BSD-3-Clause
    url: https://forge.etsi.org/legal-matters
  version: 3.1.1
paths:
  /{appInstanceId}/ue_identity_tag_info:
    get:
      summary: Retrieve information about specific UeIdentityTagInfo.
      description: This method retrieves information about a UeIdentityTagInfo resource.
      operationId: ueidentitytaginfoGET
      tags:
      - uEIdentity
      parameters:
      - $ref: '#/components/parameters/Query.Ueidentitytag'
      responses:
        '200':
          description: It is used to indicate nonspecific success. The response body contains a representation of the UeIdentityTagInfo resource.
          content:
            application/json:
              schema:
                type: object
                properties:
                  UeIdentityTagInfo:
                    $ref: '#/components/schemas/UeIdentityTagInfo'
        '400':
          $ref: '#/components/responses/400'
        '404':
          $ref: '#/components/responses/404'
        '403':
          $ref: '#/components/responses/403'
    put:
      summary: Register/De-register the information about specific UeIdentityTagInfo.
      description: This method registers/deregisters one or more UE Identity tags. It has "replace" semantics.
      operationId: ueidentitytaginfoPUT
      tags:
      - uEIdentity
      requestBody:
        description: The updated "state" for each included UE Identity tag is included in the entity body of the request.
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                UeIdentityTagInfo:
                  $ref: '#/components/schemas/UeIdentityTagInfo'
      responses:
        '200':
          description: It is used to indicate success. The response body contains a representation of the UeIdentityTagInfo resource.
          content:
            application/json:
              schema:
                type: object
                properties:
                  UeIdentityTagInfo:
                    $ref: '#/components/schemas/UeIdentityTagInfo'
        '400':
          $ref: '#/components/responses/400'
        '404':
          $ref: '#/components/responses/404'
        '403':
          $ref: '#/components/responses/403'
        '412':
          $ref: '#/components/responses/412'
components:
  schemas:
    ProblemDetails:
      type: object
      properties:
        type:
          type: string
          format: uri
          description: A URI reference according to IETF RFC 3986 that identifies the problem type
          x-etsi-mec-cardinality: 0..1
          x-etsi-mec-origin-type: URI
        title:
          type: string
          description: A short, human-readable summary of the problem type
          x-etsi-mec-cardinality: 0..1
          x-etsi-mec-origin-type: String
        status:
          type: integer
          format: uint32
          description: The HTTP status code for this occurrence of the problem
          x-etsi-mec-cardinality: 0..1
          x-etsi-mec-origin-type: Uint32
        detail:
          type: string
          description: A human-readable explanation specific to this occurrence of the problem
          x-etsi-mec-cardinality: 0..1
          x-etsi-mec-origin-type: String
        instance:
          type: string
          format: uri
          description: A URI reference that identifies the specific occurrence of the problem
          x-etsi-mec-cardinality: 0..1
          x-etsi-mec-origin-type: URI
    UeIdentityTagInfo:
      x-etsi-ref: 6.2.2
      type: object
      properties:
        ueIdentityTags:
          type: array
          items:
            $ref: '#/components/schemas/UeIdentityTags'
      required:
      - ueIdentityTags
    UeIdentityTags:
      description: 1 to N tags presented by a MEC Application instance to a MEC Platform
      x-etsi-mec-origin-type: Structure (inlined)
      x-etsi-mec-cardinality: 1..N
      type: object
      minItems: 1
      properties:
        ueIdentityTag:
          description: Specific tag presented by a MEC Application instance to a MEC Platform
          x-etsi-mec-origin-type: String
          x-etsi-mec-cardinality: '1'
          type: string
        state:
          type: integer
          description: 'The following numeric values are defined:

            0 = UNREGISTERED

            1 = REGISTERED'
          enum:
          - SEE_DESCRIPTION
          x-etsi-mec-origin-type: Enum_inlined
          x-etsi-mec-cardinality: '1'
      required:
      - ueIdentityTag
      - state
  responses:
    '200':
      description: OK
    '400':
      description: 'Bad Request: used to indicate that incorrect parameters were passed to the request.'
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/ProblemDetails'
    '403':
      description: 'Forbidden: operation is not allowed given the current status of the resource.'
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/ProblemDetails'
    '404':
      description: 'Not Found: used when a client provided a URI that cannot be mapped to a valid resource URI.'
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/ProblemDetails'
    '412':
      description: 'Precondition failed: used when a condition has failed during conditional requests, e.g. when using ETags to avoid write conflicts when using PUT'
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/ProblemDetails'
  parameters:
    Query.Ueidentitytag:
      description: Represents one or more UEs.
      name: ueidentitytag
      cardinality: 1..N
      in: query
      required: true
      x-exportParamName: Query.Ueidentitytag
      schema:
        type: array
        items:
          type: string