rsynctask.create¶
Create a Rsync Task.
No Additional Items
Tuple Validation
Parameter 1: rsync_task_create
rsync_task_create
Type: objectNo Additional Properties
Path
Type: stringSee the comment in Rsyncmod about path
length limits.
Must be at most 1023
characters long
User
Type: stringMode
Type: enum (of string) Default: "MODULE"different operating mechanisms for Rsync i.e Rsync Module mode / Rsync SSH mode
Must be one of:
- "MODULE"
- "SSH"
Remotehost
Default: nullip address or hostname of the remote system. If username differs on the remote host, "username@remote_host"
format should be used.
Remoteport
Default: nullRemotemodule
Default: nullname of remote module, this attribute should be specified when mode
is set to MODULE.
Ssh Credentials
Default: nullthe path on the remote system.
Remotepath
Type: stringwill automatically add remote host key to user's known_hosts file
Direction
Type: enum (of string) Default: "PUSH"specifies if data should be PULLED or PUSHED from the remote system
Must be one of:
- "PULL"
- "PUSH"
Desc
Type: string Default: ""RsyncTaskSchedule
Type: objectNo Additional Properties
Minute
Type: string Default: "00"Hour
Type: string Default: "*""00" - "23"
Dom
Type: string Default: "*""1" - "31"
Month
Type: string Default: "*""1" (January) - "12" (December)
Dow
Type: string Default: "*""1" (Monday) - "7" (Sunday)
Recursive
Type: boolean Default: trueTimes
Type: boolean Default: trueCompress
Type: boolean Default: truewhen set reduces the size of the data which is to be transmitted.
Archive
Type: boolean Default: falsewhen set makes rsync run recursively, preserving symlinks, permissions, modification times, group, and special
files.
Delete
Type: boolean Default: falsewhen set deletes files in the destination directory which do not exist in the source directory.
Quiet
Type: boolean Default: falsePreserveperm
Type: boolean Default: falsewhen set preserves original file permissions.
Preserveattr
Type: boolean Default: falseDelayupdates
Type: boolean Default: trueExtra
Type: array of stringNo Additional Items
Each item of this array must be:
Enabled
Type: boolean Default: trueValidate Rpath
Type: boolean Default: trueboolean which when sets validates the existence of the remote path
Ssh Keyscan
Type: boolean Default: falseRsyncTaskEntry
Type: objectNo Additional Properties
Id
Type: integerPath
Type: stringSee the comment in Rsyncmod about path
length limits.
Must be at most 1023
characters long
User
Type: stringMode
Type: enum (of string) Default: "MODULE"different operating mechanisms for Rsync i.e Rsync Module mode / Rsync SSH mode
Must be one of:
- "MODULE"
- "SSH"
Remotehost
Default: nullip address or hostname of the remote system. If username differs on the remote host, "username@remote_host"
format should be used.
Remoteport
Default: nullRemotemodule
Default: nullname of remote module, this attribute should be specified when mode
is set to MODULE.
In SSH mode, if ssh_credentials
(a keychain credential of SSH_CREDENTIALS
type) is specified then it is used
to connect to the remote host. If it is not specified, then keys in user
's .ssh directory are used.
KeychainCredentialEntry
Type: objectNo Additional Properties
Id
Type: integerName
Type: stringDistinguishes this Keychain Credential from others.
Must be at least 1
characters long
Type
Type: enum (of string)Must be one of:
- "SSH_KEY_PAIR"
- "SSH_CREDENTIALS"
Attributes
SSHKeyPair
Type: objectAt least one of the two keys must be provided on creation.
No Additional PropertiesPrivate Key
Default: nullPublic Key
Default: nullCan be omitted and automatically derived from the private key.
SSHCredentials
Type: objectNo Additional Properties
Host
Type: stringPort
Type: integer Default: 22Username
Type: string Default: "root"Private Key
Type: integerKeychain Credential ID.
Remote Host Key
Type: stringCan be discovered with keychaincredential.remotesshhostkeyscan.
Connect Timeout
Type: integer Default: 10Remotepath
Type: stringwill automatically add remote host key to user's known_hosts file
Direction
Type: enum (of string) Default: "PUSH"specifies if data should be PULLED or PUSHED from the remote system
Must be one of:
- "PULL"
- "PUSH"
Desc
Type: string Default: ""RsyncTaskSchedule
Type: objectNo Additional Properties
Minute
Type: string Default: "00"Hour
Type: string Default: "*""00" - "23"
Dom
Type: string Default: "*""1" - "31"
Month
Type: string Default: "*""1" (January) - "12" (December)
Dow
Type: string Default: "*""1" (Monday) - "7" (Sunday)
Recursive
Type: boolean Default: trueTimes
Type: boolean Default: trueCompress
Type: boolean Default: truewhen set reduces the size of the data which is to be transmitted.
Archive
Type: boolean Default: falsewhen set makes rsync run recursively, preserving symlinks, permissions, modification times, group, and special
files.
Delete
Type: boolean Default: falsewhen set deletes files in the destination directory which do not exist in the source directory.
Quiet
Type: boolean Default: falsePreserveperm
Type: boolean Default: falsewhen set preserves original file permissions.
Preserveattr
Type: boolean Default: falseDelayupdates
Type: boolean Default: trueExtra
Type: array of stringNo Additional Items
Each item of this array must be:
Enabled
Type: boolean Default: trueLocked
Type: booleanJob
Required roles: SNAPSHOT_TASK_WRITE