AQL Entities and Fields Reference

Complete field reference for all AQL domains — item, build, promotion, property, statistic, artifact, module, dependency, and release bundle fields with types and descriptions.

This page provides the complete field reference for all AQL domains. Use these field names in your .find() criteria and .include() output specifications.

You may issue a find request on any primary domain, and configure your request to display fields from any of the related domains. For information on cross-domain field paths, see Query Structure and Syntax.

Item Domain Fields

Field NameTypeDescription
repoStringThe name of the repository in which this item is stored.
pathStringThe full path associated with this item. Note: The path for a folder should not include a /*, whereas for items it is required.
nameStringThe name of the item.
createdDateThe date when the item was created.
modifiedDateFile system timestamp indicating when the item was last modified.
updatedDateWhen the item was last uploaded to a repository.
created_byStringThe name of the item owner.
modified_byStringThe name of the last user that modified the item.
typeEnumThe item type (file/folder/any). If type is not specified in the query, the default type searched for is file.
depthIntThe depth of the item in the path from the root folder.
original_md5StringThe item's MD5 hash code when it was originally uploaded.
actual_md5StringThe item's current MD5 hash code.
original_sha1StringThe item's SHA1 hash code when it was originally uploaded.
actual_sha1StringThe item's current SHA1 hash code.
sha256StringThe item's SHA256 hash code. Supported from Artifactory version 5.5.
sizeLongThe item's size on disk.
virtual_reposStringThe virtual repositories which contain the repository in which this item is stored.

Example query using Item domain fields:

items.find({"repo": "libs-release-local", "name": {"$match": "*.jar"}}).include("name", "path", "size", "sha256")

Build Domain Fields

Field NameTypeDescription
urlStringThe URL of the build.
nameStringThe build name.
numberStringThe build number.
createdDateFile system timestamp indicating when the build was created.
created_byStringThe name of the user who created the build.
modifiedDateFile system timestamp indicating when the build was last modified.
modified_byStringThe name of the last user that modified the build.
startedDateThe build start time. Taken from the build's build-info.json file. This field is immutable and does not change upon build promotion or replication.
repoStringThe repository associated with the build.

Example query using Build domain fields:

builds.find({"name": "my-build", "created": {"$last": "7d"}}).include("name", "number", "started")

Promotion Domain Fields

Field NameTypeDescription
createdDateWhen the build was promoted.
created_byStringThe Artifactory user that promoted the build.
statusStringThe status of the promotion.
repoStringThe name of the repository to which the build was promoted.
commentStringA free text comment about the promotion.
userStringThe CI server user that promoted the build.

Property Domain Fields

Field NameTypeDescription
keyStringThe property key.
valueStringThe property value.

Statistic Domain Fields

Field NameTypeDescription
downloadedDateThe last time an item was downloaded.
downloadsIntThe total number of downloads for an item.
downloaded_byStringThe name of the last user to download this item.
remote_downloadsIntThe total number of downloads from a smart remote repository proxying the local repository.
remote_downloadedDateThe last time an item was downloaded from a smart remote repository proxy.
remote_downloaded_byStringThe name of the last user to download from a smart remote repository proxy.
remote_originStringThe address of the remote Artifactory instance along a smart remote proxy chain.
remote_pathStringThe full path along a smart remote proxy chain.

Example query using Statistic domain fields:

items.find({"stat.downloads": {"$gt": "100"}}).include("name", "repo", "stat.downloads", "stat.downloaded")

Artifact Domain Fields

Field NameTypeDescription
nameStringThe name of the artifact.
typeStringThe type of the artifact.
sha1StringThe SHA1 hash code of the artifact.
md5StringThe MD5 hash code of the artifact.

Module and Dependency Domain Fields

Module Fields

Field NameTypeDescription
nameStringThe name of the module.

Dependency Fields

Field NameTypeDescription
nameStringThe name of the dependency.
scopeStringThe scope of the dependency.
typeStringThe type of the dependency.
sha1StringThe SHA1 hash code of the dependency.
md5StringThe MD5 hash code of the dependency.

Release Domain Fields

Field NameTypeDescription
nameStringThe name of the release bundle.
versionStringThe version of the release bundle.
statusStringThe status of the release bundle.
createdStringThe date when the release bundle was created.
signatureStringThe release bundle signature.
typeStringThe type of the release bundle.
storing_repoStringThe repository storing the release bundle.
keepIntThe retention setting for the release bundle.
source_service_idStringThe source service identifier for the release bundle.

Release Artifact Fields

Field NameTypeDescription
pathStringThe release artifact full repo path.

Item Info Domain Fields

The Item Info domain provides metadata about property modifications on items. It can be queried as a primary domain using item.infos.find(...).

Field NameTypeDescription
item_idLongThe ID of the item associated with this info record.
props_modifiedDateThe date when the item's properties were last modified.
props_modified_byStringThe name of the user who last modified the item's properties.
props_md5StringThe MD5 checksum of the item's properties.

Deprecated Domains and Fields

📘

Deprecated: Archive Domain

The Archive domain and all related fields are deprecated and no longer functional since Q3 2024. Using any archive-related syntax will result in a query parsing error.

The following fields are deprecated and should not be used:

DomainField NameTypeStatus
archive(no fields)--Deprecated since Q3 2024
entrynameStringDeprecated
entrypathStringDeprecated

Related Topics