BuildLocator
Represents a locator string for filtering Build entities. Examples:
id:1
— find build with ID1
.buildType:<buildTypeLocator>
— find builds under build configuration found bybuildTypeLocator
.defaultFilter:false,agent:<agentLocator>
— find builds executed on agent found byagentLocator
, withdefaultFilter
disabled (see below).
Properties
Dimension | Data type | Format | Description |
---|---|---|---|
|
| Project (direct or indirect parent) locator. | |
|
| Agent locator. | |
|
|
| typeId of agent used to execute build. |
|
| State can be any. | |
|
| ||
|
| Branch locator. | |
|
| Build type locator. | |
|
| Is canceled. | |
|
| Agent locator. | |
|
| Is composite. | |
|
|
| For paginated calls, how many entities to return per page. |
|
| If true, applies default filter which returns only "normal" builds (finished builds which are not canceled, not failed-to-start, not personal, and on default branch (in branched build configurations)). | |
|
| Is failed to start. | |
|
|
| Requires either date or build dimension. |
|
| Is finished. | |
|
| Is hanging. | |
|
| Is history build. | |
|
| Entity ID. | |
|
|
| Supply multiple locators and return a union of the results. |
|
|
| Limit processing to the latest |
|
| Build number string. | |
|
| Is a personal build. | |
|
| Is pinned. | |
|
| Project (direct parent) locator. | |
|
|
| Supported values:
|
|
| Is queued. | |
|
|
| Requires either date or build dimension. |
|
| Build revision. | |
|
| Is running. | |
|
| ||
|
|
| For paginated calls, from which entity to start rendering the page. |
|
|
| Requires either date or build dimension. |
|
| Supported values:
| |
|
| Status text. | |
|
| Tag locator. | |
|
|
| ID of a build or build promotion. |
|
| For personal builds checks the owner of the build, triggerring user in other cases. |