Services

​

Service

class Service(*, port: int, name: str | None = None, protocol: ServiceProtocol | str | None = None, visibility: ServiceVisibility | str | None = None, endpoint: Endpoint | dict[str, Any] | None = None)

• name (str | None) : Optional service name.
• protocol (ServiceProtocol | str | None) : L4 protocol (defaults to TCP when unset). Must be unset or TCP when endpoint is set.
• visibility (ServiceVisibility | str | None) : Who may reach this port (PUBLIC/PRIVATE/CUSTOM). CUSTOM means the fleet assigns reachability; service_urls stays empty unless the API reports a URL. The service still appears in exposed_ports. Must be PUBLIC when endpoint is set.
• endpoint (Endpoint | dict[str, Any] | None) : Optional product endpoint. HTTPS/OPEN (optional request_timeout_seconds) or TLS_PASSTHROUGH (auth and timeout unset). Omit for a plain TCP/UDP port.

​

ServiceProtocol

class ServiceProtocol

• UNSPECIFIED = 'unspecified'
• TCP = 'tcp'
• UDP = 'udp'
• SCTP = 'sctp'

​

ServiceVisibility

class ServiceVisibility

• UNSPECIFIED = 'unspecified'
• PUBLIC = 'public'
• PRIVATE = 'private'
• CUSTOM = 'custom'