mw domain
Manage domains, virtual hosts and DNS settings in your projects
mw domain dnszone get DNSZONE-ID
gets a specific zone
USAGE
$ mw domain dnszone get DNSZONE-ID [--token <value>] [-o txt|json]
ARGUMENTS
DNSZONE-ID ID or domain name of a DNS zone
FLAGS
-o, --output=<option> [default: txt] The output format to use; use 'txt' for a human readable text representation,
and 'json' for a machine-readable JSON representation.
<options: txt|json>
AUTHENTICATION FLAGS
--token=<value> API token to use for authentication (overrides environment and config file). NOTE: watch out that
tokens passed via this flag might be logged in your shell history.
DESCRIPTION
gets a specific zone
mw domain dnszone list
list all DNS zones by project ID
USAGE
$ mw domain dnszone list -o txt|json|yaml|csv|tsv [--token <value>] [-x] [--no-header] [--no-truncate]
[--no-relative-dates] [--csv-separator ,|;] [-p <value>]
FLAGS
-o, --output=<option> (required) [default: txt] output in a more machine friendly format
<options: txt|json|yaml|csv|tsv>
-p, --project-id=<value> ID or short ID of a project; this flag is optional if a default project is set in the
context
-x, --extended show extended information
--csv-separator=<option> [default: ,] separator for CSV output (only relevant for CSV output)
<options: ,|;>
--no-header hide table header
--no-relative-dates show dates in absolute format, not relative (only relevant for txt output)
--no-truncate do not truncate output (only relevant for txt output)
AUTHENTICATION FLAGS
--token=<value> API token to use for authentication (overrides environment and config file). NOTE: watch out that
tokens passed via this flag might be logged in your shell history.
DESCRIPTION
list all DNS zones by project ID
FLAG DESCRIPTIONS
-p, --project-id=<value> ID or short ID of a project; this flag is optional if a default project is set in the context
May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
to persistently set a default project for all commands that accept this flag.
mw domain dnszone update DNSZONE-ID RECORD-SET
Updates a record set of a DNS zone
USAGE
$ mw domain dnszone update DNSZONE-ID RECORD-SET [--token <value>] [-q] [-p <value>] [--record <value>... | --managed |
--unset] [--ttl <value>]
ARGUMENTS
DNSZONE-ID ID or domain name of a DNS zone
RECORD-SET (a|mx|txt|srv|cname) The record type of the record set
FLAGS
-p, --project-id=<value> ID or short ID of a project; this flag is optional if a default project is set in the
context
-q, --quiet suppress process output and only display a machine-readable summary
--managed Reset this record set to fully-managed (only for A and MX records)
--record=<value>... The records to set; may not be used with --managed
--ttl=<value> The TTL of the record set; omit to use the default TTL
--unset Set this to remove all records from the record set
AUTHENTICATION FLAGS
--token=<value> API token to use for authentication (overrides environment and config file). NOTE: watch out that
tokens passed via this flag might be logged in your shell history.
DESCRIPTION
Updates a record set of a DNS zone
EXAMPLES
Set A and AAAA records
$ mw domain dnszone update domain.example a --record 203.0.113.123 --record 2001:db8::1
Set MX records
$ mw domain dnszone update domain.example mx --record "10 mail1.domain.example" --record "20 \
mail2.domain.example"
FLAG DESCRIPTIONS
-p, --project-id=<value> ID or short ID of a project; this flag is optional if a default project is set in the context
May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
to persistently set a default project for all commands that accept this flag.
-q, --quiet suppress process output and only display a machine-readable summary
This flag controls if you want to see the process output or only a summary. When using mw non-interactively (e.g. in
scripts), you can use this flag to easily get the IDs of created resources for further processing.
--record=<value>... The records to set; may not be used with --managed
The format depends on the record set type:
- for "a" records, this parameter should contain a IPv4 or IPv6 address (we will automatically create an A or AAAA
record)
- for "mx" records, the parameter should be formatted as "<priority> <fqdn>", e.g. "10 mail.example.com"
- for "srv" records, the parameter should be formatted as "<priority> <weight> <port> <fqdn>", e.g. "10 1 5060
sip.example.com"
- for "txt" records, the parameter should be a string containing the TXT record value.
mw domain get DOMAIN-ID
gets a specific domain
USAGE
$ mw domain get DOMAIN-ID [--token <value>] [-o txt|json]
ARGUMENTS
DOMAIN-ID ID or domain name of a domain
FLAGS
-o, --output=<option> [default: txt] The output format to use; use 'txt' for a human readable text representation,
and 'json' for a machine-readable JSON representation.
<options: txt|json>
AUTHENTICATION FLAGS
--token=<value> API token to use for authentication (overrides environment and config file). NOTE: watch out that
tokens passed via this flag might be logged in your shell history.
DESCRIPTION
gets a specific domain
mw domain list
List domains belonging to a project.
USAGE
$ mw domain list -o txt|json|yaml|csv|tsv [--token <value>] [-x] [--no-header] [--no-truncate]
[--no-relative-dates] [--csv-separator ,|;] [-p <value>]
FLAGS
-o, --output=<option> (required) [default: txt] output in a more machine friendly format
<options: txt|json|yaml|csv|tsv>
-p, --project-id=<value> ID or short ID of a project; this flag is optional if a default project is set in the
context
-x, --extended show extended information
--csv-separator=<option> [default: ,] separator for CSV output (only relevant for CSV output)
<options: ,|;>
--no-header hide table header
--no-relative-dates show dates in absolute format, not relative (only relevant for txt output)
--no-truncate do not truncate output (only relevant for txt output)
AUTHENTICATION FLAGS
--token=<value> API token to use for authentication (overrides environment and config file). NOTE: watch out that
tokens passed via this flag might be logged in your shell history.
DESCRIPTION
List domains belonging to a project.
FLAG DESCRIPTIONS
-p, --project-id=<value> ID or short ID of a project; this flag is optional if a default project is set in the context
May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
to persistently set a default project for all commands that accept this flag.
mw domain virtualhost create
Create a new ingress
USAGE
$ mw domain virtualhost create --hostname <value> [--token <value>] [-q] [-p <value>] [--path-to-app <value>...]
[--path-to-url <value>...] [--path-to-container <value>...]
FLAGS
-p, --project-id=<value> ID or short ID of a project; this flag is optional if a default project is set in
the context
-q, --quiet suppress process output and only display a machine-readable summary
--hostname=<value> (required) the hostname of the ingress
--path-to-app=<value>... add a path mapping to an app
--path-to-container=<value>... add a path mapping to a container
--path-to-url=<value>... add a path mapping to an external url
AUTHENTICATION FLAGS
--token=<value> API token to use for authentication (overrides environment and config file). NOTE: watch out that
tokens passed via this flag might be logged in your shell history.
DESCRIPTION
Create a new ingress
EXAMPLES
Create a new ingress, with the root path mapping to your project's root directory
$ mw domain virtualhost create --hostname mw.example --path-to-dir /:/
Create a new ingress, with the root path mapping to an app
$ mw domain virtualhost create --hostname mw.example --path-to-app /:3ecaf1a9-6eb4-4869-b811-8a13c3a2e745
Create a new ingress, with the root path mapping to a URL
$ mw domain virtualhost create --hostname mw.example --path-to-url /:https://redirect.example
FLAG DESCRIPTIONS
-p, --project-id=<value> ID or short ID of a project; this flag is optional if a default project is set in the context
May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
to persistently set a default project for all commands that accept this flag.
-q, --quiet suppress process output and only display a machine-readable summary
This flag controls if you want to see the process output or only a summary. When using mw non-interactively (e.g. in
scripts), you can use this flag to easily get the IDs of created resources for further processing.
--path-to-app=<value>... add a path mapping to an app
This flag can be used to map a specific URL path to an app; the value for this flag should be the URL path and the
app ID, separated by a colon, e.g. /:3ecaf1a9-6eb4-4869-b811-8a13c3a2e745. You can specify this flag multiple times
to map multiple paths to different apps, and also combine it with the other --path-to-* flags.
--path-to-container=<value>... add a path mapping to a container
This flag can be used to map a specific URL path to a container; the value for this flag should be the URL path, the
container ID and the target port, each separated by a colon, e.g. /:3ecaf1a9-6eb4-4869-b811-8a13c3a2e745:80/tcp. You
can specify this flag multiple times to map multiple paths to different containers, and also combine it with the
other --path-to-* flags.
--path-to-url=<value>... add a path mapping to an external url
This flag can be used to map a specific URL path to an external URL; the value for this flag should be the URL path
and the external URL, separated by a colon, e.g. /:https://redirect.example. You can specify this flag multiple
times to map multiple paths to different external URLs, and also combine it with the other --path-to-* flags.
mw domain virtualhost delete VIRTUAL-HOST-ID
Delete a virtual host
USAGE
$ mw domain virtualhost delete VIRTUAL-HOST-ID [--token <value>] [-q] [-f]
ARGUMENTS
VIRTUAL-HOST-ID ID of the virtual host to delete
FLAGS
-f, --force do not ask for confirmation
-q, --quiet suppress process output and only display a machine-readable summary
AUTHENTICATION FLAGS
--token=<value> API token to use for authentication (overrides environment and config file). NOTE: watch out that
tokens passed via this flag might be logged in your shell history.
DESCRIPTION
Delete a virtual host
FLAG DESCRIPTIONS
-q, --quiet suppress process output and only display a machine-readable summary
This flag controls if you want to see the process output or only a summary. When using mw non-interactively (e.g. in
scripts), you can use this flag to easily get the IDs of created resources for further processing.
mw domain virtualhost get INGRESS-ID
Get a virtual host.
USAGE
$ mw domain virtualhost get INGRESS-ID [--token <value>] [-o txt|json]
FLAGS
-o, --output=<option> [default: txt] The output format to use; use 'txt' for a human readable text representation,
and 'json' for a machine-readable JSON representation.
<options: txt|json>
AUTHENTICATION FLAGS
--token=<value> API token to use for authentication (overrides environment and config file). NOTE: watch out that
tokens passed via this flag might be logged in your shell history.
DESCRIPTION
Get a virtual host.
mw domain virtualhost list
List virtualhosts for a project.
USAGE
$ mw domain virtualhost list -o txt|json|yaml|csv|tsv [--token <value>] [-x] [--no-header] [--no-truncate]
[--no-relative-dates] [--csv-separator ,|;] [-p <value>] [-a]
FLAGS
-a, --all List all virtual hosts that you have access to, regardless of project
-o, --output=<option> (required) [default: txt] output in a more machine friendly format
<options: txt|json|yaml|csv|tsv>
-p, --project-id=<value> ID or short ID of a project; this flag is optional if a default project is set in the
context
-x, --extended show extended information
--csv-separator=<option> [default: ,] separator for CSV output (only relevant for CSV output)
<options: ,|;>
--no-header hide table header
--no-relative-dates show dates in absolute format, not relative (only relevant for txt output)
--no-truncate do not truncate output (only relevant for txt output)
AUTHENTICATION FLAGS
--token=<value> API token to use for authentication (overrides environment and config file). NOTE: watch out that
tokens passed via this flag might be logged in your shell history.
DESCRIPTION
List virtualhosts for a project.
FLAG DESCRIPTIONS
-p, --project-id=<value> ID or short ID of a project; this flag is optional if a default project is set in the context
May contain a short ID or a full ID of a project; you can also use the "mw context set --project-id=<VALUE>" command
to persistently set a default project for all commands that accept this flag.