Manage job executions

This page describes how to view and delete job executions. To execute, cancel,or override a job configuration, seeExecute jobs.

Required roles

To get the permissions that you need to manage Cloud Run jobs, ask your administrator to grant you theCloud Run Developer (roles/run.developer) IAM role on your Cloud Run job.

For a list of IAM roles and permissions that are associated withCloud Run, seeCloud Run IAM rolesandCloud Run IAM permissions.If your Cloud Run job interfaces withGoogle Cloud APIs, such as Cloud Client Libraries, see theservice identity configuration guide.For more information about granting roles, seedeployment permissionsandmanage access.

View job executions in your project

You can view a list of the job executions in your project usingGoogle 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 youwant to manage.

  3. Click the job to display the executions list.

  4. In the execution details page, select the execution you are interested infrom the list. You can optionally use the filter set to a desired criteria, forexample,Status with a value ofcompleted:

gcloud

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

gcloudrunjobsexecutionslist

To list only the executions for a specific job:

gcloudrunjobsexecutionslist--jobJOB_NAME

ReplaceJOB_NAME with the name of the job you arefiltering on.

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

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

gcloudrunjobsdescribeJOB_NAME--format="value(status.latestCreatedExecution.name)"

ReplaceJOB_NAME with the name of the job you arefiltering on.

Client libraries

To list all of the job executions from code:

REST API

To list job executions, send aGET HTTP request tothe Cloud Run Admin APIjobs endpoint.

For example, usingcurl:

curl-H"Content-Type: application/json"\-H"Authorization: BearerACCESS_TOKEN"\-XGET\-d''\https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/jobs/JOB-NAME/executions

Replace:

  • ACCESS_TOKEN with a valid access token for an account thathas theIAM permissions to view job executions.For example, if you are logged into gcloud, you can retrieve anaccess token usinggcloud auth print-access-token.From within a Cloud Run container instance, you can retrievean access token using thecontainer instance metadata server.
  • JOB-NAME with the name of the job.
  • REGION with the Google Cloud region of the job.
  • PROJECT-ID with the Google Cloud project ID.

View job execution details

You can view job execution details for the most recent 1,000 executions of a jobusing theexecution details pane.Older execution details are removed and are no longer visible in the executiondetails pane. However, the logs and monitoring data for olderexecutions are still available inCloud Logging andCloud Monitoring, subject to the retention policiesfor those products.

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

Console

To view details for a specific job execution:

  1. Go to the Cloud Run jobs page

  2. Click the job to open the job details pane.

  3. Click the job execution you want to view. The execution details areshown in the right hand panel.

  4. Note theTasks,Containers,Volumes,Networking,Security, andYAML, tabs, and also theView Logs link.

    • Tasks shows information about the tasks in the job execution.
    • YAML shows the configuration of the job in YAML format.
    • Click theView Logs link to see the logs related to the execution.
    • The other tabs show information about the job, container, security,connectivity and so forth used in the execution.

gcloud

To view details about a job execution:

Use the command:

gcloudrunjobsexecutionsdescribeEXECUTION_NAME

ReplaceEXECUTION_NAME with the name of the execution.

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

gcloudrunjobsexecutionsdescribeEXECUTION_NAME--formatyaml

Client libraries

To view job execution details from code:

REST API

To view job execution details, send aGET HTTP request tothe Cloud Run Admin APIjobs endpoint.

For example, usingcurl:

curl-H"Content-Type: application/json"\-H"Authorization: BearerACCESS_TOKEN"\-XGET\-d''\https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/jobs/JOB-NAME/executions/EXECUTION-NAME

Replace:

  • ACCESS_TOKEN with a valid access token for an account thathas theIAM permissions to view job execution details.For example, if you are logged into gcloud, you can retrieve anaccess token usinggcloud auth print-access-token.From within a Cloud Run container instance, you can retrievean access token using thecontainer instance metadata server.
  • JOB-NAME with the name of the job.
  • EXECUTION-NAME with the name of the job execution.
  • REGION with the Google Cloud region of the job.
  • PROJECT-ID with the Google Cloud project ID.

Delete a job execution

You can delete a job execution, even during an execution. If you deletean execution, it stops the execution from continuing.

Note: In comparison, if you use the job executioncancel method to stop the current job execution, the job execution remains in the list of job executions.

Although a deleted execution does notappear in the list of executions, its logs continue to be available inCloud Logging for the remainder of the log retentionperiod, and monitoring data continues to be available inCloud Monitoring.

Console

To delete a job execution:

  1. Go to the Cloud Run jobs page

  2. Click the job to open the job details pane.

  3. Select the job execution you want to delete.

  4. Under theActions menu, click the ellipsis icon, then clickDelete.

  5. If prompted to confirm the deletion, clickConfirm.

gcloud

To delete a job execution:

  1. Use the command:

    gcloudrunjobsexecutionsdeleteEXECUTION_NAME

    ReplaceEXECUTION_NAME with the name of the execution.

  2. If prompted to confirm, respondy. Upon success, a success messagewill be displayed.

Client libraries

To delete a job execution from code:

REST API

To delete a job execution, send aDELETE HTTP request to request tothe Cloud Run Admin APIjobs endpoint

For example, usingcurl:

curl-H"Content-Type: application/json"\-H"Authorization: BearerACCESS_TOKEN"\-XDELETE\-d''\https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/jobs/JOB-NAME/executions/EXECUTION-NAME

Replace:

  • ACCESS_TOKEN with a valid access token for an account thathas theIAM permissions to delete job executions.For example, if you are logged into gcloud, you can retrieve anaccess token usinggcloud auth print-access-token.From within a Cloud Run container instance, you can retrievean access token using thecontainer instance metadata server.
  • JOB_NAME with the name of the job.
  • EXECUTION-NAME with the name of the job execution.
  • REGION with the Google Cloud region of the job.
  • PROJECT-ID with the Google Cloud project ID.

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2026-02-19 UTC.