REST Resource: projects.locations.jobs

Resource: Job

Deskripsi tugas operasi batch penyimpanan.

Representasi 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.
}
Kolom
name

string

ID. Nama resource tugas.

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

Misalnya: projects/123456/locations/global/jobs/job01.

jobId bersifat unik dalam project tertentu.
description

string

Opsional. Deskripsi yang diberikan pengguna untuk tugas.

Panjang maksimum: 1.024 byte saat dienkode unicode.
loggingConfig

object (LoggingConfig)

Opsional. Konfigurasi logging.
createTime

string (Timestamp format)

Hanya output. Waktu saat tugas dibuat.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
scheduleTime

string (Timestamp format)

Hanya output. Waktu tugas dijadwalkan.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
completeTime

string (Timestamp format)

Hanya output. Waktu penyelesaian pekerjaan.

Menggunakan RFC 3339 yang outputnya akan selalu dinormalisasi Z dan menggunakan 0, 3, 6, atau 9 digit pecahan. Offset selain "Z" juga diterima. Contoh: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z", atau "2014-10-02T15:01:23+05:30".
counters

object (Counters)

Hanya output. Informasi tentang kemajuan pekerjaan.
errorSummaries[]

object (ErrorSummary)

Hanya output. Merangkum kesalahan yang ditemui dengan contoh entri log kesalahan.
state

enum (State)

Hanya output. Kondisi pekerjaan.
dryRun

boolean

Opsional. Jika benar, pekerjaan akan berjalan dalam mode uji coba, mengembalikan jumlah total objek dan, jika konfigurasi objek berupa daftar awalan, byte yang ditemukan dari sumber. Tidak ada transformasi yang dilakukan.
isMultiBucketJob

boolean

Hanya output. Jika benar, pekerjaan ini beroperasi pada beberapa bucket. Pekerjaan multi-bucket memiliki batasan kuota yang berbeda dibandingkan dengan pekerjaan single-bucket.
Kolom union source. Menentukan objek yang akan diubah. source hanya ada berupa salah satu diantara berikut:
bucketList

object (BucketList)

Menentukan daftar bucket dan objeknya yang akan diubah.
projectSource

object (ProjectSource)

Menentukan sumber project dan filter untuk mengidentifikasi objek yang akan diubah.
Kolom union transformation. Operasi yang akan dilakukan pada objek. transformation hanya ada berupa salah satu diantara berikut:
putObjectHold

object (PutObjectHold)

Mengubah status penangguhan objek.
deleteObject

object (DeleteObject)

Menghapus objek.
putMetadata

object (PutMetadata)

Memperbarui metadata objek. Memungkinkan pembaruan metadata kunci tetap dan kustom. Misalnya, Cache-Control, Content-Disposition, Content-Encoding, Content-Language, Content-Type, Custom-Time, dan Retention configuration.
rewriteObject

object (RewriteObject)

Menulis ulang objek dan mengupdate metadata seperti kunci KMS.
updateObjectCustomContext

object (UpdateObjectCustomContext)

Memperbarui konteks kustom objek.
setObjectAcls

object (SetObjectAcls)

Memperbarui ACL objek.

BucketList

Menjelaskan daftar bucket dan objeknya yang akan diubah.

Representasi JSON 
{
  "buckets": [
    {
      object (Bucket)
    }
  ]
}
Kolom
buckets[]

object (Bucket)

Wajib. Daftar bucket dan objeknya yang akan diubah. Anda hanya dapat menentukan satu bucket per tugas. Jika beberapa bucket ditentukan, akan terjadi error.

Bucket

Mendeskripsikan konfigurasi satu bucket dan objeknya yang akan diubah.

Representasi 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.
}
Kolom
bucket

string

Wajib. Nama wadah untuk objek yang akan ditransformasikan.
Kolom union object_configuration. Menentukan objek yang akan diubah. object_configuration hanya ada berupa salah satu diantara berikut:
prefixList

object (PrefixList)

Menentukan objek yang cocok dengan set awalan.
manifest

object (Manifest)

Menentukan objek dalam file manifes.

LoggingConfig

Menentukan perilaku Cloud Logging.

Representasi JSON 
{
  "logActions": [
    enum (LoggableAction)
  ],
  "logActionStates": [
    enum (LoggableActionState)
  ]
}
Kolom
logActions[]

enum (LoggableAction)

Wajib. Menentukan tindakan yang akan dicatat.
logActionStates[]

enum (LoggableActionState)

Wajib. Negara bagian tempat Tindakan dicatat dalam log.Jika kosong, tidak ada log yang dibuat.

LoggableAction

Jenis tindakan yang dapat dicatat.

Enum
LOGGABLE_ACTION_UNSPECIFIED Nilai ilegal, untuk menghindari pemberian nilai default.
TRANSFORM Tindakan transformasi yang sesuai dalam pekerjaan ini.

LoggableActionState

Filter status tindakan yang dapat dicatat.

Enum
LOGGABLE_ACTION_STATE_UNSPECIFIED Nilai ilegal, untuk menghindari penggunaan nilai default.
SUCCEEDED LoggableAction berhasil diselesaikan. Tindakan SUCCEEDED dicatat sebagai [INFO][google.logging.type.LogSeverity.INFO].
FAILED LoggableAction dihentikan dalam status error. Tindakan FAILED dicatat sebagai [ERROR][google.logging.type.LogSeverity.ERROR].

Negara Bagian

Menjelaskan status tugas.

Enum
STATE_UNSPECIFIED Nilai default. Nilai ini tidak digunakan.
RUNNING Dalam proses.
SUCCEEDED Berhasil diselesaikan.
CANCELED Dibatalkan oleh pengguna.
FAILED Dihentikan karena kegagalan yang tidak dapat dipulihkan.
QUEUED Dalam antrean, tetapi belum dimulai.

Metode

cancel

 Membatalkan tugas batch.

create

 Membuat tugas batch.

delete

 Menghapus tugas batch.

get

 Mendapatkan tugas batch.

list

 Mencantumkan Tugas dalam project tertentu.