Ingresses

List ingresses

client.Ingresses.List(ctx) (*[]Ingress, error)

get/ingresses

Create ingress

client.Ingresses.New(ctx, body) (*Ingress, error)

post/ingresses

Get ingress details

client.Ingresses.Get(ctx, id) (*Ingress, error)

get/ingresses/{id}

Delete ingress

client.Ingresses.Delete(ctx, id) error

delete/ingresses/{id}

ModelsExpand Collapse

type Ingress struct{…}

ID string

Auto-generated unique identifier

CreatedAt Time

Creation timestamp (RFC3339)

formatdate-time

Name string

Human-readable name

Rules []IngressRule

Routing rules for this ingress

Match IngressMatch

Hostname string

Hostname to match. Can be:

Literal: "api.example.com" (exact match on Host header)
Pattern: "{instance}.example.com" (dynamic routing based on subdomain)

Pattern hostnames use named captures in curly braces (e.g., {instance}, {app}) that extract parts of the hostname for routing. The extracted values can be referenced in the target.instance field.

Port int64optional

Host port to listen on for this rule (default 80)

Target IngressTarget

Instance string

Target instance name, ID, or capture reference.

For literal hostnames: Use the instance name or ID directly (e.g., "my-api")
For pattern hostnames: Reference a capture from the hostname (e.g., "{instance}")

When using pattern hostnames, the instance is resolved dynamically at request time.

Port int64

Target port on the instance

RedirectHTTP booloptional

Auto-create HTTP to HTTPS redirect for this hostname (only applies when tls is enabled)

Tls booloptional

Enable TLS termination (certificate auto-issued via ACME).

type IngressMatch struct{…}

Hostname string

Hostname to match. Can be:

Literal: "api.example.com" (exact match on Host header)
Pattern: "{instance}.example.com" (dynamic routing based on subdomain)

Pattern hostnames use named captures in curly braces (e.g., {instance}, {app}) that extract parts of the hostname for routing. The extracted values can be referenced in the target.instance field.

Port int64optional

Host port to listen on for this rule (default 80)

type IngressRule struct{…}

Match IngressMatch

Hostname string

Hostname to match. Can be:

Literal: "api.example.com" (exact match on Host header)
Pattern: "{instance}.example.com" (dynamic routing based on subdomain)

Pattern hostnames use named captures in curly braces (e.g., {instance}, {app}) that extract parts of the hostname for routing. The extracted values can be referenced in the target.instance field.

Port int64optional

Host port to listen on for this rule (default 80)

Target IngressTarget

Instance string

Target instance name, ID, or capture reference.

For literal hostnames: Use the instance name or ID directly (e.g., "my-api")
For pattern hostnames: Reference a capture from the hostname (e.g., "{instance}")

When using pattern hostnames, the instance is resolved dynamically at request time.

Port int64

Target port on the instance

RedirectHTTP booloptional

Auto-create HTTP to HTTPS redirect for this hostname (only applies when tls is enabled)

Tls booloptional

Enable TLS termination (certificate auto-issued via ACME).

type IngressTarget struct{…}

Instance string

Target instance name, ID, or capture reference.

For literal hostnames: Use the instance name or ID directly (e.g., "my-api")
For pattern hostnames: Reference a capture from the hostname (e.g., "{instance}")

When using pattern hostnames, the instance is resolved dynamically at request time.

Port int64

Target port on the instance