Skip to main content

AttributeFilter

Filter by an effective attribute.

Each filter targets a single attribute key and matches against the resource's effective attributes — its own attributes plus any it inherits from its ancestors (project → environment → component → instance). A team attribute set on a project therefore also matches that project's environments and instances.

Pass a list of attribute filters to require several attributes at once; the entries are combined with AND. Within a single entry, use in to match any of several values for that key.

# Resources whose effective "team" attribute is "payments"
{ "attributes": [{ "key": "team", "eq": "payments" }] }

# Resources whose effective "team" is "payments" AND "tier" is "prod" or "staging"
{
"attributes": [
{ "key": "team", "eq": "payments" },
{ "key": "tier", "in": ["prod", "staging"] }
]
}
input AttributeFilter {
key: String!
eq: String
in: [String!]
}

Fields

AttributeFilter.key ● String! non-null scalar {#key}

The attribute key to match, e.g. team or cost_center.

AttributeFilter.eq ● String scalar {#eq}

Return only resources whose value for this key exactly equals this string.

AttributeFilter.in ● [String!] list scalar {#in}

Return resources whose value for this key matches any string in this list.

Member Of

EnvironmentsFilter input ● InstancesFilter input ● ProjectsFilter input