支持 NSX-T Data Center 上的 vSphere Distributed Switch 的 NSX-T Data Center API 命令。

针对 vSphere Distributed Switch 进行的 API 更改

有关与 API 调用相关的详细信息,请参见《NSX-T Data Center API 指南》

注: 还可以从 vCenter Server 用户界面使用 API 命令完成配置。有关使用 vSphere Distributed Switch 作为主机交换机创建 NSX-T Data Center 传输节点的详细信息,请参阅 NSX-T Data Center 安装指南中的 配置受管主机传输节点主题。
API vSphere Distributed Switch (VDS) 上的 NSX-T 针对 vSphere Distributed Switch 上的 NSX-T 进行的 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-T 中创建的上行链路,用于将 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-T Data Center API 指南》

虚拟机配置 vim.vm.device.VirtualEthernetCard.DistributedVirtualPortBackingInfo
  • vSphere Distributed Switch:作为 vSphere 管理员,请确保已将 BackingType 参数设置为 NSX
注: 如果将 BackingType 设置为 OpaqueNetworkBackingInfo,VNIC BackingType 将默认为 DistributedVirtualPortBackingInfo
VMkernel 网卡 vim.dvs.DistributedVirtualPort
  • N-VDS:作为 NSX-T 管理员,请设置以下参数的值:
    • OpaqueNetworkId
    • OpaqueNetworkType
  • vSphere Distributed Switch 上 NSX-T:作为 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-T 的上行链路配置文件中定义的 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 属性。