Method: projects.locations.batches.list

Elenca i workload batch.

Richiesta HTTP

GET https://dataproc.googleapis.com/v1/{parent=projects/*/locations/*}/batches

L'URL utilizza la sintassi di transcodifica gRPC.

Parametri del percorso

Parametri
parent

string

Obbligatorio. L'elemento principale, proprietario di questa raccolta di batch.

L'autorizzazione richiede la seguente autorizzazione IAM sulla risorsa specificata parent:

  • dataproc.batches.list

Parametri di query

Parametri
pageSize

integer

Facoltativo. Il numero massimo di batch da restituire in ogni risposta. Il servizio potrebbe restituire meno di questo valore. Le dimensioni pagina predefinite sono 20; le dimensioni pagina massime sono 1000.
pageToken

string

Facoltativo. Un token di pagina ricevuto da una chiamata batches.list precedente. Fornisci questo token per recuperare la pagina successiva.
filter

string

Facoltativo. Un filtro per i batch da restituire nella risposta.

Un filtro è un'espressione logica che limita i valori di vari campi in ogni risorsa batch. I filtri sono sensibili alle maiuscole e possono contenere più clausole combinate con operatori logici (AND/OR). I campi supportati sono batchId, batchUuid, state, createTime e labels.

ad es. i filtri state = RUNNING and createTime < "2023-01-01T00:00:00Z" per i batch in stato RUNNING creati prima del 01/01/2023. state = RUNNING and labels.environment=production filtra i batch in stato RUNNING con un'etichetta dell'ambiente di produzione.

Visita la pagina https://google.aip.dev/assets/misc/ebnf-filtering.txt per una descrizione dettagliata della sintassi del filtro e un elenco dei confronti supportati.
orderBy

string

Facoltativo. I campi in base ai quali ordinare l'elenco di batch.

Al momento, gli unici ordini di ordinamento supportati sono non specificati (vuoto) e createTime desc per ordinare per primi i batch creati più di recente.

Per ulteriori dettagli, visita la pagina https://google.aip.dev/132#ordering.

Corpo della richiesta

Il corpo della richiesta deve essere vuoto.

Corpo della risposta

Un elenco di workload batch.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "batches": [
    {
      object (Batch)
    }
  ],
  "nextPageToken": string,
  "unreachable": [
    string
  ]
}
Campi
batches[]

object (Batch)

Solo output. I batch della raccolta specificata.
nextPageToken

string

Un token che può essere inviato come pageToken per recuperare la pagina successiva. Se questo campo viene omesso, non verranno visualizzate altre pagine.
unreachable[]

string

Solo output. Elenco di batch che non è stato possibile includere nella risposta. Il tentativo di ottenere una di queste risorse potrebbe indicare il motivo per cui non è stata inclusa nella risposta dell'elenco.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/cloud-platform

Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.