Create a job.
This method waits—the workflow execution is paused—until the operation is
complete, fails, or times out. The default timeout value is 1800
seconds (30
minutes) and can be changed to a maximum value of 31536000
seconds (one year)
for long-running operations using the connector_params
field. See the Connectors reference
.
The connector uses polling to monitor the long-running operation, which might generate additional billable steps. For more information about retries and long-running operations, refer to Understand connectors .
The polling policy for the long-running operation can be configured. To set the
connector-specific parameters ( connector_params
), refer to Invoke a connector call
.
Arguments
parent
string
Required. The namespace in which the job should be created. Replace {namespace} with the project ID or number. It takes the form namespaces/{namespace}. For example: namespaces/PROJECT_ID
location
string
Location of the HTTP endpoint. For example, us-central1
or asia-southeast1
. If not set, the global endpoint https://run.googleapis.com will be used, which supports list methods only. See service endpoints
for more location options.
body
object ( Job
)
Required.
Raised exceptions
ConnectionError
HttpError
TimeoutError
TypeError
ValueError
OperationError
ResponseTypeError
Response
If successful, the response contains an instance of Job
.
Subworkflow snippet
Some fields might be optional or required. To identify required fields, refer to the API documentation .
YAML
- create : call : googleapis.run.v1.namespaces.jobs.create args : parent : ... body : apiVersion : ... kind : ... metadata : annotations : ... clusterName : ... creationTimestamp : ... deletionGracePeriodSeconds : ... deletionTimestamp : ... finalizers : ... generateName : ... generation : ... labels : ... name : ... namespace : ... ownerReferences : ... resourceVersion : ... selfLink : ... uid : ... spec : runExecutionToken : ... startExecutionToken : ... template : metadata : ... spec : parallelism : ... taskCount : ... template : spec : containers : ... maxRetries : ... serviceAccountName : ... timeoutSeconds : ... volumes : ... result : createResult
JSON
[ { "create" : { "call" : "googleapis.run.v1.namespaces.jobs.create" , "args" : { "parent" : "..." , "body" : { "apiVersion" : "..." , "kind" : "..." , "metadata" : { "annotations" : "..." , "clusterName" : "..." , "creationTimestamp" : "..." , "deletionGracePeriodSeconds" : "..." , "deletionTimestamp" : "..." , "finalizers" : "..." , "generateName" : "..." , "generation" : "..." , "labels" : "..." , "name" : "..." , "namespace" : "..." , "ownerReferences" : "..." , "resourceVersion" : "..." , "selfLink" : "..." , "uid" : "..." }, "spec" : { "runExecutionToken" : "..." , "startExecutionToken" : "..." , "template" : { "metadata" : "..." , "spec" : { "parallelism" : "..." , "taskCount" : "..." , "template" : { "spec" : { "containers" : "..." , "maxRetries" : "..." , "serviceAccountName" : "..." , "timeoutSeconds" : "..." , "volumes" : "..." } } } } } } }, "result" : "createResult" } } ]
