`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.

`mw domain virtualhost update VIRTUAL-HOST-ID`

Update the paths of an existing virtual host. The given paths replace the existing ones entirely, so you need to specify all paths that the virtual host should have after the update.

USAGE
  $ mw domain virtualhost update VIRTUAL-HOST-ID [--token <value>] [-q] [--path-to-app <value>...] [--path-to-url <value>...]
    [--path-to-container <value>...]

ARGUMENTS
  VIRTUAL-HOST-ID  ID of the virtual host to update

FLAGS
  -q, --quiet                         suppress process output and only display a machine-readable summary
      --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
  Update the paths of an existing virtual host. The given paths replace the existing ones entirely, so you need to
  specify all paths that the virtual host should have after the update.

EXAMPLES
  Point the root path of a virtual host to an app

    $ mw domain virtualhost update 3ecaf1a9-6eb4-4869-b811-8a13c3a2e745 --path-to-app \
      /:fdc7e3a8-9b1c-4d2e-8f5a-6c7b8d9e0f1a

  Point the root path of a virtual host to a URL

    $ mw domain virtualhost update 3ecaf1a9-6eb4-4869-b811-8a13c3a2e745 --path-to-url /:https://redirect.example

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.

  --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 dnszone get DNSZONE-ID​

mw domain dnszone list​

mw domain dnszone update DNSZONE-ID RECORD-SET​

mw domain get DOMAIN-ID​

mw domain list​

mw domain virtualhost create​

mw domain virtualhost delete VIRTUAL-HOST-ID​

mw domain virtualhost get INGRESS-ID​

mw domain virtualhost list​

mw domain virtualhost update VIRTUAL-HOST-ID​