diff --git a/website/content/docs/concepts/domain-model/hosts.mdx b/website/content/docs/concepts/domain-model/hosts.mdx index 5ef8891ab0..28b5aff96e 100644 --- a/website/content/docs/concepts/domain-model/hosts.mdx +++ b/website/content/docs/concepts/domain-model/hosts.mdx @@ -8,11 +8,36 @@ description: |- # Hosts -A host is a computing element with a network address reachable from Boundary. -A Host belongs to one and only one Host Catalog. -A Host can be contained by zero or more Host Sets. -Host is abstract. -A Host is deleted when the Host Catalog it belongs to is deleted. -The lifecycle of a Host is not tied to the lifecycle of any Host Sets. +A host is a resource +that represents a computing element with a network address +reachable from Boundary. +A host belongs to a [host catalog][]. +A host can only be included +by [host sets][] +from the same host catalog as the host. ## Attributes + +A host has the following configurable attributes: + +- `name` - (optional) + If set, the `name` must be unique within the host's parent [host catalog][]. + +- `description` - (optional) + +### Static Host Attributes + +Static host types have the following additional attribute: + +- `address` - (required) + Must be at least 3 characters long and not greater than 255 characters. + +## Referenced By + +- [Host Catalog][] +- [Host Set][] + +[host catalog]: /docs/concepts/domain-model/host-catalogs +[host catalogs]: /docs/concepts/domain-model/host-catalogs +[host set]: /docs/concepts/domain-model/host-sets +[host sets]: /docs/concepts/domain-model/host-sets