# REST Resource: projects.locations.multicastConsumerAssociations

- [Resource: MulticastConsumerAssociation](https://docs.cloud.google.com/vpc/docs/multicast/reference/rest/v1/projects.locations.multicastConsumerAssociations#MulticastConsumerAssociation)
  - [JSON representation](https://docs.cloud.google.com/vpc/docs/multicast/reference/rest/v1/projects.locations.multicastConsumerAssociations#MulticastConsumerAssociation.SCHEMA_REPRESENTATION)
- [Methods](https://docs.cloud.google.com/vpc/docs/multicast/reference/rest/v1/projects.locations.multicastConsumerAssociations#METHODS_SUMMARY)

## Resource: MulticastConsumerAssociation

Multicast consumer association resource.

| JSON representation |
|---|
| ``` { "name": string, "createTime": string, "updateTime": string, "labels": { string: string, ... }, "multicastDomainActivation": string, "network": string, "description": string, "resourceState": enum (`https://docs.cloud.google.com/vpc/docs/multicast/reference/rest/v1/ConsumerResourceState`), "state": { object (`https://docs.cloud.google.com/vpc/docs/multicast/reference/rest/v1/MulticastResourceState`) }, "uniqueId": string, "placementPolicy": string } ``` |

| Fields ||
|---|---|
| `name` | `string` Identifier. The resource name of the multicast consumer association. Use the following format: `projects/*/locations/*/multicastConsumerAssociations/*`. |
| `createTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Output only. \[Output only\] The timestamp when the multicast consumer association was created. Uses RFC 3339, where generated output will always be Z-normalized and use 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. \[Output only\] The timestamp when the Multicast Consumer Association was most recently updated. Uses RFC 3339, where generated output will always be Z-normalized and use 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)` Optional. Labels as key-value pairs An object containing a list of `"key": value` pairs. Example: `{ "name": "wrench", "mass": "1.3kg", "count": "3" }`. |
| `multicastDomainActivation` | `string` |
| `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 (deprecated)` | ``enum (`https://docs.cloud.google.com/vpc/docs/multicast/reference/rest/v1/ConsumerResourceState`)`` > [!WARNING] > This item is deprecated! Output only. \[Deprecated\] The resource state of the multicast consumer association. Use the state field instead. |
| `state` | ``object (`https://docs.cloud.google.com/vpc/docs/multicast/reference/rest/v1/MulticastResourceState`)`` Output only. \[Output only\] The state of the 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 uniqueId. |
| `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. |

| ## Methods ||
|---|---|
| ### `https://docs.cloud.google.com/vpc/docs/multicast/reference/rest/v1/projects.locations.multicastConsumerAssociations/create` | Creates a new multicast consumer association in a given project and location. |
| ### `https://docs.cloud.google.com/vpc/docs/multicast/reference/rest/v1/projects.locations.multicastConsumerAssociations/delete` | Deletes a single multicast consumer association. |
| ### `https://docs.cloud.google.com/vpc/docs/multicast/reference/rest/v1/projects.locations.multicastConsumerAssociations/get` | Gets details of a single multicast consumer association. |
| ### `https://docs.cloud.google.com/vpc/docs/multicast/reference/rest/v1/projects.locations.multicastConsumerAssociations/list` | Lists multicast consumer associations in a given project and location. |