Skip to content
StratumStratum Docs

stratumctl dns

Manage DNS zones, health checks, latency targets

Terminal window
stratumctl dns [flags]

Subcommands

Section titled “Subcommands”

stratumctl dns health-checks

Section titled “stratumctl dns health-checks”

Manage DNS health checks

Terminal window
stratumctl dns health-checks [flags]

Aliases: health-check, hc

Subcommands

Section titled “Subcommands”

stratumctl dns health-checks create

Section titled “stratumctl dns health-checks create”

Create a DNS health check

Terminal window
stratumctl dns health-checks create <name> [flags]

Examples

Section titled “Examples”
Terminal window
stratumctl dns health-checks create web-hc --protocol https --address 10.0.1.10 --port 443 --path /healthz
stratumctl dns health-checks create db-hc --protocol tcp --address 10.0.2.5 --port 5432

Flags

Section titled “Flags”
Flag Type Default Description
--address string Target address (required)
--path string HTTP path to probe
--port int 0 Target port (required)
--project string Project ID (defaults to STRATUM_PROJECT or profile project_id)
--protocol string http | https | tcp (required)

stratumctl dns health-checks delete

Section titled “stratumctl dns health-checks delete”

Delete a DNS health check

Terminal window
stratumctl dns health-checks delete <health-check-id> [flags]

Examples

Section titled “Examples”
Terminal window
stratumctl dns health-checks delete 6

Flags

Section titled “Flags”
Flag Type Default Description
--project string Project ID (defaults to STRATUM_PROJECT or profile project_id)

stratumctl dns health-checks get

Section titled “stratumctl dns health-checks get”

Describe a DNS health check

Terminal window
stratumctl dns health-checks get <health-check-id> [flags]

Examples

Section titled “Examples”
Terminal window
stratumctl dns health-checks get 6
stratumctl dns health-checks get 6 --output json

Flags

Section titled “Flags”
Flag Type Default Description
--project string Project ID (defaults to STRATUM_PROJECT or profile project_id)

stratumctl dns health-checks list

Section titled “stratumctl dns health-checks list”

List DNS health checks in a project

Terminal window
stratumctl dns health-checks list [flags]

Examples

Section titled “Examples”
Terminal window
stratumctl dns health-checks list
stratumctl dns health-checks list --output json

Flags

Section titled “Flags”
Flag Type Default Description
--project string Project ID (defaults to STRATUM_PROJECT or profile project_id)

stratumctl dns latency-targets

Section titled “stratumctl dns latency-targets”

Manage DNS latency targets

Terminal window
stratumctl dns latency-targets [flags]

Aliases: latency-target, lt

Subcommands

Section titled “Subcommands”

stratumctl dns latency-targets create

Section titled “stratumctl dns latency-targets create”

Create a DNS latency target

Terminal window
stratumctl dns latency-targets create <name> [flags]

Examples

Section titled “Examples”
Terminal window
stratumctl dns latency-targets create eu-edge --probe-protocol https --address 203.0.113.10 --probe-path /ping
stratumctl dns latency-targets create us-edge --probe-protocol icmp --address 198.51.100.7

Flags

Section titled “Flags”
Flag Type Default Description
--address string Target address (required)
--probe-path string HTTP path to probe
--probe-protocol string http | https | tcp | icmp (required)
--project string Project ID (defaults to STRATUM_PROJECT or profile project_id)

stratumctl dns latency-targets delete

Section titled “stratumctl dns latency-targets delete”

Delete a DNS latency target

Terminal window
stratumctl dns latency-targets delete <latency-target-id> [flags]

Examples

Section titled “Examples”
Terminal window
stratumctl dns latency-targets delete 9

Flags

Section titled “Flags”
Flag Type Default Description
--project string Project ID (defaults to STRATUM_PROJECT or profile project_id)

stratumctl dns latency-targets get

Section titled “stratumctl dns latency-targets get”

Describe a DNS latency target

Terminal window
stratumctl dns latency-targets get <latency-target-id> [flags]

Examples

Section titled “Examples”
Terminal window
stratumctl dns latency-targets get 9
stratumctl dns latency-targets get 9 --output json

Flags

Section titled “Flags”
Flag Type Default Description
--project string Project ID (defaults to STRATUM_PROJECT or profile project_id)

stratumctl dns latency-targets list

Section titled “stratumctl dns latency-targets list”

List DNS latency targets in a project

Terminal window
stratumctl dns latency-targets list [flags]

Examples

Section titled “Examples”
Terminal window
stratumctl dns latency-targets list
stratumctl dns latency-targets list --output json

