service_domains

Creates, updates, deletes, gets or lists a service_domains resource.

Overview

Name	service_domains
Type	Resource
Id	railway.networking.service_domains

Fields

The following fields are returned by SELECT queries:

list

One row per ServiceDomain.

Name	Datatype	Description
id	string
edge_id	string
environment_id	string
project_id	string
service_id	string
new_domain_name	string
created_at	string (date-time)
deleted_at	string (date-time)
domain	string
new_host_label	string
suffix	string
sync_status	string	(ACTIVE, CREATING, DELETED, DELETING, UNSPECIFIED, UPDATING)
target_port	integer
updated_at	string (date-time)

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
list	select	environment_id, project_id, service_id		Lists ServiceDomain objects of a AllDomains. Backed by the Railway GraphQL query domains.serviceDomains.
create	insert	environment_id, service_id		Creates a new service domain. Backed by the Railway GraphQL mutation serviceDomainCreate.
update	update	domain, environment_id, service_domain_id, service_id		Updates a service domain. Backed by the Railway GraphQL mutation serviceDomainUpdate.
delete	delete	id		Deletes a service domain. Backed by the Railway GraphQL mutation serviceDomainDelete.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
environment_id	string
project_id	string
service_id	string
domain	string
id	string
service_domain_id	string

SELECT examples

list

Lists ServiceDomain objects of a AllDomains. Backed by the Railway GraphQL query domains.serviceDomains.

SELECT
id,
edge_id,
environment_id,
project_id,
service_id,
new_domain_name,
created_at,
deleted_at,
domain,
new_host_label,
suffix,
sync_status,
target_port,
updated_at
FROM railway.networking.service_domains
WHERE environment_id = '{{ environment_id }}' -- required
AND project_id = '{{ project_id }}' -- required
AND service_id = '{{ service_id }}' -- required
;

INSERT examples

create

Creates a new service domain. Backed by the Railway GraphQL mutation serviceDomainCreate.

INSERT INTO railway.networking.service_domains (
environment_id,
service_id,
target_port
)
SELECT 
'{{ environment_id }}' /* required */,
'{{ service_id }}' /* required */,
{{ target_port }}
RETURNING
id,
edge_id,
environment_id,
project_id,
service_id,
new_domain_name,
created_at,
deleted_at,
domain,
new_host_label,
suffix,
sync_status,
target_port,
updated_at
;

Manifest

# Description fields are for documentation purposes
- name: service_domains
props:
  - name: environment_id
    value: "{{ environment_id }}"
  - name: service_id
    value: "{{ service_id }}"
  - name: target_port
    value: {{ target_port }}

UPDATE examples

update

Updates a service domain. Backed by the Railway GraphQL mutation serviceDomainUpdate.

UPDATE railway.networking.service_domains
SET 
target_port = '{{ target_port }}'
WHERE 
domain = '{{ domain }}' --required
AND environment_id = '{{ environment_id }}' --required
AND service_domain_id = '{{ service_domain_id }}' --required
AND service_id = '{{ service_id }}' --required
RETURNING
result;

DELETE examples

delete

Deletes a service domain. Backed by the Railway GraphQL mutation serviceDomainDelete.

DELETE FROM railway.networking.service_domains
WHERE 
id = '{{ id }}' --required
;