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

# PATCH /projects/{project}/global/interconnectAttachmentGroups/{interconnectAttachmentGroup}

`PATCH /projects/{project}/global/interconnectAttachmentGroups/{interconnectAttachmentGroup}`

Patches the specified InterconnectAttachmentGroup 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
- `interconnectAttachmentGroup` string, required

## Query parameters

- `requestId` string
- `updateMask` string

## Request body

- InterconnectAttachmentGroup — An interconnect attachment group resource allows customers to create, analyze, and expand highly available deployments.
  - `description` string — An optional description of this resource. Provide this property when you create the resource.
  - `interconnectGroup` string — The URL of an InterconnectGroup that groups these Attachments' Interconnects. Customers do not need to set this unless directed by Google Support.
  - `intent` InterconnectAttachmentGroupIntent — The user's intent for this AttachmentGroup. This is the only required field besides the name that must be specified on group creation.
    - `availabilitySla` 'AVAILABILITY_SLA_UNSPECIFIED' | 'NO_SLA' | 'PRODUCTION_CRITICAL' | 'PRODUCTION_NON_CRITICAL'
  - `logicalStructure` InterconnectAttachmentGroupLogicalStructure — [Output Only] An analysis of the logical layout of Attachments in this group. Every Attachment in the group is shown once in this structure.
    - `regions` InterconnectAttachmentGroupLogicalStructureRegion[]
      - `region` string — Output only. [Output Only] The name of a region, like "us-central1".
      - `metros` InterconnectAttachmentGroupLogicalStructureRegionMetro[]
        - `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 an Interconnect.
        - `facilities` InterconnectAttachmentGroupLogicalStructureRegionMetroFacility[]
          - `zones` InterconnectAttachmentGroupLogicalStructureRegionMetroFacilityZone[]
            - `zone` string — Output only. [Output Only] The name of a zone, either "zone1" or "zone2".
            - `attachments` string[] — Output only. [Output Only] URLs of Attachments in the given zone, to the given region, on Interconnects in the given facility and metro. Every Attachment in the AG has such an entry.
          - `facility` string — Output only. [Output Only] The name of a facility, like "iad-1234".
  - `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 byAIP 154.
  - `id` string, uint64 — Output only. [Output Only] The unique identifier for the resource type. The server generates this identifier.
  - `configured` InterconnectAttachmentGroupConfigured — [Output Only] The redundancy this group is configured to support. The way a user queries what SLA their Attachment gets is by looking at this field of the Attachment's AttachmentGroup.
    - `availabilitySla` InterconnectAttachmentGroupConfiguredAvailabilitySLA — [Output Only] Which SLA this group is configured to support, and why this group does or does not meet that SLA's requirements.
      - `effectiveSla` 'EFFECTIVE_SLA_UNSPECIFIED' | 'NO_SLA' | 'PRODUCTION_CRITICAL' | 'PRODUCTION_NON_CRITICAL'
      - `intendedSlaBlockers` InterconnectAttachmentGroupConfiguredAvailabilitySLAIntendedSlaBlockers[]
        - `zones` string[] — Output only. [Output Only] Zones used to explain this blocker in more detail. Format is "zone1" and/or "zone2". This will be set for some blockers (like MISSING_ZONE) but does not apply to others.
        - `documentationLink` string — Output only. [Output Only] The url of Google Cloud public documentation explaining this requirement. This is set for every type of requirement.
        - `blockerType` 'BLOCKER_TYPE_UNSPECIFIED' | 'INCOMPATIBLE_METROS' | 'INCOMPATIBLE_REGIONS' | 'MISSING_GLOBAL_ROUTING' | 'NO_ATTACHMENTS' | 'NO_ATTACHMENTS_IN_METRO_AND_ZONE' | 'OTHER'
        - `regions` string[] — Output only. [Output Only] Regions used to explain this blocker in more detail. These are region names formatted like "us-central1". This will be set for some blockers (like INCOMPATIBLE_REGIONS) but does not apply to others.
        - `metros` string[] — Output only. [Output Only] Metros used to explain this blocker in more detail. These are three-letter lowercase strings like "iad". This will be set for some blockers (like NO_ATTACHMENTS_IN_METRO_AND_ZONE) but does not apply to others.
        - `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.
        - `attachments` string[] — Output only. [Output Only] URLs of any particular Attachments to explain this blocker in more detail.
  - `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.
  - `kind` string — Output only. [Output Only] Type of the resource. Always compute#interconnectAttachmentGroup.
  - `selfLink` string — Output only. [Output Only] Server-defined URL for the resource.
  - `attachments` object — Attachments in the AttachmentGroup. 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 "Attachments per group" quota.

## 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/versions/6120ed8969d4/schema)
