Scalable Services Services API

openapi: 3.1.0
info:
  title: Kubernetes Core API (v1) ConfigMaps Services API
  description: 'The Kubernetes API is served by the kube-apiserver and exposes a uniform,

    versioned REST surface for cluster resources. This OpenAPI is a hand-curated

    subset of the core/v1 group covering the most common workloads — pods,

    namespaces, services, configmaps, secrets, nodes, and persistent volumes.

    Authentication is per-cluster (bearer tokens, client certs, OIDC). The base

    URL is the API server endpoint of a given cluster (no single public base).

    This file is an API Evangelist research artifact for the scalable-services

    topic.

    '
  version: 1.0.0
  contact:
    name: API Evangelist
    url: https://apievangelist.com
servers:
- url: https://kubernetes.default.svc
  description: In-cluster API server
- url: https://{cluster}:6443
  description: External cluster endpoint
  variables:
    cluster:
      default: localhost
      description: Cluster API server hostname
security:
- BearerAuth: []
tags:
- name: Services
paths:
  /api/v1/namespaces/{namespace}/services:
    parameters:
    - $ref: '#/components/parameters/Namespace'
    get:
      summary: List services in a namespace
      operationId: listNamespacedServices
      tags:
      - Services
      responses:
        '200':
          description: Service list.
    post:
      summary: Create a service
      operationId: createService
      tags:
      - Services
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
      responses:
        '201':
          description: Service created.
  /api/v1/namespaces/{namespace}/services/{name}:
    parameters:
    - $ref: '#/components/parameters/Namespace'
    - $ref: '#/components/parameters/Name'
    get:
      summary: Read a service
      operationId: readService
      tags:
      - Services
      responses:
        '200':
          description: A service.
    delete:
      summary: Delete a service
      operationId: deleteService
      tags:
      - Services
      responses:
        '200':
          description: Service deleted.
components:
  parameters:
    Name:
      name: name
      in: path
      required: true
      schema:
        type: string
    Namespace:
      name: namespace
      in: path
      required: true
      schema:
        type: string
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: ServiceAccountToken