---
title: "POST /v1/{+parent}/mirroringEndpointGroupAssociations"
method: POST
path: "/v1/{+parent}/mirroringEndpointGroupAssociations"
tags: ["projects"]
---

# POST /v1/{+parent}/mirroringEndpointGroupAssociations

`POST /v1/{+parent}/mirroringEndpointGroupAssociations`

Creates an association in a given project and location. See https://google.aip.dev/133.

## Path parameters

- `parent` string, required

## Query parameters

- `mirroringEndpointGroupAssociationId` string
- `requestId` string

## Request body

- MirroringEndpointGroupAssociation — An endpoint group association represents a link between a network and an endpoint group in the organization. Creating an association creates the networking infrastructure linking the network to the endpoint group, but does not enable mirroring by itself. To enable mirroring, the user must also create a network firewall policy containing mirroring rules and associate it with the network.
  - `updateTime` string, google-datetime — Output only. The timestamp when the resource was most recently updated. See https://google.aip.dev/148#timestamps.
  - `name` string — Immutable. Identifier. The resource name of this endpoint group association, for example: `projects/123456789/locations/global/mirroringEndpointGroupAssociations/my-eg-association`. See https://google.aip.dev/122 for more details.
  - `networkCookie` integer — Output only. Identifier used by the data-path. See the NSI GENEVE format for more details: https://docs.cloud.google.com/network-security-integration/docs/understand-geneve#network_id
  - `state` 'STATE_UNSPECIFIED' | 'ACTIVE' | 'CREATING' | 'DELETING' | 'CLOSED' | 'OUT_OF_SYNC' | 'DELETE_FAILED' — Output only. Current state of the endpoint group association.
  - `locationsDetails` MirroringEndpointGroupAssociationLocationDetails[] — Output only. The list of locations where the association is present. This information is retrieved from the linked endpoint group, and not configured as part of the association itself.
    - `location` string — Output only. The cloud location, e.g. "us-central1-a" or "asia-south1".
    - `state` 'STATE_UNSPECIFIED' | 'ACTIVE' | 'OUT_OF_SYNC' — Output only. The current state of the association in this location.
  - `locations` MirroringLocation[] — Output only. The list of locations where the association is configured. This information is retrieved from the linked endpoint group.
    - `state` 'STATE_UNSPECIFIED' | 'ACTIVE' | 'OUT_OF_SYNC' — Output only. The current state of the association in this location.
    - `location` string — Output only. The cloud location, e.g. "us-central1-a" or "asia-south1".
  - `reconciling` boolean — Output only. The current state of the resource does not match the user's intended state, and the system is working to reconcile them. This part of the normal operation (e.g. adding a new location to the target deployment group). See https://google.aip.dev/128.
  - `createTime` string, google-datetime — Output only. The timestamp when the resource was created. See https://google.aip.dev/148#timestamps.
  - `mirroringEndpointGroup` string — Immutable. The endpoint group that this association is connected to, for example: `projects/123456789/locations/global/mirroringEndpointGroups/my-eg`. See https://google.aip.dev/124.
  - `labels` object — Optional. Labels are key/value pairs that help to organize and filter resources.
  - `network` string — Immutable. The VPC network that is associated. for example: `projects/123456789/global/networks/my-network`. See https://google.aip.dev/124.

## Response `200`

Successful response

---

[API](https://skmtc.net/google/apis/networksecurity.md) · [All operations](https://skmtc.net/google/apis/networksecurity/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/networksecurity/versions/4afd54463fe6/schema)