Flags

Section titled “Flags”
Flag Type Default Description
--project string Project ID (defaults to STRATUM_PROJECT or profile project_id)

stratumctl dns record-sets

Section titled “stratumctl dns record-sets”

Manage record sets within a hosted zone

Terminal window
stratumctl dns record-sets [flags]

Aliases: record-set, records, rrsets

Subcommands

Section titled “Subcommands”

stratumctl dns record-sets create

Section titled “stratumctl dns record-sets create”

Create a record set (literal –records, or an –alias-target-* to a Stratum resource)

Terminal window
stratumctl dns record-sets create <zone-id> [flags]

Examples

Section titled “Examples”
Terminal window
stratumctl dns record-sets create zone-4k8m2x7q9a --name www.example.com. --type A --records 10.0.0.5 --ttl 60
stratumctl dns record-sets create zone-4k8m2x7q9a --name app.example.com. --type A --alias-target-type lb --alias-target-id lb-7k2m9x4q8a

Flags

Section titled “Flags”
Flag Type Default Description
--alias-target-id string Alias target resource id, e.g. lb-… (records must be empty)
--alias-target-type string Alias target kind: lb | fip | instance (with –alias-target-id)
--name string Record name, e.g. www.example.com. (required)
--project string Project ID (defaults to STRATUM_PROJECT or profile project_id)
--records stringSlice Literal record values (comma-separated), e.g. 10.0.0.5
--ttl int 300 TTL in seconds
--type string Record type: A | AAAA | CNAME | TXT | MX |… (required)

stratumctl dns record-sets delete

Section titled “stratumctl dns record-sets delete”

Delete a record set

Terminal window
stratumctl dns record-sets delete <zone-id> <record-set-id> [flags]

Examples

Section titled “Examples”
Terminal window
stratumctl dns record-sets delete zone-4k8m2x7q9a rrset-8k2m4x7q9a

Flags

Section titled “Flags”
Flag Type Default Description
--project string Project ID (defaults to STRATUM_PROJECT or profile project_id)

stratumctl dns record-sets get

Section titled “stratumctl dns record-sets get”

Describe a record set

Terminal window
stratumctl dns record-sets get <zone-id> <record-set-id> [flags]

Examples

Section titled “Examples”
Terminal window
stratumctl dns record-sets get zone-4k8m2x7q9a rrset-8k2m4x7q9a
stratumctl dns record-sets get zone-4k8m2x7q9a rrset-8k2m4x7q9a --output json

Flags

Section titled “Flags”
Flag Type Default Description
--project string Project ID (defaults to STRATUM_PROJECT or profile project_id)

stratumctl dns record-sets list

Section titled “stratumctl dns record-sets list”

List record sets in a zone

Terminal window
stratumctl dns record-sets list <zone-id> [flags]

Examples

Section titled “Examples”
Terminal window
stratumctl dns record-sets list zone-4k8m2x7q9a
stratumctl dns record-sets list zone-4k8m2x7q9a --output json

Flags

Section titled “Flags”
Flag Type Default Description
--project string Project ID (defaults to STRATUM_PROJECT or profile project_id)

stratumctl dns resolver-inbound-endpoints

Section titled “stratumctl dns resolver-inbound-endpoints”

Manage resolver inbound endpoints (hybrid DNS,)

Terminal window
stratumctl dns resolver-inbound-endpoints [flags]

Aliases: resolver-inbound, rie

Subcommands

Section titled “Subcommands”

stratumctl dns resolver-inbound-endpoints create

Section titled “stratumctl dns resolver-inbound-endpoints create”

Create a resolver inbound endpoint (binds a floating IP to the VPC recursor)

Terminal window
stratumctl dns resolver-inbound-endpoints create [flags]

Examples

Section titled “Examples”
Terminal window
stratumctl dns resolver-inbound-endpoints create --project p-team-a --vpc vpc-9k2m4x7q --floating-ip fip-4k8m2x7q9a
stratumctl dns resolver-inbound-endpoints create --project p-team-a --vpc vpc-9k2m4x7q --floating-ip fip-4k8m2x7q9a \
  --allowed-cidr 172.24.0.0/16 --subnet subnet-3k8m2x7q --security-group sg-3f8d2k9x

Flags

