Schedule [velero.io/v1]

描述
Schedule is a Velero resource that represents a pre-scheduled or periodic Backup that should be run.
类型
object

规格

属性类型描述
apiVersionstring

APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

kindstring

Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

metadataObjectMeta

ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create.

specobject

ScheduleSpec defines the specification for a Velero schedule

statusobject

ScheduleStatus captures the current state of a Velero schedule

.spec

描述
ScheduleSpec defines the specification for a Velero schedule
类型
object
必填
scheduletemplate
属性类型描述
pausedboolean

Paused specifies whether the schedule is paused or not

schedulestring

Schedule is a Cron expression defining when to run the Backup.

skipImmediatelyboolean

SkipImmediately specifies whether to skip backup if schedule is due immediately from schedule.status.lastBackup timestamp when schedule is unpaused or if schedule is new. If true, backup will be skipped immediately when schedule is unpaused if it is due based on .Status.LastBackupTimestamp or schedule is new, and will run at next schedule time. If false, backup will not be skipped immediately when schedule is unpaused, but will run at next schedule time. If empty, will follow server configuration (default: false).

templateobject

Template is the definition of the Backup to be run on the provided schedule

useOwnerReferencesInBackupboolean

UseOwnerReferencesBackup specifies whether to use OwnerReferences on backups created by this Schedule.

.spec.template

描述
Template is the definition of the Backup to be run on the provided schedule
类型
object
属性类型描述
csiSnapshotTimeoutstring

CSISnapshotTimeout specifies the time used to wait for CSI VolumeSnapshot status turns to ReadyToUse during creation, before returning error as timeout. The default value is 10 minute.

datamoverstring

DataMover specifies the data mover to be used by the backup. If DataMover is "" or "velero", the built-in data mover will be used.

defaultVolumesToFsBackupboolean

DefaultVolumesToFsBackup specifies whether pod volume file system backup should be used for all volumes by default.

defaultVolumesToResticboolean

DefaultVolumesToRestic specifies whether restic should be used to take a backup of all pod volumes by default.

Deprecated: this field is no longer used and will be removed entirely in future. Use DefaultVolumesToFsBackup instead.

excludedClusterScopedResourcesarray

ExcludedClusterScopedResources is a slice of cluster-scoped resource type names to exclude from the backup. If set to "*", all cluster-scoped resource types are excluded. The default value is empty.

excludedNamespaceScopedResourcesarray

ExcludedNamespaceScopedResources is a slice of namespace-scoped resource type names to exclude from the backup. If set to "*", all namespace-scoped resource types are excluded. The default value is empty.

excludedNamespacesarray

ExcludedNamespaces contains a list of namespaces that are not included in the backup.

excludedResourcesarray

ExcludedResources is a slice of resource names that are not included in the backup.

hooksobject

Hooks represent custom behaviors that should be executed at different phases of the backup.

includeClusterResourcesboolean

IncludeClusterResources specifies whether cluster-scoped resources should be included for consideration in the backup.

includedClusterScopedResourcesarray

IncludedClusterScopedResources is a slice of cluster-scoped resource type names to include in the backup. If set to "*", all cluster-scoped resource types are included. The default value is empty, which means only related cluster-scoped resources are included.

includedNamespaceScopedResourcesarray

IncludedNamespaceScopedResources is a slice of namespace-scoped resource type names to include in the backup. The default value is "*".

includedNamespacesarray

IncludedNamespaces is a slice of namespace names to include objects from. If empty, all namespaces are included.

includedResourcesarray

IncludedResources is a slice of resource names to include in the backup. If empty, all resources are included.

itemOperationTimeoutstring

ItemOperationTimeout specifies the time used to wait for asynchronous BackupItemAction operations The default value is 4 hour.

labelSelectorobject

LabelSelector is a metav1.LabelSelector to filter with when adding individual objects to the backup. If empty or nil, all objects are included. Optional.

