Managing multicast groups - Amazon VPC
Registering sources with a multicast groupRegistering members with a multicast groupDeregistering sources from a multicast groupDeregistering members from a multicast groupViewing your multicast groups
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Managing multicast groups

Registering sources with a multicast group

Note

This procedure is only required when you have set the Static sources support attribute to enable.

Use the following procedure to register sources with a multicast group. The source is the network interface that sends multicast traffic.

You need the following information before you add a source:

  • The ID of the multicast domain

  • The IDs of the sources' network interfaces

  • The multicast group IP address

Console
To register sources using the console

  1. Open the Amazon VPC console at https://console.amazonaws.cn/vpc/.

  2. On the navigation pane, choose Transit Gateway Multicast.

  3. Select the multicast domain, and then choose Actions, Add group sources.

  4. For Group IP address, enter either the IPv4 CIDR block or IPv6 CIDR block to assign to the multicast domain.

  5. Under Choose network interfaces, select the multicast senders' network interfaces.

  6. Choose Add sources.

Command line
To register sources using the Amazon CLI

Use the register-transit-gateway-multicast-group-sources command.

Registering members with a multicast group

Use the following procedure to register group members with a multicast group.

You need the following information before you add members:

  • The ID of the multicast domain

  • The IDs of the group members' network interfaces

  • The multicast group IP address

Console
To register members using the console

  1. Open the Amazon VPC console at https://console.amazonaws.cn/vpc/.

  2. On the navigation pane, choose Transit Gateway Multicast.

  3. Select the multicast domain, and then choose Actions, Add group members.

  4. For Group IP address, enter either the IPv4 CIDR block or IPv6 CIDR block to assign to the multicast domain.

  5. Under Choose network interfaces, select the multicast receivers' network interfaces.

  6. Choose Add members.

Command line
To register members using the Amazon CLI

Use the register-transit-gateway-multicast-group-members command.

Deregistering sources from a multicast group

You don't need to follow this procedure unless you manually added a source to the multicast group.

Console
To remove a source using the console

  1. Open the Amazon VPC console at https://console.amazonaws.cn/vpc/.

  2. On the navigation pane, choose Transit Gateway Multicast.

  3. Select the multicast domain.

  4. Choose the Groups tab.

  5. Select the sources, and then choose Remove source.

Command line
To remove a source using the Amazon CLI

Use the deregister-transit-gateway-multicast-group-sources command.

Deregistering members from a multicast group

You don't need to follow this procedure unless you manually added a member to the multicast group.

Console
To deregister members using the console

  1. Open the Amazon VPC console at https://console.amazonaws.cn/vpc/.

  2. On the navigation pane, choose Transit Gateway Multicast.

  3. Select the multicast domain.

  4. Choose the Groups tab.

  5. Select the members, and then choose Remove member.

Command line
To deregister members using the Amazon CLI

Use the deregister-transit-gateway-multicast-group-members command.

Viewing your multicast groups

You can view information about your multicast groups to verify that members were discovered using the IGMPv2 protocol. Member type (in the console), or MemberType (in the Amazon CLI) displays IGMP when Amazon discovered members with the protocol.

Console
To view multicast groups using the console

  1. Open the Amazon VPC console at https://console.amazonaws.cn/vpc/.

  2. On the navigation pane, choose Transit Gateway Multicast.

  3. Select the multicast domain.

  4. Choose the Groups tab.

Command line
To view multicast groups using the Amazon CLI

Use the search-transit-gateway-multicast-groups command.

The following example shows that the IGMP protocol discovered multicast group members.

aws ec2 search-transit-gateway-multicast-groups --transit-gateway-multicast-domain tgw-mcast-domain-000fb24d04EXAMPLE
{
    "MulticastGroups": [
        {
            "GroupIpAddress": "224.0.1.0",
            "TransitGatewayAttachmentId": "tgw-attach-0372e72386EXAMPLE",
            "SubnetId": "subnet-0187aff814EXAMPLE",
            "ResourceId": "vpc-0065acced4EXAMPLE",
            "ResourceType": "vpc",
            "NetworkInterfaceId": "eni-03847706f6EXAMPLE",
            "MemberType": "igmp"
        }
    ]
}