48 lines
1.2 KiB
Plaintext
48 lines
1.2 KiB
Plaintext
---
|
|
layout: docs
|
|
page_title: Domain Model - Host Sets
|
|
sidebar_title: Host Sets
|
|
description: |-
|
|
The anatomy of a Boundary host set
|
|
---
|
|
|
|
# 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)
|
|
|
|
## Referenced By
|
|
|
|
- [Host][]
|
|
- [Host Catalog][]
|
|
- [Target][]
|
|
|
|
[host catalog]: /docs/concepts/domain-model/host-catalogs
|
|
[host catalogs]: /docs/concepts/domain-model/host-catalogs
|
|
[host]: /docs/concepts/domain-model/hosts
|
|
[hosts]: /docs/concepts/domain-model/hosts
|
|
[project]: /docs/concepts/domain-model/scopes#projects
|
|
[projects]: /docs/concepts/domain-model/scopes#projects
|
|
[target]: /docs/concepts/domain-model/targets
|
|
[targets]: /docs/concepts/domain-model/targets
|
|
|
|
## Service API Docs
|
|
|
|
The following services are relevant to this resource:
|
|
|
|
* [Host Set Service](/api-docs/host-set-service) |