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

針對 vSphere Distributed Switch 的 API 變更

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

備註： 使用 API 命令完成的組態也可以從 vCenter Server 使用者介面完成。如需有關使用 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 中建立的上行，將上行對應至實體 NIC。
  • "uplink_name"：在 NSX-T Data Center 中建立的上行，將 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-T Data Center 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-T Data Center 管理員，請將值設定為以下參數：
    • OpaqueNetworkId
    • OpaqueNetworkType
  • vSphere Distributed Switch 上的 NSX-T Data Center：身為 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-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 內容。