Nesta página, descrevemos como visualizar jobs em lote e as tarefas deles.
Antes de começar
- Se você nunca usou o Batch antes, analise os Primeiros passos com o Batch e ative o Batch preenchendo os pré-requisitos para projetos e usuários.
-
Para receber as permissões necessárias para visualizar jobs e tarefas, solicite ao administrador que conceda a você o papel de IAM de Visualizador de jobs em lote (
roles/batch.jobsViewer
) ou Editor de job em lote (roles/batch.jobsEditor
) no projeto. Para obter mais informações sobre como conceder papéis, consulte Gerenciar o acesso.Também é possível conseguir as permissões necessárias com papéis personalizados ou outros papéis predefinidos.
Listar e descrever jobs
Listar os jobs para visualizá-los em um projeto. Descreva um job para visualizar os detalhes de configuração.
Listar jobs
É possível listar jobs usando o console do Google Cloud, a CLI gcloud, a API em lote, o Go, o Java, o Node.js ou o Python.
Console
Para listar os jobs do seu projeto, acesse a página Lista de jobs no Console do Google Cloud.
gcloud
Para listar os jobs do seu projeto usando a CLI gcloud, use o comando gcloud batch jobs list
.
gcloud batch jobs list
API
Para listar os jobs do seu projeto para um local específico usando a API em lote, use o método jobs.list
:
GET https://batch.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/jobs/
Substitua:
PROJECT_ID
: o ID do projeto.LOCATION
: o local do job.JOB_NAME
: o nome do job.
Go
Go
Para mais informações, consulte a documentação de referência da API Batch Go.
Java
Java
Para mais informações, consulte a documentação de referência da API Batch Java.
Node.js
Node.js
Para mais informações, consulte a documentação de referência da API Batch Node.js.
Python
Python
Para mais informações, consulte a documentação de referência da API Batch Python.
Descrever um job
É possível descrever um job usando o console do Google Cloud, a CLI gcloud, a API Batch, Go, Java, Node.js ou Python.
Console
Para listar os jobs do seu projeto, acesse a página Lista de jobs no Console do Google Cloud.
Para descrever uma tarefa, na coluna Nome da tarefa, clique no nome da tarefa. A página Detalhes do job é aberta.
A guia Detalhes é aberta por padrão. Clique em outras guias para mais informações.
gcloud
Para descrever um job usando a CLI gcloud, use o comando gcloud batch jobs describe
.
gcloud batch jobs describe JOB_NAME --location LOCATION
Substitua:
JOB_NAME
: o nome do job.LOCATION
: o local do job.
API
Para descrever um job usando a API Batch, use o método jobs.get
:
GET https://batch.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/jobs/JOB_NAME
Substitua:
PROJECT_ID
: o ID do projeto.LOCATION
: o local do job.JOB_NAME
: o nome do job.
Go
Go
Para mais informações, consulte a documentação de referência da API Batch Go.
Java
Java
Para mais informações, consulte a documentação de referência da API Batch Java.
Node.js
Node.js
Para mais informações, consulte a documentação de referência da API Batch Node.js.
Python
Python
Para mais informações, consulte a documentação de referência da API Batch Python.
Listar e descrever tarefas
Listar tarefas para visualizar as tarefas em um job ou no grupo de tarefas de um job. Descreva uma tarefa para ver os detalhes de configuração.
Listar tarefas
É possível listar as tarefas de um job usando o console do Google Cloud, a CLI gcloud, a API Batch, Go, Java, Node.js ou Python.
Console
Para visualizar os detalhes de uma tarefa usando o console do Google Cloud, descreva uma tarefa para abrir a página Detalhes da tarefa e consulte a seção Detalhes da tarefa.
gcloud
Para listar as tarefas do grupo de tarefas de um job usando a CLI gcloud, use o comando gcloud batch tasks list
.
gcloud batch tasks list --location LOCATION \
--job JOB_NAME
Substitua:
LOCATION
: o local do job.JOB_NAME
: o nome do job.
API
Para listar as tarefas de um grupo de tarefas de um job usando a API em lote, use o método tasks.list
:
GET https://batch.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/jobs/JOB_NAME/taskGroups/TASK_GROUP_NAME/tasks
Substitua:
PROJECT_ID
: o ID do projeto.LOCATION
: o local do job.JOB_NAME
: o nome do job.TASK_GROUP_NAME
: o nome do grupo de tarefas que você quer descrever. Defina comogroup0
.
Go
Go
Para mais informações, consulte a documentação de referência da API Batch Go.
Java
Java
Para mais informações, consulte a documentação de referência da API Batch Java.
Node.js
Node.js
Para mais informações, consulte a documentação de referência da API Batch Node.js.
Python
Python
Para mais informações, consulte a documentação de referência da API Batch Python.
Descrever uma tarefa
É possível descrever uma tarefa usando o console do Google Cloud, a CLI gcloud, a API Batch, Go, Java, Node.js ou Python.
Console
Para visualizar os detalhes de uma tarefa usando o console do Google Cloud, descreva uma tarefa para abrir a página Detalhes da tarefa e consulte a seção Detalhes da tarefa.
gcloud
Para descrever uma tarefa usando a CLI gcloud, use o comando gcloud batch tasks describe
.
gcloud batch tasks describe TASK_INDEX \
--location LOCATION \
--job JOB_NAME \
--task_group TASK_GROUP_NAME
Substitua:
TASK_INDEX
: o índice da tarefa que você quer descrever. Os índices da tarefa em um grupo de tarefas começam em0
e aumentam em um para cada tarefa. Por exemplo, os índices de um grupo de tarefas com quatro tarefas são0
,1
,2
e3
.TASK_GROUP_NAME
: o nome do grupo de tarefas que contém a tarefa que você quer descrever. Defina comogroup0
.JOB_NAME
: o nome do job.LOCATION
: o local do job.
API
Para descrever uma tarefa usando a API Batch, use o
método tasks.get
:
GET https://batch.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/jobs/JOB_NAME/taskGroups/TASK_GROUP_NAME/tasks/TASK_INDEX
Substitua:
PROJECT_ID
: o ID do projeto.LOCATION
: o local do job.JOB_NAME
: o nome do job.TASK_GROUP_NAME
: o nome do grupo de tarefas que contém a tarefa que você quer descrever. Defina comogroup0
.TASK_INDEX
: o índice da tarefa que você quer descrever. Os índices da tarefa em um grupo de tarefas começam em0
e aumentam em um para cada tarefa. Por exemplo, os índices de um grupo de tarefas com quatro tarefas são0
,1
,2
e3
.
Go
Go
Para mais informações, consulte a documentação de referência da API Batch Go.
Java
Java
Para mais informações, consulte a documentação de referência da API Batch Java.
Node.js
Node.js
Para mais informações, consulte a documentação de referência da API Batch Node.js.
Python
Python
Para mais informações, consulte a documentação de referência da API Batch Python.