Comandos de API de NSX para admitir vSphere Distributed Switch en NSX.

Cambios de API para vSphere Distributed Switch

Para obtener información detallada sobre las llamadas API, consulte la Guía de NSX API.

Nota: La configuración realizada mediante comandos de API también es posible desde la interfaz de usuario de VMware vCenter. Para obtener más información sobre cómo crear un nodo de transporte de NSX mediante vSphere Distributed Switch como conmutador de host, consulte el tema Configurar un nodo de transporte de host administrado en la Guía de instalación de NSX.
API NSX en vSphere Distributed Switch (VDS) Cambios en los comandos de API de NSX en vSphere Distributed Switch
Cree un nodo de transporte para un nodo detectado. /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": no es un nombre de conmutador introducido por el administrador. El campo del nombre de conmutador de host se selecciona en la lista de conmutadores VDS creados en vSphere.

  • "host_switch_id": es el UUID del objeto de vSphere Distributed Switch. La API correspondiente en vSphere es vim.DistributedVirtualSwitch.config.uuid .

  • "vds_uplink_name": un vínculo superior creado en vSphere Distributed Switch que asigna vínculos superiores a NIC físicas.
  • "uplink_name": un vínculo superior creado en NSX que asigna vínculos superiores en N-VDS a los vínculos superiores definidos en vds_uplink_name.
  • "is_migrate_pnics": false: de forma predeterminada, no se admite la migración de NIC físicas cuando se utiliza vSphere Distributed Switch.
  • "transport_zone_endpoints": no se admite cuando el tipo de conmutador de host es vSphere Distributed Switch. Este campo es obligatorio cuando el tipo de conmutador de host es N-VDS. Los identificadores de endpoint de zona de transporte corresponden al conmutador de host al que están asociados.

    Para obtener más información sobre /api/v1/fabric/discovered-nodes/<external-id/discovered-node-id>?action=create_transport_node, consulte la Guía de NSX API.
Configuración de máquina virtual vim.vm.device.VirtualEthernetCard.DistributedVirtualPortBackingInfo
  • vSphere Distributed Switch: como administrador de vSphere, asegúrese de que el parámetro BackingType esté configurado como NSX.
Nota: El valor predeterminado de VNIC BackingType es DistributedVirtualPortBackingInfo cuando BackingType está configurado como OpaqueNetworkBackingInfo.
NIC de VMkernel vim.dvs.DistributedVirtualPort
  • N-VDS: como administrador de NSX, establezca los valores para estos parámetros:
    • OpaqueNetworkId
    • OpaqueNetworkType
  • NSX en vSphere Distributed Switch: como administrador de vSphere, establezca los valores para estos parámetros:
    • SwitchUUID y portgroupKey
    • BackingType de la DVPG debe ser NSX.
NIC física para la asignación de vínculo superior

API: vim.host.NetworkSystem:networkSystem.updateNetworkConfig

Propiedad: vim.host.NetworkConfig.proxySwitch
  • Para asignar NIC físicas a vínculos superiores para vSphere Distributed Switch ejecutando el comando de la API, configure la propiedad maxMtu.
MTU

API: vim.dvs.VmwareDistributedVirtualSwitch.reconfigure

Propiedad: VmwareDistributedVirtualSwitch.ConfigSpec.maxMtu
  • Para configurar un valor de MTU para vSphere Distributed Switch ejecutando el comando de la API, configure la propiedad maxMtu.
    Nota: El valor de MTU definido en los perfiles de vínculo superior de NSX no se aplica al conmutador de host.

LAG

API: vim.dvs.VmwareDistributedVirtualSwitch.updateLacpGroupConfig

Propiedad: vim.dvs.VmwareDistributedVirtualSwitch.LacpGroupSpec
  • Para configurar un perfil LAG para vSphere Distributed Switch ejecutando el comando de la API, configure la propiedad LacpGroupSpec.
NIOC

API: vim.dvs.VmwareDistributedVirtualSwitch.reconfigure

Propiedad: vim.dvs.VmwareDistributedVirtualSwitch.ConfigSpec.infrastructureTrafficResourceConfig
  • Para configurar un perfil NIOC para vSphere Distributed Switch ejecutando el comando de la API, configure la propiedad infrastructureTrafficResourceConfig.
LLDP

API: vim.dvs.VmwareDistributedVirtualSwitch.reconfigure

Propiedad: vim.dvs.VmwareDistributedVirtualSwitch.ConfigSpec.linkDiscoveryProtocolConfig
  • Para configurar un perfil LLDP para vSphere Distributed Switch ejecutando el comando de la API, configure la propiedad linkDiscoveryProtocolConfig.