Ingress

List hostnames tunnels publish or could publish, and why.

Changed on

For each: the tunnel carrying it, its state (published, pending, error, not_published) and, when not published, the reason and what to do.

get/ingress/hostnames

Request

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

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