支持 NSX 上的 vSphere Distributed Switch 的 NSX API 命令。

针对 vSphere Distributed Switch 进行的 API 更改

有关与 API 调用相关的详细信息,请参见NSX API 指南

注: 还可以从 VMware vCenter 用户界面使用 API 命令完成配置。有关使用 vSphere Distributed Switch 作为主机交换机创建 NSX 传输节点的详细信息,请参阅 NSX 安装指南中的 配置受管主机传输节点主题。
API vSphere Distributed Switch (VDS) 上的 NSX 针对 vSphere Distributed Switch 上的 NSX 进行的 API 命令更改
为已发现的节点创建传输节点。 /api/v1/fabric/discovered-nodes/<external-id/discovered-node-id>?action=create_transport_node
{
"node_id":
 "d7ef478b-752c-400a-b5f0-207c04567e5d", "host_switch_spec": {
 "host_switches": [
 {
 "host_switch_name": "vds-1",
 "host_switch_id":
 "50 2b 92 54 e0 80 d8 d1-ee ab 8d a6 7b fd f9 4b",
 "host_switch_type": "VDS",
 "host_switch_mode": "STANDARD",
 "host_switch_profile_ids": [
 {
 "key": "UplinkHostSwitchProfile",
 "value":
 "159353ae-c572-4aca-9469-9582480a7467"
 } ],
 "pnics": [],
 "uplinks": [
 {
 "vds_uplink_name": "Uplink 2",
 "uplink_name": "nsxuplink1"
 } ],
 "is_migrate_pnics": false,
 "ip_assignment_spec": {
 "resource_type": "AssignedByDhcp"
 },
 "cpu_config": [],
 "transport_zone_endpoints": [
 {
 "transport_zone_id":
 "06ba5326-67ac-4f2c-9953-a8c5d326b51e",
 "transport_zone_profile_ids": [
 {
 "resource_type": "BfdHealthMonitoringProfile",
 "profile_id": 
"52035bb3-ab02-4a08-9884-18631312e50a"
 } ] } ],
 "vmk_install_migration": [],
 "pnics_uninstall_migration": [],
 "vmk_uninstall_migration": [],
 "not_ready": false
 } 
 ],
 "resource_type": "StandardHostSwitchSpec"
 },
 "transport_zone_endpoints": [],
 "maintenance_mode": "DISABLED",
 "is_overridden": false,
 "resource_type": "TransportNode",
 "display_name": "TestTN",
}
  • "host_switch_name": "vds-1":不是由管理员输入的交换机名称。将从在 vSphere 中创建的 vSphere Distributed Switch 填充列表中选择主机交换机名称字段。
  • "host_switch_id":vSphere Distributed Switch 对象的 UUID。vSphere 中的对应 API 为 vim.DistributedVirtualSwitch.config.uuid

  • "vds_uplink_name":在 vSphere Distributed Switch 中创建的上行链路,用于将上行链路映射到物理网卡。
  • "uplink_name":在 NSX 中创建的上行链路,用于将 N-VDS 上的上行链路映射到在 vds_uplink_name 中定义的上行链路。
  • "is_migrate_pnics": false:默认情况下,当使用 vSphere Distributed Switch 时,将不支持迁移物理网卡。
  • "transport_zone_endpoints":当主机交换机类型为 vSphere Distributed Switch 时,此字段不受支持。当主机交换机类型为 N-VDS 时,此字段为必填字段。传输区域端点 ID 与相关联的主机交换机相对应。

    有关 /api/v1/fabric/discovered-nodes/<external-id/discovered-node-id>?action=create_transport_node 的更多详细信息,请参阅NSX API 指南

虚拟机配置 vim.vm.device.VirtualEthernetCard.DistributedVirtualPortBackingInfo
  • vSphere Distributed Switch:作为 vSphere 管理员,请确保已将 BackingType 参数设置为 NSX
注: 如果将 BackingType 设置为 OpaqueNetworkBackingInfo,VNIC BackingType 将默认为 DistributedVirtualPortBackingInfo
VMkernel 网卡 vim.dvs.DistributedVirtualPort
  • N-VDS:作为 NSX 管理员,请设置以下参数的值:
    • OpaqueNetworkId
    • OpaqueNetworkType
  • vSphere Distributed Switch 上的 NSX:作为 vSphere 管理员,请设置以下参数的值:
    • SwitchUUIDportgroupKey
    • DVPG 的 BackingType 必须为 NSX
物理网卡到上行链路的映射

API:vim.host.NetworkSystem:networkSystem.updateNetworkConfig

属性:vim.host.NetworkConfig.proxySwitch

  • 要通过调用 API 命令将物理网卡映射到 vSphere Distributed Switch 的上行链路,请设置 maxMtu 属性。
MTU

API:vim.dvs.VmwareDistributedVirtualSwitch.reconfigure

属性:VmwareDistributedVirtualSwitch.ConfigSpec.maxMtu

  • 要通过调用 API 命令为 vSphere Distributed Switch 配置 MTU 值,请设置 maxMtu 属性。
    注:NSX 的上行链路配置文件中定义的 MTU 值不会应用于主机交换机。

LAG

API:vim.dvs.VmwareDistributedVirtualSwitch.updateLacpGroupConfig

属性:vim.dvs.VmwareDistributedVirtualSwitch.LacpGroupSpec

  • 要通过调用 API 命令为 vSphere Distributed Switch 配置 LAG 配置文件,请设置 LacpGroupSpec 属性。
NIOC

API:vim.dvs.VmwareDistributedVirtualSwitch.reconfigure

属性:vim.dvs.VmwareDistributedVirtualSwitch.ConfigSpec.infrastructureTrafficResourceConfig

  • 要通过调用 API 命令为 vSphere Distributed Switch 配置 NIOC 配置文件,请设置 infrastructureTrafficResourceConfig 属性。
LLDP

API:vim.dvs.VmwareDistributedVirtualSwitch.reconfigure

属性:vim.dvs.VmwareDistributedVirtualSwitch.ConfigSpec.linkDiscoveryProtocolConfig

  • 要通过调用 API 命令为 vSphere Distributed Switch 配置 LLDP 配置文件,请设置 linkDiscoveryProtocolConfig 属性。