這些 NSX API 命令用來支援 NSX 上的 vSphere Distributed Switch。

針對 vSphere Distributed Switch 的 API 變更

如需有關 API 呼叫的詳細資訊，請參閱《NSX API 指南》。

備註： 使用 API 命令完成的組態也可以從 VMware vCenter 使用者介面完成。如需有關使用 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 中建立的上行，將上行對應至實體 NIC。
  • "uplink_name"：在 NSX 中建立的上行，將 N-VDS 上的上行對應至 vds_uplink_name 中定義的上行。
  • "is_migrate_pnics": false：依預設，不支援使用 vSphere Distributed Switch 時移轉實體 NIC。
  • "transport_zone_endpoints"：主機交換器類型為 vSphere Distributed Switch 時不支援。當主機交換器類型為 N-VDS 時，此欄位為必填。傳輸區域端點識別碼會與其相關聯的主機交換器對應。

    如需有關 /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 NIC vim.dvs.DistributedVirtualPort
  • N-VDS：身為 NSX 管理員，請將值設定為以下參數：
    • OpaqueNetworkId
    • OpaqueNetworkType
  • vSphere Distributed Switch 上的 NSX：身為 vSphere 管理員，請將值設定為以下參數：
    • SwitchUUID 和 portgroupKey
    • DVPG 的 BackingType 必須為 NSX。
實體 NIC 與上行的對應

API：vim.host.NetworkSystem:networkSystem.updateNetworkConfig

內容：vim.host.NetworkConfig.proxySwitch
  • 若要透過呼叫 API 命令將實體 NIC 對應至 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 內容。