# REST Resource: projects.locations.zones.interconnectAttachments

- [Resource: InterconnectAttachment](https://docs.cloud.google.com/distributed-cloud/connected/1.10.0/docs/reference/network/rest/v1/projects.locations.zones.interconnectAttachments#InterconnectAttachment)
  - [JSON representation](https://docs.cloud.google.com/distributed-cloud/connected/1.10.0/docs/reference/network/rest/v1/projects.locations.zones.interconnectAttachments#InterconnectAttachment.SCHEMA_REPRESENTATION)
- [Methods](https://docs.cloud.google.com/distributed-cloud/connected/1.10.0/docs/reference/network/rest/v1/projects.locations.zones.interconnectAttachments#METHODS_SUMMARY)

## Resource: InterconnectAttachment

Message describing InterconnectAttachment object

| JSON representation |
|---|
| ``` { "name": string, "createTime": string, "updateTime": string, "labels": { string: string, ... }, "description": string, "interconnect": string, "network": string, "vlanId": integer, "mtu": integer, "state": enum (`https://docs.cloud.google.com/distributed-cloud/edge/1.10.0/docs/reference/network/rest/v1/ResourceState`), "peeringType": enum (`https://docs.cloud.google.com/distributed-cloud/edge/1.10.0/docs/reference/network/rest/v1/RemotePeeringNetworkType`) } ``` |

| Fields ||
|---|---|
| `name` | `string` Required. The canonical resource name of the interconnect attachment. |
| `createTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Output only. The time when the interconnect attachment was created. Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: `"2014-10-02T15:01:23Z"`, `"2014-10-02T15:01:23.045123456Z"` or `"2014-10-02T15:01:23+05:30"`. |
| `updateTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Output only. The time when the interconnect attachment was last updated. Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: `"2014-10-02T15:01:23Z"`, `"2014-10-02T15:01:23.045123456Z"` or `"2014-10-02T15:01:23+05:30"`. |
| `labels` | `map (key: string, value: string)` Labels associated with this resource. An object containing a list of `"key": value` pairs. Example: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }`. |
| `description` | `string` Optional. A free-text description of the resource. Max length 1024 characters. |
| `interconnect` | `string` Required. The canonical name of underlying Interconnect object that this attachment's traffic will traverse through. The name is in the form of `projects/{project}/locations/{location}/zones/{zone}/interconnects/{interconnect}`. |
| `network` | `string` Optional. The canonical Network name in the form of `projects/{project}/locations/{location}/zones/{zone}/networks/{network}`. |
| `vlanId` | `integer` Required. VLAN id provided by user. Must be site-wise unique. |
| `mtu` | `integer` IP (L3) MTU value of the virtual edge cloud. Valid values are: 1500 and 9000. Default to 1500 if not set. |
| `state` | ``enum (`https://docs.cloud.google.com/distributed-cloud/edge/1.10.0/docs/reference/network/rest/v1/ResourceState`)`` Output only. Current stage of the resource to the device by config push. |
| `peeringType` | ``enum (`https://docs.cloud.google.com/distributed-cloud/edge/1.10.0/docs/reference/network/rest/v1/RemotePeeringNetworkType`)`` Optional. The remote peering network type of the underlying interconnect. It is required when peering separation is enabled. |

| ## Methods ||
|---|---|
| ### `https://docs.cloud.google.com/distributed-cloud/edge/1.10.0/docs/reference/network/rest/v1/projects.locations.zones.interconnectAttachments/create` | Creates a new InterconnectAttachment in a given project and location. |
| ### `https://docs.cloud.google.com/distributed-cloud/edge/1.10.0/docs/reference/network/rest/v1/projects.locations.zones.interconnectAttachments/delete` | Deletes a single InterconnectAttachment. |
| ### `https://docs.cloud.google.com/distributed-cloud/edge/1.10.0/docs/reference/network/rest/v1/projects.locations.zones.interconnectAttachments/get` | Gets details of a single InterconnectAttachment. |
| ### `https://docs.cloud.google.com/distributed-cloud/edge/1.10.0/docs/reference/network/rest/v1/projects.locations.zones.interconnectAttachments/list` | Lists InterconnectAttachments in a given project and location. |