---
title: "PATCH /projects/{project}/global/interconnectGroups/{interconnectGroup}"
method: PATCH
path: "/projects/{project}/global/interconnectGroups/{interconnectGroup}"
tags: ["interconnectGroups"]
---

# PATCH /projects/{project}/global/interconnectGroups/{interconnectGroup}

`PATCH /projects/{project}/global/interconnectGroups/{interconnectGroup}`

Patches the specified InterconnectGroup resource with the data included in
the request. This method supports PATCH
semantics and usesJSON merge
patch format and processing rules.

## Path parameters

- `project` string, required
- `interconnectGroup` string, required

## Query parameters

- `requestId` string
- `updateMask` string

## Request body

- InterconnectGroup — An interconnect group resource allows customers to create, analyze, and expand their redundant connections.
  - `kind` string — Output only. [Output Only] Type of the resource. Always compute#InterconnectGroup
  - `name` string — Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply withRFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
  - `selfLink` string — Output only. [Output Only] Server-defined URL for the resource.
  - `description` string — An optional description of this resource. Provide this property when you create the resource.
  - `intent` InterconnectGroupIntent — The user's intent for this group. This is the only required field besides the name that must be specified on group creation.
    - `topologyCapability` 'NO_SLA' | 'PRODUCTION_CRITICAL' | 'PRODUCTION_NON_CRITICAL' | 'UNSPECIFIED'
  - `id` string, uint64 — Output only. [Output Only] The unique identifier for the resource type. The server generates this identifier.
  - `configured` InterconnectGroupConfigured — [Output Only] The status of the group as configured. This has the same structure as the operational field reported by the OperationalStatus method, but does not take into account the operational status of each resource.
    - `topologyCapability` InterconnectGroupConfiguredTopologyCapability — [Output Only] How reliable this topology is configured to be, and why this group does or does not meet the requirements for the intended capability.
      - `intendedCapabilityBlockers` InterconnectGroupConfiguredTopologyCapabilityIntendedCapabilityBlockers[]
        - `explanation` string — Output only. [Output Only] A human-readable explanation of this requirement and why it's not met. This is set for every type of requirement.
        - `facilities` string[] — Output only. [Output Only] Facilities used to explain this blocker in more detail. Like physicalStructure.metros.facilities.facility, this is a numeric string like "5467".
        - `interconnects` string[] — Output only. [Output Only] Interconnects used to explain this blocker in more detail.
        - `blockerType` 'INCOMPATIBLE_METROS' | 'NOT_AVAILABLE' | 'NO_INTERCONNECTS' | 'NO_INTERCONNECTS_IN_METRO_AND_ZONE' | 'OTHER' | 'UNSPECIFIED'
        - `metros` string[] — Output only. [Output Only] Metros used to explain this blocker in more detail. These are three-letter lowercase strings like "iad". A blocker like INCOMPATIBLE_METROS will specify the problematic metros in this field.
        - `documentationLink` string — Output only. [Output Only] The url of Google Cloud public documentation explaining this requirement. This is set for every type of requirement.
        - `zones` string[] — Output only. [Output Only] Zones used to explain this blocker in more detail. Zone names are "zone1" and/or "zone2".
      - `supportedSla` 'NO_SLA' | 'PRODUCTION_CRITICAL' | 'PRODUCTION_NON_CRITICAL' | 'UNSPECIFIED'
  - `physicalStructure` InterconnectGroupPhysicalStructure — [Output Only] An analysis of the physical layout of Interconnects in this group. Every Interconnect in the group is shown once in this structure.
    - `metros` InterconnectGroupPhysicalStructureMetros[]
      - `metro` string — Output only. [Output Only] The name of the metro, as a three-letter lowercase string like "iad". This is the first component of the location of Interconnects underneath this.
      - `facilities` InterconnectGroupPhysicalStructureMetrosFacilities[]
        - `facility` string — Output only. [Output Only] The ID of this facility, as a numeric string like "5467". This is the third component of the location of Interconnects in this facility.
        - `zones` InterconnectGroupPhysicalStructureMetrosFacilitiesZones[]
          - `zone` string — Output only. [Output Only] The name of the zone, either "zone1" or "zone2". This is the second component of the location of Interconnects in this facility.
          - `interconnects` string[] — Output only. [Output Only] URLs of Interconnects in this redundancy group in the given metro, facility, and zone.
  - `interconnects` object — Interconnects in the InterconnectGroup. Keys are arbitrary user-specified strings. Users are encouraged, but not required, to use their preferred format for resource links as keys. Note that there are add-members and remove-members methods in gcloud. The size of this map is limited by an "Interconnects per group" quota.
  - `creationTimestamp` string — Output only. [Output Only] Creation timestamp inRFC3339 text format.
  - `etag` string — Opaque system-generated token that uniquely identifies the configuration. If provided when patching a configuration in update mode, the provided token must match the current token or the update is rejected. This provides a reliable means of doing read-modify-write (optimistic locking) as described by AIP 154.

## Response `200`

Successful response

---

[API](https://skmtc.net/google/apis/compute.md) · [All operations](https://skmtc.net/google/apis/compute/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/compute/revisions/6120ed8969d4/schema)