google_cloudiot_device resource: bindDeviceToGateway method support

[voxmaster]

Community Note

• Please vote on this issue by adding a 👍 reaction to the original issue to help the community and maintainers prioritize this request
• Please do not leave "+1" or "me too" comments, they generate extra noise for issue followers and do not help prioritize the request
• If you are interested in working on this issue or have submitted a pull request, please leave a comment. If the issue is assigned to the "modular-magician" user, it is either in the process of being autogenerated, or is planned to be autogenerated soon. If the issue is assigned to a user, that user is claiming responsibility for the issue. If the issue is assigned to "hashibot", a community member has claimed the issue already.

Description

Implement bindDeviceToGateway API method in google_cloudiot_device Terraform resource.

New or Affected Resource(s)

• google_cloudiot_device

Potential Terraform Configuration

resource "google_cloudiot_device" "iot_gw0" {
  name     = "iot-gw0"
  registry = google_cloudiot_registry.iot.id
  gateway_config {
    gateway_type = "GATEWAY"
    bound_devices = ["DEVICE_NUM_ID", "...."] # << Proposed change 
  }
}

References

• #0000 https://cloud.google.com/iot/docs/reference/cloudiot/rest/v1/projects.locations.registries/bindDeviceToGateway

[c2thorn]

The solution for implementing this from the API is pretty abnormal, but this should be possible. The API exposes gatewayListOptions which lets you specify a device ID during list. This would return a set of gateway ID's associated with the device.

Updating the set of gateways bound to the device is possible, but also very abnormal. Binding is a separate action in the parent, and we would have to call bind/unbind until the listed set matches the user's intended set.

Technically possible, but extremely abnormal (regular API cases would just provide a gateways field and an update verb that updates it). Considering the google_cloudiot_device resource is auto-generated, I see this as a pretty complex feature.

[rileykarson]

Note: This service is getting retired later in the year: https://cloud.google.com/iot/docs/release-notes#August_16_2022

[github-actions]

I'm going to lock this issue because it has been closed for 30 days ⏳. This helps our maintainers find and focus on the active issues.
If you have found a problem that seems similar to this, please open a new issue and complete the issue template so we can capture all the details necessary to investigate further.