Comandi API di NSX per supportare vSphere Distributed Switch in NSX.

Modifiche nell'API per vSphere Distributed Switch

Per informazioni dettagliate sulle chiamate API, vedere Guida di NSX API.

Nota: La configurazione eseguita utilizzando i comandi API è possibile anche dall'interfaccia utente di VMware vCenter. Per ulteriori informazioni sulla creazione di un nodo di trasporto NSX utilizzando vSphere Distributed Switch come commutatore host, fare riferimento all'argomento Configurazione di un nodo di trasporto host gestito in Guida all'installazione di NSX.
API NSX su vSphere Distributed Switch (VDS) Modifiche nei comandi API per NSX su vSphere Distributed Switch
Creare un nodo di trasporto per un nodo rilevato. /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": non è un nome di commutatore immesso dall'amministratore. Il campo del nome del commutatore host viene selezionato nell'elenco popolato di vSphere Distributed Switch creati in vSphere.

  • "host_switch_id": è l'UUID dell'oggetto vSphere Distributed Switch. L'API corrispondente in vSphere è vim.DistributedVirtualSwitch.config.uuid .

  • "vds_uplink_name": uplink creato in vSphere Distributed Switch, che mappa gli uplink alle NIC fisiche.
  • "uplink_name": uplink creato in NSX che mappa gli uplink in N-VDS agli uplink definiti in vds_uplink_name.
  • "is_migrate_pnics": false: per impostazione predefinita, la migrazione delle NIC fisiche quando si utilizza vSphere Distributed Switch non è supportata.
  • "transport_zone_endpoints": non supportato quando il tipo di commutatore host è vSphere Distributed Switch. Questo campo è obbligatorio quando il tipo di commutatore host è N-VDS. Gli ID degli endpoint della zona di trasporto corrispondono al commutatore host a cui è associato.

    Per ulteriori dettagli su /api/v1/fabric/discovered-nodes/<external-id/discovered-node-id>?action=create_transport_node, fare riferimento a Guida di NSX API.
Configurazione macchina virtuale vim.vm.device.VirtualEthernetCard.DistributedVirtualPortBackingInfo
  • vSphere Distributed Switch: in qualità di amministratore di vSphere, assicurarsi che il parametro BackingType sia impostato su NSX.
Nota: Il BackingType di VNIC è impostato come predefinito su DistributedVirtualPortBackingInfo quando BackingType è impostato su OpaqueNetworkBackingInfo.
NIC VMkernel vim.dvs.DistributedVirtualPort
  • N-VDS: in qualità di amministratore di NSX, impostare i valori su questi parametri:
    • OpaqueNetworkId
    • OpaqueNetworkType
  • NSX on vSphere Distributed Switch: in qualità di amministratore di vSphere, impostare i valori su questi parametri:
    • SwitchUUID e portgroupKey
    • BackingType del DVPG deve essere NSX.
Mappatura da NIC fisica a uplink

API: vim.host.NetworkSystem:networkSystem.updateNetworkConfig

Proprietà: vim.host.NetworkConfig.proxySwitch
  • Per mappare le NIC fisiche agli uplink per vSphere Distributed Switch chiamando il comando API, impostare la proprietà maxMtu.
MTU

API: vim.dvs.VmwareDistributedVirtualSwitch.reconfigure

Proprietà: VmwareDistributedVirtualSwitch.ConfigSpec.maxMtu
  • Per configurare un valore MTU per vSphere Distributed Switch chiamando il comando API, impostare la proprietà maxMtu.
    Nota: Il valore MTU definito nei profili di uplink in NSX non viene applicato al commutatore host.

LAG

API: vim.dvs.VmwareDistributedVirtualSwitch.updateLacpGroupConfig

Proprietà: vim.dvs.VmwareDistributedVirtualSwitch.LacpGroupSpec
  • Per configurare un profilo LAG per vSphere Distributed Switch chiamando il comando API, impostare la proprietà LacpGroupSpec.
NIOC

API:vim.dvs.VmwareDistributedVirtualSwitch.reconfigure

Proprietà: vim.dvs.VmwareDistributedVirtualSwitch.ConfigSpec.infrastructureTrafficResourceConfig
  • Per configurare un profilo NIOC per vSphere Distributed Switch chiamando il comando API, impostare la proprietà infrastructureTrafficResourceConfig.
LLDP

API: vim.dvs.VmwareDistributedVirtualSwitch.reconfigure

Proprietà: vim.dvs.VmwareDistributedVirtualSwitch.ConfigSpec.linkDiscoveryProtocolConfig
  • Per configurare il profilo LLDP per vSphere Distributed Switch chiamando il comando API, impostare la proprietà linkDiscoveryProtocolConfig.