Manage jobs

This page describes how to manage jobs. To create a job, seecreate jobs.To execute a job, 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 jobs in your project

You can view a list of the jobs in your project using one of the followingapproaches:

Console

To view jobs:

  1. Go to the Cloud Run jobs page.

  2. Optionally, filter the job by one of the criteria in the dropdown menu,such as job name, execution time, region, and so on.

gcloud

  1. To list all jobs in your project:

    gcloudrunjobslist

  2. To filter jobs by region:

    gcloudrunjobslist--regionREGION

    ReplaceREGION with the name of the region you arefiltering on, for exampleeurope-west1.

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

Client libraries

To view jobs in your project from code:

REST API

To view the list of jobs in your project, 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

Replace:

  • ACCESS_TOKEN with a valid access token for an account thathas theIAM permissions to view jobs.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.
  • REGION with the Google Cloud region of the job.
  • PROJECT-ID with the Google Cloud project ID.

View job details

Use the gcloud command line to see more details about a job.

Console

To view details for a specific job execution:

  1. Go to the Cloud Run jobs page

  2. Locate the job you are interested in.

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

  4. Note theHistory,Metrics,Logs,Triggers andYAML tabs.

    • TheHistory tab shows information about the tasks in the job execution.
    • Logs shows the logs information.
    • Metrics shows information about the job executions.
    • YAML shows the configuration of the job in YAML format.

gcloud

To view details about a job:

Use the command:

gcloudrunjobsdescribeJOB_NAME

ReplaceJOB_NAME with the name of the job.

Client libraries

To view details about a job from code:

REST API

To view details about a job, 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

Replace:

  • ACCESS_TOKEN with a valid access token for an account thathas theIAM permissions to view job 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.
  • REGION with the Google Cloud region of the job.
  • PROJECT-ID with the Google Cloud project ID.

Delete a job

Deleting a job terminates all the job executions in progress and all running container instances.

Although a deleted job no longer appears in the list of jobs, its logs continueto 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:

  1. Go to the Cloud Run jobs page

  2. Select the job.

  3. ClickDelete.

gcloud

To delete a job:

  1. Use the command:

    gcloudrunjobsdeleteJOB_NAME

    ReplaceJOB_NAME with the name of the job.

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

Client libraries

To delete a job from code:

REST API

To delete a job, send aDELETE HTTP 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

Replace:

  • ACCESS_TOKEN with a valid access token for an account thathas theIAM permissions to delete jobs.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.

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-18 UTC.