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

# POST /v1/{+parent}/multicastConsumerAssociations

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

Creates a new multicast consumer association in a given project and location.

## Path parameters

- `parent` string, required

## Query parameters

- `multicastConsumerAssociationId` string
- `requestId` string

## Request body

- MulticastConsumerAssociation — Multicast consumer association resource.
  - `name` string — Identifier. The resource name of the multicast consumer association. Use the following format: `projects/*/locations/*/multicastConsumerAssociations/*`.
  - `createTime` string, google-datetime — Output only. [Output only] The timestamp when the multicast consumer association was created.
  - `updateTime` string, google-datetime — Output only. [Output only] The timestamp when the Multicast Consumer Association was most recently updated.
  - `labels` object — Optional. Labels as key-value pairs
  - `multicastDomainActivation` string — Optional. The resource name of the multicast domain activation that is in the same zone as this multicast consumer association. Use the following format: `projects/*/locations/*/multicastDomainActivations/*`.
  - `network` string — Required. The resource name of the multicast consumer VPC network. Use following format: `projects/{project}/locations/global/networks/{network}`.
  - `description` string — Optional. An optional text description of the multicast consumer association.
  - `resourceState` 'CONSUMER_RESOURCE_STATE_UNSPECIFIED' | 'ACTIVE' | 'OBSOLETE' — Output only. [Deprecated] The resource state of the multicast consumer association. Use the state field instead.
  - `state` MulticastResourceState — The multicast resource's state.
    - `state` 'STATE_ENUM_UNSPECIFIED' | 'CREATING' | 'ACTIVE' | 'DELETING' | 'DELETE_FAILED' | 'UPDATING' | 'UPDATE_FAILED' | 'INACTIVE' | 'OBSOLETE' — Optional. The state of the multicast resource.
  - `uniqueId` string — Output only. [Output only] The Google-generated UUID for the resource. This value is unique across all multicast consumer association resources. If a consumer association is deleted and another with the same name is created, the new consumer association is assigned a different unique_id.
  - `placementPolicy` string — Output only. [Output only] A Compute Engine (placement policy)[https://cloud.google.com/compute/docs/instances/placement-policies-overview] that can be used to place virtual machine (VM) instances as multicast consumers close to the multicast infrastructure created for this domain, on a best effort basis.

## Response `200`

Successful response

---

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