Section titled “Flags”
Flag Type Default Description
--allowed-cidr stringSlice Client network permitted to query through the endpoint, e.g. 172.24.0.0/16. Repeatable. Without it the endpoint answers only the VPC’s own clients — an off-cluster resolver’s queries are refused, and the refusal is lost on the return path so it looks like a timeout
--floating-ip string Allocated floating IP to bind (required)
--project string Project ID (defaults to STRATUM_PROJECT or profile project_id)
--security-group stringSlice Security group applied to the endpoint’s interfaces. Repeatable. Requires –subnet, and is mutually exclusive with –allowed-cidr
--subnet stringSlice Tenant subnet to place an interface in. Repeatable. Required for –security-group: a security group binds to a port, so the endpoint needs an interface of its own
--vpc string VPC whose recursor to expose (required)

stratumctl dns resolver-inbound-endpoints delete

Section titled “stratumctl dns resolver-inbound-endpoints delete”

Delete a resolver inbound endpoint (frees the floating IP)

Terminal window
stratumctl dns resolver-inbound-endpoints delete <rie-id> [flags]

Examples

Section titled “Examples”
Terminal window
stratumctl dns resolver-inbound-endpoints delete rie-5k8m2x7q9a

Flags

Section titled “Flags”
Flag Type Default Description
--project string Project ID (defaults to STRATUM_PROJECT or profile project_id)

stratumctl dns resolver-inbound-endpoints get

Section titled “stratumctl dns resolver-inbound-endpoints get”

Describe a resolver inbound endpoint

Terminal window
stratumctl dns resolver-inbound-endpoints get <rie-id> [flags]

Examples

Section titled “Examples”
Terminal window
stratumctl dns resolver-inbound-endpoints get rie-5k8m2x7q9a
stratumctl dns resolver-inbound-endpoints get rie-5k8m2x7q9a --output json

Flags

Section titled “Flags”
Flag Type Default Description
--project string Project ID (defaults to STRATUM_PROJECT or profile project_id)

stratumctl dns resolver-inbound-endpoints list

Section titled “stratumctl dns resolver-inbound-endpoints list”

List resolver inbound endpoints in a project

Terminal window
stratumctl dns resolver-inbound-endpoints list [flags]

Examples

Section titled “Examples”
Terminal window
stratumctl dns resolver-inbound-endpoints list
stratumctl dns resolver-inbound-endpoints list --vpc vpc-9k2m4x7q --output json

Flags

Section titled “Flags”
Flag Type Default Description
--project string Project ID (defaults to STRATUM_PROJECT or profile project_id)
--vpc string Filter by VPC ID

stratumctl dns zones

Section titled “stratumctl dns zones”

Manage DNS hosted zones

Terminal window
stratumctl dns zones [flags]

Aliases: zone

Subcommands

Section titled “Subcommands”

stratumctl dns zones create

Section titled “stratumctl dns zones create”

Create a DNS zone (name is the FQDN with a trailing dot)

Terminal window
stratumctl dns zones create <name> [flags]

Examples

Section titled “Examples”
Terminal window
stratumctl dns zones create example.com.
stratumctl dns zones create internal.example.com. --visibility private --vpc-id vpc-9k2m4x7q --default-ttl 120

Flags

Section titled “Flags”
Flag Type Default Description
--comment string Free-form comment
--default-ttl int 0 Default record TTL in seconds
--project string Project ID (defaults to STRATUM_PROJECT or profile project_id)
--region string Region override
--visibility string public | private (private requires –vpc-id)
--vpc-id string VPC ID for a private zone

stratumctl dns zones delete

Section titled “stratumctl dns zones delete”

Delete a DNS zone

Terminal window
stratumctl dns zones delete <zone-id> [flags]

Examples

Section titled “Examples”
Terminal window
stratumctl dns zones delete zone-4k8m2x7q9a

Flags

Section titled “Flags”
Flag Type Default Description
--project string Project ID (defaults to STRATUM_PROJECT or profile project_id)

stratumctl dns zones get

Section titled “stratumctl dns zones get”

Describe a DNS zone

Terminal window
stratumctl dns zones get <zone-id> [flags]

Examples

Section titled “Examples”
Terminal window
stratumctl dns zones get zone-4k8m2x7q9a
stratumctl dns zones get zone-4k8m2x7q9a --output json

Flags

Section titled “Flags”
Flag Type Default Description
--project string Project ID (defaults to STRATUM_PROJECT or profile project_id)

stratumctl dns zones list

Section titled “stratumctl dns zones list”

List DNS zones in a project

Terminal window
stratumctl dns zones list [flags]

Examples

Section titled “Examples”
Terminal window
stratumctl dns zones list
stratumctl dns zones list --output json

Flags

Section titled “Flags”
Flag Type Default Description
--project string Project ID (defaults to STRATUM_PROJECT or profile project_id)