Add MulticloudDataTransferConfig Resource (#15988)

Author: sreemoyee-basu

mmv1/products/networkconnectivity/MulticloudDataTransferConfig.yaml

@@ -0,0 +1,135 @@
+# Copyright 2025 Google Inc.
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+
+---
+name: 'MulticloudDataTransferConfig'
+description: |
+  'Manage Multicloud Data Transfer Configs'
+references:
+  guides:
+    'QUICKSTART_TITLE': 'https://docs.cloud.google.com/data-transfer-essentials/docs/create-resources'
+  api: 'https://docs.cloud.google.com/network-connectivity/docs/reference/networkconnectivity/rest/v1/projects.locations.multicloudDataTransferConfigs'
+
+base_url: 'projects/{{project}}/locations/{{location}}/multicloudDataTransferConfigs'
+self_link: 'projects/{{project}}/locations/{{location}}/multicloudDataTransferConfigs/{{name}}'
+
+immutable: false
+
+create_url: 'projects/{{project}}/locations/{{location}}/multicloudDataTransferConfigs?multicloudDataTransferConfigId={{name}}'
+
+update_verb: 'PATCH'
+update_mask: true
+
+autogen_async: true
+async:
+  operation:
+    base_url: '{{op_id}}'
+
+examples:
+  - name: "network_connectivity_multicloud_data_transfer_config_basic"
+    primary_resource_id: "example"
+    vars:
+      config_name: "basic_config"
+
+parameters:
+  - name: 'location'
+    type: String
+    required: true
+    immutable: true
+    url_param_only: true
+    description: |
+      The location of the multicloud data transfer config.
+  - name: 'name'
+    type: String
+    required: true
+    immutable: true
+    url_param_only: true
+    description: |
+      The name of the MulticloudDataTransferConfig resource.
+
+properties:
+  - name: 'createTime'
+    type: Time
+    output: true
+    description: |
+      Time when the MulticloudDataTransferConfig resource was created.
+  - name: 'updateTime'
+    type: Time
+    output: true
+    description: |
+      Time when the MulticloudDataTransferConfig resource was updated.
+  - name: 'labels'
+    type: KeyValueLabels
+    description: |
+      User-defined labels.
+  - name: 'etag'
+    type: Fingerprint
+    description: |
+      The etag is computed by the server, and might be sent with update and
+      delete requests so that the client has an up-to-date value before
+      proceeding.
+  - name: 'description'
+    type: String
+    description: |
+      A description of this resource.
+  - name: 'destinationsCount'
+    type: Integer
+    output: true
+    description: |
+      The number of Destination resources configured for the
+      MulticloudDataTransferConfig resource.
+  - name: 'destinationsActiveCount'
+    type: Integer
+    output: true
+    description: |
+      The number of Destination resources in use with the
+      MulticloudDataTransferConfig resource.
+  - name: 'services'
+    type: Array
+    description: |
+      Maps services to their current or planned states. Service names are keys,
+      and the associated values describe the state of the service.
+    custom_flatten: 'templates/terraform/custom_flatten/network_connectivity_mcdt_services_state_timeline_flatten.go.tmpl'
+    custom_expand: 'templates/terraform/custom_expand/network_connectivity_mcdt_services_state_timeline_expand.go.tmpl'
+    item_type:
+      type: NestedObject
+      properties:
+        - name: 'service_name'
+          type: String
+          description: |
+            The name of the service, like "big-query" or "cloud-storage".
+            This corresponds to the map key in the API.
+          required: true
+        - name: 'states'
+          type: Array
+          description: 'The state and activation time details for the service.'
+          output: true
+          item_type:
+            type: NestedObject
+            properties:
+              - name: 'state'
+                type: String
+                description: 'The state of the resource.'
+                output: true
+              - name: 'effective_time'
+                type: String
+                description: 'The time when the state becomes effective'
+                output: true
+  - name: 'uid'
+    type: String
+    output: true
+    description: |
+      The Google-generated unique ID for the MulticloudDataTransferConfig
+      resource. This value is unique across all MulticloudDataTransferConfig
+      resources. If a resource is deleted and another with the same name is
+      created, the new resource is assigned a different and unique ID.

mmv1/templates/terraform/custom_expand/network_connectivity_mcdt_services_state_timeline_expand.go.tmpl

@@ -0,0 +1,65 @@
+{{/*
+ The license inside this block applies to this file
+ Copyright 2024 Google Inc.
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+*/ -}}
+func expand{{$.GetPrefix}}{{$.TitlelizeProperty}}(v interface{}, d tpgresource.TerraformResourceData, config *transport_tpg.Config) (interface{}, error) {
+	if v == nil {
+		return make(map[string]interface{}), nil
+	}
+
+	l, ok := v.([]interface{})
+	if !ok {
+		return nil, fmt.Errorf("expected 'services' to be a list, got %T", v)
+	}
+
+	req := make(map[string]interface{})
+	for _, raw := range l {
+		if raw == nil {
+			continue
+		}
+
+		original, ok := raw.(map[string]interface{})
+		if !ok {
+			return nil, fmt.Errorf("expected a service item to be a map, got %T", raw)
+		}
+
+		serviceName, ok := original["service_name"].(string)
+		if !ok || serviceName == "" {
+			// Skip items without a valid service name
+			continue
+		}
+
+		var apiStates []interface{}
+		if states, ok := original["states"].([]interface{}); ok {
+			for _, stateRaw := range states {
+				state, ok := stateRaw.(map[string]interface{})
+				if !ok {
+					continue
+				}
+
+				apiState := make(map[string]interface{})
+				if s, ok := state["state"].(string); ok {
+					apiState["state"] = s
+				}
+				if et, ok := state["effective_time"].(string); ok {
+					apiState["effectiveTime"] = et
+				}
+				apiStates = append(apiStates, apiState)
+			}
+		}
+
+		req[serviceName] = map[string]interface{}{
+			"states": apiStates,
+		}
+	}
+
+	return req, nil
+}

mmv1/templates/terraform/custom_flatten/network_connectivity_mcdt_services_state_timeline_flatten.go.tmpl

@@ -0,0 +1,65 @@
+{{/*
+ The license inside this block applies to this file
+ Copyright 2024 Google Inc.
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at http://www.apache.org/licenses/LICENSE-2.0
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+*/ -}}
+func flatten{{$.GetPrefix}}{{$.TitlelizeProperty}}(v interface{}, d *schema.ResourceData, config *transport_tpg.Config) interface{} {
+	if v == nil {
+		return nil
+	}
+
+	servicesMap, ok := v.(map[string]interface{})
+	if !ok {
+		return nil
+	}
+
+	transformed := make([]interface{}, 0, len(servicesMap))
+
+	// Sort the service names to ensure a consistent ordering.
+	serviceNames := make([]string, 0, len(servicesMap))
+	for name := range servicesMap {
+		serviceNames = append(serviceNames, name)
+	}
+	sort.Strings(serviceNames)
+
+	for _, serviceName := range serviceNames {
+		stateTimelineRaw := servicesMap[serviceName]
+		stateTimeline, ok := stateTimelineRaw.(map[string]interface{})
+		if !ok {
+			continue
+		}
+
+		var flattenedStates []interface{}
+		if states, ok := stateTimeline["states"].([]interface{}); ok {
+			for _, stateRaw := range states {
+				state, ok := stateRaw.(map[string]interface{})
+				if !ok {
+					continue
+				}
+				flattenedState := make(map[string]interface{})
+				if s, ok := state["state"].(string); ok {
+					flattenedState["state"] = s
+				}
+				if et, ok := state["effectiveTime"].(string); ok {
+					flattenedState["effective_time"] = et
+				}
+				flattenedStates = append(flattenedStates, flattenedState)
+			}
+		}
+
+		flattenedService := map[string]interface{}{
+			"service_name": serviceName,
+			"states":       flattenedStates,
+		}
+		transformed = append(transformed, flattenedService)
+	}
+
+	return transformed
+}

mmv1/templates/terraform/examples/network_connectivity_multicloud_data_transfer_config_basic.tf.tmpl

@@ -0,0 +1,14 @@
+resource "google_network_connectivity_multicloud_data_transfer_config" "{{$.PrimaryResourceId}}" {
+  name        = "{{index $.Vars "config_name"}}"
+  location = "europe-west1"
+  description = "A basic multicloud data transfer configs"
+  labels = {
+    foo = "bar"
+  }
+  services {
+    service_name = "big-query"
+  }
+  services {
+    service_name = "cloud-storage"
+  }
+}