Structures
|
Parameter |
Mandatory or Optional |
Type |
Description |
Constraint |
|---|---|---|---|---|
|
payload_filter_request |
Optional |
String |
Path for filtering event parameters. The default value is $. |
Valid JSONPath format |
|
payload_filter_response |
Optional |
String |
Path for filtering event results. The default value is $. |
Valid JSONPath format |
|
event_source |
Mandatory |
String |
Type of source event |
Enumerated value. Only OBS is supported. |
|
trigger_type |
Optional |
Array String |
List of OBS event types |
Enumerated value. OBS event type description. |
|
trigger_prefix |
Optional |
String |
Prefix of an OBS event trigger |
Regular expressions are not supported. |
|
trigger_suffix |
Optional |
String |
Suffix of an OBS event trigger |
Regular expressions are not supported. |
|
trigger_bucket |
Optional |
String |
Bucket triggered by specific OBS events |
The bucket must be an existing one. |
|
Parameter |
Mandatory or Optional |
Type |
Constraint |
Description |
|---|---|---|---|---|
|
parameter_name |
Mandatory |
String |
The value contains 1 to 20 characters. Only lowercase letters, digits, and hyphens (-) are allowed. |
Parameter name. You can define a maximum of 60 parameter names, and each name is unique. |
|
type |
Mandatory |
|
- |
Parameter type |
|
description |
Optional |
String |
The value contains 0 to 256 characters. |
Parameter description information |
|
default |
Optional |
String |
The default value can be replaced by an external input when a workflow instance is created. If the default value is not specified, the value of this parameter must be entered. |
The default value type should be consistent with the defined parameter type. If they are inconsistent, the parser automatically converts their types, leading to unexpected results. |
|
label |
Optional |
String |
String length: 0 to 64 characters |
Label of a parameter. The labels defined here can be displayed by category during stack creation. |
|
constraints |
Optional |
map |
- |
Parameter constraint, which is used to define the valid value range of an input parameter. |
|
invisible |
Optional |
Boolean |
If this parameter is set to true, the return value is ******. |
Specifies whether to display the command output. |
|
Parameter |
Mandatory or Optional |
Type |
Description |
Constraint |
|---|---|---|---|---|
|
start |
Optional |
bool |
Indicates the start state. In the figure, there must be only one state whose start value is true. |
There is only one state whose start value is true. |
|
type |
Mandatory |
string |
DELAY, SWITCH, OPERATION, EVENT, END, Noop |
Enumerated |
|
payload_filter_in |
Optional |
string |
Specifies whether to filter input parameters. The default value is $, indicating no filtering for input parameters. |
Valid JSONPath format |
|
payload_filter_out |
Optional |
string |
Specifies whether to filter the state output. The default value is $, indicating no filtering for state output. |
Valid JSONPath format |
|
state_name |
Mandatory |
string |
State name definition |
The value contains 1 to 20 characters. Only lowercase letters, digits, and hyphens (-) are allowed. |
The END state does not have the payload_filter_in and payload_filter_out attributes.
|
Parameter |
Mandatory or Optional |
Type |
Description |
Constraint |
|---|---|---|---|---|
|
events |
Mandatory |
Array |
JSON array that defines the event messages in a queue. Each array member is an event message object. |
- |
|
event_timeout |
Optional |
int |
Maximum waiting time for an event. Unit: seconds. 0 indicates that this parameter is not specified. The default value is 30s. |
The value is an integer ranging from 0 to 86400. |
|
Parameter |
Mandatory or Optional |
Type |
Description |
Constraint |
|---|---|---|---|---|
|
action_mode |
Optional |
String |
Specifies in which mode are actions invoked. The options are PARALLEL or SEQUENTIAL. The default value is SEQUENTIAL. |
The value can be PARALLEL or SEQUENTIAL. |
|
actions |
Mandatory |
Array |
JSON array that defines an action. |
One or more actions must be defined. |
|
next_state |
Mandatory |
String |
Name of the next state, which is a string and must exist in the graph definition |
The value must be a state name in a workflow. |
|
Parameter |
Mandatory or Optional |
Type |
Description |
Constraint |
|---|---|---|---|---|
|
default |
Mandatory |
String |
Specifies that if no branch is matched, the workflow is transferred to the node specified by default. |
The value must be a state name in a workflow. |
|
choices |
Mandatory |
Array |
Path choices |
There must be path choices and the choices.size value must be greater than 0. |
|
Parameter |
Mandatory or Optional |
Type |
Description |
Constraint |
|---|---|---|---|---|
|
time_delay |
Mandatory |
String |
Waiting time, in seconds. The value is an integer. |
The value ranges from 0 and to 86400. |
|
next_state |
Mandatory |
String |
Name of the next state, which is a string and must exist in the graph definition |
The value must be a state name in a workflow template. |
|
Parameter |
Mandatory or Optional |
Type |
Description |
Constraint |
|---|---|---|---|---|
|
action_name |
Mandatory |
String |
Action name |
The value must be unique in a state. The action name is a string of 1 to 20 characters containing only digits, letters, hyphens (-), and underscores (_). |
|
function |
Mandatory |
String |
URN of a user-defined function |
You can set it for either function or function-template. |
|
function_template |
Mandatory |
String |
URN of the built-in function template |
You can set it for either function or function-template. |
|
invocation_mode |
Optional |
String |
Specifies the mode in which an action is invoked. |
The value must be SYNC or ASYNC. |
|
results |
Optional |
Array |
Retry mechanism after an action failure |
The value is a JSON array that contains the result definition. If the results exist, the value is greater than or equal to 0. |
|
timeout |
Optional |
Int |
Timeout interval of an action, or the maximum waiting duration. The default value is 30s. |
The value is an integer ranging from 0 to 300. 0 indicates that this parameter is not specified. |
|
payload_filter |
Optional |
String |
Filtering path of results. The default value is $. |
Valid JSONPath format |
|
dynamic_source |
Optional |
Map |
When a workflow is being created, a function based on the user-defined function template can be created and parameter values can be specified. |
The value must be a specified parameter name. Otherwise, the parameter does not take effect. |
|
Parameter |
Mandatory or Optional |
Type |
Description |
Constraint |
|---|---|---|---|---|
|
match |
Mandatory |
String |
Errors in matching |
MatchAny, States.ActionFailed, States.PermissionError, States.ParameterError, States.NotFound, States.TooManyRequests, States.FunctionStageUnavailable, States.FunctionStageOtherErrors |
|
retry_interval |
Optional |
Int |
Retry interval, in seconds. |
The value is an integer greater than or equal to 0. |
|
max_retry |
Optional |
Int |
Maximum number of retry times. If this parameter is not set, the default value 3 is used. 0 indicates no retries. |
The value is an integer greater than or equal to 0. |
|
next_state |
Optional |
String |
Name of the next state, which is a string and must exist in the graph definition |
The value must be a state name in a workflow template. |
|
is_terminal |
Mandatory |
Bool |
Specifies whether to interrupt an action in case of an exception. The default value is False. |
True: needless to specify the next-state; False: The next-state must be specified. |
|
Parameter |
Mandatory or Optional |
Type |
Description |
Constraint |
|---|---|---|---|---|
|
event_expression |
Mandatory |
String |
Waiting event ID |
The value must be the name of an event in event-ref that exists in the event definition. |
|
action_mode |
Optional |
String |
Specifies in which mode are actions invoked. The options are PARALLEL or SEQUENTIAL. The default value is SEQUENTIAL. |
The value can be PARALLEL or SEQUENTIAL. |
|
actions |
Optional |
Array |
JSON array that defines an action. |
If this field exists, it should contain 0 or more actions. |
|
next_state |
Mandatory |
String |
Name of the next state, which is a string and must exist in the graph definition |
The value must be a state name in a workflow template. |
|
Parameter |
Mandatory or Optional |
Type |
Description |
Constraint |
|---|---|---|---|---|
|
path |
Mandatory |
string |
It is used to obtain a value from the output of the previous node and then compare it with the user-defined value. |
- |
|
value |
Mandatory |
string |
User-defined value |
- |
|
next_state |
Mandatory |
string |
Name of the next state after matching |
The value must be a state name in a workflow template. |
|
Parameter |
Mandatory or Optional |
Type |
Description |
Constraint |
|---|---|---|---|---|
|
key |
Mandatory |
String |
Tag key |
A tag name contains 1 to 256 characters. Only letters, digits, underscores (_), and hyphens (-) are allowed. |
|
value |
Mandatory |
String |
Tag value |
A tag value is a string of 1 to 256 characters. |
|
Parameter |
Type |
Description |
|---|---|---|
|
name |
String |
Workflow name |
|
created_at |
String |
Creation time of a workflow template recorded in the system |
|
Parameter |
Type |
Description |
|---|---|---|
|
name |
String |
Workflow name |
|
created_at |
String |
Creation time of a workflow template recorded in the system |
|
graph_urn |
String |
Workflow URN |
|
Parameter |
Mandatory or Optional |
Type |
Description |
Constraint |
|---|---|---|---|---|
|
id |
Mandatory |
String |
Policy rule ID |
A rule ID contains 1 to 256 characters. Only letters, digits, underscores (_), and hyphens (-) are allowed. Each rule ID must be unique in a policy. |
|
graph_urn |
Mandatory |
String |
Workflow URN |
You need to create the workflow first. |
|
events |
Mandatory |
Array |
OBS event list. For details, see the description about OBS event types. |
- |
|
prefix |
Optional |
String |
Object name prefix |
Key word of object names. Based on the prefix defined by this parameter, enter the key word for filtering objects. A longer string of characters delivers a more accurate filtering result. A maximum of 1024 characters are supported. It also can be empty. In addition, the total length of the prefix and suffix cannot exceed 1024 characters. |
|
suffix |
Optional |
String |
Suffix of an object name |
Key word of object names. Based on the suffix defined by this parameter, enter the key word for filtering objects. A longer string of characters delivers a more accurate filtering result. A maximum of 1024 characters are supported. It also can be empty. In addition, the total length of the prefix and suffix cannot exceed 1024 characters. |
|
Parameter |
Type |
Description |
|---|---|---|
|
graph_urn |
String |
Workflow URN |
|
execution_urn |
String |
URN of a running instance |
|
started_at |
String |
Start time of a running instance |
|
stopped_at |
String |
Specifies the time when the instance stops running. This parameter is optional. |
|
execution_state |
String |
Overall status of running instances |
|
execution_type |
String |
Trigger type of a running instance. Value options: APICALL, TRIGGERCALL |
|
start_state |
String |
First node of a workflow |
|
isTest |
bool |
Specifies whether an instance is started by starting a workflow test. If yes, the value is true. |
|
execution_name |
String |
Name of a running instance |
|
output |
String |
Output of a running instance. This field does not exist when the current instance is running. |
|
input |
String |
Input when an instance starts running |
|
state_map |
Dictionary |
Includes information about each state. For details, see parameters in the ExecutionState structure. |
Parameters in the ExecutionState
|
Parameter |
Type |
Description |
|---|---|---|
|
key |
String |
Name of a workflow node. The name is user-defined without a fixed format, for example, next1. |
|
state_name |
String |
Name of a state |
|
status |
String |
Status of the current state |
|
started_at |
String |
Start time of a state |
|
stopped_at |
String |
End time of a state. This parameter is optional. |
|
type |
String |
Type of a state |
|
input |
String |
Input when current state starts. This parameter is optional. When a state is stopped, this parameter is contained. |
|
output |
String |
Output when the current state starts |
Last Article: Deleting a Bucket Trigger
Next Article: Other APIs
Did this article solve your problem?
Thank you for your score!Your feedback would help us improve the website.