Create a provider network

Provision a provider network with the scoping credential so the create wizard can offer an inline create-network flow. GKE creates an auto subnet-mode VPC (a subnetwork in every region, like the GCP default network) and waits for the compute operation to finish; other providers answer 400. The GCP service account needs the compute.networks.create permission (for example via the Compute Network Admin role, roles/compute.networkAdmin); a credential without it answers 400 with the provider’s permission message. The response is the created network in the options catalog’s private_networks shape.

POST /api/v1/clusters/managed/{provider}/networks

Create a provider network

Python

import requests

url = "https://platform.ankra.app/api/v1/clusters/managed/{provider}/networks"

payload = {
    "credential_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "name": "<string>"
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

200

{
  "id": "<string>",
  "name": "<string>",
  "provider_reference": "<string>",
  "region": "<string>",
  "is_default": false
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Headers

x-ankra-organisation-id · string

PAT organisation override.

Path Parameters

provider · enum<string> · required

Available options: doks, uks, gke, ovh_mks, aks, eks, kapsule

Example:

"kapsule"

Body

application/json

credential_id · string<uuid> · required

name · string · required

region · string | null

Response

200

application/json

Successful response

id · string · required

name · string · required

provider_reference · string · required

region · string · required

is_default · boolean · default: false