feat: achieve CLI parity with Central UI
Add 33 new management message records, ManagementActor handlers, and CLI commands to close all functionality gaps between the Central UI and the Management CLI. New capabilities include: - Template member CRUD (attributes, alarms, scripts, compositions) - Shared script CRUD - Database connection definition CRUD - Inbound API method CRUD - LDAP scope rule management - API key enable/disable - Area update - Remote event log and parked message queries - Missing get/update commands for templates, sites, instances, data connections, external systems, notifications, and SMTP config Includes 12 new ManagementActor unit tests covering authorization, happy-path queries, and error handling. Updates CLI README and component design documents (Component-CLI.md, Component-ManagementService.md).
This commit is contained in:
Joseph Doherty
@@ -119,6 +119,21 @@ scadalink --contact-points <uri> template create --name <string> [--description
|
||||
| `--description` | no | Template description |
|
||||
| `--parent-id` | no | Parent template ID for inheritance |
|
||||
|
||||
#### `template update`
|
||||
|
||||
Update an existing template's name, description, or parent.
|
||||
|
||||
```sh
|
||||
scadalink --contact-points <uri> template update --id <int> [--name <string>] [--description <string>] [--parent-id <int>]
|
||||
```
|
||||
|
||||
| Option | Required | Description |
|
||||
|--------|----------|-------------|
|
||||
| `--id` | yes | Template ID |
|
||||
| `--name` | no | Updated template name |
|
||||
| `--description` | no | Updated description |
|
||||
| `--parent-id` | no | Updated parent template ID |
|
||||
|
||||
#### `template delete`
|
||||
|
||||
Delete a template by ID.
|
||||
@@ -131,10 +146,201 @@ scadalink --contact-points <uri> template delete --id <int>
|
||||
|--------|----------|-------------|
|
||||
| `--id` | yes | Template ID |
|
||||
|
||||
#### `template validate`
|
||||
|
||||
Run pre-deployment validation on a template (flattening, naming collisions, script compilation).
|
||||
|
||||
```sh
|
||||
scadalink --contact-points <uri> template validate --id <int>
|
||||
```
|
||||
|
||||
| Option | Required | Description |
|
||||
|--------|----------|-------------|
|
||||
| `--id` | yes | Template ID |
|
||||
|
||||
#### `template attribute add`
|
||||
|
||||
Add an attribute to a template.
|
||||
|
||||
```sh
|
||||
scadalink --contact-points <uri> template attribute add --template-id <int> --name <string> --data-type <string> [--default-value <string>] [--tag-path <string>]
|
||||
```
|
||||
|
||||
| Option | Required | Description |
|
||||
|--------|----------|-------------|
|
||||
| `--template-id` | yes | Template ID |
|
||||
| `--name` | yes | Attribute name |
|
||||
| `--data-type` | yes | Attribute data type (e.g. `Float`, `Int`, `String`, `Bool`) |
|
||||
| `--default-value` | no | Default value |
|
||||
| `--tag-path` | no | Data connection tag path |
|
||||
|
||||
#### `template attribute update`
|
||||
|
||||
Update an attribute on a template.
|
||||
|
||||
```sh
|
||||
scadalink --contact-points <uri> template attribute update --template-id <int> --name <string> [--data-type <string>] [--default-value <string>] [--tag-path <string>]
|
||||
```
|
||||
|
||||
| Option | Required | Description |
|
||||
|--------|----------|-------------|
|
||||
| `--template-id` | yes | Template ID |
|
||||
| `--name` | yes | Attribute name to update |
|
||||
| `--data-type` | no | Updated data type |
|
||||
| `--default-value` | no | Updated default value |
|
||||
| `--tag-path` | no | Updated tag path |
|
||||
|
||||
#### `template attribute delete`
|
||||
|
||||
Remove an attribute from a template.
|
||||
|
||||
```sh
|
||||
scadalink --contact-points <uri> template attribute delete --template-id <int> --name <string>
|
||||
```
|
||||
|
||||
| Option | Required | Description |
|
||||
|--------|----------|-------------|
|
||||
| `--template-id` | yes | Template ID |
|
||||
| `--name` | yes | Attribute name to delete |
|
||||
|
||||
#### `template alarm add`
|
||||
|
||||
Add an alarm definition to a template.
|
||||
|
||||
```sh
|
||||
scadalink --contact-points <uri> template alarm add --template-id <int> --name <string> --trigger-attribute <string> --condition <string> --setpoint <string> [--severity <string>] [--notification-list <string>]
|
||||
```
|
||||
|
||||
| Option | Required | Description |
|
||||
|--------|----------|-------------|
|
||||
| `--template-id` | yes | Template ID |
|
||||
| `--name` | yes | Alarm name |
|
||||
| `--trigger-attribute` | yes | Attribute that triggers the alarm |
|
||||
| `--condition` | yes | Trigger condition (e.g. `GreaterThan`, `LessThan`, `Equal`) |
|
||||
| `--setpoint` | yes | Setpoint value |
|
||||
| `--severity` | no | Alarm severity (default: `Warning`) |
|
||||
| `--notification-list` | no | Notification list name to notify on alarm |
|
||||
|
||||
#### `template alarm update`
|
||||
|
||||
Update an alarm definition on a template.
|
||||
|
||||
```sh
|
||||
scadalink --contact-points <uri> template alarm update --template-id <int> --name <string> [--condition <string>] [--setpoint <string>] [--severity <string>] [--notification-list <string>]
|
||||
```
|
||||
|
||||
| Option | Required | Description |
|
||||
|--------|----------|-------------|
|
||||
| `--template-id` | yes | Template ID |
|
||||
| `--name` | yes | Alarm name to update |
|
||||
| `--condition` | no | Updated trigger condition |
|
||||
| `--setpoint` | no | Updated setpoint value |
|
||||
| `--severity` | no | Updated severity |
|
||||
| `--notification-list` | no | Updated notification list name |
|
||||
|
||||
#### `template alarm delete`
|
||||
|
||||
Remove an alarm definition from a template.
|
||||
|
||||
```sh
|
||||
scadalink --contact-points <uri> template alarm delete --template-id <int> --name <string>
|
||||
```
|
||||
|
||||
| Option | Required | Description |
|
||||
|--------|----------|-------------|
|
||||
| `--template-id` | yes | Template ID |
|
||||
| `--name` | yes | Alarm name to delete |
|
||||
|
||||
#### `template script add`
|
||||
|
||||
Add a script to a template.
|
||||
|
||||
```sh
|
||||
scadalink --contact-points <uri> template script add --template-id <int> --name <string> --trigger-type <string> [--trigger-attribute <string>] [--interval <int>] --code <string>
|
||||
```
|
||||
|
||||
| Option | Required | Description |
|
||||
|--------|----------|-------------|
|
||||
| `--template-id` | yes | Template ID |
|
||||
| `--name` | yes | Script name |
|
||||
| `--trigger-type` | yes | Trigger type: `OnChange`, `Periodic`, `OnAlarm` |
|
||||
| `--trigger-attribute` | no | Attribute name for `OnChange` trigger |
|
||||
| `--interval` | no | Interval in milliseconds for `Periodic` trigger |
|
||||
| `--code` | yes | Script source code (or `@filepath` to read from file) |
|
||||
|
||||
#### `template script update`
|
||||
|
||||
Update a script on a template.
|
||||
|
||||
```sh
|
||||
scadalink --contact-points <uri> template script update --template-id <int> --name <string> [--trigger-type <string>] [--trigger-attribute <string>] [--interval <int>] [--code <string>]
|
||||
```
|
||||
|
||||
| Option | Required | Description |
|
||||
|--------|----------|-------------|
|
||||
| `--template-id` | yes | Template ID |
|
||||
| `--name` | yes | Script name to update |
|
||||
| `--trigger-type` | no | Updated trigger type |
|
||||
| `--trigger-attribute` | no | Updated trigger attribute |
|
||||
| `--interval` | no | Updated interval |
|
||||
| `--code` | no | Updated script source code (or `@filepath`) |
|
||||
|
||||
#### `template script delete`
|
||||
|
||||
Remove a script from a template.
|
||||
|
||||
```sh
|
||||
scadalink --contact-points <uri> template script delete --template-id <int> --name <string>
|
||||
```
|
||||
|
||||
| Option | Required | Description |
|
||||
|--------|----------|-------------|
|
||||
| `--template-id` | yes | Template ID |
|
||||
| `--name` | yes | Script name to delete |
|
||||
|
||||
#### `template composition add`
|
||||
|
||||
Add a feature module composition to a template.
|
||||
|
||||
```sh
|
||||
scadalink --contact-points <uri> template composition add --template-id <int> --module-template-id <int> --instance-name <string>
|
||||
```
|
||||
|
||||
| Option | Required | Description |
|
||||
|--------|----------|-------------|
|
||||
| `--template-id` | yes | Target template ID |
|
||||
| `--module-template-id` | yes | Feature module template ID to compose |
|
||||
| `--instance-name` | yes | Instance name for the composed module (used in path-qualified addressing) |
|
||||
|
||||
#### `template composition delete`
|
||||
|
||||
Remove a feature module composition from a template.
|
||||
|
||||
```sh
|
||||
scadalink --contact-points <uri> template composition delete --template-id <int> --instance-name <string>
|
||||
```
|
||||
|
||||
| Option | Required | Description |
|
||||
|--------|----------|-------------|
|
||||
| `--template-id` | yes | Target template ID |
|
||||
| `--instance-name` | yes | Instance name of the composed module to remove |
|
||||
|
||||
---
|
||||
|
||||
### `instance` — Manage instances
|
||||
|
||||
#### `instance get`
|
||||
|
||||
Get a single instance by ID.
|
||||
|
||||
```sh
|
||||
scadalink --contact-points <uri> instance get --id <int>
|
||||
```
|
||||
|
||||
| Option | Required | Description |
|
||||
|--------|----------|-------------|
|
||||
| `--id` | yes | Instance ID |
|
||||
|
||||
#### `instance list`
|
||||
|
||||
List instances, with optional filters.
|
||||
@@ -212,10 +418,35 @@ scadalink --contact-points <uri> instance delete --id <int>
|
||||
|--------|----------|-------------|
|
||||
| `--id` | yes | Instance ID |
|
||||
|
||||
#### `instance set-bindings`
|
||||
|
||||
Set data connection bindings for an instance's attributes.
|
||||
|
||||
```sh
|
||||
scadalink --contact-points <uri> instance set-bindings --id <int> --bindings <json>
|
||||
```
|
||||
|
||||
| Option | Required | Description |
|
||||
|--------|----------|-------------|
|
||||
| `--id` | yes | Instance ID |
|
||||
| `--bindings` | yes | JSON string mapping attribute names to data connection IDs (e.g. `{"attr1": 1, "attr2": 2}`) |
|
||||
|
||||
---
|
||||
|
||||
### `site` — Manage sites
|
||||
|
||||
#### `site get`
|
||||
|
||||
Get a single site by ID.
|
||||
|
||||
```sh
|
||||
scadalink --contact-points <uri> site get --id <int>
|
||||
```
|
||||
|
||||
| Option | Required | Description |
|
||||
|--------|----------|-------------|
|
||||
| `--id` | yes | Site ID |
|
||||
|
||||
#### `site list`
|
||||
|
||||
List all registered sites.
|
||||
@@ -262,6 +493,58 @@ scadalink --contact-points <uri> site deploy-artifacts [--site-id <int>]
|
||||
|--------|----------|-------------|
|
||||
| `--site-id` | no | Target site ID; omit to deploy to all sites |
|
||||
|
||||
#### `site area list`
|
||||
|
||||
List all areas for a site.
|
||||
|
||||
```sh
|
||||
scadalink --contact-points <uri> site area list --site-id <int>
|
||||
```
|
||||
|
||||
| Option | Required | Description |
|
||||
|--------|----------|-------------|
|
||||
| `--site-id` | yes | Site ID |
|
||||
|
||||
#### `site area create`
|
||||
|
||||
Create an area within a site.
|
||||
|
||||
```sh
|
||||
scadalink --contact-points <uri> site area create --site-id <int> --name <string> [--parent-area-id <int>]
|
||||
```
|
||||
|
||||
| Option | Required | Description |
|
||||
|--------|----------|-------------|
|
||||
| `--site-id` | yes | Site ID |
|
||||
| `--name` | yes | Area name |
|
||||
| `--parent-area-id` | no | Parent area ID for nested areas |
|
||||
|
||||
#### `site area update`
|
||||
|
||||
Update an area's name or parent.
|
||||
|
||||
```sh
|
||||
scadalink --contact-points <uri> site area update --id <int> [--name <string>] [--parent-area-id <int>]
|
||||
```
|
||||
|
||||
| Option | Required | Description |
|
||||
|--------|----------|-------------|
|
||||
| `--id` | yes | Area ID |
|
||||
| `--name` | no | Updated area name |
|
||||
| `--parent-area-id` | no | Updated parent area ID |
|
||||
|
||||
#### `site area delete`
|
||||
|
||||
Delete an area. Fails if any instances are assigned to it.
|
||||
|
||||
```sh
|
||||
scadalink --contact-points <uri> site area delete --id <int>
|
||||
```
|
||||
|
||||
| Option | Required | Description |
|
||||
|--------|----------|-------------|
|
||||
| `--id` | yes | Area ID |
|
||||
|
||||
---
|
||||
|
||||
### `deploy` — Deployment operations
|
||||
@@ -309,6 +592,18 @@ scadalink --contact-points <uri> deploy status [--instance-id <int>] [--status <
|
||||
|
||||
### `data-connection` — Manage data connections
|
||||
|
||||
#### `data-connection get`
|
||||
|
||||
Get a single data connection by ID.
|
||||
|
||||
```sh
|
||||
scadalink --contact-points <uri> data-connection get --id <int>
|
||||
```
|
||||
|
||||
| Option | Required | Description |
|
||||
|--------|----------|-------------|
|
||||
| `--id` | yes | Data connection ID |
|
||||
|
||||
#### `data-connection list`
|
||||
|
||||
List all configured data connections.
|
||||
@@ -331,6 +626,21 @@ scadalink --contact-points <uri> data-connection create --name <string> --protoc
|
||||
| `--protocol` | yes | Protocol identifier (e.g. `OpcUa`) |
|
||||
| `--configuration` | no | Protocol-specific configuration as a JSON string |
|
||||
|
||||
#### `data-connection update`
|
||||
|
||||
Update a data connection definition.
|
||||
|
||||
```sh
|
||||
scadalink --contact-points <uri> data-connection update --id <int> [--name <string>] [--protocol <string>] [--configuration <json>]
|
||||
```
|
||||
|
||||
| Option | Required | Description |
|
||||
|--------|----------|-------------|
|
||||
| `--id` | yes | Data connection ID |
|
||||
| `--name` | no | Updated connection name |
|
||||
| `--protocol` | no | Updated protocol identifier |
|
||||
| `--configuration` | no | Updated protocol-specific configuration as a JSON string |
|
||||
|
||||
#### `data-connection delete`
|
||||
|
||||
Delete a data connection.
|
||||
@@ -356,10 +666,35 @@ scadalink --contact-points <uri> data-connection assign --connection-id <int> --
|
||||
| `--connection-id` | yes | Data connection ID |
|
||||
| `--site-id` | yes | Site ID |
|
||||
|
||||
#### `data-connection unassign`
|
||||
|
||||
Remove a data connection assignment from a site.
|
||||
|
||||
```sh
|
||||
scadalink --contact-points <uri> data-connection unassign --connection-id <int> --site-id <int>
|
||||
```
|
||||
|
||||
| Option | Required | Description |
|
||||
|--------|----------|-------------|
|
||||
| `--connection-id` | yes | Data connection ID |
|
||||
| `--site-id` | yes | Site ID |
|
||||
|
||||
---
|
||||
|
||||
### `external-system` — Manage external HTTP systems
|
||||
|
||||
#### `external-system get`
|
||||
|
||||
Get a single external system definition by ID.
|
||||
|
||||
```sh
|
||||
scadalink --contact-points <uri> external-system get --id <int>
|
||||
```
|
||||
|
||||
| Option | Required | Description |
|
||||
|--------|----------|-------------|
|
||||
| `--id` | yes | External system ID |
|
||||
|
||||
#### `external-system list`
|
||||
|
||||
List all external system definitions.
|
||||
@@ -383,6 +718,22 @@ scadalink --contact-points <uri> external-system create --name <string> --endpoi
|
||||
| `--auth-type` | yes | Authentication type: `ApiKey` or `BasicAuth` |
|
||||
| `--auth-config` | no | Auth credentials as a JSON string |
|
||||
|
||||
#### `external-system update`
|
||||
|
||||
Update an external system definition.
|
||||
|
||||
```sh
|
||||
scadalink --contact-points <uri> external-system update --id <int> [--name <string>] [--endpoint-url <url>] [--auth-type <string>] [--auth-config <json>]
|
||||
```
|
||||
|
||||
| Option | Required | Description |
|
||||
|--------|----------|-------------|
|
||||
| `--id` | yes | External system ID |
|
||||
| `--name` | no | Updated display name |
|
||||
| `--endpoint-url` | no | Updated base URL |
|
||||
| `--auth-type` | no | Updated authentication type |
|
||||
| `--auth-config` | no | Updated auth credentials as a JSON string |
|
||||
|
||||
#### `external-system delete`
|
||||
|
||||
Delete an external system definition.
|
||||
@@ -399,6 +750,18 @@ scadalink --contact-points <uri> external-system delete --id <int>
|
||||
|
||||
### `notification` — Manage notification lists
|
||||
|
||||
#### `notification get`
|
||||
|
||||
Get a single notification list by ID.
|
||||
|
||||
```sh
|
||||
scadalink --contact-points <uri> notification get --id <int>
|
||||
```
|
||||
|
||||
| Option | Required | Description |
|
||||
|--------|----------|-------------|
|
||||
| `--id` | yes | Notification list ID |
|
||||
|
||||
#### `notification list`
|
||||
|
||||
List all notification lists.
|
||||
@@ -420,6 +783,20 @@ scadalink --contact-points <uri> notification create --name <string> --emails <e
|
||||
| `--name` | yes | Notification list name |
|
||||
| `--emails` | yes | Comma-separated list of recipient email addresses |
|
||||
|
||||
#### `notification update`
|
||||
|
||||
Update a notification list's name or recipients.
|
||||
|
||||
```sh
|
||||
scadalink --contact-points <uri> notification update --id <int> [--name <string>] [--emails <email1,email2,...>]
|
||||
```
|
||||
|
||||
| Option | Required | Description |
|
||||
|--------|----------|-------------|
|
||||
| `--id` | yes | Notification list ID |
|
||||
| `--name` | no | Updated list name |
|
||||
| `--emails` | no | Updated comma-separated list of recipient email addresses |
|
||||
|
||||
#### `notification delete`
|
||||
|
||||
Delete a notification list.
|
||||
@@ -432,6 +809,31 @@ scadalink --contact-points <uri> notification delete --id <int>
|
||||
|--------|----------|-------------|
|
||||
| `--id` | yes | Notification list ID |
|
||||
|
||||
#### `notification smtp list`
|
||||
|
||||
Show the current SMTP configuration.
|
||||
|
||||
```sh
|
||||
scadalink --contact-points <uri> notification smtp list
|
||||
```
|
||||
|
||||
#### `notification smtp update`
|
||||
|
||||
Update the SMTP configuration.
|
||||
|
||||
```sh
|
||||
scadalink --contact-points <uri> notification smtp update --host <string> --port <int> --auth-type <string> [--username <string>] [--password <string>] [--from-address <string>]
|
||||
```
|
||||
|
||||
| Option | Required | Description |
|
||||
|--------|----------|-------------|
|
||||
| `--host` | yes | SMTP server hostname |
|
||||
| `--port` | yes | SMTP server port |
|
||||
| `--auth-type` | yes | Authentication type: `OAuth2` or `Basic` |
|
||||
| `--username` | no | SMTP username (for Basic auth) |
|
||||
| `--password` | no | SMTP password (for Basic auth) |
|
||||
| `--from-address` | no | Sender email address |
|
||||
|
||||
---
|
||||
|
||||
### `security` — Security settings
|
||||
@@ -456,6 +858,20 @@ scadalink --contact-points <uri> security api-key create --name <string>
|
||||
|--------|----------|-------------|
|
||||
| `--name` | yes | Descriptive label for the key |
|
||||
|
||||
#### `security api-key update`
|
||||
|
||||
Update an API key's name or enabled status.
|
||||
|
||||
```sh
|
||||
scadalink --contact-points <uri> security api-key update --id <int> [--name <string>] [--enabled <bool>]
|
||||
```
|
||||
|
||||
| Option | Required | Description |
|
||||
|--------|----------|-------------|
|
||||
| `--id` | yes | API key ID |
|
||||
| `--name` | no | Updated label |
|
||||
| `--enabled` | no | Enable or disable the key (`true` or `false`) |
|
||||
|
||||
#### `security api-key delete`
|
||||
|
||||
Revoke and delete an API key.
|
||||
@@ -489,6 +905,20 @@ scadalink --contact-points <uri> security role-mapping create --ldap-group <stri
|
||||
| `--ldap-group` | yes | LDAP group distinguished name or CN |
|
||||
| `--role` | yes | ScadaLink role: `Admin`, `Design`, or `Deployment` |
|
||||
|
||||
#### `security role-mapping update`
|
||||
|
||||
Update an LDAP role mapping.
|
||||
|
||||
```sh
|
||||
scadalink --contact-points <uri> security role-mapping update --id <int> [--ldap-group <string>] [--role <string>]
|
||||
```
|
||||
|
||||
| Option | Required | Description |
|
||||
|--------|----------|-------------|
|
||||
| `--id` | yes | Mapping ID |
|
||||
| `--ldap-group` | no | Updated LDAP group distinguished name or CN |
|
||||
| `--role` | no | Updated ScadaLink role |
|
||||
|
||||
#### `security role-mapping delete`
|
||||
|
||||
Remove an LDAP role mapping.
|
||||
@@ -501,6 +931,43 @@ scadalink --contact-points <uri> security role-mapping delete --id <int>
|
||||
|--------|----------|-------------|
|
||||
| `--id` | yes | Mapping ID |
|
||||
|
||||
#### `security scope-rule list`
|
||||
|
||||
List all site scope rules for role mappings.
|
||||
|
||||
```sh
|
||||
scadalink --contact-points <uri> security scope-rule list [--role-mapping-id <int>]
|
||||
```
|
||||
|
||||
| Option | Required | Description |
|
||||
|--------|----------|-------------|
|
||||
| `--role-mapping-id` | no | Filter by role mapping ID |
|
||||
|
||||
#### `security scope-rule add`
|
||||
|
||||
Add a site scope rule to a role mapping, restricting it to a specific site.
|
||||
|
||||
```sh
|
||||
scadalink --contact-points <uri> security scope-rule add --role-mapping-id <int> --site-id <int>
|
||||
```
|
||||
|
||||
| Option | Required | Description |
|
||||
|--------|----------|-------------|
|
||||
| `--role-mapping-id` | yes | Role mapping ID |
|
||||
| `--site-id` | yes | Site ID to scope the mapping to |
|
||||
|
||||
#### `security scope-rule delete`
|
||||
|
||||
Remove a site scope rule from a role mapping.
|
||||
|
||||
```sh
|
||||
scadalink --contact-points <uri> security scope-rule delete --id <int>
|
||||
```
|
||||
|
||||
| Option | Required | Description |
|
||||
|--------|----------|-------------|
|
||||
| `--id` | yes | Scope rule ID |
|
||||
|
||||
---
|
||||
|
||||
### `health` — Health monitoring
|
||||
@@ -525,6 +992,37 @@ scadalink --contact-points <uri> health site --identifier <string>
|
||||
|--------|----------|-------------|
|
||||
| `--identifier` | yes | Site identifier (e.g. `site-a`) |
|
||||
|
||||
#### `health event-log`
|
||||
|
||||
Query the site event log for a specific site. Events are fetched remotely from the site's local SQLite store.
|
||||
|
||||
```sh
|
||||
scadalink --contact-points <uri> health event-log --site-identifier <string> [--from <datetime>] [--to <datetime>] [--search <string>] [--page <int>] [--page-size <int>]
|
||||
```
|
||||
|
||||
| Option | Required | Default | Description |
|
||||
|--------|----------|---------|-------------|
|
||||
| `--site-identifier` | yes | — | Site identifier |
|
||||
| `--from` | no | — | Start timestamp in ISO 8601 format |
|
||||
| `--to` | no | — | End timestamp in ISO 8601 format |
|
||||
| `--search` | no | — | Keyword search term |
|
||||
| `--page` | no | `1` | Page number |
|
||||
| `--page-size` | no | `50` | Results per page |
|
||||
|
||||
#### `health parked-messages`
|
||||
|
||||
Query parked (dead-letter) messages at a specific site.
|
||||
|
||||
```sh
|
||||
scadalink --contact-points <uri> health parked-messages --site-identifier <string> [--page <int>] [--page-size <int>]
|
||||
```
|
||||
|
||||
| Option | Required | Default | Description |
|
||||
|--------|----------|---------|-------------|
|
||||
| `--site-identifier` | yes | — | Site identifier |
|
||||
| `--page` | no | `1` | Page number |
|
||||
| `--page-size` | no | `50` | Results per page |
|
||||
|
||||
---
|
||||
|
||||
### `audit-log` — Audit log queries
|
||||
@@ -549,6 +1047,199 @@ scadalink --contact-points <uri> audit-log query [options]
|
||||
|
||||
---
|
||||
|
||||
### `shared-script` — Manage shared scripts
|
||||
|
||||
#### `shared-script list`
|
||||
|
||||
List all shared script definitions.
|
||||
|
||||
```sh
|
||||
scadalink --contact-points <uri> shared-script list
|
||||
```
|
||||
|
||||
#### `shared-script get`
|
||||
|
||||
Get a single shared script by ID.
|
||||
|
||||
```sh
|
||||
scadalink --contact-points <uri> shared-script get --id <int>
|
||||
```
|
||||
|
||||
| Option | Required | Description |
|
||||
|--------|----------|-------------|
|
||||
| `--id` | yes | Shared script ID |
|
||||
|
||||
#### `shared-script create`
|
||||
|
||||
Create a new shared script.
|
||||
|
||||
```sh
|
||||
scadalink --contact-points <uri> shared-script create --name <string> --code <string>
|
||||
```
|
||||
|
||||
| Option | Required | Description |
|
||||
|--------|----------|-------------|
|
||||
| `--name` | yes | Shared script name |
|
||||
| `--code` | yes | Script source code (or `@filepath` to read from file) |
|
||||
|
||||
#### `shared-script update`
|
||||
|
||||
Update a shared script's name or code.
|
||||
|
||||
```sh
|
||||
scadalink --contact-points <uri> shared-script update --id <int> [--name <string>] [--code <string>]
|
||||
```
|
||||
|
||||
| Option | Required | Description |
|
||||
|--------|----------|-------------|
|
||||
| `--id` | yes | Shared script ID |
|
||||
| `--name` | no | Updated script name |
|
||||
| `--code` | no | Updated script source code (or `@filepath`) |
|
||||
|
||||
#### `shared-script delete`
|
||||
|
||||
Delete a shared script.
|
||||
|
||||
```sh
|
||||
scadalink --contact-points <uri> shared-script delete --id <int>
|
||||
```
|
||||
|
||||
| Option | Required | Description |
|
||||
|--------|----------|-------------|
|
||||
| `--id` | yes | Shared script ID |
|
||||
|
||||
---
|
||||
|
||||
### `db-connection` — Manage database connections
|
||||
|
||||
#### `db-connection list`
|
||||
|
||||
List all database connection definitions.
|
||||
|
||||
```sh
|
||||
scadalink --contact-points <uri> db-connection list
|
||||
```
|
||||
|
||||
#### `db-connection get`
|
||||
|
||||
Get a single database connection by ID.
|
||||
|
||||
```sh
|
||||
scadalink --contact-points <uri> db-connection get --id <int>
|
||||
```
|
||||
|
||||
| Option | Required | Description |
|
||||
|--------|----------|-------------|
|
||||
| `--id` | yes | Database connection ID |
|
||||
|
||||
#### `db-connection create`
|
||||
|
||||
Create a new database connection definition.
|
||||
|
||||
```sh
|
||||
scadalink --contact-points <uri> db-connection create --name <string> --connection-string <string> [--provider <string>]
|
||||
```
|
||||
|
||||
| Option | Required | Description |
|
||||
|--------|----------|-------------|
|
||||
| `--name` | yes | Connection name |
|
||||
| `--connection-string` | yes | Database connection string |
|
||||
| `--provider` | no | Database provider (default: `SqlServer`) |
|
||||
|
||||
#### `db-connection update`
|
||||
|
||||
Update a database connection definition.
|
||||
|
||||
```sh
|
||||
scadalink --contact-points <uri> db-connection update --id <int> [--name <string>] [--connection-string <string>] [--provider <string>]
|
||||
```
|
||||
|
||||
| Option | Required | Description |
|
||||
|--------|----------|-------------|
|
||||
| `--id` | yes | Database connection ID |
|
||||
| `--name` | no | Updated connection name |
|
||||
| `--connection-string` | no | Updated connection string |
|
||||
| `--provider` | no | Updated database provider |
|
||||
|
||||
#### `db-connection delete`
|
||||
|
||||
Delete a database connection definition.
|
||||
|
||||
```sh
|
||||
scadalink --contact-points <uri> db-connection delete --id <int>
|
||||
```
|
||||
|
||||
| Option | Required | Description |
|
||||
|--------|----------|-------------|
|
||||
| `--id` | yes | Database connection ID |
|
||||
|
||||
---
|
||||
|
||||
### `api-method` — Manage inbound API methods
|
||||
|
||||
#### `api-method list`
|
||||
|
||||
List all inbound API method definitions.
|
||||
|
||||
```sh
|
||||
scadalink --contact-points <uri> api-method list
|
||||
```
|
||||
|
||||
#### `api-method get`
|
||||
|
||||
Get a single inbound API method by ID.
|
||||
|
||||
```sh
|
||||
scadalink --contact-points <uri> api-method get --id <int>
|
||||
```
|
||||
|
||||
| Option | Required | Description |
|
||||
|--------|----------|-------------|
|
||||
| `--id` | yes | API method ID |
|
||||
|
||||
#### `api-method create`
|
||||
|
||||
Create a new inbound API method.
|
||||
|
||||
```sh
|
||||
scadalink --contact-points <uri> api-method create --name <string> --code <string> [--description <string>]
|
||||
```
|
||||
|
||||
| Option | Required | Description |
|
||||
|--------|----------|-------------|
|
||||
| `--name` | yes | Method name (used as the URL path segment in `POST /api/{methodName}`) |
|
||||
| `--code` | yes | Script source code implementing the method (or `@filepath` to read from file) |
|
||||
| `--description` | no | Method description |
|
||||
|
||||
#### `api-method update`
|
||||
|
||||
Update an inbound API method.
|
||||
|
||||
```sh
|
||||
scadalink --contact-points <uri> api-method update --id <int> [--name <string>] [--code <string>] [--description <string>]
|
||||
```
|
||||
|
||||
| Option | Required | Description |
|
||||
|--------|----------|-------------|
|
||||
| `--id` | yes | API method ID |
|
||||
| `--name` | no | Updated method name |
|
||||
| `--code` | no | Updated script source code (or `@filepath`) |
|
||||
| `--description` | no | Updated description |
|
||||
|
||||
#### `api-method delete`
|
||||
|
||||
Delete an inbound API method.
|
||||
|
||||
```sh
|
||||
scadalink --contact-points <uri> api-method delete --id <int>
|
||||
```
|
||||
|
||||
| Option | Required | Description |
|
||||
|--------|----------|-------------|
|
||||
| `--id` | yes | API method ID |
|
||||
|
||||
---
|
||||
|
||||
## Architecture Notes
|
||||
|
||||
The CLI connects to the Central cluster using Akka.NET's `ClusterClient`. It does not join the cluster — it contacts the `ClusterClientReceptionist` on one of the configured Central nodes and sends commands to the `ManagementActor` at path `/user/management`.
|
||||
|
||||
Reference in New Issue
Block a user