支持 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 Data Center 针对 vSphere Distributed Switch 上的 NSX-T Data Center 进行的 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 Data Center 中创建的上行链路，用于将 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 Data Center 管理员，请设置以下参数的值：
    • OpaqueNetworkId
    • OpaqueNetworkType
  • vSphere Distributed Switch 上的 NSX-T Data Center：作为 vSphere 管理员，请设置以下参数的值：
    • SwitchUUID 和portgroupKey
    • 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 Data Center 的上行链路配置文件中定义的 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 属性。