Open a session
A session reaches the database from anywhere, without entering its VPC: open url as a WebSocket within 30 seconds, offering the subprotocols ezgh.databases.tunnel.v1 (or ezgh.databases.query.v1 for kind query) and ticket.. The ticket works once. Sessions don't pass the database's allowed sources; the engine still checks its own user and password. An Idempotency-Key replay answers the same session with ticket null. 409 database_not_available while the database is being created or deleted, or has failed, 409 sessions_unavailable before its next maintenance update, 429 quota_exceeded with Retry-After at 20 open sessions.
https://databases-api.ezghcloud.com/v1/organizations/{orgId}/projects/{projectId}/databases/{database}/sessionsAuthorization
Path parameters
Header parameters
Request bodyJSONrequired
Returns
201
The session, and its one-time ticket.
400
invalid_request (with issues), invalid_cursor, or the endpoint's own 400 codes.
403
access_denied: the caller's policies don't allow the action; forbidden_origin: a cookie-authenticated write from an origin that isn't allowed; spend_limit_reached.
404
not_found: unknown, malformed, or in an organization the caller isn't in.
409
quota_exceeded (an allocation quota, with quota), idempotency_conflict, idempotency_in_progress (with Retry-After), organization_deletion_pending, operation_in_progress, or the endpoint's own 409 codes.
413
payload_too_large: the body is over the endpoint's limit (1 MiB unless it says otherwise).
429
too_many_requests, with Retry-After; or quota_exceeded (a rate, usage or concurrency quota, with quota), never with Retry-After.
500
internal_error: a bug; the details are in the logs, under the request ID.