Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

On This Page

Table of Contents

Overview

Files may be Filtering allows you to set rules that determine which items are included in or excluded from transfers the transfer. Files may be filtered based on metadata attributes, file size, item name patterns, and extensions. This feature is useful for customers who need to transfer only a subset of items based on certain file characteristics.

DryvIQ applies the job filters to all items that have changed on subsequent job runs. This means that an item that did not transfer on a previous job run may transfer on a subsequent run due to changes that cause the item to now meet an include filter criteria. Similarly, an item that originally transferred could be skipped if the update causes the item to now meet an exclude filter criteria.

...

Info

Filtering is not available for intelligent migration jobs.

Adding Custom Filters

When you choose to add a custom filter, you must first choose if you are adding an “include” or “exclude” filter. Once you select the filter type, you can select the specific filters rules you want to add. Based on the rule type you select, you will specify additional information for the rule. Refer to the pages linked below to learn more about each filter rule you can add.

...

Note

If you need to add multiple rules to an include or exclude filter, you must ensure you handle them as follows:

Multiple Exclude Filters: You must add a separate exclude filter for each rule you want to use.

Multiple Include Filters: You must add all rules to one include filter.

Info

When using multiple filters, any include filters will be overwritten/ignored if an overlapping exclude filter is included on the job. For example, if you choose to include a specific file based on path but the file type meets a type specified in an exclude filter, the file will not transfer. 

Image Removed

Image Removed

Note

You cannot use Filtering and Scripting together to add filters to the job. Any filters added using scripting will be overwritten by any custom filters added on the Filtering page.

Job Filter Options

For information about specific filters, refer to the corresponding documentation page.

Child pages (Children Display)

General REST API Format

Filters are applied through the REST API by adding a filter block within the transfer block of a transfer job body when calling the REST API (POST .../v1/jobs) or using the CLI to create a job. A source or destination block or both may be defined. Each refers to the source and destination connections for the job. Note that the filter block is placed within the transfer block. The action value is set to either exclude or include.

Include items that match any rule: Transfer items that match any of the defined rules in this filter. Exclude all other content.

Exclude items that match any rule: Exclude items that match any of the defined rules in this filter. All other content will be transferred.

Info

If the action attribute is missing or set to null, the default action is set to exclude.

...