Questo documento spiega come visualizzare i job e le attività Batch.
Prima di iniziare
- Se non hai mai utilizzato Batch, consulta la sezione Guida introduttiva a Batch e attiva Batch completando i prerequisiti per progetti e utenti.
-
Per ottenere le autorizzazioni necessarie per visualizzare job e attività, chiedi all'amministratore di concederti il ruolo IAM Batch Job Viewer (
roles/batch.jobsViewer) o Batch Job Editor (roles/batch.jobsEditor) nel progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.
Visualizzare i job
Per visualizzare i tuoi job, seleziona uno dei seguenti metodi:
Per visualizzare tutti i job nel tuo progetto, visualizza un elenco dei tuoi job.
Per visualizzare tutti i dettagli di configurazione di un job specifico, visualizza i dettagli di un job.
Visualizzare un elenco dei tuoi lavori
Puoi visualizzare un elenco dei job nel progetto corrente utilizzando la consoleGoogle Cloud , gcloud CLI, l'API Batch, Go, Java, Node.js, Python o C++.
Console
Per visualizzare un elenco di job nel progetto corrente utilizzando la consoleGoogle Cloud , vai alla pagina Elenco job.
L'elenco dei job potrebbe essere suddiviso su più pagine. Se devi passare alla pagina successiva, fai clic su Avanti nella parte inferiore dello schermo.
(Facoltativo) Se vuoi filtrare l'elenco dei lavori, fai clic su Filtro. Poi, digita o seleziona una proprietà e un valore.
Ad esempio, per filtrare l'elenco in modo da includere solo i job in uno stato specifico, inserisci quanto segue:
Status:JOB_STATESostituisci
JOB_STATEcon uno stato del job, ad esempioFAILED.
gcloud
Visualizza tutte le offerte di lavoro
Per visualizzare un elenco di job nel progetto corrente utilizzando
gcloud CLI, utilizza il
comando gcloud batch jobs list.
gcloud batch jobs list
Visualizzare un elenco filtrato di job
(Facoltativo) Puoi aggiungere uno o più flag per visualizzare un elenco filtrato di lavori:
Per visualizzare solo i lavori in una località specifica, includi il flag
--location.Per visualizzare solo i job in base a un'espressione di filtro, specifica il flag
--filter.
Ad esempio, utilizza il seguente comando:
gcloud batch jobs list \
--location=LOCATION \
--filter="FILTER_EXPRESSION"
Sostituisci quanto segue:
LOCATION: la posizione in cui esistono uno o più lavori.FILTER_EXPRESSION: un'espressione di filtro che definisce i lavori che vuoi elencare. L'espressione di filtro deve definire una o più coppie proprietà-valore separate da zero o più operatori booleani (AND,OReNOT).Ad esempio, vedi le seguenti espressioni di filtro:
Filtra in base allo stato del job:per visualizzare solo i job in uno stato specifico, utilizza la seguente espressione di filtro:
status.state="JOB_STATE"Sostituisci
JOB_STATEcon uno stato del job, ad esempioFAILED.Filtra in base alle etichette: supponiamo che il tuo progetto abbia definito le seguenti etichette personalizzate:
Per indicare i job e le relative risorse creati dal tuo team di ricerca quando visualizzi i report di fatturazione Cloud, alcuni dei tuoi job e delle relative risorse hanno un'etichetta
teamimpostata suresearch.Per indicare i workload sensibili al tempo, alcuni job hanno un'etichetta
deadlineimpostata su vari valori.Per indicare i runnable che il tuo team di sviluppo ha testato correttamente, alcuni runnable hanno un'etichetta
testedimpostata sutrue.
Quindi, potresti specificare la seguente espressione di filtro:
(allocationPolicy.labels.team=research) AND ((labels.deadline:*) OR (runnables.labels.tested=true))Questa espressione di filtro elenca solo i job che soddisfano tutti i seguenti criteri:
Job del team di ricerca con un'etichetta
teamnella norma di allocazione del job impostata suresearch.Job che soddisfano almeno uno dei seguenti criteri:
Job sensibili al tempo, che hanno un'etichetta
deadlinesul job impostata su qualsiasi valore.Job con almeno un eseguibile testato correttamente, ovvero job con almeno un eseguibile con un'etichetta
testedimpostata sutrue.
API
Visualizza tutte le offerte di lavoro
Per visualizzare un elenco di job nel progetto corrente per una località specifica utilizzando
l'API Batch, invia una richiesta GET al
metodo jobs.list.
GET https://batch.googleapis.com/v1/projects/PROJECT_ID/locations/LOCATION/jobs
Sostituisci quanto segue:
PROJECT_ID: l'ID progetto del progetto corrente.LOCATION: la posizione in cui esistono i lavori.
Visualizzare un elenco filtrato di job
(Facoltativo) Puoi specificare il parametro di query filter per visualizzare un elenco filtrato di job in base a un'espressione di filtro.
Ad esempio, invia la seguente richiesta GET:
GET https://batch.googleapis.com/v1/projects/example-project/locations/us-central1/jobs?filter=FILTER_EXPRESSION
Sostituisci FILTER_EXPRESSION con un'espressione di filtro che utilizza la codifica URL.
L'espressione di filtro deve definire una o più coppie proprietà-valore separate da zero o più
operatori booleani (AND, OR e NOT).
Ad esempio, vedi le seguenti espressioni di filtro:
Filtra in base allo stato del job:per visualizzare solo i job in uno stato specifico, utilizza la seguente espressione di filtro:
status.state="JOB_STATE"Sostituisci
JOB_STATEcon uno stato del job, ad esempioFAILED.Filtra in base alle etichette: supponiamo che il tuo progetto abbia definito le seguenti etichette personalizzate:
Per indicare i job e le relative risorse creati dal tuo team di ricerca quando visualizzi i report di fatturazione Cloud, alcuni dei tuoi job e delle relative risorse hanno un'etichetta
teamimpostata suresearch.Per indicare i workload sensibili al tempo, alcuni job hanno un'etichetta
deadlineimpostata su vari valori.Per indicare i runnable che il tuo team di sviluppo ha testato correttamente, alcuni runnable hanno un'etichetta
testedimpostata sutrue.
Quindi, potresti specificare la seguente espressione di filtro:
(allocationPolicy.labels.team%3Dresearch)%20AND%20((labels.deadline%3A*)%20OR%20(runnables.labels.tested%3Dtrue))Questa espressione di filtro elenca solo i job che soddisfano tutti i seguenti criteri:
Job del team di ricerca con un'etichetta
teamnella norma di allocazione del job impostata suresearch.Job che soddisfano almeno uno dei seguenti criteri:
Job sensibili al tempo, che hanno un'etichetta
deadlinesul job impostata su qualsiasi valore.Job con almeno un eseguibile testato correttamente, ovvero job con almeno un eseguibile con un'etichetta
testedimpostata sutrue.
Go
Go
Per saperne di più, consulta la documentazione di riferimento dell'API Batch Go.
Per eseguire l'autenticazione in Batch, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Java
Java
Per saperne di più, consulta la documentazione di riferimento dell'API Batch Java.
Per eseguire l'autenticazione in Batch, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.
Node.js
Node.js
Per saperne di più, consulta la documentazione di riferimento dell'API Batch Node.js.
Per eseguire l'autenticazione in Batch, configura le Credenziali predefinite dell'applicazione. Per saperne di più, consulta Configura l'autenticazione per un ambiente di sviluppo locale.