Cloud network provisioning and lifecycle management.
GET
/infra/connections/{connection}/provider-networksList available cloud provider networks
Returns VPCs and subnets available in the cloud provider account for the specified connection and region.
Parameters
regionstring
region
AWS region to list networks for. If not provided, defaults to the connection's configured region.
Type
string
Responses
Responses
List of available networks
application/json
JSON "items": [ { "provider": "string", "vpcId": "vpc-0123456789abcdef0", "cidr": "10.0.0.0/16", "name": "Production VPC", "azCount": 3, "state": "available", "tags": { "additionalProperties": "string" } } ]
{
}
GET
/infra/networksList cloud networks
Returns all managed networks created through the API across all connections, supporting marker-based pagination.
Parameters
limitinteger
limit
The maximum number of items to list.
Type
integer
Format
"int32"Minimum
0Maximum
100Default
100markerstring
marker
The pagination token returned from the previous list operation.
Type
string
Responses
Responses
List of managed external networks
application/json
JSON "items": [ { "id": "A1B2C3D4E5", "connectionId": "A1B2C3D4E5", "name": "Production Cluster", "region": "us-east-1", "providerNetworkId": "vpc-0a1b2c3d4e5f6g7h8", "config": { "cidr": "10.0.0.0/16" }, "iacState": { "projectName": "lakesail-byoc-cluster", "stackName": "lakesail-prod-cluster-abc123" }, "iacOutputs": { "additionalProperties": "string" }, "status": "string", "statusMessage": "string", "createdAt": "string", "createdBy": "A1B2C3D4E5", "updatedAt": "string", "updatedBy": "A1B2C3D4E5" } ], "included": { "networks": [ { "id": "A1B2C3D4E5", "connectionId": "A1B2C3D4E5", "name": "Production Cluster", "region": "us-east-1", "providerNetworkId": "vpc-0a1b2c3d4e5f6g7h8", "config": { "cidr": "10.0.0.0/16" }, "iacState": { "projectName": "lakesail-byoc-cluster", "stackName": "lakesail-prod-cluster-abc123" }, "iacOutputs": { "additionalProperties": "string" }, "status": "string", "statusMessage": "string", "createdAt": "string", "createdBy": "A1B2C3D4E5", "updatedAt": "string", "updatedBy": "A1B2C3D4E5" } ], "connections": [ { "id": "A1B2C3D4E5", "name": "Production Cluster", "provider": "string", "providerConfig": { "accountId": "123456789012", "region": "us-east-1", "roleArn": "arn:aws:iam::123456789012:role/LakeSailConnection", "externalIdSecretArn": "arn:aws:secretsmanager:us-east-1:123456789012:secret:lakesail-ext-id", "stackArn": "arn:aws:cloudformation:us-east-1:123456789012:stack/lakesail-connection/abc123" }, "status": "active", "statusMessage": "string", "lastUsedAt": "string", "templateSyncedAt": "string", "templateSyncMessage": "string", "createdAt": "string", "createdBy": "A1B2C3D4E5", "updatedAt": "string", "updatedBy": "A1B2C3D4E5" } ], "clusters": [ { "id": "A1B2C3D4E5", "connectionId": "A1B2C3D4E5", "networkId": "A1B2C3D4E5", "clusterId": "A1B2C3D4E5", "name": "Production Cluster", "region": "us-east-1", "status": "string", "statusMessage": "string", "config": { "kubernetesVersion": "1.35", "systemNodeGroup": { "name": "system", "instanceTypes": [ [ "m7g.large", "m7g.xlarge" ] ], "minSize": 1, "maxSize": 3, "desiredSize": 2, "diskSizeGb": 100 }, "publicAccessCidrs": [ "string" ] }, "providerMetadata": { "clusterName": "string", "clusterArn": "string" }, "iacState": { "projectName": "lakesail-byoc-cluster", "stackName": "lakesail-prod-cluster-abc123" }, "iacOutputs": { "additionalProperties": "string" }, "jobRunnerRoleArn": "arn:aws:iam::123456789012:role/lakesail-conn1234-clus5678-jr", "createdAt": "string", "createdBy": "A1B2C3D4E5", "updatedAt": "string", "updatedBy": "A1B2C3D4E5", "lastHealthStatus": "string", "lastHealthMessage": "string", "lastHealthCheckAt": "string" } ], "operations": [ { "id": "A1B2C3D4E5", "organizationId": "A1B2C3D4E5", "memberId": "A1B2C3D4E5", "operation": "string", "status": "string", "result": { "items": [ { "provider": "string", "instanceType": "string", "vCpus": 0, "memoryMiB": 0, "architecture": "string", "gpuCount": 0, "instanceFamily": "string", "maxPods": 0, "group": "string", "allocatableMilliCpu": 0 } ], "metadata": { "provider": "string", "systemPodsPerNode": 0, "systemPodsPerSystemNode": 0, "systemPodsFixed": 0, "systemPodsPerNodeMargin": 0, "systemPodsFixedMargin": 0, "systemMilliCPUPerNode": 0, "systemMilliCPUFixed": 0, "karpenterMilliCPUPerReplica": 0, "karpenterReplicas": 0 } }, "error": { "code": "string", "message": "string", "errorType": "string", "details": { "retryable": true, "retryAfter": 0, "fieldErrors": { "additionalProperties": "string" }, "requestId": "string", "causedBy": "string" } }, "progress": { "stage": "string", "message": "string", "resources": [ { "urn": "string", "type": "string", "name": "string", "operation": "string", "status": "string", "duration": 0 } ], "summary": { "total": 0, "pending": 0, "running": 0, "succeeded": 0, "failed": 0, "unchanged": 0 } }, "resourceType": "string", "resourceId": "A1B2C3D4E5", "createdAt": "string", "updatedAt": "string", "startedAt": "string", "completedAt": "string" } ] }, "marker": "string"
{
}
DELETE
/infra/networks/{network}Delete a cloud network record
Permanently deletes a cloud network record. The network's infrastructure must
first be destroyed before the record can be deleted. A network in a failed state
may still have active infrastructure and should be destroyed first.
Responses
Responses
The requested operation was done successfully.
GET
/infra/connections/{connection}/networksList cloud networks by connection
Returns the managed networks provisioned through the specified connection.
Parameters
limitinteger
limit
The maximum number of items to list.
Type
integer
Format
"int32"Minimum
0Maximum
100Default
100markerstring
marker
The pagination token returned from the previous list operation.
Type
string
Responses
Responses
List of managed external networks
application/json
JSON "items": [ { "id": "A1B2C3D4E5", "connectionId": "A1B2C3D4E5", "name": "Production Cluster", "region": "us-east-1", "providerNetworkId": "vpc-0a1b2c3d4e5f6g7h8", "config": { "cidr": "10.0.0.0/16" }, "iacState": { "projectName": "lakesail-byoc-cluster", "stackName": "lakesail-prod-cluster-abc123" }, "iacOutputs": { "additionalProperties": "string" }, "status": "string", "statusMessage": "string", "createdAt": "string", "createdBy": "A1B2C3D4E5", "updatedAt": "string", "updatedBy": "A1B2C3D4E5" } ], "included": { "networks": [ { "id": "A1B2C3D4E5", "connectionId": "A1B2C3D4E5", "name": "Production Cluster", "region": "us-east-1", "providerNetworkId": "vpc-0a1b2c3d4e5f6g7h8", "config": { "cidr": "10.0.0.0/16" }, "iacState": { "projectName": "lakesail-byoc-cluster", "stackName": "lakesail-prod-cluster-abc123" }, "iacOutputs": { "additionalProperties": "string" }, "status": "string", "statusMessage": "string", "createdAt": "string", "createdBy": "A1B2C3D4E5", "updatedAt": "string", "updatedBy": "A1B2C3D4E5" } ], "connections": [ { "id": "A1B2C3D4E5", "name": "Production Cluster", "provider": "string", "providerConfig": { "accountId": "123456789012", "region": "us-east-1", "roleArn": "arn:aws:iam::123456789012:role/LakeSailConnection", "externalIdSecretArn": "arn:aws:secretsmanager:us-east-1:123456789012:secret:lakesail-ext-id", "stackArn": "arn:aws:cloudformation:us-east-1:123456789012:stack/lakesail-connection/abc123" }, "status": "active", "statusMessage": "string", "lastUsedAt": "string", "templateSyncedAt": "string", "templateSyncMessage": "string", "createdAt": "string", "createdBy": "A1B2C3D4E5", "updatedAt": "string", "updatedBy": "A1B2C3D4E5" } ], "clusters": [ { "id": "A1B2C3D4E5", "connectionId": "A1B2C3D4E5", "networkId": "A1B2C3D4E5", "clusterId": "A1B2C3D4E5", "name": "Production Cluster", "region": "us-east-1", "status": "string", "statusMessage": "string", "config": { "kubernetesVersion": "1.35", "systemNodeGroup": { "name": "system", "instanceTypes": [ [ "m7g.large", "m7g.xlarge" ] ], "minSize": 1, "maxSize": 3, "desiredSize": 2, "diskSizeGb": 100 }, "publicAccessCidrs": [ "string" ] }, "providerMetadata": { "clusterName": "string", "clusterArn": "string" }, "iacState": { "projectName": "lakesail-byoc-cluster", "stackName": "lakesail-prod-cluster-abc123" }, "iacOutputs": { "additionalProperties": "string" }, "jobRunnerRoleArn": "arn:aws:iam::123456789012:role/lakesail-conn1234-clus5678-jr", "createdAt": "string", "createdBy": "A1B2C3D4E5", "updatedAt": "string", "updatedBy": "A1B2C3D4E5", "lastHealthStatus": "string", "lastHealthMessage": "string", "lastHealthCheckAt": "string" } ], "operations": [ { "id": "A1B2C3D4E5", "organizationId": "A1B2C3D4E5", "memberId": "A1B2C3D4E5", "operation": "string", "status": "string", "result": { "items": [ { "provider": "string", "instanceType": "string", "vCpus": 0, "memoryMiB": 0, "architecture": "string", "gpuCount": 0, "instanceFamily": "string", "maxPods": 0, "group": "string", "allocatableMilliCpu": 0 } ], "metadata": { "provider": "string", "systemPodsPerNode": 0, "systemPodsPerSystemNode": 0, "systemPodsFixed": 0, "systemPodsPerNodeMargin": 0, "systemPodsFixedMargin": 0, "systemMilliCPUPerNode": 0, "systemMilliCPUFixed": 0, "karpenterMilliCPUPerReplica": 0, "karpenterReplicas": 0 } }, "error": { "code": "string", "message": "string", "errorType": "string", "details": { "retryable": true, "retryAfter": 0, "fieldErrors": { "additionalProperties": "string" }, "requestId": "string", "causedBy": "string" } }, "progress": { "stage": "string", "message": "string", "resources": [ { "urn": "string", "type": "string", "name": "string", "operation": "string", "status": "string", "duration": 0 } ], "summary": { "total": 0, "pending": 0, "running": 0, "succeeded": 0, "failed": 0, "unchanged": 0 } }, "resourceType": "string", "resourceId": "A1B2C3D4E5", "createdAt": "string", "updatedAt": "string", "startedAt": "string", "completedAt": "string" } ] }, "marker": "string"
{
}
POST
/infra/connections/{connection}/networksCreate a cloud network
Creates a new network in the customer's cloud account via the specified connection. Requires an active connection.
Request Body
application/json
JSON "connectionId": "A1B2C3D4E5", "name": "Production Cluster", "region": "us-east-1", "config": { "cidr": "10.0.0.0/16" }
{
}
Responses
Responses
Managed external network created successfully.
application/json
JSON "id": "A1B2C3D4E5", "connectionId": "A1B2C3D4E5", "name": "Production Cluster", "region": "us-east-1", "providerNetworkId": "vpc-0a1b2c3d4e5f6g7h8", "config": { "cidr": "10.0.0.0/16" }, "iacState": { "projectName": "lakesail-byoc-cluster", "stackName": "lakesail-prod-cluster-abc123" }, "iacOutputs": { "additionalProperties": "string" }, "status": "string", "statusMessage": "string", "createdAt": "string", "createdBy": "A1B2C3D4E5", "updatedAt": "string", "updatedBy": "A1B2C3D4E5"
{
}
GET
/infra/connections/{connection}/networks/{network}Describe a cloud network
Returns the details of a cloud network, including its VPC configuration, subnets, and provisioning status.
Responses
Responses
Managed external network details with connection information.
application/json
JSON "item": { "id": "A1B2C3D4E5", "connectionId": "A1B2C3D4E5" }, "included": { "networks": [ { "id": "A1B2C3D4E5", "connectionId": "A1B2C3D4E5", "name": "Production Cluster", "region": "us-east-1", "providerNetworkId": "vpc-0a1b2c3d4e5f6g7h8", "config": { "cidr": "10.0.0.0/16" }, "iacState": { "projectName": "lakesail-byoc-cluster", "stackName": "lakesail-prod-cluster-abc123" }, "iacOutputs": { "additionalProperties": "string" }, "status": "string", "statusMessage": "string", "createdAt": "string", "createdBy": "A1B2C3D4E5", "updatedAt": "string", "updatedBy": "A1B2C3D4E5" } ], "connections": [ { "id": "A1B2C3D4E5", "name": "Production Cluster", "provider": "string", "providerConfig": { "accountId": "123456789012", "region": "us-east-1", "roleArn": "arn:aws:iam::123456789012:role/LakeSailConnection", "externalIdSecretArn": "arn:aws:secretsmanager:us-east-1:123456789012:secret:lakesail-ext-id", "stackArn": "arn:aws:cloudformation:us-east-1:123456789012:stack/lakesail-connection/abc123" }, "status": "active", "statusMessage": "string", "lastUsedAt": "string", "templateSyncedAt": "string", "templateSyncMessage": "string", "createdAt": "string", "createdBy": "A1B2C3D4E5", "updatedAt": "string", "updatedBy": "A1B2C3D4E5" } ], "clusters": [ { "id": "A1B2C3D4E5", "connectionId": "A1B2C3D4E5", "networkId": "A1B2C3D4E5", "clusterId": "A1B2C3D4E5", "name": "Production Cluster", "region": "us-east-1", "status": "string", "statusMessage": "string", "config": { "kubernetesVersion": "1.35", "systemNodeGroup": { "name": "system", "instanceTypes": [ [ "m7g.large", "m7g.xlarge" ] ], "minSize": 1, "maxSize": 3, "desiredSize": 2, "diskSizeGb": 100 }, "publicAccessCidrs": [ "string" ] }, "providerMetadata": { "clusterName": "string", "clusterArn": "string" }, "iacState": { "projectName": "lakesail-byoc-cluster", "stackName": "lakesail-prod-cluster-abc123" }, "iacOutputs": { "additionalProperties": "string" }, "jobRunnerRoleArn": "arn:aws:iam::123456789012:role/lakesail-conn1234-clus5678-jr", "createdAt": "string", "createdBy": "A1B2C3D4E5", "updatedAt": "string", "updatedBy": "A1B2C3D4E5", "lastHealthStatus": "string", "lastHealthMessage": "string", "lastHealthCheckAt": "string" } ], "operations": [ { "id": "A1B2C3D4E5", "organizationId": "A1B2C3D4E5", "memberId": "A1B2C3D4E5", "operation": "string", "status": "string", "result": { "items": [ { "provider": "string", "instanceType": "string", "vCpus": 0, "memoryMiB": 0, "architecture": "string", "gpuCount": 0, "instanceFamily": "string", "maxPods": 0, "group": "string", "allocatableMilliCpu": 0 } ], "metadata": { "provider": "string", "systemPodsPerNode": 0, "systemPodsPerSystemNode": 0, "systemPodsFixed": 0, "systemPodsPerNodeMargin": 0, "systemPodsFixedMargin": 0, "systemMilliCPUPerNode": 0, "systemMilliCPUFixed": 0, "karpenterMilliCPUPerReplica": 0, "karpenterReplicas": 0 } }, "error": { "code": "string", "message": "string", "errorType": "string", "details": { "retryable": true, "retryAfter": 0, "fieldErrors": { "additionalProperties": "string" }, "requestId": "string", "causedBy": "string" } }, "progress": { "stage": "string", "message": "string", "resources": [ { "urn": "string", "type": "string", "name": "string", "operation": "string", "status": "string", "duration": 0 } ], "summary": { "total": 0, "pending": 0, "running": 0, "succeeded": 0, "failed": 0, "unchanged": 0 } }, "resourceType": "string", "resourceId": "A1B2C3D4E5", "createdAt": "string", "updatedAt": "string", "startedAt": "string", "completedAt": "string" } ] }
{
}
DELETE
/infra/connections/{connection}/networks/{network}Destroy a cloud network
Initiates destruction of an active cloud network and all associated networking resources. All clusters and catalogs in the network must be destroyed first. The network record is retained for reference. Returns an operation ID for tracking progress.
Responses
Responses
Destruction operation initiated.
application/json
JSON "id": "A1B2C3D4E5", "organizationId": "A1B2C3D4E5", "memberId": "A1B2C3D4E5", "operation": "string", "status": "string", "result": { "items": [ { "provider": "string", "instanceType": "string", "vCpus": 0, "memoryMiB": 0, "architecture": "string", "gpuCount": 0, "instanceFamily": "string", "maxPods": 0, "group": "string", "allocatableMilliCpu": 0 } ], "metadata": { "provider": "string", "systemPodsPerNode": 0, "systemPodsPerSystemNode": 0, "systemPodsFixed": 0, "systemPodsPerNodeMargin": 0, "systemPodsFixedMargin": 0, "systemMilliCPUPerNode": 0, "systemMilliCPUFixed": 0, "karpenterMilliCPUPerReplica": 0, "karpenterReplicas": 0 } }, "error": { "code": "string", "message": "string", "errorType": "string", "details": { "retryable": true, "retryAfter": 0, "fieldErrors": { "additionalProperties": "string" }, "requestId": "string", "causedBy": "string" } }, "progress": { "stage": "string", "message": "string", "resources": [ { "urn": "string", "type": "string", "name": "string", "operation": "string", "status": "string", "duration": 0 } ], "summary": { "total": 0, "pending": 0, "running": 0, "succeeded": 0, "failed": 0, "unchanged": 0 } }, "resourceType": "string", "resourceId": "A1B2C3D4E5", "createdAt": "string", "updatedAt": "string", "startedAt": "string", "completedAt": "string"
{
}
PATCH
/infra/connections/{connection}/networks/{network}Update a cloud network
Modifies a cloud network's metadata such as its name.
Request Body
application/json
JSON "name": "Production Cluster", "config": { "cidr": "10.0.0.0/16" }
{
}
Responses
Responses
Updated external network.
application/json
JSON "id": "A1B2C3D4E5", "connectionId": "A1B2C3D4E5", "name": "Production Cluster", "region": "us-east-1", "providerNetworkId": "vpc-0a1b2c3d4e5f6g7h8", "config": { "cidr": "10.0.0.0/16" }, "iacState": { "projectName": "lakesail-byoc-cluster", "stackName": "lakesail-prod-cluster-abc123" }, "iacOutputs": { "additionalProperties": "string" }, "status": "string", "statusMessage": "string", "createdAt": "string", "createdBy": "A1B2C3D4E5", "updatedAt": "string", "updatedBy": "A1B2C3D4E5"
{
}
POST
/infra/connections/{connection}/networks/{network}/provisionProvision a cloud network
Triggers provisioning of a cloud network in pending status. Returns an operation ID for progress tracking.
Responses
Responses
Provisioning operation initiated.
application/json
JSON "id": "A1B2C3D4E5", "organizationId": "A1B2C3D4E5", "memberId": "A1B2C3D4E5", "operation": "string", "status": "string", "result": { "items": [ { "provider": "string", "instanceType": "string", "vCpus": 0, "memoryMiB": 0, "architecture": "string", "gpuCount": 0, "instanceFamily": "string", "maxPods": 0, "group": "string", "allocatableMilliCpu": 0 } ], "metadata": { "provider": "string", "systemPodsPerNode": 0, "systemPodsPerSystemNode": 0, "systemPodsFixed": 0, "systemPodsPerNodeMargin": 0, "systemPodsFixedMargin": 0, "systemMilliCPUPerNode": 0, "systemMilliCPUFixed": 0, "karpenterMilliCPUPerReplica": 0, "karpenterReplicas": 0 } }, "error": { "code": "string", "message": "string", "errorType": "string", "details": { "retryable": true, "retryAfter": 0, "fieldErrors": { "additionalProperties": "string" }, "requestId": "string", "causedBy": "string" } }, "progress": { "stage": "string", "message": "string", "resources": [ { "urn": "string", "type": "string", "name": "string", "operation": "string", "status": "string", "duration": 0 } ], "summary": { "total": 0, "pending": 0, "running": 0, "succeeded": 0, "failed": 0, "unchanged": 0 } }, "resourceType": "string", "resourceId": "A1B2C3D4E5", "createdAt": "string", "updatedAt": "string", "startedAt": "string", "completedAt": "string"
{
}