Add purpose field to google compute address

products/compute/api.yaml

@@ -121,6 +121,16 @@ objects:
           following characters must be a dash, lowercase letter, or digit,
           except the last character, which cannot be a dash.
         required: true
+      - !ruby/object:Api::Type::Enum
+        name: purpose
+        description: |
+          The purpose of this resource, which can be one of the following values:
+
+          - GCE_ENDPOINT for addresses that are used by VM instances, alias IP ranges, internal load balancers, and similar resources.
+
+          This should only be set when using an Internal address.
+        values:
+          - :GCE_ENDPOINT
       - !ruby/object:Api::Type::Enum
         name: 'networkTier'
         description: |

products/compute/terraform.yaml

@@ -28,6 +28,11 @@ overrides: !ruby/object:Overrides::ResourceOverrides
           address_name: "my-internal-address"
           network_name: "my-network"
           subnetwork_name: "my-subnet"
+      - !ruby/object:Provider::Terraform::Examples
+        name: "address_with_gce_endpoint"
+        primary_resource_id: "internal_with_gce_endpoint"
+        vars:
+          address_name: "my-internal-address-"
       # TODO(rileykarson): Remove this example when instance is supported
       - !ruby/object:Provider::Terraform::Examples
         name: "instance_with_ip"
@@ -40,6 +45,8 @@ overrides: !ruby/object:Overrides::ResourceOverrides
         default_from_api: true
       addressType: !ruby/object:Overrides::Terraform::PropertyOverride
         custom_flatten: 'templates/terraform/custom_flatten/default_if_empty.erb'
+      purpose: !ruby/object:Overrides::Terraform::PropertyOverride
+        diff_suppress_func: addressDiffSuppress
       id: !ruby/object:Overrides::Terraform::PropertyOverride
         exclude: true
       labelFingerprint: !ruby/object:Overrides::Terraform::PropertyOverride
@@ -63,6 +70,7 @@ overrides: !ruby/object:Overrides::ResourceOverrides
           * `address` - The IP of the created resource.
     custom_code: !ruby/object:Provider::Terraform::CustomCode
       post_create: templates/terraform/post_create/labels.erb
+      constants: templates/terraform/constants/address.go.erb
   Autoscaler: !ruby/object:Overrides::Terraform::ResourceOverride
     id_format: "{{zone}}/{{name}}"
     examples:

templates/terraform/constants/address.go.erb

@@ -0,0 +1,14 @@
+// All internal addresses default to a purpose of `GCE_ENDPOINT`, but it is not
+// allowed on external addresses, so we can't set the default on the field.
+func addressDiffSuppress(k, old, new string, d *schema.ResourceData) bool {
+    if k == "purpose" {
+        addressType := d.Get("address_type")
+
+        if addressType == "INTERNAL" && old == "GCE_ENDPOINT" &&
+          new == "" {
+            return true
+        }
+    }
+
+    return false
+}

templates/terraform/examples/address_with_gce_endpoint.tf.erb

@@ -0,0 +1,5 @@
+resource "google_compute_address" "<%= ctx[:primary_resource_id] %>" {
+  name         = "<%= ctx[:vars]['address_name'] %>"
+  address_type = "INTERNAL"
+  purpose      = "GCE_ENDPOINT"
+}