Add support for description to tag template fields (#8810) (#4650) (#3128)

Co-authored-by: Geir Sagberg <[email protected]>
Signed-off-by: Modular Magician <[email protected]>

Co-authored-by: Geir Sagberg <[email protected]>

Author: modular-magician

.changelog/4650.txt

@@ -0,0 +1,3 @@
+```release-note:enhancement
+datacatalog: added `description` field to `google_data_catalog_tag_template ` resource
+```

google-beta/resource_data_catalog_tag_template.go

@@ -96,6 +96,11 @@ Can have up to 500 allowed values.`,
 								},
 							},
 						},
+						"description": {
+							Type:        schema.TypeString,
+							Optional:    true,
+							Description: `A description for this field.`,
+						},
 						"display_name": {
 							Type:        schema.TypeString,
 							Optional:    true,
@@ -429,6 +434,7 @@ func flattenDataCatalogTagTemplateFields(v interface{}, d *schema.ResourceData,
 			"field_id":     k,
 			"name":         flattenDataCatalogTagTemplateFieldsName(original["name"], d, config),
 			"display_name": flattenDataCatalogTagTemplateFieldsDisplayName(original["displayName"], d, config),
+			"description":  flattenDataCatalogTagTemplateFieldsDescription(original["description"], d, config),
 			"type":         flattenDataCatalogTagTemplateFieldsType(original["type"], d, config),
 			"is_required":  flattenDataCatalogTagTemplateFieldsIsRequired(original["isRequired"], d, config),
 			"order":        flattenDataCatalogTagTemplateFieldsOrder(original["order"], d, config),
@@ -444,6 +450,10 @@ func flattenDataCatalogTagTemplateFieldsDisplayName(v interface{}, d *schema.Res
 	return v
 }
 
+func flattenDataCatalogTagTemplateFieldsDescription(v interface{}, d *schema.ResourceData, config *Config) interface{} {
+	return v
+}
+
 func flattenDataCatalogTagTemplateFieldsType(v interface{}, d *schema.ResourceData, config *Config) interface{} {
 	if v == nil {
 		return nil
@@ -546,6 +556,13 @@ func expandDataCatalogTagTemplateFields(v interface{}, d TerraformResourceData,
 			transformed["displayName"] = transformedDisplayName
 		}
 
+		transformedDescription, err := expandDataCatalogTagTemplateFieldsDescription(original["description"], d, config)
+		if err != nil {
+			return nil, err
+		} else if val := reflect.ValueOf(transformedDescription); val.IsValid() && !isEmptyValue(val) {
+			transformed["description"] = transformedDescription
+		}
+
 		transformedType, err := expandDataCatalogTagTemplateFieldsType(original["type"], d, config)
 		if err != nil {
 			return nil, err
@@ -584,6 +601,10 @@ func expandDataCatalogTagTemplateFieldsDisplayName(v interface{}, d TerraformRes
 	return v, nil
 }
 
+func expandDataCatalogTagTemplateFieldsDescription(v interface{}, d TerraformResourceData, config *Config) (interface{}, error) {
+	return v, nil
+}
+
 func expandDataCatalogTagTemplateFieldsType(v interface{}, d TerraformResourceData, config *Config) (interface{}, error) {
 	l := v.([]interface{})
 	if len(l) == 0 || l[0] == nil {

website/docs/r/data_catalog_tag_template.html.markdown

@@ -111,6 +111,10 @@ The `fields` block supports:
   (Optional)
   The display name for this field.
 
+* `description` -
+  (Optional)
+  A description for this field.
+
 * `type` -
   (Required)
   The type of value this tag field can contain.