REST Resource: projects.locations.jobs

Risorsa: Job

La descrizione del job di operazioni batch di archiviazione.

Rappresentazione JSON 
{
  "name": string,
  "description": string,
  "loggingConfig": {
    object (LoggingConfig)
  },
  "createTime": string,
  "scheduleTime": string,
  "completeTime": string,
  "counters": {
    object (Counters)
  },
  "errorSummaries": [
    {
      object (ErrorSummary)
    }
  ],
  "state": enum (State),
  "dryRun": boolean,
  "isMultiBucketJob": boolean,

  // Union field source can be only one of the following:
  "bucketList": {
    object (BucketList)
  },
  "projectSource": {
    object (ProjectSource)
  }
  // End of list of possible types for union field source.

  // Union field transformation can be only one of the following:
  "putObjectHold": {
    object (PutObjectHold)
  },
  "deleteObject": {
    object (DeleteObject)
  },
  "putMetadata": {
    object (PutMetadata)
  },
  "rewriteObject": {
    object (RewriteObject)
  },
  "updateObjectCustomContext": {
    object (UpdateObjectCustomContext)
  },
  "setObjectAcls": {
    object (SetObjectAcls)
  }
  // End of list of possible types for union field transformation.
}
Campi
name

string

Identificatore. Il nome della risorsa del job.

Formato: projects/{projectId}/locations/global/jobs/{jobId}.

Ad esempio: projects/123456/locations/global/jobs/job01.

jobId è univoco in un determinato progetto.
description

string

Facoltativo. Una descrizione del lavoro fornita dall'utente.

Lunghezza massima: 1024 byte se codificata in Unicode.
loggingConfig

object (LoggingConfig)

Facoltativo. Configurazione del logging.
createTime

string (Timestamp format)

Solo output. Il momento in cui è stato creato il posto di lavoro.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
scheduleTime

string (Timestamp format)

Solo output. L'ora in cui è stato pianificato il job.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
completeTime

string (Timestamp format)

Solo output. Il momento in cui il lavoro è stato completato.

Utilizza RFC 3339, in cui l'output generato è sempre con normalizzazione Z e utilizza 0, 3, 6 o 9 cifre frazionarie. Sono accettati anche offset diversi da "Z". Esempi: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" o "2014-10-02T15:01:23+05:30".
counters

object (Counters)

Solo output. Informazioni sullo stato di avanzamento del lavoro.
errorSummaries[]

object (ErrorSummary)

Solo output. Riepiloga gli errori riscontrati con esempi di voci del registro degli errori.
state

enum (State)

Solo output. Stato del lavoro.
dryRun

boolean

Facoltativo. Se impostato su true, il processo viene eseguito in modalità di simulazione, restituendo il numero totale di oggetti e, se la configurazione degli oggetti è un elenco di prefissi, i byte trovati dalla sorgente. Non viene eseguita alcuna trasformazione.
isMultiBucketJob

boolean

Solo output. Se vero, questo lavoro opera su più bucket. I lavori multi-bucket sono soggetti a limiti di quota diversi rispetto ai lavori single-bucket.
Campo unione source. Specifica gli oggetti da trasformare. source può essere solo uno dei seguenti tipi:
bucketList

object (BucketList)

Specifica un elenco di bucket e i relativi oggetti da trasformare.
projectSource

object (ProjectSource)

Specifica un'origine progetto e i filtri per identificare gli oggetti da trasformare.
Campo unione transformation. Operazione da eseguire sugli oggetti. transformation può essere solo uno dei seguenti tipi:
putObjectHold

object (PutObjectHold)

Modifica lo stato del blocco oggetto.
deleteObject

object (DeleteObject)

Elimina oggetti.
putMetadata

object (PutMetadata)

Aggiorna i metadati dell'oggetto. Consente di aggiornare i metadati personalizzati e a chiave fissa. Ad esempio, Cache-Control, Content-Disposition, Content-Encoding, Content-Language, Content-Type, Custom-Time e Retention configuration.
rewriteObject

object (RewriteObject)

Riscrivi l'oggetto e aggiorna i metadati come la chiave KMS.
updateObjectCustomContext

object (UpdateObjectCustomContext)

Aggiorna il contesto personalizzato dell'oggetto.
setObjectAcls

object (SetObjectAcls)

Aggiorna gli ACL degli oggetti.

BucketList

Descrive l'elenco dei bucket e dei relativi oggetti da trasformare.

Rappresentazione JSON 
{
  "buckets": [
    {
      object (Bucket)
    }
  ]
}
Campi
buckets[]

object (Bucket)

Obbligatorio. Elenco dei bucket e dei relativi oggetti da trasformare. Puoi specificare un solo bucket per job. Se vengono specificati più bucket, si verifica un errore.

Bucket

Descrive la configurazione di un singolo bucket e dei relativi oggetti da trasformare.

Rappresentazione JSON 
{
  "bucket": string,

  // Union field object_configuration can be only one of the following:
  "prefixList": {
    object (PrefixList)
  },
  "manifest": {
    object (Manifest)
  }
  // End of list of possible types for union field object_configuration.
}
Campi
bucket

string

Obbligatorio. Nome del bucket per gli oggetti da trasformare.
Campo unione object_configuration. Specifica gli oggetti da trasformare. object_configuration può essere solo uno dei seguenti tipi:
prefixList

object (PrefixList)

Specifica gli oggetti che corrispondono a un set di prefissi.
manifest

object (Manifest)

Specifica gli oggetti in un file manifesto.

LoggingConfig

Specifica il comportamento di registrazione nel cloud.

Rappresentazione JSON 
{
  "logActions": [
    enum (LoggableAction)
  ],
  "logActionStates": [
    enum (LoggableActionState)
  ]
}
Campi
logActions[]

enum (LoggableAction)

Obbligatorio. Specifica le azioni da registrare.
logActionStates[]

enum (LoggableActionState)

Obbligatorio. Stati in cui vengono registrate le azioni.Se vuoto, non vengono generati log.

LoggableAction

Tipi di azioni registrabili.

Enum
LOGGABLE_ACTION_UNSPECIFIED Valore non valido, per evitare di consentire un valore predefinito.
TRANSFORM La corrispondente azione di trasformazione in questo lavoro.

LoggableActionState

Filtro degli stati delle azioni registrabili.

Enum
LOGGABLE_ACTION_STATE_UNSPECIFIED Valore non valido, per evitare di consentire un valore predefinito.
SUCCEEDED LoggableAction completato correttamente. SUCCEEDED Le azioni vengono registrate come [INFO][google.logging.type.LogSeverity.INFO].
FAILED LoggableAction terminato in uno stato di errore. FAILED le azioni vengono registrate come [ERROR][google.logging.type.LogSeverity.ERROR].

Stato

Descrive lo stato di un job.

Enum
STATE_UNSPECIFIED Valore predefinito. Questo valore non viene utilizzato.
RUNNING In corso.
SUCCEEDED Operazione completata con successo.
CANCELED Annullato dall'utente.
FAILED Interrotto a causa di un guasto irreversibile.
QUEUED In coda ma non ancora avviato.

Metodi

cancel

 Annulla un job batch.

create

 Crea un job batch.

delete

 Elimina un job batch.

get

 Esegue un'job batch.

list

 Elenca le posizioni lavorative in un determinato progetto.