---
title: "Serverless Configuration"
url: "https://nov18-dev.movespot.fyi/apis/konnect-cloud-gateways-internal-2/versions/53f44c10-7c5c-44ed-9e12-01aa08aa0a32/schemas/ServerlessConfigurationManifest"
---

> Full API specification: https://nov18-dev.movespot.fyi/apis/konnect-cloud-gateways-internal-2/versions/53f44c10-7c5c-44ed-9e12-01aa08aa0a32.md

# Serverless Configuration

## OpenAPI definition

```yaml
openapi: 3.0.3
info:
  title: Konnect Cloud Gateways
  version: 3.0.0
servers:
  - url: https://global.api.konghq.com/v3
    description: Base URL for the global region
components:
  schemas:
    BaseConfigurationManifest:
      type: object
      properties:
        id:
          description: ID of the configuration.
          type: string
          format: uuid
          example: f521675a-af6b-4684-be7b-43bc27b20543
          readOnly: true
        kind:
          type: string
          enum:
            - dedicated.v0
            - serverless.v0
            - serverless.v1
        control_plane_id:
          description: ID of the control-plane a configuration belongs to.
          type: string
          format: uuid
          example: b5922611-a763-499e-8d86-5643de122768
          readOnly: true
        control_plane_geo:
          $ref: "#/components/schemas/ControlPlaneGeo"
      discriminator:
        propertyName: kind
        mapping:
          serverless.v0: "#/components/schemas/ServerlessConfigurationManifest"
          dedicated.v0: "#/components/schemas/DedicatedConfigurationManifest"
          serverless.v1: "#/components/schemas/ServerlessV1ConfigurationManifest"
      required:
        - id
        - kind
        - control_plane_id
        - control_plane_geo
      title: Base Configuration
    ServerlessDataPlaneGroupConfig:
      description: Object that describes where serverless gateways will be deployed
        to, along with how many instances.
      type: array
      items:
        $ref: "#/components/schemas/ServerlessDataPlaneGroupConfigItem"
      title: Serverless Data-Plane Groups Configuration
    ServerlessDataPlaneGroup:
      description: Object that describes a serverless data-plane group, deployed for a
        control-plane.
      type: object
      properties:
        id:
          description: ID of the data-plane group that represents the deployment target.
          type: string
          format: uuid
          example: 14a74117-868a-4859-bf6c-eb2fe301a6ab
        region:
          description: Serverless region the gateway will be deployed to.
          type: string
          example: us
        state:
          description: State of the data-plane group.
          type: string
          enum:
            - created
            - initializing
            - ready
            - terminating
            - terminated
        state_metadata:
          description: >
            Metadata describing the backing state of the dataplane group and why
            it may be in an erroneous state.
          type: object
          additionalProperties: false
          properties:
            reported_status:
              description: Reported status of the dataplane group from backing infrastructure.
              type: string
              example: ERROR
            reason:
              description: >
                Reason why the dataplane group may be in an erroneous state,
                reported from backing infrastructure.
              type: string
              example: >
                Dataplane group could not be deployed due to insufficient cloud
                provider compute instances.
        hostnames:
          description: List of hostnames for proxying to the serverless data-plane group.
          type: array
          items:
            type: string
        created_at:
          description: An ISO-8604 timestamp representation of data-plane group creation
            date.
          type: string
          format: date-time
          example: 2022-11-04T20:10:06.927Z
          readOnly: true
        updated_at:
          description: An ISO-8604 timestamp representation of data-plane group update date.
          type: string
          format: date-time
          example: 2022-11-04T20:10:06.927Z
          readOnly: true
      required:
        - id
        - region
        - state
        - created_at
        - updated_at
      title: Serverless Data-Plane Group
    ControlPlaneGeo:
      description: Set of control-plane geos supported for deploying cloud-gateways
        configurations.
      type: string
      enum:
        - us
        - eu
        - au
        - me
        - in
        - sg
      title: Control-Plane Geo
    ServerlessDataPlaneGroupConfigItem:
      description: >
        Object that describes where a serverless data-plane group will be
        deployed to.
      type: object
      properties:
        region:
          description: Region of cloud provider the cloud gateways will be deployed to.
          type: string
          example: us
      additionalProperties: false
      required:
        - region
      title: Serverless Data-Plane Group Configuration
    ServerlessConfigurationManifest:
      type: object
      allOf:
        - $ref: "#/components/schemas/BaseConfigurationManifest"
        - properties:
            kind:
              type: string
              enum:
                - serverless.v0
            dataplane_group_config:
              $ref: "#/components/schemas/ServerlessDataPlaneGroupConfig"
            dataplane_groups:
              description: List of data-plane groups describe where serverless gateways are
                deployed to, along with how many instances.
              type: array
              items:
                $ref: "#/components/schemas/ServerlessDataPlaneGroup"
            entity_version:
              description: Positive, monotonically increasing version integer, to serialize
                configuration changes.
              type: number
              example: 1
              readOnly: true
            created_at:
              description: An ISO-8604 timestamp representation of configuration creation
                date.
              type: string
              format: date-time
              example: 2022-11-04T20:10:06.927Z
              readOnly: true
            updated_at:
              description: An ISO-8604 timestamp representation of configuration update date.
              type: string
              format: date-time
              example: 2022-11-04T20:10:06.927Z
              readOnly: true
          required:
            - id
            - kind
            - dataplane_group_config
            - dataplane_groups
            - entity_version
            - created_at
            - updated_at
      title: Serverless Configuration
```
