Provision a Serverless Gateway

1. From Gateway Manager, click the New Gateway button and select Serverless.

2. Enter a name, optionally a description or label, for your serverless gateway and click Create.

Your serverless gateway is now provisioned with the data plane attached. You can use it like you would any other Kong Gateway in Konnect.

The URL where your serverless gateway can be accessed is shown in the Overview section of the Control Plane page.

The Konnect API uses Personal Access Token (PAT) authentication. You can obtain your PAT from the personal access token page. The PAT must be passed in the Authorization header of all requests.

1. Create a serverless gateway control plane using the /control-planes endpoint:

    curl --request POST \
    --url https://{region}.api.konghq.com/v2/control-planes \
    --header 'Authorization: Bearer <personal-access-token>' \
    --header 'Content-Type: application/json' \
    --data '{
        "name": "serverless-gateway-control-plane",
        "description": "A test control plane for Serverless Gateways.",
        "cluster_type": "CLUSTER_TYPE_SERVERLESS",
        "cloud_gateway": false,
        "auth_type": "pinned_client_certs"
    }'
   

   Replace the PAT as well as the following placeholders with your own values:

   • name: The name that you want to display for the serverless gateway control plane.
   • description: Description of the serverless gateway control plane.

   You should get a 201 response like the following:

    {
        "id": "23be21c0-5984-4698-aa1f-ac258d77f0d1",
        "name": "serverless-gateway-control-plane",
        "description": "A test control plane for Serverless Gateways.",
        "labels": {},
        "config": {
            "control_plane_endpoint": "https://52ec253413.cp0.konghq.tech",
            "telemetry_endpoint": "https://52ec253413.tp0.konghq.tech",
            "cluster_type": "CLUSTER_TYPE_SERVERLESS",
            "auth_type": "pinned_client_certs",
            "cloud_gateway": false,
            "proxy_urls": []
        },
        "created_at": "2024-10-15T21:25:29.376Z",
        "updated_at": "2024-10-15T21:25:29.376Z"
    }
   

   Save the control plane id to use in the next step.

2. Create a Dedicated Cloud Gateway data plane using the /cloud-gateways/configurations endpoint:

    curl --request PUT \
    --url https://global.api.konghq.com/v3/cloud-gateways/configurations \
    --header 'Authorization: Bearer <personal-access-token>' \
    --header 'Content-Type: application/json' \
    --data '{
        "control_plane_id": "23be21c0-5984-4698-aa1f-ac258d77f0d1",
        "control_plane_geo": "us",
        "dataplane_groups": [
            {
                "region": "na"
            }
        ],
        "kind": "serverless.v0"
    }'
   

   Replace the PAT as well as the following placeholders with your own values:

   • control_plane_id: The ID of the control plane you created in the previous step.
   • control_plane_geo: The geo of the control plane.
   • region: The region you want to deploy the data plane in.

   Note: The Serverless Gateway data plane can only be provisioned in the na, eu, or au regions. However your data plane and control plane regions can be different (e.g. it’s possible to attach an eu data plane to an me control plane.)

   You should get a 201 response which means your serverless gateway is now provisoned. You can use it like you would any other Kong Gateway in Konnect.