Using AQL With Remote Repositories

Searching Remote Repositories

From Artifactory version 7.17.4, you can search directly within Smart Remote repositories (pointing to a local repository on a different remote instance of Artifactory). This requires providing credentials to the remote Artifactory on the remote repository configuration under the Basic tab.

To enable a search within a remote repository, add the transitive tag to the search query.

items.find(“repo”: “remote-repo”).transitive()

Rules and Guidelines for Using AQL in Remote Repositories

The following rules and guidelines apply when searching remote and virtual repositories:

The remote repository MUST be an Artifactory instance.
The query MUST include a single repository and a $eq clause.
Example
```
items.find(“repo”: “remote-repo”).transitive()
```
You cannot use Sort and Offset flags within the AQL Query.
The primary domain can only contain Items.
Include may only have the following domains: Items and ItemProperties.
The search will run on the first five remote repositories within the virtual repository.