github.com/go-swagger/go-swagger@v0.31.0/fixtures/bugs/2919/edge-api/client/services.yml (about)

     1  ---
     2  paths:
     3    services:
     4      get:
     5        summary: List services
     6        description: |
     7          Retrieves a list of config resources; supports filtering, sorting, and pagination. Requires admin access.
     8        security:
     9          - ztSession: [ ]
    10        tags:
    11          - Service
    12        operationId: listServices
    13        parameters:
    14          - $ref: '../shared/parameters.yml#/limit'
    15          - $ref: '../shared/parameters.yml#/offset'
    16          - $ref: '../shared/parameters.yml#/filter'
    17          - $ref: '../shared/parameters.yml#/roleFilter'
    18          - $ref: '../shared/parameters.yml#/roleSemantic'
    19        responses:
    20          '200':
    21            $ref: '../shared/services.yml#/responses/listServices'
    22          '401':
    23            $ref: '../shared/standard-responses.yml#/responses/unauthorizedResponse'
    24          '400':
    25            $ref: '../shared/standard-responses.yml#/responses/badRequestResponse'
    26    services-id:
    27      parameters:
    28        - $ref: '../shared/parameters.yml#/id'
    29      get:
    30        summary: Retrieves a single service
    31        description: Retrieves a single service by id. Requires admin access.
    32        security:
    33          - ztSession: [ ]
    34        tags:
    35          - Service
    36        operationId: detailService
    37        responses:
    38          '200':
    39            $ref: '../shared/services.yml#/responses/detailService'
    40          '404':
    41            $ref: '../shared/standard-responses.yml#/responses/notFoundResponse'
    42          '401':
    43            $ref: '../shared/standard-responses.yml#/responses/unauthorizedResponse'
    44  
    45    services-id-terminators:
    46      parameters:
    47        - $ref: '../shared/parameters.yml#/id'
    48      get:
    49        summary: List of terminators assigned to a service
    50        description: |
    51          Retrieves a list of terminator resources that are assigned specific service; supports filtering, sorting, and pagination.
    52        security:
    53          - ztSession: [ ]
    54        tags:
    55          - Service
    56        operationId: listServiceTerminators
    57        parameters:
    58          - $ref: '../shared/parameters.yml#/limit'
    59          - $ref: '../shared/parameters.yml#/offset'
    60          - $ref: '../shared/parameters.yml#/filter'
    61        responses:
    62          '200':
    63            $ref: '#/responses/listClientTerminators'
    64          '401':
    65            $ref: '../shared/standard-responses.yml#/responses/unauthorizedResponse'
    66          '400':
    67            $ref: '../shared/standard-responses.yml#/responses/badRequestResponse'
    68  
    69  responses:
    70    listClientTerminators:
    71      description: A list of terminators
    72      schema:
    73        $ref: '#/definitions/listClientTerminatorsEnvelope'
    74  
    75  definitions:
    76    listClientTerminatorsEnvelope:
    77      type: object
    78      required:
    79        - meta
    80        - data
    81      properties:
    82        meta:
    83          $ref: '../shared/standard-responses.yml#/definitions/meta'
    84        data:
    85          $ref: '#/definitions/terminatorClientList'
    86    terminatorClientList:
    87      type: array
    88      items:
    89        $ref: '#/definitions/terminatorClientDetail'
    90    terminatorClientDetail:
    91      type: object
    92      allOf:
    93        - $ref: '../shared/base-entity.yml#/definitions/baseEntity'
    94        - type: object
    95          required:
    96            - serviceId
    97            - service
    98            - routerId
    99            - identity
   100          properties:
   101            serviceId:
   102              type: string
   103            service:
   104              $ref: '../shared/base-entity.yml#/definitions/entityRef'
   105            routerId:
   106              type: string
   107            identity:
   108              type: string