feat: refactor prefix format errors

internal/servers/controller/handlers/host_sets/host_set_service.go

@@ -412,6 +412,10 @@ func toProto(in *static.HostSet, hs []*static.Host) *pb.HostSet {
 	return &out
 }
 
+func invalidResourcePrefix(r, p string) string {
+	return fmt.Sprintf("The resource ID prefix is incorrectly formatted, '%s' resources begin with '%s'", r, p)
+}
+
 // A validateX method should exist for each method above.  These methods do not make calls to any backing service but enforce
 // requirements on the structure of the request.  They verify that:
 //  * The path passed in is correctly formatted
@@ -426,14 +430,15 @@ func validateGetRequest(req *pbs.GetHostSetRequest) error {
 func validateCreateRequest(req *pbs.CreateHostSetRequest) error {
 	return handlers.ValidateCreateRequest(req.GetItem(), func() map[string]string {
 		badFields := map[string]string{}
-		if !handlers.ValidId(static.HostCatalogPrefix, req.GetItem().GetHostCatalogId()) {
-			badFields["host_catalog_id"] = "The field is incorrectly formatted."
-		}
+
 		switch host.SubtypeFromId(req.GetItem().GetHostCatalogId()) {
 		case host.StaticSubtype:
 			if req.GetItem().GetType() != "" && req.GetItem().GetType() != host.StaticSubtype.String() {
 				badFields["type"] = "Doesn't match the parent resource's type."
 			}
+			if !handlers.ValidId(static.HostCatalogPrefix, req.GetItem().GetHostCatalogId()) {
+				badFields["host_catalog_id"] = invalidResourcePrefix("Host Catalog", static.HostCatalogPrefix)
+			}
 		}
 		return badFields
 	})
@@ -458,8 +463,11 @@ func validateDeleteRequest(req *pbs.DeleteHostSetRequest) error {
 
 func validateListRequest(req *pbs.ListHostSetsRequest) error {
 	badFields := map[string]string{}
-	if !handlers.ValidId(static.HostCatalogPrefix, req.GetHostCatalogId()) {
-		badFields["host_catalog_id"] = "The field is incorrectly formatted."
+	switch host.SubtypeFromId(req.GetItem().GetHostCatalogId()) {
+	case host.StaticSubtype:
+		if !handlers.ValidId(static.HostCatalogPrefix, req.GetItem().GetHostCatalogId()) {
+			badFields["host_catalog_id"] = invalidResourcePrefix("Host Catalog", static.HostCatalogPrefix)
+		}
 	}
 	if len(badFields) > 0 {
 		return handlers.InvalidArgumentErrorf("Improperly formatted identifier.", badFields)

internal/servers/controller/handlers/verifiers.go

@@ -149,6 +149,8 @@ func ValidateDeleteRequest(prefix string, r DeleteRequest, fn CustomValidatorFun
 
 var reInvalidID = regexp.MustCompile("[^A-Za-z0-9]")
 
+// ValidId verifies the resource prefix to ensure it's a valid resource in the
+// Boundary domain model
 func ValidId(prefix, id string) bool {
 	prefix = prefix + "_"
 	if !strings.HasPrefix(id, prefix) {