Skip to main content

Endpoint Services

VeloDB Cloud publishes regional endpoint services for platform features that need to communicate with a warehouse but do not connect directly to the warehouse backend service. Clients can create a private endpoint in the same region and use private DNS to reach supported VeloDB Cloud hostnames.

The following access paths currently use these endpoint services:

Access pathPurposeHostname format
Warehouse-specific Console endpointCarries data-plane requests from the frontend Console UI to a specific warehouse.<warehouse-id>-studio.<region>.<provider>.velodb.cloud
Metrics APIExposes regional warehouse metrics for monitoring systems.apps-api.<region>.<provider>.velodb.cloud

This service model applies to supported SaaS and BYOC use cases. It is separate from direct warehouse connectivity. A SaaS warehouse has its own backend Endpoint Service, while applications connect to a BYOC warehouse through the network in the customer's cloud environment.

Private Connectivity

For each supported region, VeloDB Cloud publishes an endpoint service through the cloud provider's private connectivity technology. You create a private endpoint in the same region and connect it to the published service.

Cloud providerPrivate connectivity technologyVeloDB publication identifier
AWSAWS PrivateLinkEndpoint Service name
Google CloudPrivate Service ConnectService attachment URI
AzureAzure Private LinkPrivate Link Service resource ID

A private endpoint can serve multiple supported VeloDB hostnames in its region. The endpoint does not replace those hostnames. Configure private DNS to resolve each required hostname to the endpoint, and continue to use the original hostname so that TLS validation and request routing work correctly.

The private endpoint and the published endpoint service must be in the same cloud region. Create an endpoint in each region from which clients need private access to supported VeloDB Cloud services.

Warning:

A private DNS zone is authoritative for its entire suffix in the networks associated with it. DNS does not fall back to the public zone when a hostname has no matching private record. Add records for every VeloDB hostname under the zone that clients must reach. Otherwise, those hostnames can return NXDOMAIN. If you do not need to cover the entire provider suffix, use a narrower regional zone where your cloud provider supports one.

Service Endpoint References

Choose your cloud provider to find the supported regions, the service identifier published in each region, and instructions for creating the private endpoint and configuring DNS.

Cloud providerService endpoint reference
AWSAWS Endpoint Services
Google CloudGoogle Cloud Endpoint Services
AzureAzure Endpoint Services