Create a Device Configuration Action
post
/api/config/Actions
Creates a new device configuration action.
The minimum required properties in the request body are:
The minimum required properties in the request body are:
- ActionName
- Actions
- ResultTimeout
Request
There are no request parameters for this operation.
Supported Media Types
- application/json
Root Schema : schema
Type:
Show Source
object
-
ActionName: string
The action name.
To avoid confusion with numeric IDs, the name value cannot be integers only or integers prefixed with the + or - symbols only. It must contain letters or other characters. For example, 1234, +1234, and -1234 are not valid, but US1234, US+1234 and US_1234 are.Example:Example Action Name
-
Actions: array
Actions
-
ResultTimeout: integer
The timeout for all commands.Example:
30
Nested Schema : items
Type:
Show Source
object
-
ActionOrder: integer
The 0-based order to run commands.Example:
1
-
ConfigActionProfileID: integer
The ID linking the action back to the parent actions profile.Example:
2
-
DisplayActionOutput: boolean
Whether to save the output of a command or not.Example:
0
-
ReadAction: string
For Telnet actions only. The prompt to use before running the command. The default is #.Example:
Example Read Action
-
WriteAction: string
The command to run.Example:
Example Write Action
Response
Supported Media Types
- application/json
200 Response
Successful operation
Root Schema : schema
Match All
Show Source
-
object
SuccessfulAddOperation
The response body for a successful add operation.
-
object
type
Nested Schema : SuccessfulAddOperation
Type:
object
The response body for a successful add operation.
Show Source
-
message: string
The response message.Example:
Added record
-
success: boolean
Whether the operation was a success (true) or a failure (false).Example:
true
Nested Schema : type
Type:
Show Source
object
-
data: array
data
The properties of the new device configuration action.
-
total: integer
The total number of results regardless of paging.Example:
1
Nested Schema : configActionsRead
Type:
Show Source
object
-
ActionCount: integer
The number of actions to be executed.Example:
1
-
ActionName: string
The descriptor for the group of actions to be run.Example:
Example Action Name
-
Actions: array
Actions
-
ConfigActionProfileID: integer
The configuration action profile ID.Example:
1001
-
ResultTimeout: integer
The timeout for all commands.Example:
30
Nested Schema : items
Type:
Show Source
object
-
ActionOrder: integer
The 0-based order to run commands.Example:
1
-
ConfigActionProfileID: integer
The ID linking the action back to the parent actions profile.Example:
2
-
DisplayActionOutput: boolean
Whether to save the output of a command or not.Example:
0
-
ReadAction: string
For Telnet actions only. The prompt to use before running the command. The default is #.Example:
Example Read Action
-
WriteAction: string
The command to run.Example:
Example Write Action
Default Response
Failed operation
Root Schema : schema
Type:
Show Source
object
-
errors: array
errors
The list of errors reported. Validation errors will be keyed by record field.
-
message: string
The response message.Example:
Exception thrown
-
success: boolean
Whether the operation was a success (true) or a failure (false).Example:
false
Nested Schema : errors
Type:
array
The list of errors reported. Validation errors will be keyed by record field.
Show Source
-
Array of:
object items
An error.
Nested Schema : items
Type:
object
An error.