metadataObjectMeta

ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create.

orLabelSelectorsarray

OrLabelSelectors is list of metav1.LabelSelector to filter with when adding individual objects to the backup. If multiple provided they will be joined by the OR operator. LabelSelector as well as OrLabelSelectors cannot co-exist in backup request, only one of them can be used.

orderedResourcesobject

OrderedResources specifies the backup order of resources of specific Kind. The map key is the resource name and value is a list of object names separated by commas. Each resource name has format "namespace/objectname". For cluster resources, simply use "objectname".

resourcePolicyobject

ResourcePolicy specifies the referenced resource policies that backup should follow

snapshotMoveDataboolean

SnapshotMoveData specifies whether snapshot data should be moved

snapshotVolumesboolean

SnapshotVolumes specifies whether to take snapshots of any PV's referenced in the set of objects included in the Backup.

storageLocationstring

StorageLocation is a string containing the name of a BackupStorageLocation where the backup should be stored.

ttlstring

TTL is a time.Duration-parseable string describing how long the Backup should be retained for.

uploaderConfigobject

UploaderConfig specifies the configuration for the uploader.

volumeSnapshotLocationsarray

VolumeSnapshotLocations is a list containing names of VolumeSnapshotLocations associated with this backup.

.spec.template.excludedClusterScopedResources

描述
ExcludedClusterScopedResources is a slice of cluster-scoped resource type names to exclude from the backup. If set to "*", all cluster-scoped resource types are excluded. The default value is empty.
类型
array

.spec.template.excludedClusterScopedResources[]

类型
string

.spec.template.excludedNamespaceScopedResources

描述
ExcludedNamespaceScopedResources is a slice of namespace-scoped resource type names to exclude from the backup. If set to "*", all namespace-scoped resource types are excluded. The default value is empty.
类型
array

.spec.template.excludedNamespaceScopedResources[]

类型
string

.spec.template.excludedNamespaces

描述
ExcludedNamespaces contains a list of namespaces that are not included in the backup.
类型
array

.spec.template.excludedNamespaces[]

类型
string

.spec.template.excludedResources

描述
ExcludedResources is a slice of resource names that are not included in the backup.
类型
array

.spec.template.excludedResources[]

类型
string

.spec.template.hooks

描述
Hooks represent custom behaviors that should be executed at different phases of the backup.
类型
object
属性类型描述
resourcesarray

Resources are hooks that should be executed when backing up individual instances of a resource.

.spec.template.hooks.resources

描述
Resources are hooks that should be executed when backing up individual instances of a resource.
类型
array

.spec.template.hooks.resources[]

描述
BackupResourceHookSpec defines one or more BackupResourceHooks that should be executed based on the rules defined for namespaces, resources, and label selector.
类型
object
必填
name
属性类型描述
excludedNamespacesarray

ExcludedNamespaces specifies the namespaces to which this hook spec does not apply.

excludedResourcesarray

ExcludedResources specifies the resources to which this hook spec does not apply.

includedNamespacesarray

IncludedNamespaces specifies the namespaces to which this hook spec applies. If empty, it applies to all namespaces.

includedResourcesarray

IncludedResources specifies the resources to which this hook spec applies. If empty, it applies to all resources.

labelSelectorobject

LabelSelector, if specified, filters the resources to which this hook spec applies.

namestring

Name is the name of this hook.

postarray

PostHooks is a list of BackupResourceHooks to execute after storing the item in the backup. These are executed after all "additional items" from item actions are processed.

prearray

PreHooks is a list of BackupResourceHooks to execute prior to storing the item in the backup. These are executed before any "additional items" from item actions are processed.

.spec.template.hooks.resources[].excludedNamespaces

描述
ExcludedNamespaces specifies the namespaces to which this hook spec does not apply.
类型
array

.spec.template.hooks.resources[].excludedNamespaces[]

类型
string

.spec.template.hooks.resources[].excludedResources

