replication.query

Type: object

Type: array
No Additional Items

Tuple Validation

Parameter 1: filters

filters

Type: array Default: []

List of filters for query results. See API documentation for "Query Methods" for more guidance.

 No Additional Items
Each item of this array must be:
Type: object

Examples:

[
    [
        "name",
        "=",
        "bob"
    ]
]

[
    [
        "OR",
        [
            [
                [
                    "name",
                    "=",
                    "bob"
                ]
            ],
            [
                [
                    "name",
                    "=",
                    "larry"
                ]
            ]
        ]
    ]
]
Parameter 2: options

options

Type: object
Default:
{ "relationships": true, "extend": null, "extend_fk": [], "extend_context": null, "prefix": null, "extra": {}, "order_by": [], "select": [], "count": false, "get": false, "offset": 0, "limit": 0, "force_sql_filters": false }

Query options customize the results returned by a query method. More complete documentation with examples
are covered in the "Query methods" section of the TrueNAS API documentation.

No Additional Properties

Relationships

Type: boolean Default: true

Extend

Default: null

Type: string
Type: null

Extend Fk

Type: array of string Default: []
No Additional Items
Each item of this array must be:
Type: string

Extend Context

Default: null

Type: string
Type: null

Prefix

Default: null

Type: string
Type: null

Extra

Type: object Default: {}

Extra options are defined on a per-endpoint basis and are described in the documentation for the associated
query method.

Order By

Type: array of string Default: []

An array of field names describing the manner in which query results should be ordered. The field names may
also have one of more of the following special prefixes: - (reverse sort direction), nulls_first: (place
any null values at the head of the results list), nulls_last: (place any null values at the tail of the
results list).

No Additional Items
Each item of this array must be:
Type: string

Example:

[
    "size",
    "-devname",
    "nulls_first:-expiretime"
]

Select

Type: array Default: []

An array of field names specifying the exact fields to include in the query return. The dot character .
may be used to explicitly select only subkeys of the query result.

No Additional Items
Each item of this array must be:

Type: string
Type: array
No Additional Items
Each item of this array must be:
Type: object

Example:

[
    "username",
    "Authentication.status"
]

Count

Type: boolean Default: false

Return a numeric value representing the number of items that match the specified query-filters.

Get

Type: boolean Default: false

Return the JSON object of the first result matching the specified query-filters. The query fails
if there specified query-filters return no results.

Offset

Type: integer Default: 0

This specifies the beginning offset of the results array. When combined with the limit query-option
it may be used to implement pagination of large results arrays. WARNING: some query methods provide
volatile results and the onus is on the developer to understand whether pagination is appropriate
for a particular query API method.

Limit

Type: integer Default: 0

This specifies the maximum number of results matching the specified query-filters to return. When
combined wtih the offset query-option it may be used to implement pagination of large results arrays.
WARNING: some query methods provide volatile results and the onus is on the developer to understand whether
pagination is appropriate for a particular query API method.

Force Sql Filters

Type: boolean Default: false

Result


Type: array of object
No Additional Items
Each item of this array must be:

ReplicationQueryResultItem

Type: object
No Additional Properties

Id

Type: integer

Name

Type: string

name for replication task

Must be at least 1 characters long

Direction

Type: enum (of string)

whether task will PUSH or PULL snapshots

Must be one of:
  • "PUSH"
  • "PULL"

Transport

Type: enum (of string)

method of snapshots transfer
* SSH transfers snapshots via SSH connection. This method is supported everywhere but does not achieve
great performance
* SSH+NETCAT uses unencrypted connection for data transfer. This can only be used in trusted networks
and requires a port (specified by range from netcat_active_side_port_min to netcat_active_side_port_max)
to be open on netcat_active_side
* LOCAL replicates to or from localhost

Must be one of:
  • "SSH"
  • "SSH+NETCAT"
  • "LOCAL"


Keychain Credential of type SSH_CREDENTIALS

KeychainCredentialEntry

Type: object
No Additional Properties

Id

Type: integer

Name

Type: string

Distinguishes 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: object

At least one of the two keys must be provided on creation.

 No Additional Properties

Private Key

Default: null

Type: string
Type: null

Public Key

Default: null

