haproxy-spec.yaml

---
swagger: "2.0"
info:
  title: HAProxy Data Plane API
  description: |
    API for editing and managing haproxy instances. Provides process information, configuration management,
    haproxy stats and logs.
  version: '2.0'
  contact:
    name: HAProxy Support
    url: https://my.haproxy.com/portal/cust/login
    email: support@haproxy.com
externalDocs:
  url: https://cbonte.github.io/haproxy-dconv/
  description: HAProxy Documentation
definitions:
  site:
    $ref: "models/simple.yaml#/site"
  sites:
    title: Sites
    description: |
      Sites array. Sites are considered as one service and all farms connected to that service.
      Farms are connected to service using use-backend and default_backend directives. Sites let you
      configure simple HAProxy configurations, for more advanced options use /haproxy/configuration 
      endpoints.
    type: array
    items:
      $ref: "#/definitions/site"
  global:
    $ref: "models/configuration.yaml#/global"
  defaults:
    $ref: "models/configuration.yaml#/defaults"
  frontend:
    $ref: "models/configuration.yaml#/frontend"
  frontends:
    title: Frontends
    description: HAProxy frontends array
    type: array
    items:
      $ref: '#/definitions/frontend'
  backend:
    $ref: "models/configuration.yaml#/backend"
  backends:
    title: Backends
    description: HAProxy backends array
    type: array
    items:
      $ref: '#/definitions/backend'
  bind:
    $ref: "models/configuration.yaml#/bind"
  binds:
    title: Binds
    description: HAProxy frontend binds array (corresponds to bind directives)
    type: array
    items:
      $ref: '#/definitions/bind'
  server:
    $ref: "models/configuration.yaml#/server"
  servers:
    title: Servers
    description: HAProxy backend servers array
    type: array
    items:
      $ref: '#/definitions/server'
  http_request_rule:
    $ref: "models/configuration.yaml#/http_request_rule"
  http_request_rules:
    title: HTTP Request Rules Array
    description: HAProxy HTTP request rules array (corresponds to http-request directives)
    type: array
    items:
      $ref: '#/definitions/http_request_rule'
  http_response_rule:
    $ref: "models/configuration.yaml#/http_response_rule"
  http_response_rules:
    title: HTTP Response Rules Array
    description: HAProxy HTTP response rules array (corresponds to http-response directives)
    type: array
    items:
      $ref: '#/definitions/http_response_rule'
  tcp_request_rule:
    $ref: "models/configuration.yaml#/tcp_request_rule"
  tcp_request_rules:
    title: TCP Request Rules Array
    description: HAProxy TCP request rules array (corresponds to tcp-request directive)
    type: array
    items:
      $ref: '#/definitions/tcp_request_rule'
  tcp_response_rule:
    $ref: "models/configuration.yaml#/tcp_response_rule"
  tcp_response_rules:
    title: TCP Response Rules Array
    description: HAProxy TCP response rules array (corresponds to tcp-response directive)
    type: array
    items:
      $ref: '#/definitions/tcp_response_rule'
  backend_switching_rule:
    $ref: "models/configuration.yaml#/backend_switching_rule"
  backend_switching_rules:
    title: Backend Switching Rules Array
    description: HAProxy backend switching rules array (corresponds to use_backend directives)
    type: array
    items:
      $ref: '#/definitions/backend_switching_rule'
  server_switching_rule:
    $ref: "models/configuration.yaml#/server_switching_rule"
  server_switching_rules:
    title: Server Switching Rules Array
    description: HAProxy backend server switching rules array (corresponds to use-server directives)
    type: array
    items:
      $ref: '#/definitions/server_switching_rule'
  filter:
    $ref: "models/configuration.yaml#/filter"
  filters:
    title: Filters Array
    description: HAProxy filters array (corresponds to filter directive)
    type: array
    items:
      $ref: '#/definitions/filter'
  stick_rule:
    $ref: "models/configuration.yaml#/stick_rule"
  stick_rules:
    title: Stick Rules Array
    description: HAProxy backend stick rules array (corresponds to stick store-request, stick match, stick on, stick store-response)
    type: array
    items:
      $ref: '#/definitions/stick_rule'
  log_target:
    $ref: "models/configuration.yaml#/log_target"
  log_targets:
    title: Log Target Array
    description: HAProxy log target array (corresponds to log directives)
    type: array
    items:
      $ref: '#/definitions/log_target'
  acl:
    $ref: "models/configuration.yaml#/acl"
  acls:
    title: ACL Lines Array
    description: HAProxy ACL lines array (corresponds to acl directives)
    type: array
    items:
      $ref: '#/definitions/acl'
  native_stats:
    $ref: "models/stats.yaml#/native_stats"
  native_stat:
    $ref: "models/stats.yaml#/native"
  error:
    $ref: "models/errors.yaml#/error"
  endpoint:
    $ref: "models/general.yaml#/endpoint"
  endpoints:
    title: Endpoints Array
    description: Collection of endpoints
    type: array
    items:
      $ref: '#/definitions/endpoint'
  process_infos:
    $ref: "models/runtime.yaml#/process_infos"
  transaction:
    $ref: "models/general.yaml#/transaction"
  transactions:
    title: Transactions array
    description: Configuration transactions array
    type: array
    items:
      $ref: "#/definitions/transaction"
  info:
    $ref: "models/general.yaml#/info"
  reload:
    $ref: "models/general.yaml#/reload"
  reloads:
    title: HAProxy Reloads Array
    description: HAProxy reloads array
    type: array
    items:
      $ref: "#/definitions/reload"
  runtime_server:
    $ref: "models/runtime.yaml#/server"
  runtime_servers:
    title: HAProxy Runtime Servers Array
    description: HAProxy runtime servers array
    type: array
    items:
      $ref: "#/definitions/runtime_server"
  stick_table:
    $ref: "models/runtime.yaml#/table"
  stick_tables:
    title: Stick Tables Array
    description: Array of runtime stick tables
    type: array
    items:
      $ref: "#/definitions/stick_table"
  stick_table_entry:
    $ref: "models/runtime.yaml#/table_entry"
  stick_table_entries:
    title: Stick Tables Entries
    description: Entries of one runtime stick table
    type: array
    items:
      $ref: "#/definitions/stick_table_entry"
  balance:
    $ref: "models/configuration.yaml#/balance"
  forwardfor:
    $ref: "models/configuration.yaml#/forwardfor"
  default_server:
    $ref: "models/configuration.yaml#/default_server"
  httpchk:
    $ref: "models/configuration.yaml#/httpchk"
  redispatch:
    $ref: "models/configuration.yaml#/redispatch"
  errorfile:
    $ref: "models/configuration.yaml#/errorfile"
  cookie:
    $ref: "models/configuration.yaml#/cookie"