描述
ExcludedResources specifies the resources to which this hook spec does not apply.
类型
array

.spec.template.hooks.resources[].excludedResources[]

类型
string

.spec.template.hooks.resources[].includedNamespaces

描述
IncludedNamespaces specifies the namespaces to which this hook spec applies. If empty, it applies to all namespaces.
类型
array

.spec.template.hooks.resources[].includedNamespaces[]

类型
string

.spec.template.hooks.resources[].includedResources

描述
IncludedResources specifies the resources to which this hook spec applies. If empty, it applies to all resources.
类型
array

.spec.template.hooks.resources[].includedResources[]

类型
string

.spec.template.hooks.resources[].labelSelector

描述
LabelSelector, if specified, filters the resources to which this hook spec applies.
类型
object
属性类型描述
matchExpressionsarray

matchExpressions is a list of label selector requirements. The requirements are ANDed.

matchLabelsobject

matchLabels is a map of {key,value} pairs. A single {key,value} in the matchLabels map is equivalent to an element of matchExpressions, whose key field is "key", the operator is "In", and the values array contains only "value". The requirements are ANDed.

.spec.template.hooks.resources[].labelSelector.matchExpressions

描述
matchExpressions is a list of label selector requirements. The requirements are ANDed.
类型
array

.spec.template.hooks.resources[].labelSelector.matchExpressions[]

描述
A label selector requirement is a selector that contains values, a key, and an operator that relates the key and values.
类型
object
必填
keyoperator
属性类型描述
keystring

key is the label key that the selector applies to.

operatorstring

operator represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists and DoesNotExist.

valuesarray

values is an array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. This array is replaced during a strategic merge patch.

.spec.template.hooks.resources[].labelSelector.matchExpressions[].values

描述
values is an array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. This array is replaced during a strategic merge patch.
类型
array

.spec.template.hooks.resources[].labelSelector.matchExpressions[].values[]

类型
string

.spec.template.hooks.resources[].labelSelector.matchLabels

描述
matchLabels is a map of {key,value} pairs. A single {key,value} in the matchLabels map is equivalent to an element of matchExpressions, whose key field is "key", the operator is "In", and the values array contains only "value". The requirements are ANDed.
类型
object

.spec.template.hooks.resources[].post

描述
PostHooks is a list of BackupResourceHooks to execute after storing the item in the backup. These are executed after all "additional items" from item actions are processed.
类型
array

.spec.template.hooks.resources[].post[]

描述
BackupResourceHook defines a hook for a resource.
类型
object
必填
exec
属性类型描述
execobject

Exec defines an exec hook.

.spec.template.hooks.resources[].post[].exec

描述
Exec defines an exec hook.
类型
object
必填
command
属性类型描述
commandarray

Command is the command and arguments to execute.

containerstring

Container is the container in the pod where the command should be executed. If not specified, the pod's first container is used.

onErrorstring

OnError specifies how Velero should behave if it encounters an error executing this hook.

timeoutstring

Timeout defines the maximum amount of time Velero should wait for the hook to complete before considering the execution a failure.

.spec.template.hooks.resources[].post[].exec.command

描述
Command is the command and arguments to execute.
类型
array

.spec.template.hooks.resources[].post[].exec.command[]

类型
string

.spec.template.hooks.resources[].pre

描述
PreHooks is a list of BackupResourceHooks to execute prior to storing the item in the backup. These are executed before any "additional items" from item actions are processed.
类型
array

.spec.template.hooks.resources[].pre[]

描述
BackupResourceHook defines a hook for a resource.
类型
object
必填
exec
属性类型描述
execobject

Exec defines an exec hook.

.spec.template.hooks.resources[].pre[].exec

描述
Exec defines an exec hook.
类型
object
必填
command
属性类型描述
commandarray

Command is the command and arguments to execute.

containerstring

Container is the container in the pod where the command should be executed. If not specified, the pod's first container is used.

