Manage job executions

This page describes how to manage job executions. To execute a job, see Execute jobs.

View job executions in your project

You can view a list of the job executions in your project using Google Cloud console or Google Cloud CLI:

Console

To view the list of executions for a job:

  1. Go to the Cloud Run jobs page

  2. In the list, locate the job whose executions you want to manage.

  3. Click the job to display the executions list.

  4. In the execution details page, locate the execution you are interested in from the list. You can optionally use the filter set to a desired criteria, for example, Status with a value of completed:

Command line

To list all of the job executions for all jobs in your project:

gcloud run jobs executions list

To list only the executions for a specific job:

gcloud run jobs executions list --job JOB_NAME

Replace JOB_NAME with the name of the job you are filtering on.

For other ways to refine the returned list, including the use of filters, see jobs executions list.

To get the name of the latest execution for a specific job, use the --format flag:

gcloud run jobs describe JOB_NAME --format="value(status.latestCreatedExecution.name)"

Replace JOB_NAME with the name of the job you are filtering on.

View job execution details

You can view job execution details for the most recent 10,000 executions of a job using the execution details pane, along with any executions that occurred within the last seven days. Older execution details are removed and are no longer visible in the execution details pane. However, the logs and monitoring data for older executions are still available in Cloud Logging and Cloud Monitoring, subject to the retention policies for those products.

You can use the Google Cloud console or Google Cloud CLI to see more details about a job execution.

Console

To view details for a specific job execution:

  1. Go to the Cloud Run jobs page

  2. Locate the job execution you are interested in.

  3. Click the job execution to display the execution details page.

  4. Note the Tasks, Logs, Configuration, and YAML tabs.

    • Tasks shows information about the tasks in the job execution.
    • Logs shows the logs related to the execution.
    • Configuration shows information about the job, the container, security, connectivity and so forth used in the execution.
    • YAML shows the configuration of the job in YAML format.

Command line

To view details about a job execution:

Use the command:

gcloud run jobs executions describe EXECUTION_NAME

Replace EXECUTION_NAME with the name of the execution.

You can use the --format flag to format the output and to get additional information. For example as YAML:

gcloud run jobs executions describe EXECUTION_NAME --format yaml

Stop (delete) a job execution

You can stop a running job execution by deleting it. You can also delete job executions that have completed.

Although a deleted execution does not appear in the list of executions, its logs continue to be available in Cloud Logging for the remainder of the log retention period, and monitoring data continues to be available in Cloud Monitoring.

Console

To delete a job execution:

  1. Go to the Cloud Run jobs page

  2. Locate the job execution you want to delete.

  3. Click Delete.

  4. When prompted to confirm the deletion, click Confirm.

Command line

To delete a job execution:

  1. Use the command:

    gcloud run jobs executions delete EXECUTION_NAME

    Replace EXECUTION_NAME with the name of the execution.

  2. If prompted to confirm, respond y. Upon success, a success message will be displayed.