REST Resource: projects.locations.backupPlans.backups

Referensi: Pencadangan

Menyatakan permintaan untuk melakukan pengambilan satu titik waktu atas beberapa bagian status cluster GKE, catatan operasi pencadangan itu sendiri, dan anchor untuk artefak dasar yang mencakup Pencadangan (pencadangan konfigurasi dan VolumeBackups). ID berikutnya: 28

Representasi JSON
{
  "name": string,
  "uid": string,
  "createTime": string,
  "updateTime": string,
  "manual": boolean,
  "labels": {
    string: string,
    ...
  },
  "deleteLockDays": integer,
  "deleteLockExpireTime": string,
  "retainDays": integer,
  "retainExpireTime": string,
  "encryptionKey": {
    object (EncryptionKey)
  },
  "containsVolumeData": boolean,
  "containsSecrets": boolean,
  "clusterMetadata": {
    object (ClusterMetadata)
  },
  "state": enum (State),
  "stateReason": string,
  "completeTime": string,
  "resourceCount": integer,
  "volumeCount": integer,
  "sizeBytes": string,
  "etag": string,
  "description": string,
  "podCount": integer,
  "configBackupSizeBytes": string,

  // Union field backup_scope can be only one of the following:
  "allNamespaces": boolean,
  "selectedNamespaces": {
    object (Namespaces)
  },
  "selectedApplications": {
    object (NamespacedNames)
  }
  // End of list of possible types for union field backup_scope.
}
Kolom
name

string

