projects

Changed on

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

post/v1/{+parent}/executions

Request

  • Base URL: https://workflowexecutions.googleapis.com
  • URL: https://workflowexecutions.googleapis.com/v1/{+parent}/executions
  • Auth: OAuth 2 (implicit, authorization URL https://accounts.google.com/o/oauth2/auth, scopes: https://www.googleapis.com/auth/cloud-platform) and OAuth 2 (authorization code, authorization URL https://accounts.google.com/o/oauth2/auth, token URL https://accounts.google.com/o/oauth2/token, scopes: https://www.googleapis.com/auth/cloud-platform)

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

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\"}"}'

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

The call logging level associated to this execution.

createTimestring google-datetime

Output only. Marks the creation 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.

durationstring google-duration

Output only. Measures the duration of the execution.

endTimestring google-datetime

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

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.

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.

namestring

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

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.

startTimestring google-datetime

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

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

Output only. Current state of the execution.

workflowRevisionIdstring

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

Response

Successful response

Changes

  • 4cf83e18b685Revision changes
    • breaking

      removed the request body

    • breaking

      removed the media type */* for the response with the status