onErrorstring

OnError specifies how Velero should behave if it encounters an error executing this hook.

timeoutstring

Timeout defines the maximum amount of time Velero should wait for the hook to complete before considering the execution a failure.

.spec.template.hooks.resources[].pre[].exec.command

描述
Command is the command and arguments to execute.
类型
array

.spec.template.hooks.resources[].pre[].exec.command[]

类型
string

.spec.template.includedClusterScopedResources

描述
IncludedClusterScopedResources is a slice of cluster-scoped resource type names to include in the backup. If set to "*", all cluster-scoped resource types are included. The default value is empty, which means only related cluster-scoped resources are included.
类型
array

.spec.template.includedClusterScopedResources[]

类型
string

.spec.template.includedNamespaceScopedResources

描述
IncludedNamespaceScopedResources is a slice of namespace-scoped resource type names to include in the backup. The default value is "*".
类型
array

.spec.template.includedNamespaceScopedResources[]

类型
string

.spec.template.includedNamespaces

描述
IncludedNamespaces is a slice of namespace names to include objects from. If empty, all namespaces are included.
类型
array

.spec.template.includedNamespaces[]

类型
string

.spec.template.includedResources

描述
IncludedResources is a slice of resource names to include in the backup. If empty, all resources are included.
类型
array

.spec.template.includedResources[]

类型
string

.spec.template.labelSelector

描述
LabelSelector is a metav1.LabelSelector to filter with when adding individual objects to the backup. If empty or nil, all objects are included. Optional.
类型
object
属性类型描述
matchExpressionsarray

matchExpressions is a list of label selector requirements. The requirements are ANDed.

matchLabelsobject

matchLabels is a map of {key,value} pairs. A single {key,value} in the matchLabels map is equivalent to an element of matchExpressions, whose key field is "key", the operator is "In", and the values array contains only "value". The requirements are ANDed.

.spec.template.labelSelector.matchExpressions

描述
matchExpressions is a list of label selector requirements. The requirements are ANDed.
类型
array

.spec.template.labelSelector.matchExpressions[]

描述
A label selector requirement is a selector that contains values, a key, and an operator that relates the key and values.
类型
object
必填
keyoperator
属性类型描述
keystring

key is the label key that the selector applies to.

operatorstring

operator represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists and DoesNotExist.

valuesarray

values is an array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. This array is replaced during a strategic merge patch.

.spec.template.labelSelector.matchExpressions[].values

描述
values is an array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. This array is replaced during a strategic merge patch.
类型
array

.spec.template.labelSelector.matchExpressions[].values[]

类型
string

.spec.template.labelSelector.matchLabels

描述
matchLabels is a map of {key,value} pairs. A single {key,value} in the matchLabels map is equivalent to an element of matchExpressions, whose key field is "key", the operator is "In", and the values array contains only "value". The requirements are ANDed.
类型
object

.spec.template.orLabelSelectors

描述
OrLabelSelectors is list of metav1.LabelSelector to filter with when adding individual objects to the backup. If multiple provided they will be joined by the OR operator. LabelSelector as well as OrLabelSelectors cannot co-exist in backup request, only one of them can be used.
类型
array

.spec.template.orLabelSelectors[]

描述
A label selector is a label query over a set of resources. The result of matchLabels and matchExpressions are ANDed. An empty label selector matches all objects. A null label selector matches no objects.
类型
object
属性类型描述
matchExpressionsarray

matchExpressions is a list of label selector requirements. The requirements are ANDed.

matchLabelsobject

matchLabels is a map of {key,value} pairs. A single {key,value} in the matchLabels map is equivalent to an element of matchExpressions, whose key field is "key", the operator is "In", and the values array contains only "value". The requirements are ANDed.

.spec.template.orLabelSelectors[].matchExpressions

描述
matchExpressions is a list of label selector requirements. The requirements are ANDed.
类型
array

