blob: 8b1eb5cc33b6872551862867759a1da5107924a1 [file] [log] [blame]
<html><body>
<style>
body, h1, h2, h3, div, span, p, pre, a {
margin: 0;
padding: 0;
border: 0;
font-weight: inherit;
font-style: inherit;
font-size: 100%;
font-family: inherit;
vertical-align: baseline;
}
body {
font-size: 13px;
padding: 1em;
}
h1 {
font-size: 26px;
margin-bottom: 1em;
}
h2 {
font-size: 24px;
margin-bottom: 1em;
}
h3 {
font-size: 20px;
margin-bottom: 1em;
margin-top: 1em;
}
pre, code {
line-height: 1.5;
font-family: Monaco, 'DejaVu Sans Mono', 'Bitstream Vera Sans Mono', 'Lucida Console', monospace;
}
pre {
margin-top: 0.5em;
}
h1, h2, h3, p {
font-family: Arial, sans serif;
}
h1, h2, h3 {
border-bottom: solid #CCC 1px;
}
.toc_element {
margin-top: 0.5em;
}
.firstline {
margin-left: 2 em;
}
.method {
margin-top: 1em;
border: solid 1px #CCC;
padding: 1em;
background: #EEE;
}
.details {
font-weight: bold;
font-size: 14px;
}
</style>
<h1><a href="workflowexecutions_v1.html">Workflow Executions API</a> . <a href="workflowexecutions_v1.projects.html">projects</a> . <a href="workflowexecutions_v1.projects.locations.html">locations</a> . <a href="workflowexecutions_v1.projects.locations.workflows.html">workflows</a></h1>
<h2>Instance Methods</h2>
<p class="toc_element">
<code><a href="workflowexecutions_v1.projects.locations.workflows.executions.html">executions()</a></code>
</p>
<p class="firstline">Returns the executions Resource.</p>
<p class="toc_element">
<code><a href="#close">close()</a></code></p>
<p class="firstline">Close httplib2 connections.</p>
<p class="toc_element">
<code><a href="#triggerPubsubExecution">triggerPubsubExecution(workflow, body=None, x__xgafv=None)</a></code></p>
<p class="firstline">Triggers a new execution using the latest revision of the given workflow by a Pub/Sub push notification.</p>
<h3>Method Details</h3>
<div class="method">
<code class="details" id="close">close()</code>
<pre>Close httplib2 connections.</pre>
</div>
<div class="method">
<code class="details" id="triggerPubsubExecution">triggerPubsubExecution(workflow, body=None, x__xgafv=None)</code>
<pre>Triggers a new execution using the latest revision of the given workflow by a Pub/Sub push notification.
Args:
workflow: string, Required. Name of the workflow for which an execution should be created. Format: projects/{project}/locations/{location}/workflows/{workflow} (required)
body: object, The request body.
The object takes the form of:
{ # Request for the TriggerPubsubExecution method.
&quot;GCPCloudEventsMode&quot;: &quot;A String&quot;, # Required. LINT: LEGACY_NAMES The query parameter value for __GCP_CloudEventsMode, set by the Eventarc service when configuring triggers.
&quot;message&quot;: { # A message that is published by publishers and consumed by subscribers. The message must contain either a non-empty data field or at least one attribute. Note that client libraries represent this object differently depending on the language. See the corresponding [client library documentation](https://cloud.google.com/pubsub/docs/reference/libraries) for more information. See [quotas and limits] (https://cloud.google.com/pubsub/quotas) for more information about message limits. # Required. The message of the Pub/Sub push notification.
&quot;attributes&quot;: { # Attributes for this message. If this field is empty, the message must contain non-empty data. This can be used to filter messages on the subscription.
&quot;a_key&quot;: &quot;A String&quot;,
},
&quot;data&quot;: &quot;A String&quot;, # The message data field. If this field is empty, the message must contain at least one attribute.
&quot;messageId&quot;: &quot;A String&quot;, # ID of this message, assigned by the server when the message is published. Guaranteed to be unique within the topic. This value may be read by a subscriber that receives a `PubsubMessage` via a `Pull` call or a push delivery. It must not be populated by the publisher in a `Publish` call.
&quot;orderingKey&quot;: &quot;A String&quot;, # If non-empty, identifies related messages for which publish order should be respected. If a `Subscription` has `enable_message_ordering` set to `true`, messages published with the same non-empty `ordering_key` value will be delivered to subscribers in the order in which they are received by the Pub/Sub system. All `PubsubMessage`s published in a given `PublishRequest` must specify the same `ordering_key` value.
&quot;publishTime&quot;: &quot;A String&quot;, # The time at which the message was published, populated by the server when it receives the `Publish` call. It must not be populated by the publisher in a `Publish` call.
},
&quot;subscription&quot;: &quot;A String&quot;, # Required. The subscription of the Pub/Sub push notification. Format: projects/{project}/subscriptions/{sub}
}
x__xgafv: string, V1 error format.
Allowed values
1 - v1 error format
2 - v2 error format
Returns:
An object of the form:
{ # A running instance of a [Workflow](/workflows/docs/reference/rest/v1/projects.locations.workflows).
&quot;argument&quot;: &quot;A String&quot;, # 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: `&#x27;{&quot;argument&quot;:&quot;{\&quot;firstName\&quot;:\&quot;FIRST\&quot;,\&quot;lastName\&quot;:\&quot;LAST\&quot;}&quot;}&#x27;`
&quot;callLogLevel&quot;: &quot;A String&quot;, # The call logging level associated to this execution.
&quot;endTime&quot;: &quot;A String&quot;, # Output only. Marks the end of execution, successful or not.
&quot;error&quot;: { # Error describes why the execution was abnormally terminated. # Output only. The error which caused the execution to finish prematurely. The value is only present if the execution&#x27;s state is `FAILED` or `CANCELLED`.
&quot;context&quot;: &quot;A String&quot;, # Human-readable stack trace string.
&quot;payload&quot;: &quot;A String&quot;, # Error message and data returned represented as a JSON string.
&quot;stackTrace&quot;: { # A collection of stack elements (frames) where an error occurred. # Stack trace with detailed information of where error was generated.
&quot;elements&quot;: [ # An array of stack elements.
{ # A single stack element (frame) where an error occurred.
&quot;position&quot;: { # Position contains source position information about the stack trace element such as line number, column number and length of the code block in bytes. # The source position information of the stack trace element.
&quot;column&quot;: &quot;A String&quot;, # The source code column position (of the line) the current instruction was generated from.
&quot;length&quot;: &quot;A String&quot;, # The number of bytes of source code making up this stack trace element.
&quot;line&quot;: &quot;A String&quot;, # The source code line number the current instruction was generated from.
},
&quot;routine&quot;: &quot;A String&quot;, # The routine where the error occurred.
&quot;step&quot;: &quot;A String&quot;, # The step the error occurred at.
},
],
},
},
&quot;name&quot;: &quot;A String&quot;, # Output only. The resource name of the execution. Format: projects/{project}/locations/{location}/workflows/{workflow}/executions/{execution}
&quot;result&quot;: &quot;A String&quot;, # Output only. Output of the execution represented as a JSON string. The value can only be present if the execution&#x27;s state is `SUCCEEDED`.
&quot;startTime&quot;: &quot;A String&quot;, # Output only. Marks the beginning of execution.
&quot;state&quot;: &quot;A String&quot;, # Output only. Current state of the execution.
&quot;workflowRevisionId&quot;: &quot;A String&quot;, # Output only. Revision of the workflow this execution is using.
}</pre>
</div>
</body></html>