# REST Resource: projects.locations.multicastDomainActivations

- [Resource: MulticastDomainActivation](https://docs.cloud.google.com/vpc/docs/multicast/reference/rest/v1beta1/projects.locations.multicastDomainActivations#MulticastDomainActivation)
  - [JSON representation](https://docs.cloud.google.com/vpc/docs/multicast/reference/rest/v1beta1/projects.locations.multicastDomainActivations#MulticastDomainActivation.SCHEMA_REPRESENTATION)
- [TrafficSpec](https://docs.cloud.google.com/vpc/docs/multicast/reference/rest/v1beta1/projects.locations.multicastDomainActivations#TrafficSpec)
  - [JSON representation](https://docs.cloud.google.com/vpc/docs/multicast/reference/rest/v1beta1/projects.locations.multicastDomainActivations#TrafficSpec.SCHEMA_REPRESENTATION)
- [Methods](https://docs.cloud.google.com/vpc/docs/multicast/reference/rest/v1beta1/projects.locations.multicastDomainActivations#METHODS_SUMMARY)

## Resource: MulticastDomainActivation

Multicast domain activation resource.

| JSON representation |
|---|
| ``` { "name": string, "createTime": string, "updateTime": string, "state": { object (`https://docs.cloud.google.com/vpc/docs/multicast/reference/rest/v1beta1/MulticastResourceState`) }, "labels": { string: string, ... }, "multicastDomain": string, "adminNetwork": string, "description": string, "multicastConsumerAssociations": [ string ], "uniqueId": string, "trafficSpec": { object (`https://docs.cloud.google.com/vpc/docs/multicast/reference/rest/v1beta1/projects.locations.multicastDomainActivations#TrafficSpec`) } } ``` |

| Fields ||
|---|---|
| `name` | `string` Identifier. The resource name of the multicast domain activation. Use the following format: `projects/*/locations/*/multicastDomainActivations/*`. |
| `createTime` | ``string (`https://protobuf.dev/reference/protobuf/google.protobuf#timestamp` format)`` Output only. \[Output only\] The timestamp when the multicast domain activation 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 domain activation 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"`. |
| `state` | ``object (`https://docs.cloud.google.com/vpc/docs/multicast/reference/rest/v1beta1/MulticastResourceState`)`` Output only. \[Output only\] The state of the resource. |
| `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" }`. |
| `multicastDomain` | `string` Optional. The resource name of the multicast domain to activate. Use the following format: `projects/*/locations/global/multicastDomains/*`. |
| `adminNetwork` | `string` Output only. \[Output only\] The URL of the admin network. |
| `description` | `string` Optional. An optional text description of the multicast domain activation. |
| `multicastConsumerAssociations[]` | `string` Output only. The resource names of associated multicast consumer associations. Use the following format: `projects/*/locations/*/multicastConsumerAssociations/*`. |
| `uniqueId` | `string` Output only. \[Output only\] The Google-generated UUID for the resource. This value is unique across all multicast domain activation resources. If a domain activation is deleted and another with the same name is created, the new domain activation is assigned a different uniqueId. |
| `trafficSpec` | ``object (`https://docs.cloud.google.com/vpc/docs/multicast/reference/rest/v1beta1/projects.locations.multicastDomainActivations#TrafficSpec`)`` Optional. The traffic specification for the multicast domain activation. |

## TrafficSpec

Specifies the traffic volume and multicast group scale parameters that are used to set up multicast infrastructure for a multicast domain in a zone.

| JSON representation |
|---|
| ``` { "aggrEgressPps": string, "aggrIngressPps": string, "avgPacketSize": integer, "maxPerGroupIngressPps": string, "maxPerGroupSubscribers": string } ``` |

| Fields ||
|---|---|
| `aggrEgressPps` | `string (https://developers.google.com/discovery/v1/type-format format)` Optional. Aggregated egress Packet-Per-Second for all multicast groups in the domain in this zone. |
| `aggrIngressPps` | `string (https://developers.google.com/discovery/v1/type-format format)` Optional. Aggregated ingress Packet-Per-Second for all multicast groups in the domain in this zone. Default to (aggregated_egress_pps / maxPerGroupSubscribers) \* 2. |
| `avgPacketSize` | `integer` Optional. Average packet size (Default to 512 bytes). |
| `maxPerGroupIngressPps` | `string (https://developers.google.com/discovery/v1/type-format format)` Optional. Maximum ingress Packet-Per-Second for a single multicast group in this zone. Default to aggregated_ingress_pps / 2. |
| `maxPerGroupSubscribers` | `string (https://developers.google.com/discovery/v1/type-format format)` Optional. Maximum number of subscribers for a single multicast group in this zone. Default to max(50, aggregated_egress_pps / aggregated_ingress_pps). |

| ## Methods ||
|---|---|
| ### `https://docs.cloud.google.com/vpc/docs/multicast/reference/rest/v1beta1/projects.locations.multicastDomainActivations/create` | Creates a new multicast domain activation in a given project and location. |
| ### `https://docs.cloud.google.com/vpc/docs/multicast/reference/rest/v1beta1/projects.locations.multicastDomainActivations/delete` | Deletes a single multicast domain activation. |
| ### `https://docs.cloud.google.com/vpc/docs/multicast/reference/rest/v1beta1/projects.locations.multicastDomainActivations/get` | Gets details of a single multicast domain activation. |
| ### `https://docs.cloud.google.com/vpc/docs/multicast/reference/rest/v1beta1/projects.locations.multicastDomainActivations/list` | Lists multicast domain activations in a given project and location. |
| ### `https://docs.cloud.google.com/vpc/docs/multicast/reference/rest/v1beta1/projects.locations.multicastDomainActivations/patch` | Updates the parameters of a single multicast domain activation. |