.spec.template.orLabelSelectors[].matchExpressions[]

描述
A label selector requirement is a selector that contains values, a key, and an operator that relates the key and values.
类型
object
必填
keyoperator
属性类型描述
keystring

key is the label key that the selector applies to.

operatorstring

operator represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists and DoesNotExist.

valuesarray

values is an array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. This array is replaced during a strategic merge patch.

.spec.template.orLabelSelectors[].matchExpressions[].values

描述
values is an array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. This array is replaced during a strategic merge patch.
类型
array

.spec.template.orLabelSelectors[].matchExpressions[].values[]

类型
string

.spec.template.orLabelSelectors[].matchLabels

描述
matchLabels is a map of {key,value} pairs. A single {key,value} in the matchLabels map is equivalent to an element of matchExpressions, whose key field is "key", the operator is "In", and the values array contains only "value". The requirements are ANDed.
类型
object

.spec.template.orderedResources

描述
OrderedResources specifies the backup order of resources of specific Kind. The map key is the resource name and value is a list of object names separated by commas. Each resource name has format "namespace/objectname". For cluster resources, simply use "objectname".
类型
object

.spec.template.resourcePolicy

描述
ResourcePolicy specifies the referenced resource policies that backup should follow
类型
object
必填
kindname
属性类型描述
apiGroupstring

APIGroup is the group for the resource being referenced. If APIGroup is not specified, the specified Kind must be in the core API group. For any other third-party types, APIGroup is required.

kindstring

Kind is the type of resource being referenced

namestring

Name is the name of resource being referenced

.spec.template.uploaderConfig

描述
UploaderConfig specifies the configuration for the uploader.
类型
object
属性类型描述
parallelFilesUploadinteger

ParallelFilesUpload is the number of files parallel uploads to perform when using the uploader.

.spec.template.volumeSnapshotLocations

描述
VolumeSnapshotLocations is a list containing names of VolumeSnapshotLocations associated with this backup.
类型
array

.spec.template.volumeSnapshotLocations[]

类型
string

.status

描述
ScheduleStatus captures the current state of a Velero schedule
类型
object
属性类型描述
lastBackupstring

LastBackup is the last time a Backup was run for this Schedule schedule

lastSkippedstring

LastSkipped is the last time a Schedule was skipped

phasestring

Phase is the current phase of the Schedule

validationErrorsarray

ValidationErrors is a slice of all validation errors (if applicable)

.status.validationErrors

描述
ValidationErrors is a slice of all validation errors (if applicable)
类型
array

.status.validationErrors[]

类型
string

API 端点

可用的 API 端点如下:

  • /apis/velero.io/v1/namespaces/{namespace}/schedules
    • DELETE: delete collection of Schedule
    • GET: list objects of kind Schedule
    • POST: create a new Schedule
  • /apis/velero.io/v1/namespaces/{namespace}/schedules/{name}
    • DELETE: delete the specified Schedule
    • GET: read the specified Schedule
    • PATCH: partially update the specified Schedule
    • PUT: replace the specified Schedule

/apis/velero.io/v1/namespaces/{namespace}/schedules

