AddController
Adds a Controller to Coordinator. You can specify a Controller by using one of the following parameter combinations:
- UUID (Universal Unique ID).
- IP address and Port.
- HostName and Port. In this case you must also set ConnectByHostName to
True
.
NOTE: You can register Controllers by UUID only if you enable SSDP in your Controllers. In this case, you can use the GetControllers action to obtain the UUID of a Controller.
You cannot register Controllers by UUID if you use GSSAPI authentication.
Example
http://123.4.5.67:9000/action=AddController&UUID=d267cf80-063a-8030-a2de-24be0523821c
http://123.4.5.67:9000/action=AddController&HostName=localhost&Port=41200&ConnectByHostName=True
http://123.4.5.67:9000/action=AddController&IP=1.2.3.4&Port=41200
Required Parameters
You must set at least one of the following parameters.
Parameter | Description |
---|---|
ConnectByHostName | Set to True to add the Controller by specifying host name information. This parameter is required if you set HostName. |
HostName | The name of the active host on which the Controller is running. If you set HostName, you must also set Port. |
IP | The IP address of the machine on which the Controller is running. If you set IP, you must also set Port. |
Port | The active port on which the Controller is running. This parameter is required if you set HostName or IP. |
UUID | The UUID of the Controller that you want to add. |
Optional Parameters
This action accepts the following optional parameters.
Parameter | Description | Required |
---|---|---|
GSSServiceName | The GSSAPI service name of the Controller. | |
UseSSL | Specifies whether the Controller uses SSL. |