public
AutomationRule

List all Automation Rules in an Environment.

Changed on
get/orgs/{orgId}/apps/{appId}/envs/{envId}/rules

Request

  • Base URL
    https://api.humanitec.io
  • URL
    https://api.humanitec.io/orgs/{orgId}/apps/{appId}/envs/{envId}/rules
  • Auth
    none declared

Path parameters

orgIdstring required

The Organization ID

appIdstring required

The Application ID

envIdstring required

The Environment ID

Response

A possibly empty array of Automation Rules

activeboolean required

Whether the rule will be processed or not.

artefacts_filterstring[] required

A list of artefact names to be processed by the rule. If the array is empty, it implies include all. If exclude_artefacts_filter is true, this list describes the artefacts to exclude.

created_atstring date-time required

The timestamp in UTC of when the Automation Rule was created.

exclude_artefacts_filterboolean required

Whether the artefacts specified in artefacts_filter should be excluded (true) or included (false) in the automation rule.

exclude_images_filterboolean required

DEPRECATED: Whether the images specified in images_filter should be excluded (true) or included (false) in the automation rule.

idstring required

The unique ID for this rule.

images_filterstring[] required

DEPRECATED: A list of image IDs to be processed by the rule. If the array is empty, it implies include all. If exclude_images_filter is true, this list describes images to exclude.

matchstring required

DEPRECATED: A regular expression applied to the branch or tag name depending on the value of update_to. Defaults to match all if omitted or empty.

match_refstring required

A regular expression applied to the ref of a new artefact version. Defaults to match all if omitted or empty.

typestring required

Specifies the type of event. Currently, only updates to either branches or tags are supported. Must be "update".

update_tostring required

DEPRECATED: Specifies whether the update occurs on commit to branch or creation of tag. Must be one of "branch" or "tag".

updated_atstring date-time required

The timestamp in UTC of when the Automation Rule was updated.

Example response

[
  {
    "active": true,
    "artefacts_filter": [
      "http://registry.org/sample-service"
    ],
    "created_at": "2020-06-22T09:37:23.523Z",
    "id": "923486d012f20324",
    "images_filter": [
      "sample-service"
    ],
    "match": "^pr-[0-9]+-.*$",
    "match_ref": "^refs/heads/pr-[0-9]+-.*$",
    "type": "update",
    "update_to": "branch",
    "updated_at": "2020-06-22T09:37:23.523Z"
  }
]

Changes