Can be omitted and automatically derived from the private key.

Type: string
Type: null

SSHCredentials

Type: object
No Additional Properties

Host

Type: string

Port

Type: integer Default: 22

Username

Type: string Default: "root"

Private Key

Type: integer

Keychain Credential ID.

Remote Host Key

Type: string

Can be discovered with keychaincredential.remotesshhostkeyscan.

Connect Timeout

Type: integer Default: 10
Type: null

Netcat Active Side


Type: enum (of string)
Must be one of:
  • "LOCAL"
  • "REMOTE"
Type: null

Netcat Active Side Listen Address


Type: string
Type: null

Netcat Active Side Port Min


Type: integer

Value must be greater or equal to 1 and lesser or equal to 65535

Type: null

Netcat Active Side Port Max


Type: integer

Value must be greater or equal to 1 and lesser or equal to 65535

Type: null

Netcat Passive Side Connect Address


Type: string
Type: null

Sudo

Type: boolean

whether SSH and SSH+NETCAT transports should use sudo (which is expected to be passwordless) to run zfs
command on the remote machine.

Source Datasets

Type: array of string

list of datasets to replicate snapshots from

Must contain a minimum of 1 items

No Additional Items
Each item of this array must be:
Type: string

Target Dataset

Type: string

dataset to put snapshots into

Recursive

Type: boolean

Exclude

Type: array of string
No Additional Items
Each item of this array must be:
Type: string

Properties

Type: boolean

whether we should send dataset properties along with snapshots

Properties Exclude

Type: array of string
No Additional Items
Each item of this array must be:
Type: string

Must be at least 1 characters long

Properties Override

Type: object

Each additional property must conform to the following schema

Type: string

Replicate

Type: boolean

Encryption

Type: boolean

Encryption Inherit


Type: boolean
Type: null

Encryption Key


Type: string
Type: null

Encryption Key Format


Type: enum (of string)
Must be one of:
  • "HEX"
  • "PASSPHRASE"
Type: null

Encryption Key Location


Type: string
Type: null

Periodic Snapshot Tasks

Type: array of object

list of periodic snapshot tasks that are sources of snapshots for this replication task. Only push replication
tasks can be bound to periodic snapshot tasks.

 No Additional Items
Each item of this array must be:

PoolSnapshotTaskDBEntry

Type: object
No Additional Properties

Dataset

Type: string

Recursive

Type: boolean Default: false

Lifetime Value

Type: integer Default: 2

Lifetime Unit

Type: enum (of string) Default: "WEEK"
Must be one of:
  • "HOUR"
  • "DAY"
  • "WEEK"
  • "MONTH"
  • "YEAR"

Enabled

Type: boolean Default: true

Exclude

Type: array of string Default: []
No Additional Items
Each item of this array must be:
Type: string

Naming Schema

Type: string Default: "auto-%Y-%m-%d_%H-%M"

Allow Empty

Type: boolean Default: true

PoolSnapshotTaskCron

Type: object
No 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)

Begin

Type: string Default: "00:00"

End

Type: string Default: "23:59"

Id

Type: integer

State

Type: string

Naming Schema

Type: array of string

list of naming schemas for pull replication

 No Additional Items
Each item of this array must be:
Type: string

Also Include Naming Schema

Type: array of string

list of naming schemas for push replication

 No Additional Items
Each item of this array must be:
Type: string

Name Regex


replicate all snapshots which names match specified regular expression

Type: string

Must be at least 1 characters long

Type: null

Auto

Type: boolean

allows replication to run automatically on schedule or after bound periodic snapshot task


schedule to run replication task. Only auto replication tasks without bound periodic snapshot tasks can have a
schedule

ReplicationTimeCronModel

Type: object
No 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)

Begin

Type: string Default: "00:00"

End

Type: string Default: "23:59"
Type: null


restricts when replication task with bound periodic snapshot tasks runs. For example, you can have periodic
snapshot tasks that run every 15 minutes, but only run replication task every hour.

ReplicationTimeCronModel

Type: object
No 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)

Begin

Type: string Default: "00:00"

End

Type: string Default: "23:59"
Type: null

Only Matching Schedule

Type: boolean

