crds-catalog/postgresql.cnpg.io/scheduledbackup_v1.json

150 lines
7.1 KiB
JSON
Raw Normal View History

2023-03-08 12:21:48 +00:00
{
"description": "ScheduledBackup is the Schema for the scheduledbackups API",
"properties": {
"apiVersion": {
2024-03-14 17:07:14 +00:00
"description": "APIVersion defines the versioned schema of this representation of an object.\nServers should convert recognized schemas to the latest internal value, and\nmay reject unrecognized values.\nMore info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources",
2023-03-08 12:21:48 +00:00
"type": "string"
},
"kind": {
2024-03-14 17:07:14 +00:00
"description": "Kind is a string value representing the REST resource this object represents.\nServers may infer this from the endpoint the client submits requests to.\nCannot be updated.\nIn CamelCase.\nMore info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds",
2023-03-08 12:21:48 +00:00
"type": "string"
},
"metadata": {
"type": "object"
},
"spec": {
2024-03-14 17:07:14 +00:00
"description": "Specification of the desired behavior of the ScheduledBackup.\nMore info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status",
2023-03-08 12:21:48 +00:00
"properties": {
"backupOwnerReference": {
"default": "none",
2024-03-14 17:07:14 +00:00
"description": "Indicates which ownerReference should be put inside the created backup resources.<br />\n- none: no owner reference for created backup objects (same behavior as before the field was introduced)<br />\n- self: sets the Scheduled backup object as owner of the backup<br />\n- cluster: set the cluster as owner of the backup<br />",
2023-03-08 12:21:48 +00:00
"enum": [
"none",
"self",
"cluster"
],
"type": "string"
},
"cluster": {
"description": "The cluster to backup",
"properties": {
"name": {
"description": "Name of the referent.",
"type": "string"
}
},
"required": [
"name"
],
"type": "object",
"additionalProperties": false
},
"immediate": {
"description": "If the first backup has to be immediately start after creation or not",
"type": "boolean"
},
2023-10-11 22:08:19 +00:00
"method": {
"default": "barmanObjectStore",
2024-07-29 17:12:29 +00:00
"description": "The backup method to be used, possible options are `barmanObjectStore`,\n`volumeSnapshot` or `plugin`. Defaults to: `barmanObjectStore`.",
2023-10-11 22:08:19 +00:00
"enum": [
"barmanObjectStore",
2024-07-29 17:12:29 +00:00
"volumeSnapshot",
"plugin"
2023-10-11 22:08:19 +00:00
],
"type": "string"
},
2023-11-03 12:02:43 +00:00
"online": {
2024-03-14 17:07:14 +00:00
"description": "Whether the default type of backup with volume snapshots is\nonline/hot (`true`, default) or offline/cold (`false`)\nOverrides the default setting specified in the cluster field '.spec.backup.volumeSnapshot.online'",
2023-11-03 12:02:43 +00:00
"type": "boolean"
},
"onlineConfiguration": {
2024-03-14 17:07:14 +00:00
"description": "Configuration parameters to control the online/hot backup with volume snapshots\nOverrides the default settings specified in the cluster '.backup.volumeSnapshot.onlineConfiguration' stanza",
2023-11-03 12:02:43 +00:00
"properties": {
"immediateCheckpoint": {
2024-03-14 17:07:14 +00:00
"description": "Control whether the I/O workload for the backup initial checkpoint will\nbe limited, according to the `checkpoint_completion_target` setting on\nthe PostgreSQL server. If set to true, an immediate checkpoint will be\nused, meaning PostgreSQL will complete the checkpoint as soon as\npossible. `false` by default.",
2023-11-03 12:02:43 +00:00
"type": "boolean"
},
"waitForArchive": {
"default": true,
2024-03-14 17:07:14 +00:00
"description": "If false, the function will return immediately after the backup is completed,\nwithout waiting for WAL to be archived.\nThis behavior is only useful with backup software that independently monitors WAL archiving.\nOtherwise, WAL required to make the backup consistent might be missing and make the backup useless.\nBy default, or when this parameter is true, pg_backup_stop will wait for WAL to be archived when archiving is\nenabled.\nOn a standby, this means that it will wait only when archive_mode = always.\nIf write activity on the primary is low, it may be useful to run pg_switch_wal on the primary in order to trigger\nan immediate segment switch.",
2023-11-03 12:02:43 +00:00
"type": "boolean"
}
},
"type": "object",
"additionalProperties": false
2024-04-24 23:06:45 +00:00
},
"pluginConfiguration": {
"description": "Configuration parameters passed to the plugin managing this backup",
"properties": {
"name": {
"description": "Name is the name of the plugin managing this backup",
"type": "string"
},
"parameters": {
"additionalProperties": {
"type": "string"
},
"description": "Parameters are the configuration parameters passed to the backup\nplugin for this backup",
"type": "object"
}
},
"required": [
"name"
],
"type": "object",
"additionalProperties": false
2023-11-03 12:02:43 +00:00
},
2023-03-08 12:21:48 +00:00
"schedule": {
2024-03-14 17:07:14 +00:00
"description": "The schedule does not follow the same format used in Kubernetes CronJobs\nas it includes an additional seconds specifier,\nsee https://pkg.go.dev/github.com/robfig/cron#hdr-CRON_Expression_Format",
2023-03-08 12:21:48 +00:00
"type": "string"
},
"suspend": {
"description": "If this backup is suspended or not",
"type": "boolean"
2023-03-20 10:09:04 +00:00
},
"target": {
2024-03-14 17:07:14 +00:00
"description": "The policy to decide which instance should perform this backup. If empty,\nit defaults to `cluster.spec.backup.target`.\nAvailable options are empty string, `primary` and `prefer-standby`.\n`primary` to have backups run always on primary instances,\n`prefer-standby` to have backups run preferably on the most updated\nstandby, if available.",
2023-03-20 10:09:04 +00:00
"enum": [
"primary",
"prefer-standby"
],
"type": "string"
2023-03-08 12:21:48 +00:00
}
},
"required": [
2023-10-11 21:09:09 +00:00
"cluster",
2023-03-08 12:21:48 +00:00
"schedule"
],
"type": "object",
"additionalProperties": false
},
"status": {
2024-03-14 17:07:14 +00:00
"description": "Most recently observed status of the ScheduledBackup. This data may not be up\nto date. Populated by the system. Read-only.\nMore info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status",
2023-03-08 12:21:48 +00:00
"properties": {
"lastCheckTime": {
"description": "The latest time the schedule",
"format": "date-time",
"type": "string"
},
"lastScheduleTime": {
"description": "Information when was the last time that backup was successfully scheduled.",
"format": "date-time",
"type": "string"
},
"nextScheduleTime": {
"description": "Next time we will run a backup",
"format": "date-time",
"type": "string"
}
},
"type": "object",
"additionalProperties": false
}
},
2023-10-11 21:09:09 +00:00
"required": [
"metadata",
"spec"
],
2023-03-08 12:21:48 +00:00
"type": "object"
}