Ingress

Explain how one hostname reaches visitors.

Changed on

Works for any hostname, served or not: the tunnels that could carry it (candidates), the one that does, and why.

get/ingress/hostnames/{hostname}

Request

  • Base URL: /api (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /api/ingress/hostnames/{hostname}
  • Auth: HTTP bearer

Path parameters

hostnamestring required

Response

chosen_connector_idinteger nullable

The tunnel chosen for it, with mode tunnel.

connector_idinteger nullable

The tunnel that publishes it, or would once detail is dealt with.

connector_namestring nullable
detailstring required

What is happening; when it is not published, why and what to do.

hostnamestring required
mode'automatic' | 'tunnel' | 'off' required

How one hostname reaches visitors, as the operator chose it (ADR 058 D9).

published_atstring date-time nullable
served_by_workersboolean required

Whether workers serve it. A tunnel only publishes those.

statestring required

published, pending, error or not_published.

Changes