From 363810aaf8d1a2a1be1000ca04bc4e949cca1594 Mon Sep 17 00:00:00 2001 From: Michael Gaffney Date: Sun, 11 Oct 2020 19:01:35 -0400 Subject: [PATCH] Docs: add content to Domain Model - Hosts page (#623) --- .../docs/concepts/domain-model/hosts.mdx | 37 ++++++++++++++++--- 1 file changed, 31 insertions(+), 6 deletions(-) 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