Hanya output. Nama Pencadangan yang sepenuhnya memenuhi syarat. projects/*/locations/*/backupPlans/*/backups/*

uid

string

Hanya output. ID unik global UUID4 yang dihasilkan server

createTime

string (Timestamp format)

Hanya output. Stempel waktu saat resource Pencadangan ini dibuat.

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan maksimal sembilan digit fraksional. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

updateTime

string (Timestamp format)

Hanya output. Stempel waktu saat resource Cadangan ini terakhir diperbarui.

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan maksimal sembilan digit fraksional. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

manual

boolean

Hanya output. Tanda ini menunjukkan apakah resource Pencadangan ini dibuat secara manual oleh pengguna atau melalui jadwal di BackupPlan. Nilai Benar (True) berarti Cadangan dibuat secara manual.

labels

map (key: string, value: string)

Sekumpulan label khusus yang disediakan oleh pengguna.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

deleteLockDays

integer

Usia minimum untuk Cadangan ini (dalam hari). Jika kolom ini ditetapkan ke nilai bukan nol, Cadangan akan "dikunci" sehingga tidak dapat dihapus (penghapusan manual atau otomatis) selama jumlah hari yang diberikan (diukur dari waktu pembuatan Cadangan). HARUS berupa nilai bilangan bulat antara 0-90 (inklusif).

Default-nya adalah setelan backupDeleteLockDays BackupPlan induk dan hanya dapat ditingkatkan (baik pada waktu pembuatan atau update berikutnya).

deleteLockExpireTime

string (Timestamp format)

Hanya output. Waktu ketika kunci hapus yang ada akan berakhir masa berlakunya untuk cadangan ini (dihitung dari createTime + deleteLockDays).

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan maksimal sembilan digit fraksional. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

retainDays

integer

Usia (dalam hari) saat Cadangan ini akan dihapus secara otomatis. Harus berupa nilai bilangan bulat >= 0:

  • Jika 0, tidak ada penghapusan otomatis yang akan terjadi untuk Cadangan ini.
  • Jika bukan 0, nilainya harus >= deleteLockDays dan <= 365.

Setelah Cadangan dibuat, nilai ini hanya dapat ditingkatkan.

Setelan defaultnya adalah nilai backupRetainDays BackupPlan induk.

retainExpireTime

string (Timestamp format)

Hanya output. Waktu saat Cadangan ini akan dihapus secara otomatis (dihitung dari createTime + retainDays).

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan maksimal sembilan digit fraksional. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

encryptionKey

object (EncryptionKey)

Hanya output. Kunci enkripsi yang dikelola pelanggan yang digunakan untuk mengenkripsi artefak Cadangan. Diwariskan dari nilai encryptionKey BackupPlan induk.

containsVolumeData

boolean

Hanya output. Apakah Cadangan berisi data volume atau tidak. Dikontrol oleh nilai includeVolumeData BackupPlan induk.

containsSecrets

boolean

Hanya output. Apakah Cadangan berisi Secret Kubernetes atau tidak. Dikontrol oleh nilai includeSecrets BackupPlan induk.

clusterMetadata

object (ClusterMetadata)

Hanya output. Informasi tentang cluster GKE tempat Cadangan ini dibuat.

state

enum (State)

Hanya output. Status Pencadangan saat ini

stateReason

string

Hanya output. Deskripsi yang dapat dibaca manusia terkait alasan cadangan berada di state saat ini.

completeTime

string (Timestamp format)

Hanya output. Waktu penyelesaian Pencadangan

Stempel waktu dalam format RFC3339 UTC "Zulu", dengan resolusi nanodetik dan maksimal sembilan digit fraksional. Contoh: "2014-10-02T15:01:23Z" dan "2014-10-02T15:01:23.045123456Z".

resourceCount

integer

Hanya output. Jumlah total resource Kubernetes yang disertakan dalam Pencadangan.

volumeCount

integer

Hanya output. Jumlah total cadangan volume yang terdapat dalam Cadangan.

sizeBytes

string (int64 format)

Hanya output. Ukuran total Pencadangan dalam byte = ukuran cadangan konfigurasi + jumlah(ukuran cadangan volume)

etag

string

Hanya output. etag digunakan untuk kontrol konkurensi optimistis sebagai cara untuk membantu mencegah update cadangan simultan agar tidak saling menimpa satu sama lain. Sangat disarankan agar sistem menggunakan etag dalam siklus baca-modifikasi-tulis untuk melakukan update pencadangan guna menghindari kondisi race: etag ditampilkan sebagai respons terhadap backups.get, dan sistem diharapkan untuk memasukkan etag tersebut dalam permintaan ke backups.patch atau backups.delete untuk memastikan bahwa perubahannya akan diterapkan ke versi resource yang sama.

description

string

String deskriptif yang ditentukan pengguna untuk Cadangan ini.

podCount

integer

Hanya output. Jumlah total Pod Kubernetes yang terdapat dalam Pencadangan.

configBackupSizeBytes

string (int64 format)

Hanya output. Ukuran cadangan konfigurasi dalam byte.

Kolom union backup_scope. Menentukan "cakupan" Pencadangan - resource dengan namespace dalam cluster yang disertakan dalam Pencadangan. Diwariskan dari nilai [backup_scope][google.cloud.gkebackup.v1.BackupPlan.BackupConfig.backup_scope] BackupPlan induk. backup_scope hanya ada berupa salah satu diantara berikut:
allNamespaces

boolean

Hanya output. Jika True, semua namespace akan disertakan dalam Cadangan.

selectedNamespaces

object (Namespaces)

Hanya output. Jika ditetapkan, daftar namespace yang disertakan dalam Cadangan.

selectedApplications

object (NamespacedNames)

Hanya output. Jika ditetapkan, daftar ProtectedApplications yang resource-nya disertakan dalam Pencadangan.

ClusterMetadata

Informasi tentang cluster GKE tempat Cadangan ini dibuat.

Representasi JSON
{
  "cluster": string,
  "k8sVersion": string,
  "backupCrdVersions": {
    string: string,
    ...
  },

  // Union field platform_version can be only one of the following:
  "gkeVersion": string,
  "anthosVersion": string
  // End of list of possible types for union field platform_version.
}
Kolom
cluster

string

Cluster sumber tempat Cadangan ini dibuat. Format yang valid:

  • projects/*/locations/*/clusters/*
  • projects/*/zones/*/clusters/*

Opsi ini diwarisi dari kolom cluster BackupPlan induk.

k8sVersion

string

Versi server Kubernetes cluster sumber.

backupCrdVersions

map (key: string, value: string)

Daftar versi Cadangan untuk GKE CRD yang ada di cluster.

Objek yang berisi daftar pasangan "key": value. Contoh: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

Kolom union platform_version. Versi khusus platform platform_version hanya dapat berupa salah satu dari yang berikut:
gkeVersion

string

Versi GKE

anthosVersion

string

Versi Anthos

Negara bagian/Provinsi

Negara bagian/Provinsi

Enum
STATE_UNSPECIFIED Resource Cadangan sedang dalam proses pembuatan.
CREATING Resource Backup telah dibuat dan resource Kubernetes BackupJob terkait telah dimasukkan ke cluster sumber.
IN_PROGRESS Agen gkebackup di cluster telah mulai menjalankan operasi pencadangan.
SUCCEEDED Operasi pencadangan berhasil diselesaikan.
FAILED Operasi pencadangan gagal.
DELETING Resource Cadangan ini (dan artefak terkait) sedang dalam proses dihapus.

Metode

create

Membuat Pencadangan untuk BackupPlan yang ditentukan.

delete

Menghapus Cadangan yang ada.

get

Mengambil detail satu Pencadangan.

getIamPolicy

Mendapatkan kebijakan kontrol akses untuk resource.

list

Mencantumkan semua Cadangan untuk BackupPlan tertentu.

patch

Perbarui Cadangan.

setIamPolicy

Menetapkan kebijakan kontrol akses pada resource yang ditentukan.

testIamPermissions

Menampilkan izin yang dimiliki pemanggil atas resource yang ditentukan.