responses:
  BadRequest:
    description: Bad request
    headers:
      Configuration-Version:
        description: Configuration file version
        type: integer
        x-nullable: false
    schema:
      $ref: '#/definitions/error'
  NotFound:
    description: The specified resource was not found
    headers:
      Configuration-Version:
        description: Configuration file version
        type: integer
        x-nullable: false
    schema:
      $ref: '#/definitions/error'
  AlreadyExists:
    description: The specified resource already exists
    headers:
      Configuration-Version:
        description: Configuration file version
        type: integer
        x-nullable: false
    schema:
      $ref: '#/definitions/error'
  DefaultError:
    description: General Error
    headers:
      Configuration-Version:
        description: Configuration file version
        type: integer
        x-nullable: false
    schema:
      $ref: '#/definitions/error'
parameters: 
  transaction_id:
    name: transaction_id
    in: query
    description: ID of the transaction where we want to add the operation. Cannot be used when version is specified.
    type: string
    required: false
    x-nullable: false
  version:
    name: version
    in: query
    description: Version used for checking configuration version. Cannot be used when transaction is specified, transaction has it's own version.
    type: integer
    required: false
    x-nullable: false
  force_reload:
    name: force_reload
    in: query
    description: If set, do a force reload, do not wait for the configured reload-delay. Cannot be used when transaction is specified, as changes in transaction are not applied directly to configuration.
    type: boolean
    required: false
    default: false
