Cloud account connections, CloudFormation template management, and resource discovery.
/infra/connectionsList cloud accounts
Returns a paginated list of cloud accounts configured for the organization.
Parameters
limitinteger
The maximum number of items to list.
"int32"0100100markerstring
The pagination token returned from the previous list operation.
Responses
Responses
List of External connections.
/infra/connectionsCreate a cloud account
Creates a new cloud account and returns the CloudFormation template information needed for deployment.
Request Body
Responses
Responses
External connection created successfully.
/infra/connections/{connection}Describe a cloud account
Returns the details of a cloud account, including its provider, region, deployment status, and associated resources.
Responses
Responses
External connection details.
/infra/connections/{connection}Delete a cloud account
Permanently removes a cloud account. While the account is still reachable, associated clusters and networks must be destroyed and deleted first, and catalog records deleted; a catalog's Glue database may stay, so destroying a catalog first is only needed if its data should be removed too. Once the account can no longer be reached, deletion removes the records without teardown. A connection whose verification is failing sits between those states: teardown through Lakesail is likely to fail too, so passing force asserts that access will not be restored and removes the records the same way an unreachable account's deletion does. Deleting a connection never removes a catalog's Glue database; only an explicit destroy on the catalog itself does, and even that deletes the Glue metadata only, never the data objects in the retained workspace S3 bucket. Databases whose records went with an unreachable account stay in the customer's account until removed there manually.
Parameters
forceboolean
Delete the connection even though child records still exist, tombstoning them without teardown. Only meaningful while the connection status is failed, which records that the account's last verification or operation failed; the role may or may not still work, so the flag is the caller's assertion that access will not be restored. While the account is reachable, the flag is refused and children must still be destroyed and deleted leaf-first. From the failed state, the forced delete is additionally refused while workloads or job runs still run on the account's clusters. On an account that is already unreachable (disconnected or deleted) the flag is redundant and accepted, and deletion behaves exactly as it would without it. Anything provisioned, including catalog Glue databases, stays in the AWS account until removed there manually.
falseResponses
Responses
The requested operation was done successfully.
/infra/connections/{connection}Update a cloud account
Modifies a cloud account's metadata such as its name.
Request Body
Responses
Responses
Updated external connection.
/infra/connections/{connection}/instance-typesList available cloud instance types
Returns EC2 instance types available in the cloud provider account for the specified connection. Supports filtering by region, architecture, CPU, and memory.
Parameters
regionstring
AWS region to list instance types for. If not provided, defaults to the connection's configured region.
limitinteger
The maximum number of items to list.
"int32"0100100architecturestring
Filter by architecture (x86_64 or arm64)
"x86_64""arm64"minVCpusinteger
Minimum number of vCPUs
1minMemoryMiBinteger
Minimum memory in MiB
1024Responses
Responses
List of available instance types for the cloud provider.
/infra/connections/{connection}/regionsList available cloud provider regions
Returns the cloud provider regions available for provisioning external clusters and networks.
Responses
Responses
List of available cloud provider regions
/infra/connections/{connection}/sync-templateSync cloud account IaC template
Updates the CloudFormation stack for this connection with the latest template. The update runs asynchronously. Only available for active connections with a deployed stack.
Responses
Responses
Template sync operation initiated.
/infra/connections/{connection}/templateGet connection template
Returns the CloudFormation template URL and parameters needed to deploy the connection stack in the cloud account.
Responses
Responses
CloudFormation template information.
/infra/connections/{connection}/template/downloadDownload connection template
Downloads the CloudFormation template file with parameter defaults pre-filled, ready for upload to the AWS CloudFormation console. Use Get connection template for the URL and raw parameters instead.
Responses
Responses
CloudFormation template with defaults injected.
/infra/connections/{connection}/verifyVerify a cloud account
Validates that the cloud account is correctly configured. Call this after deploying the CloudFormation template.
Request Body
Responses
Responses
External connection verification result.