ResourceTargetingCriteria interface

Model that represents a set of targeting criteria for resource selection. Used on both the include and exclude sides of ResourceTargeting.

All dimensions use unified null/empty semantics:

  • Null or omitted means "no constraint" (this dimension is inactive).
  • Empty array is treated the same as null (no constraint).
  • Non-empty array means the dimension is active.

Properties

locations

Array of Azure location strings (e.g., "eastus", "westeurope", "global"). Case-insensitive, normalized form only (e.g., "eastus" not "East US").

physicalZones

Array of physical datacenter zone identifiers in {region}-az{N} format (e.g., "westus2-az1"). Resolved to logical zones per-subscription at execution time.

Mutually exclusive with zones — set one or the other, not both.

resources

Array of fully qualified Azure resource IDs. Case-insensitive equality.

tags

Array of tag key-value pairs for filtering by Azure resource tags. Key and value are matched case-insensitively. Use "*" as value to match any value for a key.

types

Array of Azure resource type strings (e.g., "Microsoft.Compute/virtualMachines"). Case-insensitive equality. Supports trailing wildcard (e.g., "Microsoft.Compute/*").

zones

Array of logical availability zone identifiers (e.g., "1", "2", "3", "zone-redundant").

Mutually exclusive with physicalZones — set one or the other, not both. When set, locations must also be set on the same side (zone IDs are only meaningful within a region).

Property Details

locations

Array of Azure location strings (e.g., "eastus", "westeurope", "global"). Case-insensitive, normalized form only (e.g., "eastus" not "East US").

locations?: string[]

Property Value

string[]

physicalZones

Array of physical datacenter zone identifiers in {region}-az{N} format (e.g., "westus2-az1"). Resolved to logical zones per-subscription at execution time.

Mutually exclusive with zones — set one or the other, not both.

physicalZones?: string[]

Property Value

string[]

resources

Array of fully qualified Azure resource IDs. Case-insensitive equality.

resources?: string[]

Property Value

string[]

tags

Array of tag key-value pairs for filtering by Azure resource tags. Key and value are matched case-insensitively. Use "*" as value to match any value for a key.

tags?: KeyValuePair[]

Property Value

types

Array of Azure resource type strings (e.g., "Microsoft.Compute/virtualMachines"). Case-insensitive equality. Supports trailing wildcard (e.g., "Microsoft.Compute/*").

types?: string[]

Property Value

string[]

zones

Array of logical availability zone identifiers (e.g., "1", "2", "3", "zone-redundant").

Mutually exclusive with physicalZones — set one or the other, not both. When set, locations must also be set on the same side (zone IDs are only meaningful within a region).

zones?: string[]

Property Value

string[]