ParamDimensionFilter

Filter instances by the value of a configuration parameter at a specific JSON path.

Parameter dimensions let you slice your infrastructure by any value in an instance's configuration — for example, filtering by database engine, instance size, or region. Use the paramDimensions query to discover which dimensions are available for your instances.

# All instances using "db.r5.xlarge"
{
  "params": {
    "dimension": ".database.instance_type",
    "eq": "db.r5.xlarge"
  }
}

# All instances whose region contains "us-east"
{
  "params": {
    "dimension": ".region",
    "contains": "us-east"
  }
}

input ParamDimensionFilter {
  dimension: String!
  eq: String
  in: [String!]
  contains: String
}

Fields

ParamDimensionFilter.dimension ● String! non-null scalar {#dimension}

jq-style path to the configuration parameter (e.g., ".database.instance_type" or ".containers[0].image"). Use the paramDimensions query to discover available paths.

ParamDimensionFilter.eq ● String scalar {#eq}

Return only instances whose parameter value exactly equals this string.

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

Return instances whose parameter value matches any string in this list.

ParamDimensionFilter.contains ● String scalar {#contains}

Return instances whose parameter value contains this substring (case-insensitive).

Member Of

InstancesFilter input