本页面介绍如何管理作业。如需创建作业,请参阅创建作业。如需执行作业,请参阅执行作业。
所需的角色
如需获得管理 Cloud Run 作业所需的权限,请让管理员向您授予 Cloud Run 作业的 Cloud Run Developer (roles/run.developer
) IAM 角色。
如需查看与 Cloud Run 关联的 IAM 角色和权限的列表,请参阅 Cloud Run IAM 角色和 Cloud Run IAM 权限。如果您的 Cloud Run 作业与 Google Cloud API(例如 Cloud 客户端库)进行交互,请参阅服务身份配置指南。如需详细了解如何授予角色,请参阅部署权限和管理访问权限。
查看项目中的作业
您可以使用以下任一方法查看项目中的作业列表:
控制台
如需查看作业,请执行以下操作:
(可选)按下拉菜单中的某个条件过滤作业,例如您可以按作业名称、执行时间、区域等条件进行过滤。
gcloud
如需列出项目中的所有作业,请运行以下命令:
gcloud run jobs list
如需按区域过滤作业,请运行以下命令:
gcloud run jobs list --region REGION
将
REGION
替换为您要按照其进行过滤的区域,例如us-central1
。
如需了解优化返回列表的其他方法(包括使用过滤条件),请参阅作业列表。
客户端库
如需通过代码查看项目中的作业,请使用以下客户端库:
REST API
如需查看项目中的作业列表,请向 Cloud Run Admin API jobs
端点发送 GET
HTTP 请求。
例如,使用 curl
:
curl -H "Content-Type: application/json" \ -H "Authorization: Bearer ACCESS_TOKEN" \ -X GET \ -d '' \ https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/jobs
您需要进行如下替换:
- 将 ACCESS_TOKEN 替换为具有查看作业的 IAM 权限的账号的有效访问令牌。例如,如果您已登录 gcloud,则可以使用
gcloud auth print-access-token
检索访问令牌。在 Cloud Run 容器实例中,您可以使用容器实例元数据服务器检索访问令牌。 - 将 REGION 替换为作业的 Google Cloud 区域。
- 将 PROJECT-ID 替换为 Google Cloud 项目 ID。
查看作业详情
使用 gcloud 命令行可查看有关作业的更多详细信息。
控制台
如需查看特定作业执行的详细信息,请执行以下操作:
找到相关作业。
点击该作业以显示作业详情页面。
请留意历史记录、指标、日志、触发器和 YAML 标签页。
- 历史记录标签页显示有关作业执行中任务的信息。
- 日志显示日志信息。
- 指标显示有关作业执行情况的信息。
- YAML 以 YAML 格式显示作业的配置。
gcloud
如需查看有关作业的详细信息,请执行以下操作:
使用以下命令:
gcloud run jobs describe JOB_NAME
将 JOB_NAME
替换为作业的名称。
客户端库
如需通过代码查看作业的相关详细信息,请使用以下客户端库:
REST API
如需查看作业的相关详细信息,请向 Cloud Run Admin API jobs
端点发送 GET
HTTP 请求。
例如,使用 curl
:
curl -H "Content-Type: application/json" \ -H "Authorization: Bearer ACCESS_TOKEN" \ -X GET \ -d '' \ https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/jobs/JOB-NAME
您需要进行如下替换:
- 将 ACCESS_TOKEN 替换为具有查看作业详情的 IAM 权限的账号的有效访问令牌。例如,如果您已登录 gcloud,则可以使用
gcloud auth print-access-token
检索访问令牌。在 Cloud Run 容器实例中,您可以使用容器实例元数据服务器检索访问令牌。 - 将 JOB-NAME 替换为作业的名称。
- 将 REGION 替换为作业的 Google Cloud 区域。
- 将 PROJECT-ID 替换为 Google Cloud 项目 ID。
删除作业
仅当作业当前没有作业执行在运行时,才能删除该作业。
虽然已删除的作业不会再出现在作业列表中,但其日志将继续在日志剩余的保留期限内在 Cloud Logging 中可用,并且监控数据将继续在 Cloud Monitoring 中可用。
控制台
要删除任务,请执行以下操作:
选择作业。
点击删除。
gcloud
要删除任务,请执行以下操作:
使用以下命令:
gcloud run jobs delete JOB_NAME
将
JOB_NAME
替换为作业的名称。如果系统提示您确认,请回复
y
。成功后,系统会显示一条成功消息。
客户端库
如需通过代码删除作业,请使用以下客户端库:
REST API
如需删除作业,请向 Cloud Run Admin API jobs
端点发送 DELETE
HTTP 请求。
例如,使用 curl
:
curl -H "Content-Type: application/json" \ -H "Authorization: Bearer ACCESS_TOKEN" \ -X DELETE \ -d '' \ https://run.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/jobs/JOB-NAME
您需要进行如下替换:
- 将 ACCESS_TOKEN 替换为具有删除作业的 IAM 权限的账号的有效访问令牌。例如,如果您已登录 gcloud,则可以使用
gcloud auth print-access-token
检索访问令牌。在 Cloud Run 容器实例中,您可以使用容器实例元数据服务器检索访问令牌。 - 将 JOB-NAME 替换为作业的名称。
- 将 REGION 替换为作业的 Google Cloud 区域。
- 将 PROJECT-ID 替换为 Google Cloud 项目 ID。