组播路由
概览
组播路由：VPC路由器接收组播源发送的组播消息，并转发给云主机，在发送端和接收端实现点对多点连接。
- ZStack Cloud支持将云主机作为组播消息接收者，VPC路由器作为组播路由器参与物理网络的组播路由信息交换。
- VPC路由器支持PIM-SM/PIM-SSM路由协议，在PIM-SM协议中，RP路由器是PIM-SM 域中的核心设备，RP地址可以通过手工方式静态配置，也可以通过BSR机制动态选举。
组播路由拓扑图如图 1所示：图 1. 组播路由拓扑图
清单
组播路由器清单(MulticastRouter Inventory)
| 名字 | 描述 | 可选的 | 可选的参数值 | 起始支持版本 |
|---|---|---|---|---|
| uuid | 请参见 资源属性 | 3.7.0 | ||
| state | 3.7.0 | |||
| description | 请参见 资源属性 | 是 | 3.7.0 | |
| groupBy | 以字段分组，相当于MySQL中的group by关键字。例如groupBy=type | 是 | 3.7.0 | |
| createDate | 请参见 资源属性 | 3.7.0 | ||
| lastOpDate | 请参见 资源属性 | 3.7.0 | ||
| userTags | 用户标签，请参见 创建用户标签(CreateUserTag) | 是 | 3.7.0 | |
| systemTags | 系统标签，请参见 创建系统标签(CreateSystemTag) | 是 | 3.7.0 |
示例
{
"inventories": [],
"success": true
}
操作（Operations）
创建组播路由器(CreateMulticastRouter)
用户可以使用CreateMulticastRouter创建组播路由器。
例如：
CreateMulticastRouter vpcRouterVmUuid=974c38ae483737c3b4ded18de56773b6参数（Parameters）
| 名字 | 描述 | 可选的 | 可选的参数值 | 起始支持版本 |
|---|---|---|---|---|
| vpcRouterVmUuid | 3.7.0 | |||
| description | 资源的详细描述 | 是 | 3.7.0 | |
| resourceUuid | 是 | 3.7.0 | ||
| tagUuids | 标签UUID列表 | 是 | 3.7.0 | |
| userTags | 用户标签，请参见 创建用户标签(CreateUserTag) | 是 | 3.7.0 | |
| systemTags | 系统标签，请参见 创建系统标签(CreateSystemTag) | 是 | 3.7.0 | |
| timeout | 是 |
删除组播路由器(DeleteMulticastRouter)
用户可以使用DeleteMulticastRouter删除组播路由器。
例如：
DeleteMulticastRouter uuid=cce17d3b823933a8b0694af5159fed4d参数（Parameters）
| 名字 | 描述 | 可选的 | 可选的参数值 | 起始支持版本 |
|---|---|---|---|---|
| uuid | 资源的UUID，唯一标示该资源 | 3.7.0 | ||
| deleteMode | 是 | 3.7.0 | ||
| userTags | 用户标签，请参见 创建用户标签(CreateUserTag) | 是 | 3.7.0 | |
| systemTags | 系统标签，请参见 创建系统标签(CreateSystemTag) | 是 | 3.7.0 | |
| timeout | 是 |
查询组播路由器(QueryMulticastRouter)
管理员可以使用QueryMulticastRouter查询组播路由器。例如：
QueryMulticastRouter 原生域查询（Primitive Fields of Query）
嵌套和扩展域查询（Nested And Expanded Fields of Query）
| 域（Field） | 清单（Inventory） | 描述 | 起始支持版本 |
|---|---|---|---|
| rpGroups | rpGroups Inventory | 组播汇聚点集合 | 3.7.0 |
| vpcVrs | vpcVrs Inventory | 组播关联的VPC路由器 | 3.7.0 |
改变组播路由器状态(ChangeMulticastRouterState)
用户可以使用ChangeMulticastRouterState改变组播路由器状态。
例如：
ChangeMulticastRouterState uuid=0cbf995f538b3aed855e3e50ea38eb0c stateEvent=enable参数（Parameters）
| 名字 | 描述 | 可选的 | 可选的参数值 | 起始支持版本 |
|---|---|---|---|---|
| uuid | 资源的UUID，唯一标示该资源 | 3.7.0 | ||
| stateEvent |
|
3.7.0 | ||
| userTags | 用户标签，请参见 创建用户标签(CreateUserTag) | 是 | 3.7.0 | |
| systemTags | 系统标签，请参见 创建系统标签(CreateSystemTag) | 是 | 3.7.0 | |
| timeout | 是 |
获取组播路由表(GetVpcMulticastRoute)
用户可以使用GetVpcMulticastRoute获取组播路由表。
例如：
GetVpcMulticastRoute uuid=a880287e652d3137a9f7349dc7f65a49参数（Parameters）
| 名字 | 描述 | 可选的 | 可选的参数值 | 起始支持版本 |
|---|---|---|---|---|
| uuid | 资源的UUID，唯一标示该资源 | 3.7.0 | ||
| userTags | 用户标签，请参见 创建用户标签(CreateUserTag) | 是 | 3.7.0 | |
| systemTags | 系统标签，请参见 创建系统标签(CreateSystemTag) | 是 | 3.7.0 | |
| timeout | 是 |
添加组播路由静态RP地址(AddRendezvousPointToMulticastRouter)
用户可以使用AddRendezvousPointToMulticastRouter添加组播路由静态RP地址。
例如：
AddRendezvousPointToMulticastRouter uuid=9127988e024a3a87865efcd1381d8fd4 rpAddress=1.2.3.4 groupAddress=239.0.0.1/32参数（Parameters）
| 名字 | 描述 | 可选的 | 可选的参数值 | 起始支持版本 |
|---|---|---|---|---|
| uuid | 资源的UUID，唯一标示该资源 | 3.7.0 | ||
| rpAddress | 3.7.0 | |||
| groupAddress | 3.7.0 | |||
| resourceUuid | 是 | 3.7.0 | ||
| tagUuids | 标签UUID列表 | 是 | 3.7.0 | |
| userTags | 用户标签，请参见 创建用户标签(CreateUserTag) | 是 | 3.7.0 | |
| systemTags | 系统标签，请参见 创建系统标签(CreateSystemTag) | 是 | 3.7.0 | |
| timeout | 是 |
删除组播路由器静态RP地址(RemoveRendezvousPointFromMulticastRouter)
用户可以使用RemoveRendezvousPointFromMulticastRouter删除组播路由器静态RP地址。
例如：
RemoveRendezvousPointFromMulticastRouter uuid=b0efeaec578931d49c6c8b457287e1db rpAddress=1.2.3.4 groupAddress=239.1.1.1/32参数（Parameters）
| 名字 | 描述 | 可选的 | 可选的参数值 | 起始支持版本 |
|---|---|---|---|---|
| uuid | 资源的UUID，唯一标示该资源 | 3.7.0 | ||
| rpAddress | 3.7.0 | |||
| groupAddress | 3.7.0 | |||
| deleteMode | 是 | 3.7.0 | ||
| userTags | 用户标签，请参见 创建用户标签(CreateUserTag) | 是 | 3.7.0 | |
| systemTags | 系统标签，请参见 创建系统标签(CreateSystemTag) | 是 | 3.7.0 | |
| timeout | 是 |
标签（Tags）
组播路由器标签（MulticastRouter Tags）
用户可以使用resourceType=MulticastRouterVO在组播路由器上创建用户标签。
例如：
CreateUserTag resourceType=MulticastRouterVO tag=MulticastRouter-user \
resourceUuid=3533e0dcd01d4e2aa8697048e152c5d8