v1

latestOpenAPI 3.0.0Creative Commons Attribution 3.02026-07-1392335.1 KB
projects

Creates a new execution using the latest revision of the given workflow. For more information, see Execute a workflow.

post/v1/{+parent}/executions

Path parameters

parentstring required

Required. Name of the workflow for which an execution should be created. Format: projects/{project}/locations/{location}/workflows/{workflow} The latest revision of the workflow will be used.

Request body

startTimestring google-datetime

Output only. Marks the beginning of execution. Note that this will be the same as createTime for executions that start immediately.

resultstring

Output only. Output of the execution represented as a JSON string. The value can only be present if the execution's state is SUCCEEDED.

durationstring google-duration

Output only. Measures the duration of the execution.

callLogLevel'CALL_LOG_LEVEL_UNSPECIFIED' | 'LOG_ALL_CALLS' | 'LOG_ERRORS_ONLY' | 'LOG_NONE'

The call logging level associated to this execution.

executionHistoryLevel'EXECUTION_HISTORY_LEVEL_UNSPECIFIED' | 'EXECUTION_HISTORY_BASIC' | 'EXECUTION_HISTORY_DETAILED'

Optional. Describes the execution history level to apply to this execution. If not specified, the execution history level is determined by its workflow's execution history level. If the levels are different, the executionHistoryLevel overrides the workflow's execution history level for this execution.

state'STATE_UNSPECIFIED' | 'ACTIVE' | 'SUCCEEDED' | 'FAILED' | 'CANCELLED' | 'UNAVAILABLE' | 'QUEUED'

Output only. Current state of the execution.

disableConcurrencyQuotaOverflowBufferingboolean

Optional. If set to true, the execution will not be backlogged when the concurrency quota is exhausted. The backlog execution starts when the concurrency quota becomes available.

createTimestring google-datetime

Output only. Marks the creation of the execution.

argumentstring

Input parameters of the execution represented as a JSON string. The size limit is 32KB. Note: If you are using the REST API directly to run your workflow, you must escape any JSON string value of argument. Example: '{"argument":"{\"firstName\":\"FIRST\",\"lastName\":\"LAST\"}"}'

namestring

Output only. The resource name of the execution. Format: projects/{project}/locations/{location}/workflows/{workflow}/executions/{execution}

endTimestring google-datetime

Output only. Marks the end of execution, successful or not.

workflowRevisionIdstring

Output only. Revision of the workflow this execution is using.

labelsobject

Labels associated with this execution. Labels can contain at most 64 entries. Keys and values can be no longer than 63 characters and can only contain lowercase letters, numeric characters, underscores, and dashes. Label keys must start with a letter. International characters are allowed. By default, labels are inherited from the workflow but are overridden by any labels associated with the execution.

Response

Successful response