Schedule [velero.io/v1]

Description
Schedule is a Velero resource that represents a pre-scheduled or periodic Backup that should be run.
Type
object

Specification

PropertyTypeDescription
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

Description
ScheduleSpec defines the specification for a Velero schedule
Type
object
Required
scheduletemplate
PropertyTypeDescription
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

Description
Template is the definition of the Backup to be run on the provided schedule
Type
object
PropertyTypeDescription
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

Description
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.
Type
array

.spec.template.excludedClusterScopedResources[]

Type
string

.spec.template.excludedNamespaceScopedResources

Description
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.
Type
array

.spec.template.excludedNamespaceScopedResources[]

Type
string

.spec.template.excludedNamespaces

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

.spec.template.excludedNamespaces[]

Type
string

.spec.template.excludedResources

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

.spec.template.excludedResources[]

Type
string

.spec.template.hooks

Description
Hooks represent custom behaviors that should be executed at different phases of the backup.
Type
object
PropertyTypeDescription
resourcesarray

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

.spec.template.hooks.resources

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

.spec.template.hooks.resources[]

Description
BackupResourceHookSpec defines one or more BackupResourceHooks that should be executed based on the rules defined for namespaces, resources, and label selector.
Type
object
Required
name
PropertyTypeDescription
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

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

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

Type
string

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

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

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

Type
string

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

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

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

Type
string

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

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

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

Type
string

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

Description
LabelSelector, if specified, filters the resources to which this hook spec applies.
Type
object
PropertyTypeDescription
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

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

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

Description
A label selector requirement is a selector that contains values, a key, and an operator that relates the key and values.
Type
object
Required
keyoperator
PropertyTypeDescription
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

Description
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.
Type
array

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

Type
string

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

Description
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.
Type
object

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

Description
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.
Type
array

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

Description
BackupResourceHook defines a hook for a resource.
Type
object
Required
exec
PropertyTypeDescription
execobject

Exec defines an exec hook.

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

Description
Exec defines an exec hook.
Type
object
Required
command
PropertyTypeDescription
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

Description
Command is the command and arguments to execute.
Type
array

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

Type
string

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

Description
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.
Type
array

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

Description
BackupResourceHook defines a hook for a resource.
Type
object
Required
exec
PropertyTypeDescription
execobject

Exec defines an exec hook.

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

Description
Exec defines an exec hook.
Type
object
Required
command
PropertyTypeDescription
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

Description
Command is the command and arguments to execute.
Type
array

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

Type
string

.spec.template.includedClusterScopedResources

Description
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.
Type
array

.spec.template.includedClusterScopedResources[]

Type
string

.spec.template.includedNamespaceScopedResources

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

.spec.template.includedNamespaceScopedResources[]

Type
string

.spec.template.includedNamespaces

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

.spec.template.includedNamespaces[]

Type
string

.spec.template.includedResources

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

.spec.template.includedResources[]

Type
string

.spec.template.labelSelector

Description
LabelSelector is a metav1.LabelSelector to filter with when adding individual objects to the backup. If empty or nil, all objects are included. Optional.
Type
object
PropertyTypeDescription
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

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

.spec.template.labelSelector.matchExpressions[]

Description
A label selector requirement is a selector that contains values, a key, and an operator that relates the key and values.
Type
object
Required
keyoperator
PropertyTypeDescription
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

Description
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.
Type
array

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

Type
string

.spec.template.labelSelector.matchLabels

Description
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.
Type
object

.spec.template.orLabelSelectors

Description
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.
Type
array

.spec.template.orLabelSelectors[]

Description
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.
Type
object
PropertyTypeDescription
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

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

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

Description
A label selector requirement is a selector that contains values, a key, and an operator that relates the key and values.
Type
object
Required
keyoperator
PropertyTypeDescription
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

Description
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.
Type
array

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

Type
string

.spec.template.orLabelSelectors[].matchLabels

Description
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.
Type
object

.spec.template.orderedResources

Description
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".
Type
object

.spec.template.resourcePolicy

Description
ResourcePolicy specifies the referenced resource policies that backup should follow
Type
object
Required
kindname
PropertyTypeDescription
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

Description
UploaderConfig specifies the configuration for the uploader.
Type
object
PropertyTypeDescription
parallelFilesUploadinteger

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

.spec.template.volumeSnapshotLocations

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

.spec.template.volumeSnapshotLocations[]

Type
string

.status

Description
ScheduleStatus captures the current state of a Velero schedule
Type
object
PropertyTypeDescription
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

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

.status.validationErrors[]

Type
string

API Endpoints

The following API endpoints are available:

  • /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/{name}/status
    • GET: read status of the specified Schedule
    • PATCH: partially update status of the specified Schedule
    • PUT: replace status of the specified Schedule

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

HTTP method
DELETE
Description
delete collection of Schedule
HTTP responses
HTTP codeResponse body
200 - OKStatus schema
401 - UnauthorizedEmpty
HTTP method
GET
Description
list objects of kind Schedule
HTTP responses
HTTP codeResponse body
200 - OKScheduleList schema
401 - UnauthorizedEmpty
HTTP method
POST
Description
create a new Schedule
Query parameters
ParameterTypeDescription
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.
Body parameters
ParameterTypeDescription
bodySchedule schemaapplication/json formatted
HTTP responses
HTTP codeResponse body
200 - OKSchedule schema
201 - CreatedSchedule schema
202 - AcceptedSchedule schema
401 - UnauthorizedEmpty

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

HTTP method
DELETE
Description
delete the specified Schedule
Query parameters
ParameterTypeDescription
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 responses
HTTP codeResponse body
200 - OKStatus schema
202 - AcceptedStatus schema
401 - UnauthorizedEmpty
HTTP method
GET
Description
read the specified Schedule
HTTP responses
HTTP codeResponse body
200 - OKSchedule schema
401 - UnauthorizedEmpty
HTTP method
PATCH
Description
partially update the specified Schedule
Query parameters
ParameterTypeDescription
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 responses
HTTP codeResponse body
200 - OKSchedule schema
401 - UnauthorizedEmpty
HTTP method
PUT
Description
replace the specified Schedule
Query parameters
ParameterTypeDescription
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.
Body parameters
ParameterTypeDescription
bodySchedule schemaapplication/json formatted
HTTP responses
HTTP codeResponse body
200 - OKSchedule schema
201 - CreatedSchedule schema
401 - UnauthorizedEmpty

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

HTTP method
GET
Description
read status of the specified Schedule
HTTP responses
HTTP codeResponse body
200 - OKSchedule schema
401 - UnauthorizedEmpty
HTTP method
PATCH
Description
partially update status of the specified Schedule
Query parameters
ParameterTypeDescription
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 responses
HTTP codeResponse body
200 - OKSchedule schema
401 - UnauthorizedEmpty
HTTP method
PUT
Description
replace status of the specified Schedule
Query parameters
ParameterTypeDescription
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.
Body parameters
ParameterTypeDescription
bodySchedule schemaapplication/json formatted
HTTP responses
HTTP codeResponse body
200 - OKSchedule schema
201 - CreatedSchedule schema
401 - UnauthorizedEmpty