Host Sets

A host set is a resource that represents a collection of hosts which are considered equivalent for the purposes of access control. A host set can only include hosts from the same host catalog as the host set. A target can reference host sets from host catalogs which belong to the same project as the target.

Attributes

A host set has the following configurable attributes:

  • name - (optional) If set, the name must be unique within the host set’s parent host catalog.

  • description - (optional)

  • preferred_endpoints - (optional) A list of selector strings in the format of either cidr:<valid IPv4/6 CIDR> or dns:<globbed name> used to select the addresses of hosts when establishing a session with a target.

Plugin Host Set Attributes

  • attributes - (optional) A collection of fields which the plugin uses to lookup which hosts should be members of this host set. Often this includes a type of filter using a syntax which is usable by the backing service.

  • sync_interval_seconds - (optional) The number of seconds between the time boundary syncs the hosts in this set using this host set’s plugin. If not provided a system determined default is used.

Referenced By

Service API Docs

The following services are relevant to this resource: