Skip to content
ClickHouse Docs
ClickHouse DocsClickHouse Docs

Get replica aware routing

GET/v1/organizations/{organizationId}/services/{serviceId}/replicaAwareRouting
API playground

This endpoint is in beta. API contract is stable, and no breaking changes are expected in the future.

Returns whether replica aware routing (sticky routing) is enabled for HTTP and native connections on the service.

Permission

The API key must have the control-plane:service:view permission.

Authorizations

Path parameters

  • organizationIdstringrequired

    ID of the organization that owns the service.

    format: uuid
  • serviceIdstringrequired

    ID of the service.

    format: uuid

Response

JSON

200

Successful response

JSON
  • statusoptionalnumber

    HTTP status code.

    Example: 200
  • requestIdoptionalstring

    Unique id assigned to every request. UUIDv4

    format: uuid
  • resultoptionalobject
    2 properties
    • httpEnabledbooleanrequired

      Whether replica aware routing is enabled for HTTP connections. When enabled, clients must send the X-ClickHouse-Replica-Tag header. Enabling this changes HTTP connection behavior for the service.

    • nativeEnabledbooleanrequired

      Whether replica aware routing is enabled for native protocol connections.