Gerencie vagas

Esta página descreve como gerenciar jobs. Para criar um job, consulte Criar jobs. Para executar um job, consulte Executar jobs.

Funções exigidas

Para ter as permissões necessárias para gerenciar os jobs do Cloud Run, peça ao administrador para conceder a você o papel do IAM de Desenvolvedor do Cloud Run (roles/run.developer) no job do Cloud Run.

Para uma lista de papéis e permissões do IAM associados ao Cloud Run, consulte Papéis do IAM do Cloud Run e Permissões do IAM do Cloud Run. Se o job do Cloud Run interagir com APIs do Google Cloud, como bibliotecas de cliente do Cloud, consulte o guia de configuração de identidade de serviço. Para mais informações sobre como conceder papéis, consulte permissões de implantação e gerenciar acesso.

Ver jobs no projeto

É possível ver uma lista dos jobs em seu projeto usando uma das seguintes abordagens:

Console

Para ver jobs:

Acesse a página de jobs do Cloud Run.
Opcionalmente, filtre o job por um dos critérios no menu suspenso, como nome do job, tempo de execução, região e assim por diante.

gcloud

Para listar todos os jobs no projeto:
```
gcloud run jobs list
```
Para filtrar jobs por região, siga estas etapas:
```
gcloud run jobs list --region REGION
```
Substitua REGION pelo nome da região que você está filtrando, por exemplo, us-central1.

Para outras maneiras de refinar a lista retornada, incluindo o uso de filtros, consulte lista de jobs.

Bibliotecas de cliente

Para visualizar jobs no projeto a partir do código:

API REST

Para visualizar a lista de jobs no projeto, envie uma solicitação HTTP GET ao endpoint jobs da API Cloud Run Admin.

Por exemplo, usando 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

Substitua:

ACCESS_TOKEN por um token de acesso válido para uma conta com as permissões do IAM para visualizar jobs. Por exemplo, se você fez login no gcloud, é possível recuperar um token de acesso usando gcloud auth print-access-token. Em uma instância de contêiner do Cloud Run, é possível recuperar um token de acesso por meio do servidor de metadados da instância de contêiner.
REGION pela região do Google Cloud do job.
PROJECT-ID pelo ID do projeto do Google Cloud.

Mais detalhes do job

Use a linha de comando do gcloud para ver mais detalhes sobre um job.

Console

Para ver detalhes de uma execução de job específica:

Acessar a página de jobs do Cloud Run
Localize o job em que você tem interesse.
Clique no job para exibir a página de detalhes.
Observe as guias Histórico, Métricas, Registros, Gatilhos e YAML.
- A guia Histórico mostra informações sobre as tarefas na execução do job.
- Registros mostra as informações dos registros.
- Métricas mostra informações sobre as execuções do job.
- YAML mostra a configuração do job no formato YAML.

gcloud

Para ver detalhes sobre um job:

Use o comando :

gcloud run jobs describe  JOB_NAME

Substitua JOB_NAME pelo nome do job.

Bibliotecas de cliente

Para visualizar detalhes sobre um job a partir do código:

API REST

Para visualizar detalhes sobre um job, envie uma solicitação HTTP GET para o endpoint jobs da API Cloud Run Admin.

Por exemplo, usando 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

Substitua:

ACCESS_TOKEN por um token de acesso válido para uma conta com as permissões do IAM para visualizar os detalhes do job. Por exemplo, se você fez login no gcloud, é possível recuperar um token de acesso usando gcloud auth print-access-token. Em uma instância de contêiner do Cloud Run, é possível recuperar um token de acesso por meio do servidor de metadados da instância de contêiner.
Substitua JOB-NAME pelo nome do job.
REGION pela região do Google Cloud do job.
PROJECT-ID pelo ID do projeto do Google Cloud.

Excluir um job

Só é possível excluir um job quando não há execuções desse job em execução no momento.

Um job excluído não aparece mais na lista de jobs, mas os registros dele continuam disponíveis no Cloud Logging até o fim do período de armazenamento de registros, e os dados de monitoramento ficam. continuará disponível no Cloud Monitoring.

Console

Para excluir um job, siga estas etapas:

Acessar a página de jobs do Cloud Run
Selecione o job.
Clique em Excluir.

gcloud

Para excluir um job, siga estas etapas:

Use o comando:
```
gcloud run jobs delete JOB_NAME
```
Substitua JOB_NAME pelo nome do job.
Se for solicitado a confirmação, responda y. Após a conclusão, uma mensagem será exibida.

Bibliotecas de cliente

Para excluir um job a partir do código:

API REST

Para excluir um job, envie uma solicitação HTTP DELETE ao endpoint jobs da API Cloud Run Admin.

Por exemplo, usando 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

Substitua:

ACCESS_TOKEN por um token de acesso válido para uma conta com as permissões do IAM para excluir jobs. Por exemplo, se você fez login no gcloud, é possível recuperar um token de acesso usando gcloud auth print-access-token. Em uma instância de contêiner do Cloud Run, é possível recuperar um token de acesso por meio do servidor de metadados da instância de contêiner.
Substitua JOB-NAME pelo nome do job.
REGION pela região do Google Cloud do job.
PROJECT-ID pelo ID do projeto do Google Cloud.