securityDefinitions:
  basic_auth:
    type: basic
basePath: /v2
schemes:
  - http
consumes:
  - application/json
produces:
  - application/json
tags:
  - name: Discovery
    description: API autodiscover endpoints
  - name: Information
  - name: Specification
  - name: Transactions
    description: |
      Managing transactions. Configuration changes can be grouped in the transaction. You start the 
      transaction with trasactions POST, and call the configuration changes you need with parameter 
      transaction_id. When you want to commit the transaction, you call the transactions PUT and all changes
      in that transaction is commited. If you call a configuration change without the transaction_id, 
      transaction mechanism is implicitly called with one operation in transaction.
  - name: Reloads
    description: |
      Checking reload success. To avoid constant reloading we reload in intervals that are configurable when
      with reload-delay option. When a change to configuration is made and force_reload url query string 
      parameter is false we issue a request for reload, and return the reload ID in response header. You can
      then use reloads endpoints to check the status of that reload ID. If force_reload is true, we override all
      of this and reload immediately.
  - name: Sites
    description: |
      Managing sites (simple configuration mode). Sites are considered as one frontend with multiple backends 
      connected to it via default_backend or use-backend directives.
  - name: Stats
    description: Stats container
  - name: Global
    description: Managing global configuration (advanced mode)
  - name: Defaults
    description: Managing defaults configuration (advanced mode)
  - name: Frontend
    description: Managing frontend configuration (advanced mode)
  - name: Backend
    description: Managing backend configurations (advanced mode)
  - name: Bind
    description: Managing frontend bind configurations (advanced mode)
  - name: Server
    description: Managing backend server configurations (advanced mode)
  - name: Frontend options
    description: Various frontend options (advanced mode)
  - name: Backend options
    description: Various backend options (advanced mode)
  - name: Configuration
    description: Raw HAProxy configuration management (advanced mode)
  - name: HAProxy configuration management
    description: Managing advanced haproxy configuration (advanced mode)
  - name: TCPRequestRule
  - name: HTTPRequestRule
  - name: HTTPResponseRule
  - name: BackendSwitchingRule
  - name: ServerSwitchingRule
  - name: TCPResponseRule
  - name: Filter
  - name: StickRule
  - name: LogTarget
  - name: ACL
security:
  - basic_auth: []
