這些 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 在 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 中建立的上行,將上行對應至實體 NIC。
  • "uplink_name":在 NSX-T 中建立的上行,將 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 管理員,請將值設定為以下參數:
    • OpaqueNetworkId
    • OpaqueNetworkType
  • 在 vSphere Distributed Switch 上的 NSX-T:身為 vSphere 管理員,請將值設定為以下參數:
    • SwitchUUIDportgroupKey
    • 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 中上行設定檔中定義的 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 內容。