feat(api): Support plugin host external_name field

Author: Hugo Vieira

api/hosts/host.gen.go

@@ -72,6 +72,7 @@ const (
 	DnsNamesField                               = "dns_names"
 	SecretsHmacField                            = "secrets_hmac"
 	ExternalIdField                             = "external_id"
+	ExternalNameField                           = "external_name"
 	InjectedApplicationCredentialSourceIdsField = "injected_application_credential_source_ids"
 	InjectedApplicationCredentialSourcesField   = "injected_application_credential_sources"
 	ConnectionsField                            = "connections"

globals/fields.go

@@ -598,6 +598,9 @@ func toProto(ctx context.Context, in host.Host, opt ...handlers.Option) (*pb.Hos
 		if outputFields.Has(globals.ExternalIdField) {
 			out.ExternalId = h.ExternalId
 		}
+		if outputFields.Has(globals.ExternalNameField) {
+			out.ExternalName = h.ExternalName
+		}
 	}
 	return &out, nil
 }

internal/daemon/controller/handlers/hosts/host_service.go

@@ -165,8 +165,11 @@ func TestGet_Plugin(t *testing.T) {
 		return static.NewRepository(rw, rw, kms)
 	}
 	hc := plugin.TestCatalog(t, conn, proj.GetPublicId(), plg.GetPublicId())
-	h := plugin.TestHost(t, conn, hc.GetPublicId(), "test")
-	hPrev := plugin.TestHost(t, conn, hc.GetPublicId(), "test-prev", plugin.WithPublicId(fmt.Sprintf("%s_1234567890", globals.PluginHostPreviousPrefix)))
+	h := plugin.TestHost(t, conn, hc.GetPublicId(), "test", plugin.WithExternalName("test-ext-name"))
+	hPrev := plugin.TestHost(t, conn, hc.GetPublicId(), "test-prev",
+		plugin.WithPublicId(fmt.Sprintf("%s_1234567890", globals.PluginHostPreviousPrefix)),
+		plugin.WithExternalName("test-prev-name"),
+	)
 	hs := plugin.TestSet(t, conn, kms, sche, hc, plgm)
 	plugin.TestSetMembers(t, conn, hs.GetPublicId(), []*plugin.Host{h, hPrev})
 
@@ -184,6 +187,7 @@ func TestGet_Plugin(t *testing.T) {
 		},
 		HostSetIds:        []string{hs.GetPublicId()},
 		ExternalId:        "test",
+		ExternalName:      "test-ext-name",
 		AuthorizedActions: testAuthorizedActions[plugin.Subtype],
 	}
 
@@ -207,6 +211,7 @@ func TestGet_Plugin(t *testing.T) {
 				resp.CreatedTime = hPrev.CreateTime.GetTimestamp()
 				resp.UpdatedTime = hPrev.UpdateTime.GetTimestamp()
 				resp.ExternalId = "test-prev"
+				resp.ExternalName = "test-prev-name"
 				return &pbs.GetHostResponse{Item: resp}
 			}(),
 		},
@@ -397,7 +402,7 @@ func TestList_Plugin(t *testing.T) {
 	var wantHs []*pb.Host
 	for i := 0; i < 10; i++ {
 		extId := fmt.Sprintf("host %d", i)
-		h := plugin.TestHost(t, conn, hc.GetPublicId(), extId)
+		h := plugin.TestHost(t, conn, hc.GetPublicId(), extId, plugin.WithExternalName(fmt.Sprintf("ext-name-%d", i)))
 		plugin.TestSetMembers(t, conn, hs.GetPublicId(), []*plugin.Host{h})
 		wantHs = append(wantHs, &pb.Host{
 			Id:            h.GetPublicId(),
@@ -413,6 +418,7 @@ func TestList_Plugin(t *testing.T) {
 			HostSetIds:        []string{hs.GetPublicId()},
 			Version:           1,
 			ExternalId:        extId,
+			ExternalName:      fmt.Sprintf("ext-name-%d", i),
 			Type:              plugin.Subtype.String(),
 			AuthorizedActions: testAuthorizedActions[plugin.Subtype],
 		})

internal/daemon/controller/handlers/hosts/host_service_test.go

@@ -4711,6 +4711,11 @@
           "description": "Output only. The external ID of the host, if any.",
           "readOnly": true
         },
+        "external_name": {
+          "type": "string",
+          "description": "Output only. Refers to the name for a given host provided by the plugin enabled backing service.",
+          "readOnly": true
+        },
         "authorized_actions": {
           "type": "array",
           "items": {

internal/gen/controller.swagger.json

@@ -88,6 +88,9 @@ message Host {
   // Output only. The external ID of the host, if any.
   string external_id = 140; // @gotags: `class:"public"`
 
+  // Output only. Refers to the name for a given host provided by the plugin enabled backing service.
+  string external_name = 150; // @gotags: `class:"public"`
+
   // Output only. The available actions on this resource for this user.
   repeated string authorized_actions = 300 [json_name = "authorized_actions"]; // @gotags: `class:"public"`
 }