NSX-T Data Center REST API

DistributedVirtualSwitch (type)

{
  "additionalProperties": false,
  "extends": {
    "$ref": "VirtualSwitch"
  },
  "id": "DistributedVirtualSwitch",
  "module_id": "InventoryCmObj",
  "polymorphic-type-descriptor": {
    "type-identifier": "DistributedVirtualSwitch"
  },
  "properties": {
    "_last_sync_time": {
      "$ref": "EpochMsTimestamp",
      "can_sort": true,
      "description": "Timestamp of last modification",
      "readonly": true
    },
    "_links": {
      "description": "The server will populate this field when returing the resource. Ignored on PUT and POST.",
      "items": {
        "$ref": "ResourceLink"
      },
      "readonly": true,
      "title": "References related to this resource",
      "type": "array"
    },
    "_schema": {
      "readonly": true,
      "title": "Schema for this resource",
      "type": "string"
    },
    "_self": {
      "$ref": "SelfResourceLink",
      "readonly": true,
      "title": "Link to this resource"
    },
    "cm_local_id": {
      "readonly": true,
      "required": false,
      "title": "ID of the virtual switch in compute manager",
      "type": "string"
    },
    "description": {
      "can_sort": true,
      "maxLength": 1024,
      "title": "Description of this resource",
      "type": "string"
    },
    "discovered_nodes": {
      "description": "Array of discovered nodes connected to this switch.",
      "items": {
        "$ref": "DiscoveredNode"
      },
      "readonly": true,
      "required": false,
      "title": "Array of discovered nodes connected",
      "type": "array"
    },
    "display_name": {
      "can_sort": true,
      "description": "Defaults to ID if not set",
      "maxLength": 255,
      "title": "Identifier to use when displaying entity in logs or GUI",
      "type": "string"
    },
    "dpu_failover_policy": {
      "$ref": "DpuFailoverPolicy",
      "description": "This specifies the failover policy for a distributed virtual switch from vCenter DVS, specifically related to the Data Processing Unit(DPU).",
      "readonly": true,
      "required": false,
      "title": "Dpu Failover policy for a DVS"
    },
    "external_id": {
      "readonly": true,
      "required": true,
      "title": "External id of the virtual switch",
      "type": "string"
    },
    "lacp_group_configs": {
      "description": "It contains information about VMware specific multiple dynamic LACP groups.",
      "items": {
        "$ref": "LacpGroupConfigInfo"
      },
      "readonly": false,
      "required": false,
      "title": "Array of Link Aggregation Control Protocol (LACP) configuration",
      "type": "array"
    },
    "network_offload_spec_id": {
      "description": "The ID of the network offload specification associated with this DVS. This value is discovered from vCenter.",
      "readonly": true,
      "required": false,
      "title": "Network offload spec ID",
      "type": "string"
    },
    "origin_id": {
      "description": "ID of the compute manager where this virtual switch is discovered.",
      "readonly": true,
      "required": false,
      "title": "ID of the compute manager",
      "type": "string"
    },
    "origin_properties": {
      "items": {
        "$ref": "KeyValuePair"
      },
      "readonly": true,
      "required": false,
      "title": "Key-Value map of additional properties of switch",
      "type": "array"
    },
    "origin_type": {
      "description": "Identifies the origin type of the virtual switch as reported by the Compute Manager. VmwareDistributedVirtualSwitch represents a vSphere Distributed Virtual Switch.",
      "readonly": true,
      "required": false,
      "title": "Origin Type of the Virtual Switch",
      "type": "string"
    },
    "owner_nsx": {
      "description": "Identifies which NSX instance has ownership of this virtual switch. SELF - this NSX instance owns the virtual switch. OTHER - another NSX instance owns the virtual switch. MULTIPLE - multiple NSX instances attempted to own this virtual switch simultaneously. NONE - no NSX instance owns this virtual switch.",
      "enum": [
        "SELF",
        "OTHER",
        "MULTIPLE",
        "NONE"
      ],
      "readonly": true,
      "required": false,
      "title": "NSX ownership of the virtual switch",
      "type": "string"
    },
    "real_time_config": {
      "$ref": "RealTimeConfig",
      "description": "Real time config for VDS which consists of vswitchRT flag and annotations for uplinks.",
      "readonly": true,
      "required": false,
      "title": "Real Time Config for a VDS"
    },
    "resource_type": {
      "description": "The type of this resource.",
      "readonly": false,
      "required": true,
      "type": "string"
    },
    "scope": {
      "description": "Specifies list of scope of discovered resource. e.g. if VHC path is associated with principal identity, who owns the discovered resource, then scope id will be VHC path and scope type will be VHC.",
      "items": {
        "$ref": "DiscoveredResourceScope"
      },
      "readonly": false,
      "required": false,
      "title": "List of scopes for discovered resource",
      "type": "array"
    },
    "tags": {
      "items": {
        "$ref": "Tag"
      },
      "maxItems": 30,
      "title": "Opaque identifiers meaningful to the API user",
      "type": "array"
    },
    "uplink_port_names": {
      "description": "The uniform name of uplink ports on each host.",
      "items": {
        "type": "string"
      },
      "readonly": true,
      "required": false,
      "title": "Uplink port names",
      "type": "array"
    },
    "uplink_portgroup": {
      "$ref": "DistributedVirtualPortgroup",
      "readonly": true,
      "required": false,
      "title": "Uplink portgroup of distributed virtual switch"
    },
    "uuid": {
      "readonly": true,
      "required": false,
      "title": "UUID of the switch",
      "type": "string"
    }
  },
  "title": "DistributedVirtualSwitch on a VC",
  "type": "object"
}