will only replicate snapshots that match schedule or restrict_schedule

Allow From Scratch

Type: boolean

will destroy all snapshots on target side and replicate everything from scratch if none of the snapshots on
target side matches source snapshots

Readonly

Type: enum (of string)

controls destination datasets readonly property:
* SET will set all destination datasets to readonly=on after finishing the replication
* REQUIRE will require all existing destination datasets to have readonly=on property
* IGNORE will avoid this kind of behavior

Must be one of:
  • "SET"
  • "REQUIRE"
  • "IGNORE"

Hold Pending Snapshots

Type: boolean

will prevent source snapshots from being deleted by retention of replication fails for some reason

Retention Policy

Type: enum (of string)

specifies how to delete old snapshots on target side:
* SOURCE deletes snapshots that are absent on source side
* CUSTOM deletes snapshots that are older than lifetime_value and lifetime_unit
* NONE does not delete any snapshots

Must be one of:
  • "SOURCE"
  • "CUSTOM"
  • "NONE"

Lifetime Value


Type: integer

Value must be greater or equal to 1

Type: null

Lifetime Unit


Type: enum (of string)
Must be one of:
  • "HOUR"
  • "DAY"
  • "WEEK"
  • "MONTH"
  • "YEAR"
Type: null

Lifetimes

Type: array of object
No Additional Items
Each item of this array must be:

ReplicationLifetimeModel

Type: object
No Additional Properties

CronModel

Type: object

Each field can either be a single value or a comma-separated list of values.
A "*" represents the full list of values.

 No Additional Properties

Minute

Type: string Default: "*"

"00" - "59"

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)

Lifetime Value

Type: integer

Value must be greater or equal to 1

Lifetime Unit

Type: enum (of string)
Must be one of:
  • "HOUR"
  • "DAY"
  • "WEEK"
  • "MONTH"
  • "YEAR"

Compression


compresses SSH stream. Available only for SSH transport

Type: enum (of string)
Must be one of:
  • "LZ4"
  • "PIGZ"
  • "PLZIP"
Type: null

Speed Limit


limits speed of SSH stream. Available only for SSH transport

Type: integer

Value must be greater or equal to 1

Type: null

Large Block

Type: boolean

Embed

Type: boolean

Compressed

Type: boolean

Retries

Type: integer

number of retries before considering replication failed

Value must be greater or equal to 1

Logging Level


Type: enum (of string)
Must be one of:
  • "DEBUG"
  • "INFO"
  • "WARNING"
  • "ERROR"
Type: null

Enabled

Type: boolean

State

Type: object

Job


Type: object
Type: null

Has Encrypted Dataset Keys

Type: boolean

ReplicationQueryResultItem

Type: object
No Additional Properties

Id

Type: integer

Name

Type: string

name for replication task

Must be at least 1 characters long

Direction

Type: enum (of string)

whether task will PUSH or PULL snapshots

Must be one of:
  • "PUSH"
  • "PULL"

Transport

Type: enum (of string)

method of snapshots transfer
* SSH transfers snapshots via SSH connection. This method is supported everywhere but does not achieve
great performance
* SSH+NETCAT uses unencrypted connection for data transfer. This can only be used in trusted networks
and requires a port (specified by range from netcat_active_side_port_min to netcat_active_side_port_max)
to be open on netcat_active_side
* LOCAL replicates to or from localhost

Must be one of:
  • "SSH"
  • "SSH+NETCAT"
  • "LOCAL"


Keychain Credential of type SSH_CREDENTIALS

Type: object
Type: null

Netcat Active Side


Type: enum (of string)
Must be one of:
  • "LOCAL"
  • "REMOTE"
Type: null

Netcat Active Side Listen Address


Type: string
Type: null

Netcat Active Side Port Min


Type: integer

Value must be greater or equal to 1 and lesser or equal to 65535

Type: null

Netcat Active Side Port Max


Type: integer

Value must be greater or equal to 1 and lesser or equal to 65535

Type: null

Netcat Passive Side Connect Address


Type: string
Type: null

Sudo

Type: boolean

whether SSH and SSH+NETCAT transports should use sudo (which is expected to be passwordless) to run zfs
command on the remote machine.

Source Datasets

