Creates 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](https://docs.cloud.google.com/workflows/docs/reference/googleapis).

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](https://docs.cloud.google.com/workflows/docs/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](https://docs.cloud.google.com/workflows/docs/reference/googleapis#invoke_a_connector_call).

## Arguments

| Parameters ||
|---|---|
| `parent` | `string` Required. The location and project in which this Job should be created. Format: projects/{project}/locations/{location}, where {project} can be project id or number. |
| `jobId` | `string` Required. The unique identifier for the Job. The name of the job becomes {parent}/jobs/{job_id}. |
| `validateOnly` | `boolean` Indicates that the request should be validated and default values populated, without persisting the request or creating any resources. |
| `body` | `object (https://cloud.google.com/workflows/docs/reference/googleapis/run/v2/Overview#GoogleCloudRunV2Job)` Required. |

## Raised exceptions

| Exceptions ||
|---|---|
| `ConnectionError` | In case of a network problem (such as DNS failure or refused connection). |
| `HttpError` | If the response status is \>= 400 (excluding 429 and 503). |
| `TimeoutError` | If a long-running operation takes longer to finish than the specified timeout limit. |
| `TypeError` | If an operation or function receives an argument of the wrong type. |
| `ValueError` | If an operation or function receives an argument of the right type but an inappropriate value. For example, a negative timeout. |
| `OperationError` | If the long-running operation finished unsuccessfully. |
| `ResponseTypeError` | If the long-running operation returned a response of the wrong type. |

## Response

If successful, the response contains an instance of [`GoogleLongrunningOperation`](https://cloud.google.com/workflows/docs/reference/googleapis/run/v2/Overview#GoogleLongrunningOperation).

## Subworkflow snippet

Some fields might be optional or required.
To identify required fields, refer to the [API documentation](https://cloud.google.com/run/docs/reference/rest/v2/projects.locations.jobs/create).

### YAML

```yaml
- create:
    call: googleapis.run.v2.projects.locations.jobs.create
    args:
        parent: ...
        jobId: ...
        validateOnly: ...
        body:
            annotations: ...
            binaryAuthorization:
                breakglassJustification: ...
                policy: ...
                useDefault: ...
            client: ...
            clientVersion: ...
            labels: ...
            launchStage: ...
            name: ...
            runExecutionToken: ...
            startExecutionToken: ...
            template:
                annotations: ...
                labels: ...
                parallelism: ...
                taskCount: ...
                template:
                    containers: ...
                    encryptionKey: ...
                    executionEnvironment: ...
                    maxRetries: ...
                    serviceAccount: ...
                    timeout: ...
                    volumes: ...
                    vpcAccess:
                        connector: ...
                        egress: ...
                        networkInterfaces: ...
    result: createResult
```

### JSON

```json
[
  {
    "create": {
      "call": "googleapis.run.v2.projects.locations.jobs.create",
      "args": {
        "parent": "...",
        "jobId": "...",
        "validateOnly": "...",
        "body": {
          "annotations": "...",
          "binaryAuthorization": {
            "breakglassJustification": "...",
            "policy": "...",
            "useDefault": "..."
          },
          "client": "...",
          "clientVersion": "...",
          "labels": "...",
          "launchStage": "...",
          "name": "...",
          "runExecutionToken": "...",
          "startExecutionToken": "...",
          "template": {
            "annotations": "...",
            "labels": "...",
            "parallelism": "...",
            "taskCount": "...",
            "template": {
              "containers": "...",
              "encryptionKey": "...",
              "executionEnvironment": "...",
              "maxRetries": "...",
              "serviceAccount": "...",
              "timeout": "...",
              "volumes": "...",
              "vpcAccess": {
                "connector": "...",
                "egress": "...",
                "networkInterfaces": "..."
              }
            }
          }
        }
      },
      "result": "createResult"
    }
  }
]
```