run-api-command

Executes another API command over multiple servers Some Virtualmin API commands can only run on a single domain at a time, so this command exists as a wrapper to loop over multiple domains easily. It can be run like: virtualmin run-api-command --user foo modify-web --mode cgi Flags to select the domains to operate on must be given before the command to run. All flags after the command will be passed to each invocation of it. You can see the final commands without running them by adding the --test flag.

Executes another API command over multiple servers#

Some Virtualmin API commands can only run on a single domain at a time, so this command exists as a wrapper to loop over multiple domains easily. It can be run like:

virtualmin run-api-command --user foo modify-web --mode cgi

Flags to select the domains to operate on must be given before the command to run. All flags after the command will be passed to each invocation of it. You can see the final commands without running them by adding the --test flag.

By default it will operate on all virtual servers, but you can choose specific servers with the --domain flag which can be given multiple times. Or to limit the domains to those owned by a single user, the --user parameter can be given, following by a domain owner’s name. You can also limit it to particular server types with the --alias, --no-alias, --subserver, --toplevel and --subdomain parameters.

To only show domains with a particular feature active, use the --with-feature parameter followed by a feature code like dns or web. Alternately, --without-feature can be used to show only domains without some feature enabled. The similar --with-web and --with-ssl flags can be used to show domains with any kind of website (Apache or Nginx).

To limit the list to virtual servers on some plan, use the --plan flag followed by a plan name or ID. Similarly, you can select only virtual servers created using some template with the --template flag, followed by an ID or name.

To show only domains owned by some reseller, use the --reseller flag followed by a reseller name. Or to list those not owned by any reseller, use the --no-reseller flag. Finally, to list domains owned by any reseller, you can use the --any-reseller option.

To show only domains that are enabled, use the --enabled flag. To show only disabled domains, use --disabled instead.

Command line help#

virtualmin run-api-command [--domain name]*
 [--user name]*
 [--id number]*
 [--with-feature feature]
 [--without-feature feature]
 [--with-web] [--with-ssl]
 [--alias domain | --no-alias]
 [--subserver | --toplevel | --subdomain]
 [--parent domain]
 [--plan ID|name]
 [--template ID|name]
 [--disabled | --enabled]
 [--reseller name | --no-reseller |
 --any-reseller]
 [--test]
 command [flags]

Source: https://www.virtualmin.com/docs/development/api-programs/run-api-command/

  • virtualmin, apache, nginx, cgi, domain, subdomain, alias, reseller, dns, ssl, user, api, command line, command
  • 0 Users Found This Useful
Was this answer helpful?

Related Articles

Pre and Post Domain Modification Scripts

Virtualmin allows the use of custom scripts (Shell, Perl, Python and etc.) to automate tasks...

OS Support

Virtualmin runs on top of Webmin. Webmin works on almost every UNIX-like OS, so with some manual...

Professional Features

Virtualmin GPL is already an extremely powerful and flexible virtual hosting control panel, so...

How to Configure Secondary DNS

This guide provides administrators with a quick overview of setting up automatic DNS secondary...

How to Configure Cloudflare DNS

For users looking to integrate Cloudflare with Virtualmin Pro, the process is straightforward and...