Type: array of string

list of datasets to replicate snapshots from

Must contain a minimum of 1 items

No Additional Items
Each item of this array must be:
Type: string

Target Dataset

Type: string

dataset to put snapshots into

Recursive

Type: boolean

Exclude

Type: array of string
No Additional Items
Each item of this array must be:
Type: string

Properties

Type: boolean

whether we should send dataset properties along with snapshots

Properties Exclude

Type: array of string
No Additional Items
Each item of this array must be:
Type: string

Must be at least 1 characters long

Properties Override

Type: object

Each additional property must conform to the following schema

Type: string

Replicate

Type: boolean

Encryption

Type: boolean

Encryption Inherit


Type: boolean
Type: null

Encryption Key


Type: string
Type: null

Encryption Key Format


Type: enum (of string)
Must be one of:
  • "HEX"
  • "PASSPHRASE"
Type: null

Encryption Key Location


Type: string
Type: null

Periodic Snapshot Tasks

Type: array

list of periodic snapshot tasks that are sources of snapshots for this replication task. Only push replication
tasks can be bound to periodic snapshot tasks.

 No Additional Items
Each item of this array must be:
Type: object

Naming Schema

Type: array of string

list of naming schemas for pull replication

 No Additional Items
Each item of this array must be:
Type: string

Also Include Naming Schema

Type: array of string

list of naming schemas for push replication

 No Additional Items
Each item of this array must be:
Type: string

Name Regex


replicate all snapshots which names match specified regular expression

Type: string

Must be at least 1 characters long

Type: null

Auto

Type: boolean

allows replication to run automatically on schedule or after bound periodic snapshot task


schedule to run replication task. Only auto replication tasks without bound periodic snapshot tasks can have a
schedule

Type: object
Type: null


restricts when replication task with bound periodic snapshot tasks runs. For example, you can have periodic
snapshot tasks that run every 15 minutes, but only run replication task every hour.

Type: object
Type: null

Only Matching Schedule

Type: boolean

will only replicate snapshots that match schedule or restrict_schedule

Allow From Scratch

Type: boolean

will destroy all snapshots on target side and replicate everything from scratch if none of the snapshots on
target side matches source snapshots

Readonly

Type: enum (of string)

controls destination datasets readonly property:
* SET will set all destination datasets to readonly=on after finishing the replication
* REQUIRE will require all existing destination datasets to have readonly=on property
* IGNORE will avoid this kind of behavior

Must be one of:
  • "SET"
  • "REQUIRE"
  • "IGNORE"

Hold Pending Snapshots

Type: boolean

will prevent source snapshots from being deleted by retention of replication fails for some reason

Retention Policy

Type: enum (of string)

specifies how to delete old snapshots on target side:
* SOURCE deletes snapshots that are absent on source side
* CUSTOM deletes snapshots that are older than lifetime_value and lifetime_unit
* NONE does not delete any snapshots

Must be one of:
  • "SOURCE"
  • "CUSTOM"
  • "NONE"

Lifetime Value


Type: integer

Value must be greater or equal to 1

Type: null

Lifetime Unit


Type: enum (of string)
Must be one of:
  • "HOUR"
  • "DAY"
  • "WEEK"
  • "MONTH"
  • "YEAR"
Type: null

Lifetimes

Type: array
No Additional Items
Each item of this array must be:
Type: object

Compression


compresses SSH stream. Available only for SSH transport

Type: enum (of string)
Must be one of:
  • "LZ4"
  • "PIGZ"
  • "PLZIP"
Type: null

Speed Limit


limits speed of SSH stream. Available only for SSH transport

Type: integer

Value must be greater or equal to 1

Type: null

Large Block

Type: boolean

Embed

Type: boolean

Compressed

Type: boolean

Retries

Type: integer

number of retries before considering replication failed

Value must be greater or equal to 1

Logging Level


Type: enum (of string)
Must be one of:
  • "DEBUG"
  • "INFO"
  • "WARNING"
  • "ERROR"
Type: null

Enabled

Type: boolean

State

Type: object

Job


Type: object
Type: null

Has Encrypted Dataset Keys

Type: boolean
Type: integer


Required roles: REPLICATION_TASK_READ