HTTP 方法
DELETE
描述
delete collection of Schedule
HTTP 响应
HTTP 状态码响应体
200 - OKStatus schema
401 - UnauthorizedEmpty
HTTP 方法
GET
描述
list objects of kind Schedule
HTTP 响应
HTTP 状态码响应体
200 - OKScheduleList schema
401 - UnauthorizedEmpty
HTTP 方法
POST
描述
create a new Schedule
查询参数
参数类型描述
dryRunstringWhen present, indicates that modifications should not be persisted. An invalid or unrecognized dryRun directive will result in an error response and no further processing of the request. Valid values are: - All: all dry run stages will be processed
fieldValidationstringfieldValidation instructs the server on how to handle objects in the request (POST/PUT/PATCH) containing unknown or duplicate fields. Valid values are: - Ignore: This will ignore any unknown fields that are silently dropped from the object, and will ignore all but the last duplicate field that the decoder encounters. This is the default behavior prior to v1.23. - Warn: This will send a warning via the standard warning response header for each unknown field that is dropped from the object, and for each duplicate field that is encountered. The request will still succeed if there are no other errors, and will only persist the last of any duplicate fields. This is the default in v1.23+ - Strict: This will fail the request with a BadRequest error if any unknown fields would be dropped from the object, or if any duplicate fields are present. The error returned from the server will contain all unknown and duplicate fields encountered.
请求体参数
参数类型描述
bodySchedule schemaapplication/json formatted
HTTP 响应
HTTP 状态码响应体
200 - OKSchedule schema
201 - CreatedSchedule schema
202 - AcceptedSchedule schema
401 - UnauthorizedEmpty

/apis/velero.io/v1/namespaces/{namespace}/schedules/{name}

HTTP 方法
DELETE
描述
delete the specified Schedule
查询参数
参数类型描述
dryRunstringWhen present, indicates that modifications should not be persisted. An invalid or unrecognized dryRun directive will result in an error response and no further processing of the request. Valid values are: - All: all dry run stages will be processed
HTTP 响应
HTTP 状态码响应体
200 - OKStatus schema
202 - AcceptedStatus schema
401 - UnauthorizedEmpty
HTTP 方法
GET
描述
read the specified Schedule
HTTP 响应
HTTP 状态码响应体
200 - OKSchedule schema
401 - UnauthorizedEmpty
HTTP 方法
PATCH
描述
partially update the specified Schedule
查询参数
参数类型描述
dryRunstringWhen present, indicates that modifications should not be persisted. An invalid or unrecognized dryRun directive will result in an error response and no further processing of the request. Valid values are: - All: all dry run stages will be processed
fieldValidationstringfieldValidation instructs the server on how to handle objects in the request (POST/PUT/PATCH) containing unknown or duplicate fields. Valid values are: - Ignore: This will ignore any unknown fields that are silently dropped from the object, and will ignore all but the last duplicate field that the decoder encounters. This is the default behavior prior to v1.23. - Warn: This will send a warning via the standard warning response header for each unknown field that is dropped from the object, and for each duplicate field that is encountered. The request will still succeed if there are no other errors, and will only persist the last of any duplicate fields. This is the default in v1.23+ - Strict: This will fail the request with a BadRequest error if any unknown fields would be dropped from the object, or if any duplicate fields are present. The error returned from the server will contain all unknown and duplicate fields encountered.
HTTP 响应
HTTP 状态码响应体
200 - OKSchedule schema
401 - UnauthorizedEmpty
HTTP 方法
PUT
描述
replace the specified Schedule
查询参数
参数类型描述
dryRunstringWhen present, indicates that modifications should not be persisted. An invalid or unrecognized dryRun directive will result in an error response and no further processing of the request. Valid values are: - All: all dry run stages will be processed
fieldValidationstringfieldValidation instructs the server on how to handle objects in the request (POST/PUT/PATCH) containing unknown or duplicate fields. Valid values are: - Ignore: This will ignore any unknown fields that are silently dropped from the object, and will ignore all but the last duplicate field that the decoder encounters. This is the default behavior prior to v1.23. - Warn: This will send a warning via the standard warning response header for each unknown field that is dropped from the object, and for each duplicate field that is encountered. The request will still succeed if there are no other errors, and will only persist the last of any duplicate fields. This is the default in v1.23+ - Strict: This will fail the request with a BadRequest error if any unknown fields would be dropped from the object, or if any duplicate fields are present. The error returned from the server will contain all unknown and duplicate fields encountered.
请求体参数
参数类型描述
bodySchedule schemaapplication/json formatted
HTTP 响应
HTTP 状态码响应体
200 - OKSchedule schema
201 - CreatedSchedule schema
401 - UnauthorizedEmpty