paths:
  /:
    $ref: "paths/general.yaml#/root"
  /specification:
    $ref: "paths/general.yaml#/specification"
  /info:
    $ref: "paths/general.yaml#/info"
  /services:
    $ref: "paths/general.yaml#/services"
  /services/haproxy:
    $ref: "paths/general.yaml#/haproxy"
  /services/haproxy/sites:
    $ref: "paths/simple.yaml#/sites"
  /services/haproxy/sites/{name}:
    $ref: "paths/simple.yaml#/sites_one"
  /services/haproxy/stats:
    $ref: "paths/general.yaml#/stats"
  /services/haproxy/stats/native:
    $ref: "paths/stats.yaml#/native"
  /services/haproxy/transactions:
    $ref: "paths/general.yaml#/transactions"
  /services/haproxy/transactions/{id}:
    $ref: "paths/general.yaml#/transactions_one"
  /services/haproxy/reloads:
    $ref: "paths/general.yaml#/reloads"
  /services/haproxy/reloads/{id}:
    $ref: "paths/general.yaml#/reloads_one"
  /services/haproxy/configuration:
    $ref: "paths/general.yaml#/configuration"    
  /services/haproxy/configuration/global:
    $ref: "paths/configuration.yaml#/global"
  /services/haproxy/configuration/defaults:
    $ref: "paths/configuration.yaml#/defaults"
  /services/haproxy/configuration/frontends:
    $ref: "paths/configuration.yaml#/frontends"
  /services/haproxy/configuration/frontends/{name}:
    $ref: "paths/configuration.yaml#/frontends_one"
  /services/haproxy/configuration/backends:
    $ref: "paths/configuration.yaml#/backends"
  /services/haproxy/configuration/backends/{name}:
    $ref: "paths/configuration.yaml#/backends_one"
  /services/haproxy/configuration/binds:
    $ref: "paths/configuration.yaml#/binds"
  /services/haproxy/configuration/binds/{name}:
    $ref: "paths/configuration.yaml#/binds_one"
  /services/haproxy/configuration/servers:
    $ref: "paths/configuration.yaml#/servers"
  /services/haproxy/configuration/servers/{name}:
    $ref: "paths/configuration.yaml#/servers_one"
  /services/haproxy/configuration/http_request_rules:
    $ref: "paths/configuration.yaml#/http_request_rules"
  /services/haproxy/configuration/http_request_rules/{id}:
    $ref: "paths/configuration.yaml#/http_request_rules_one"
  /services/haproxy/configuration/http_response_rules:
    $ref: "paths/configuration.yaml#/http_response_rules"
  /services/haproxy/configuration/http_response_rules/{id}:
    $ref: "paths/configuration.yaml#/http_response_rules_one"
  /services/haproxy/configuration/tcp_request_rules:
    $ref: "paths/configuration.yaml#/tcp_request_rules"
  /services/haproxy/configuration/tcp_request_rules/{id}:
    $ref: "paths/configuration.yaml#/tcp_request_rules_one"
  /services/haproxy/configuration/tcp_response_rules:
    $ref: "paths/configuration.yaml#/tcp_response_rules"
  /services/haproxy/configuration/tcp_response_rules/{id}:
    $ref: "paths/configuration.yaml#/tcp_response_rules_one"
  /services/haproxy/configuration/backend_switching_rules:
    $ref: "paths/configuration.yaml#/backend_switching_rules"
  /services/haproxy/configuration/backend_switching_rules/{id}:
    $ref: "paths/configuration.yaml#/backend_switching_rules_one"
  /services/haproxy/configuration/server_switching_rules:
    $ref: "paths/configuration.yaml#/server_switching_rules"
  /services/haproxy/configuration/server_switching_rules/{id}:
    $ref: "paths/configuration.yaml#/server_switching_rules_one"
  /services/haproxy/configuration/filters:
    $ref: "paths/configuration.yaml#/filters"
  /services/haproxy/configuration/filters/{id}:
    $ref: "paths/configuration.yaml#/filters_one"
  /services/haproxy/configuration/stick_rules:
    $ref: "paths/configuration.yaml#/stick_rules"
  /services/haproxy/configuration/stick_rules/{id}:
    $ref: "paths/configuration.yaml#/stick_rules_one"
  /services/haproxy/configuration/log_targets:
    $ref: "paths/configuration.yaml#/log_targets"
  /services/haproxy/configuration/log_targets/{id}:
    $ref: "paths/configuration.yaml#/log_targets_one"
  /services/haproxy/configuration/acls:
    $ref: "paths/configuration.yaml#/acls"
  /services/haproxy/configuration/acls/{id}:
    $ref: "paths/configuration.yaml#/acls_one"
  /services/haproxy/configuration/raw:
    $ref: "paths/configuration.yaml#/configuration"
  /services/haproxy/runtime:
    $ref: "paths/general.yaml#/runtime"
  /services/haproxy/runtime/info:
    $ref: "paths/runtime.yaml#/process_info"
  /services/haproxy/runtime/servers:
    $ref: "paths/runtime.yaml#/servers"
  /services/haproxy/runtime/servers/{name}:
    $ref: "paths/runtime.yaml#/servers_one"
  /services/haproxy/runtime/stick_tables:
    $ref: "paths/runtime.yaml#/stick_tables"
  /services/haproxy/runtime/stick_tables/{name}:
    $ref: "paths/runtime.yaml#/stick_tables_one"
  /services/haproxy/runtime/stick_table_entries:
    $ref: "paths/runtime.yaml#/stick_table_entries"